Metrik video TikTok melalui API: tontonan, masa tontonan dan kadar tontonan penuh
API for Business TikTok memulangkan metrik sepanjang hayat bagi setiap hantaran daripada GET /business/video/list/, diminta mengikut nama dalam fields: video_views, reach, likes, comments, shares dan favorites, total_time_watched dan average_time_watched dalam saat, full_video_watched_rate, video_view_retention, impression_sources serta pecahan penonton seperti audience_countries. Kebanyakan kiraan tiba lewat 24 hingga 48 jam dan berhenti dikemas kini 365 hari selepas diterbitkan.
easyCoexistence membaca metrik video TikTok dengan get_social_insights daripada Claude, ChatGPT atau kod anda sendiri: nyatakan medan yang anda mahu, seperti video_views, reach atau full_video_watched_rate, dan beri item_id video.
Skop yang diperlukan untuk masa tontonan, penyiapan, pengekalan, sumber trafik dan pecahan penonton; kiraan asas memerlukan video.list.
Tempoh tidak aktif selepas itu capaian, masa tontonan, sumber trafik dan audience_countries boleh hilang bagi sesebuah video.
Kebanyakan entri dalam senarai audience_countries dan audience_cities bagi sesebuah video.
Kelewatan biasa bagi video_views, likes, reach, masa tontonan dan sumber trafik, dalam UTC.
Apakah metrik yang ada pada sesebuah video?
GET /business/video/list/ memulangkan ini bagi setiap hantaran yang dinyatakan dalam fields, dikumpulkan sepanjang hayat hantaran itu dan bukan tetingkap 60 hari bagi metrik akaun. Kiraan seperti tontonan dan suka memerlukan skop video.list pada token, manakala angka tontonan, penyiapan dan pengekalan memerlukan video.insights:
Bagaimana anda memintanya?
Nyatakan dalam fields, tatasusunan JSON yang mesti termasuk item_id apabila senarai itu mengandungi lebih daripada satu medan, dan pilih hantaran dengan filters.video_ids. Tanpa penapis, endpoint itu menyemak hantaran akaun halaman demi halaman, sehingga 20 sekali gus:
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>"]}'Bagaimanakah rupa respons?
Tatasusunan videos dengan satu objek bagi setiap hantaran dan medan yang diminta, serta cursor dan has_more untuk penomboran halaman. Contoh TikTok sendiri, dipendekkan, menunjukkan unitnya: masa tontonan dalam saat dengan sehingga tiga titik perpuluhan, dan full_video_watched_rate sebagai perpuluhan, 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
}
}Apakah maksud sumber trafik?
impression_sources menyusun tempat penonton menemui hantaran itu, daripada bahagian terbesar kepada terkecil, dengan setiap entri ialah impression_source beserta peratusannya. TikTok mendokumentasikan nilai-nilai ini:
- For You: suapan For You.
- Follow: suapan Follow.
- Sound: halaman bunyi.
- Personal Profile: halaman profil peribadi.
- Search: halaman carian.
- Direct Message: mesej langsung, apabila TikTok Studio menunjukkan data itu untuk akaun.
- Others: segala yang lain.
Pecahan penonton yang mana ada?
Empat, kesemuanya menggambarkan orang yang menonton hantaran itu dan bukan pengikut akaun, dan kesemuanya memerlukan video.insights:
audience_genders: bahagian penonton mengikut jantina, Female, Male atau Other.audience_countries: sehingga 10 negara atau wilayah, dalam kod ISO 3166-1 alpha-2.audience_cities: sehingga 10 bandar, dinamakan seperti US Cincinnati.audience_types:NEW_VIEWERdanRETURN_VIEWER, sertaFOLLOWER_PERCENTberbandingNON_FOLLOWER_PERCENT.
Metrik mana yang bergantung pada jenis akaun?
Beberapa klik dan lawatan profil datang daripada Business Analytics TikTok dan memerlukan lebih daripada akaun peribadi. profile_views, lawatan profil yang didorong oleh hantaran, memerlukan akaun dengan Advanced Access atau Verified Business Account. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks dan address_clicks memerlukan Verified Business Account.
Mengapa sesuatu metrik boleh hilang atau lewat?
Ini berlaku kerana TikTok mengira kebanyakannya secara luar talian dan hanya daripada TikTok Analytics. Kiraan dan metrik tontonan biasanya lewat 24 hingga 48 jam, manakala item_id, caption dan links adalah masa nyata. Capaian, masa tontonan, sumber trafik dan audience_countries boleh hilang bagi video yang tidak ditonton, disukai, diulas atau dikongsi selama 7 hari; tip TikTok ialah berinteraksi dengannya dan cuba semula selepas 24 hingga 48 jam. Data berhenti dikemas kini 365 hari selepas diterbitkan, dan hantaran yang ditapis kerana pelanggaran, seperti hak cipta muzik, tidak dipulangkan.
Bagaimana easyCoexistence membaca metrik sesebuah video?
Dengan get_social_insights: beri item_id video sebagai object_id dan nama medan sebagai metrics, dan ia memulangkan medan hantaran itu, dengan mencarinya dalam 20 hantaran terbaharu akaun. Bagi hantaran lama, kod anda sendiri memanggil business/video/list/ dengan fields dan filters.video_ids sebagai parameter, menggunakan token daripada 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"]
}Kesilapan biasa
- Menganggap satu skala bagi setiap peratusan. Contoh TikTok memberikan impression_sources sebagai pecahan yang berjumlah 1, manakala contoh audience_cities menunjukkan nilai seperti 17.4921.
- Meminta beberapa medan tanpa item_id. Rujukan TikTok memberi amaran bahawa permintaan sedemikian mungkin gagal.
- Menjangka capaian bagi video lama yang senyap. TikTok boleh membiarkan capaian, masa tontonan dan sumber trafik kosong selepas 7 hari tanpa tontonan, suka, ulasan atau kongsi.
- Membandingkan metrik hantaran dengan metrik akaun harian. Angka hantaran meliputi seluruh hayatnya, manakala metrik akaun datang mengikut hari bagi sehingga 60 hari.
Bagi hantaran lama, get_social_credentials memberi kod anda sendiri token akaun itu. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma pertama.
Soalan lazim
Adakah API TikTok memberi masa tontonan bagi setiap video?
Ya. total_time_watched dan average_time_watched datang dalam saat daripada /business/video/list/, bagi token dengan skop video.insights.
Bagaimana saya mendapatkan kadar tontonan penuh video TikTok melalui API?
Minta full_video_watched_rate dalam fields pada /business/video/list/. TikTok mentakrifkannya sebagai peratusan penonton yang menghabiskan tontonan video itu.
Mengapa capaian dan masa tontonan kosong bagi video TikTok saya?
TikTok boleh meninggalkannya bagi video yang tiada tontonan, suka, ulasan atau kongsi dalam 7 hari terakhir, dan data terkini lewat 24 hingga 48 jam.
Bolehkah API memulangkan metrik bagi satu video TikTok tertentu?
Boleh. Nyatakan IDnya dalam filters.video_ids, dengan item_id dan metrik yang anda mahu dalam fields.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada