TikTok video metrike kroz API: pregledi, vreme gledanja i završetak
TikTokov API for Business vraća ukupne metrike svake objave za ceo njen životni vek preko GET /business/video/list/, zatražene po imenu u polju 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 i raspodele gledalaca kao što je audience_countries. Većina brojki stiže sa kašnjenjem od 24 do 48 sati i prestaje da se ažurira 365 dana posle objavljivanja.
easyCoexistence čita metrike TikTok videa preko get_social_insights iz Claude-a, ChatGPT-ja ili vašeg sopstvenog koda: navedite polja koja želite, na primer video_views, reach ili full_video_watched_rate, i unesite item_id videa.
Scope potreban za vreme gledanja, završetak, zadržavanje, izvore saobraćaja i raspodele gledalaca; osnovne brojke traže video.list.
Neaktivnost posle koje doseg, vreme gledanja, izvori saobraćaja i audience_countries mogu nedostajati za video.
Većina unosa u listama audience_countries i audience_cities.
Uobičajeno kašnjenje za video_views, likes, reach, vreme gledanja i izvore saobraćaja, u UTC.
Koje metrike ima video?
GET /business/video/list/ vraća ovo za svaku objavu navedenu u fields, zbirno za ceo životni vek objave, a ne za period od 60 dana kao metrike naloga. Brojke kao što su pregledi i lajkovi traže scope video.list na tokenu, dok brojke o gledanju, završetku i zadržavanju traže video.insights:
Kako ih tražite?
Navedite ih u fields, JSON nizu koji mora da sadrži item_id kad god navodi više od jednog polja, a objave birajte preko filters.video_ids. Bez filtera endpoint prolazi kroz objave naloga, 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 sa jednim objektom po objavi i traženim poljima, plus cursor i has_more za paginaciju. TikTokov primer, skraćen, pokazuje jedinice: vremena gledanja u sekundama sa do tri decimale, a full_video_watched_rate kao decimalni broj, ovde 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
}
}Šta znače izvori saobraćaja?
impression_sources rangira mesta na kojima su gledaoci otkrili objavu, od najvećeg udela do najmanjeg, a svaki unos je impression_source sa svojim procentom. TikTok dokumentuje ove vrednosti:
- For You: feed For You.
- Follow: feed Follow.
- Sound: stranice zvuka.
- Personal Profile: stranice profila.
- Search: stranice pretrage.
- Direct Message: direktne poruke, kad TikTok Studio prikazuje te podatke za nalog.
- Others: sve ostalo.
Koje raspodele gledalaca postoje?
Četiri, sve opisuju ljude koji su gledali tu objavu, a ne pratioce naloga, i sve traže video.insights:
audience_genders: udeli gledalaca po polu, Female, Male ili Other.audience_countries: do 10 zemalja ili regiona, kao ISO 3166-1 alpha-2 kodovi.audience_cities: do 10 gradova, navedenih kao US Cincinnati.audience_types:NEW_VIEWERiRETURN_VIEWER, teFOLLOWER_PERCENTnaspramNON_FOLLOWER_PERCENT.
Koje metrike zavise od tipa naloga?
Nekoliko klikova i poseta profilu dolazi iz TikTokove Business Analytics i traži više od ličnog naloga. profile_views, posete profilu koje je objava izazvala, traži nalog sa 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 da nedostaje ili kasni?
Zato što TikTok većinu izračunava van mreže i samo iz TikTok Analytics. Brojke i metrike gledanja obično kasne 24 do 48 sati, dok su item_id, opis i linkovi u realnom vremenu. Doseg, vreme gledanja, izvori saobraćaja i audience_countries mogu nedostajati za video koji niko nije pogledao, lajkovao, komentarisao ili podelio 7 dana; TikTokov savet je da sa njim stupite u interakciju i pokušate ponovo posle 24 do 48 sati. Podaci prestaju da se ažuriraju 365 dana posle objavljivanja, a objave filtrirane zbog kršenja pravila, na primer autorskih prava za muziku, ne vraćaju se.
Kako easyCoexistence čita metrike videa?
Pomoću get_social_insights: unesite item_id videa kao object_id i nazive polja kao metrics, a alat vraća polja te objave tražeći među 20 najnovijih objava naloga. Za stariju objavu, vaš sopstveni kod poziva business/video/list/ sa fields i filters.video_ids kao parametrima, uz 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"]
}Česte greške
- Pretpostavka jedne skale za svaki procenat. TikTokovi primeri daju impression_sources kao udele u vidu decimalnih brojeva koji se sabiraju u 1, dok njegov primer audience_cities prikazuje vrednosti poput 17.4921.
- Traženje nekoliko polja bez item_id. TikTokova referenca upozorava da takav zahtev može da ne uspe.
- Očekivanje dosega za staru, tihu objavu. TikTok može da ostavi doseg, vreme gledanja i izvore saobraćaja praznim posle 7 dana bez pregleda, lajkova, komentara ili deljenja.
- Poređenje metrika objave sa dnevnim metrikama naloga. Metrike objave pokrivaju ceo njen životni vek, dok metrike naloga stižu po danima za do 60 dana.
Za starije objave, get_social_credentials daje vašem kodu token naloga. Od US$ 9 do US$ 0.75 po vezi mesečno, uz smanjenje kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Da li TikTok API daje vreme gledanja po videu?
Da. total_time_watched i average_time_watched stižu u sekundama sa /business/video/list/, za tokene sa scope-om video.insights.
Kako preko API-ja dobijam stopu završetka TikTok videa?
Zatražite full_video_watched_rate u fields na /business/video/list/. TikTok je definiše kao procenat gledalaca koji dogledaju video do kraja.
Zašto su doseg i vreme gledanja prazni za moj TikTok video?
TikTok ih može izostaviti za video bez pregleda, lajkova, komentara ili deljenja u poslednjih 7 dana, a skoriji podaci kasne 24 do 48 sati.
Može li API da vrati metrike za jedan određeni TikTok video?
Može. Prosledite njegov ID u filters.video_ids, sa item_id i metrikama koje želite u fields.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na