Metrike TikTok videa putem API-ja: pregledi, vrijeme gledanja i dovršenost
TikTokov API za poslovanje vraća metrike za cijeli život svake objave iz GET /business/video/list/, zatražene po nazivu u fields: video_views, reach, likes, comments, shares i favorites, total_time_watched i average_time_watched u sekundama, full_video_watched_rate, video_view_retention, impression_sources te raščlambe gledatelja poput audience_countries. Većina brojki stiže s kašnjenjem od 24 do 48 sati i prestaje se ažurirati 365 dana nakon objave.
easyCoexistence čita metrike TikTok videa pomoću get_social_insights, dostupnog u Claude, ChatGPT ili vlastitom kodu: navedite polja, poput video_views, reach ili full_video_watched_rate, i dajte item_id videa.
Opseg potreban za vrijeme gledanja, dovršenost, zadržavanje, izvore prometa i raščlambe gledatelja; osnovne brojke traže video.list.
Neaktivnost nakon koje reach, vrijeme gledanja, izvori prometa i audience_countries mogu nedostajati za video.
Većina unosa u popisima audience_countries i audience_cities za video.
Uobičajeno kašnjenje za video_views, likes, reach, vrijeme gledanja i izvore prometa, u UTC-u.
Koje metrike ima video?
GET /business/video/list/ vraća ove podatke za svaku objavu navedenu u fields, zbrojene za cijeli život objave, a ne za 60-dnevni prozor metrika računa. Brojke poput pregleda i sviđanja traže opseg video.list na tokenu, dok su podaci o gledanju, dovršenosti i zadržavanju potrebni opseg video.insights:
Kako ih zatražiti?
Navedite ih u fields, JSON nizu koji mora sadržavati item_id kad god navodi više od jednog polja, a objave birajte pomoću filters.video_ids. Bez filtera endpoint prolazi kroz objave računa, do 20 odjednom:
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>"]}'Kako izgleda odgovor?
Niz videos s jednim objektom po objavi i traženim poljima, uz cursor i has_more za straničenje. TikTokov vlastiti skraćeni primjer pokazuje mjerne jedinice: vremena gledanja u sekundama s najviše tri decimale, a full_video_watched_rate kao decimalni broj, ovdje 0.0237:
{
"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
}
}Što znače izvori prometa?
impression_sources rangira mjesta na kojima su gledatelji otkrili objavu, od najvećeg udjela do najmanjeg, a svaki unos je impression_source s postotkom. TikTok dokumentira ove vrijednosti:
- For You: feed For You.
- Follow: feed Follow.
- Sound: stranice zvukova.
- Personal Profile: stranice profila.
- Search: stranice pretrage.
- Direct Message: izravne poruke, kad TikTok Studio prikazuje te podatke za račun.
- Others: sve ostalo.
Koje raščlambe gledatelja postoje?
Četiri, sve opisuju ljude koji su gledali tu objavu, a ne pratitelje računa, i sve traže video.insights:
audience_genders: udjeli gledatelja po spolu, Female, Male ili Other.audience_countries: do 10 zemalja ili regija, kao kodovi ISO 3166-1 alpha-2.audience_cities: do 10 gradova, zapisanih poput US Cincinnati.audience_types:NEW_VIEWERiRETURN_VIEWERteFOLLOWER_PERCENTnaspramNON_FOLLOWER_PERCENT.
Koje metrike ovise o vrsti računa?
Nekoliko klikova i posjeta profilu dolazi iz TikTok Business Analytics i zahtijeva više od osobnog računa. profile_views, posjete profilu koje je objava potaknula, traži račun s Advanced Access ili Verified Business Account. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks i address_clicks traže Verified Business Account.
Zašto metrika može nedostajati ili kasniti?
Jer TikTok većinu njih računa izvan mreže, i to samo iz podataka TikTok Analytics. Podaci o gledanju i brojke obično kasne 24 do 48 sati, dok su item_id, caption i links u stvarnom vremenu. Reach, vrijeme gledanja, izvori prometa i audience_countries mogu nedostajati za video koji u 7 dana nitko nije gledao, označio sviđanjem, komentirao ili podijelio; TikTokov savjet je da s njim komunicirate i pokušate ponovno nakon 24 do 48 sati. Podaci prestaju se ažurirati 365 dana nakon objave, a objave filtrirane zbog kršenja, poput autorskih prava na glazbu, ne vraćaju se.
Kako easyCoexistence čita metrike videa?
Pomoću get_social_insights: item_id videa dajte kao object_id, a nazive polja kao metrics, i alat vraća polja te objave tražeći među 20 najnovijih objava računa. Za stariju objavu vlastiti kod poziva business/video/list/ s parametrima fields i filters.video_ids, koristeći token iz 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"]
}Uobičajene pogreške
- Pretpostavka jednog mjerila za sve postotke. TikTokovi primjeri daju impression_sources kao udjele čiji zbroj iznosi 1, dok njegov primjer audience_cities pokazuje vrijednosti poput 17.4921.
- Traženje više polja bez item_id. TikTokova referenca upozorava da takav zahtjev može ne uspjeti.
- Očekivanje dosega za stari, neaktivan video. TikTok može ostaviti reach, vrijeme gledanja i izvore prometa praznima nakon 7 dana bez pregleda, sviđanja, komentara ili dijeljenja.
- Usporedba metrika objave s dnevnim metrikama računa. Brojke objave pokrivaju cijeli njezin život, dok metrike računa dolaze po danima za do 60 dana.
Za starije objave, get_social_credentials daje vašem kodu token računa. US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, s prvih 3 dana besplatno.
Često postavljana pitanja
Daje li TikTok API vrijeme gledanja po videu?
Da. total_time_watched i average_time_watched dolaze u sekundama iz /business/video/list/, za tokene s opsegom video.insights.
Kako preko API-ja dobiti stopu dovršenosti TikTok videa?
Zatražite full_video_watched_rate u fields na /business/video/list/. TikTok je definira kao postotak gledatelja koji dogledaju video do kraja.
Zašto su reach i vrijeme gledanja prazni za moj TikTok video?
TikTok ih može izostaviti za video bez pregleda, sviđanja, komentara ili dijeljenja u posljednjih 7 dana, a noviji podaci kasne 24 do 48 sati.
Može li API vratiti metrike za jedan određeni TikTok video?
Da. Navedite njegov ID u filters.video_ids, a item_id i metrike koje želite u fields.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na