Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

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.

video.insights

Scope potreban za vreme gledanja, završetak, zadržavanje, izvore saobraćaja i raspodele gledalaca; osnovne brojke traže video.list.

7 days

Neaktivnost posle koje doseg, vreme gledanja, izvori saobraćaja i audience_countries mogu nedostajati za video.

10

Većina unosa u listama audience_countries i audience_cities.

24 to 48 h

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:

video_viewsViews, counted on the first playback in an impression session
reachPeople who watched the post at least once
likes, comments, sharesLifetime totals; shares include sends to friends inside TikTok
favoritesTimes the post was added to favorites
total_time_watchedSeconds viewers spent watching, in total
average_time_watchedAverage seconds viewers spent watching
full_video_watched_rateShare of viewers who finished the video
video_view_retentionShare of viewers still watching at each second
impression_sourcesWhere viewers found the post, by share
new_followersViewers who started following the account
engagement_likesShare of viewers who liked at each second
video_durationLength of the video in seconds

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:

Metrics for one video
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:

A video's metrics, from TikTok's example
{
  "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_VIEWER i RETURN_VIEWER, te FOLLOWER_PERCENT naspram NON_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.

One video's metrics through MCP
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.
Ovo radite uz EasyCoexistence

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