Metrik video TikTok lewat API: tayangan, waktu tonton, dan penyelesaian
API TikTok for Business mengembalikan metrik sepanjang masa tayang tiap postingan dari GET /business/video/list/, diminta dengan nama di fields: video_views, reach, likes, comments, shares dan favorites, total_time_watched dan average_time_watched dalam detik, full_video_watched_rate, video_view_retention, impression_sources, serta rincian penonton seperti audience_countries. Sebagian besar angka terlambat 24 hingga 48 jam dan berhenti diperbarui 365 hari setelah publikasi.
easyCoexistence membaca metrik video TikTok dengan get_social_insights dari Claude, ChatGPT, atau kode Anda sendiri: sebutkan field yang Anda inginkan, misalnya video_views, reach, atau full_video_watched_rate, dan berikan item_id video.
Cakupan yang dibutuhkan untuk waktu tonton, penyelesaian, retensi, sumber trafik, dan rincian penonton; angka dasar membutuhkan video.list.
Periode tidak aktif setelah itu jangkauan, waktu tonton, sumber trafik, dan audience_countries bisa hilang untuk sebuah video.
Sebagian besar entri dalam daftar audience_countries dan audience_cities.
Jeda umum untuk video_views, likes, reach, waktu tonton, dan sumber trafik, dalam UTC.
Metrik apa saja yang dimiliki sebuah video?
GET /business/video/list/ mengembalikan ini untuk setiap postingan yang disebut di fields, dihitung sepanjang masa hidup postingan, bukan jendela 60 hari seperti metrik akun. Hitungan seperti tayangan dan likes membutuhkan scope video.list pada token, sedangkan angka tonton, penyelesaian, dan retensi membutuhkan video.insights:
Bagaimana cara memintanya?
Sebutkan di fields, sebuah array JSON yang wajib menyertakan item_id setiap kali memuat lebih dari satu field, lalu pilih postingan dengan filters.video_ids. Tanpa filter, endpoint menelusuri postingan akun, hingga 20 sekaligus:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","video_views","reach","video_duration","total_time_watched","average_time_watched","full_video_watched_rate","impression_sources","audience_countries"]' \
--data-urlencode 'filters={"video_ids":["<ITEM_ID>"]}'Seperti apa responsnya?
Sebuah array videos dengan satu objek untuk setiap postingan dan field yang diminta, ditambah cursor dan has_more untuk penomoran halaman. Contoh resmi TikTok, yang sudah dipangkas, menunjukkan satuannya: waktu tonton dalam detik dengan hingga tiga desimal, dan full_video_watched_rate sebagai desimal, 0.0237 di sini:
{
"code": 0,
"message": "OK",
"request_id": "2021080307532501024502410704A7306F",
"data": {
"videos": [
{
"item_id": "6990565363377392901",
"video_views": 1231,
"reach": 154,
"likes": 10,
"comments": 2,
"shares": 0,
"video_duration": 20.0,
"total_time_watched": 695.942,
"average_time_watched": 4.118,
"full_video_watched_rate": 0.0237,
"impression_sources": [
{ "impression_source": "For You", "percentage": 0.8983 },
{ "impression_source": "Personal Profile", "percentage": 0.0904 },
{ "impression_source": "Follow", "percentage": 0.0113 }
],
"audience_countries": [
{ "country": "US", "percentage": 0.7574 },
{ "country": "GB", "percentage": 0.1775 }
]
}
],
"cursor": 0,
"has_more": false
}
}Apa arti sumber trafik?
impression_sources memeringkat dari mana penonton menemukan postingan, dari porsi terbesar ke terkecil, dengan setiap entri berupa impression_source beserta persentasenya. TikTok mendokumentasikan nilai-nilai ini:
- For You: feed For You.
- Follow: feed Follow.
- Sound: halaman suara.
- Personal Profile: halaman profil.
- Search: halaman pencarian.
- Direct Message: pesan langsung, ketika TikTok Studio menampilkan data itu untuk akun.
- Others: lainnya.
Rincian penonton apa saja yang ada?
Empat, semuanya menggambarkan orang yang menonton postingan itu, bukan pengikut akun, dan semuanya membutuhkan video.insights:
audience_genders: porsi penonton menurut jenis kelamin, Female, Male, atau Other.audience_countries: hingga 10 negara atau wilayah, dalam kode ISO 3166-1 alpha-2.audience_cities: hingga 10 kota, ditulis seperti US Cincinnati.audience_types:NEW_VIEWERdanRETURN_VIEWER, sertaFOLLOWER_PERCENTdibandingNON_FOLLOWER_PERCENT.
Metrik mana yang bergantung pada jenis akun?
Beberapa klik dan kunjungan profil berasal dari Business Analytics TikTok dan membutuhkan lebih dari sekadar akun pribadi. profile_views, yaitu kunjungan profil yang didorong sebuah postingan, membutuhkan akun dengan Advanced Access atau Verified Business Account. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks, dan address_clicks membutuhkan Verified Business Account.
Mengapa sebuah metrik bisa hilang atau terlambat?
Karena TikTok menghitung sebagian besar secara offline dan hanya dari TikTok Analytics. Hitungan dan metrik tonton biasanya tertinggal 24 hingga 48 jam, sedangkan item_id, caption, dan links berjalan waktu nyata. Jangkauan, waktu tonton, sumber trafik, dan audience_countries bisa hilang untuk video yang tidak dilihat, disukai, dikomentari, atau dibagikan selama 7 hari; saran TikTok adalah berinteraksi dengan video itu lalu mencoba kembali setelah 24 hingga 48 jam. Data berhenti diperbarui 365 hari setelah publikasi, dan postingan yang difilter karena pelanggaran, misalnya hak cipta musik, tidak dikembalikan.
Bagaimana easyCoexistence membaca metrik sebuah video?
Dengan get_social_insights: berikan item_id video sebagai object_id dan nama field sebagai metrics, lalu tool itu mengembalikan field postingan tersebut dengan mencarinya di antara 20 postingan terbaru akun. Untuk postingan yang lebih lama, kode Anda sendiri memanggil business/video/list/ dengan fields dan filters.video_ids sebagai parameter, memakai token dari get_social_credentials.
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"object_id": "<ITEM_ID>",
"metrics": ["video_views", "reach", "average_time_watched", "full_video_watched_rate", "impression_sources"]
}Kesalahan umum
- Mengira satu skala untuk semua persentase. Contoh TikTok memberi impression_sources sebagai pecahan yang jumlahnya 1, sedangkan contoh audience_cities-nya menampilkan nilai seperti 17.4921.
- Meminta beberapa field tanpa item_id. Referensi TikTok memperingatkan bahwa permintaan semacam itu bisa gagal.
- Mengharapkan jangkauan untuk video lama yang sepi. TikTok bisa mengosongkan jangkauan, waktu tonton, dan sumber trafik setelah 7 hari tanpa tayangan, suka, komentar, atau dibagikan.
- Membandingkan metrik postingan dengan metrik harian akun. Angka sebuah postingan mencakup seluruh masa hidupnya, sedangkan metrik akun tersedia per hari untuk hingga 60 hari.
Untuk postingan lama, get_social_credentials memberi kode Anda sendiri token akun. Dari US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah API TikTok memberi waktu tonton per video?
Ya. total_time_watched dan average_time_watched datang dalam detik dari /business/video/list/, untuk token dengan scope video.insights.
Bagaimana cara mendapatkan tingkat penyelesaian video TikTok lewat API?
Minta full_video_watched_rate di fields pada /business/video/list/. TikTok mendefinisikannya sebagai persentase penonton yang menonton video sampai selesai.
Mengapa jangkauan dan waktu tonton kosong untuk video TikTok saya?
TikTok bisa menghilangkannya untuk video tanpa tayangan, suka, komentar, atau dibagikan dalam 7 hari terakhir, dan data terbaru tertinggal 24 hingga 48 jam.
Bisakah API mengembalikan metrik untuk satu video TikTok tertentu?
Bisa. Berikan ID-nya di filters.video_ids, dengan item_id dan metrik yang Anda inginkan di fields.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada