IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Vipimo vya video za TikTok kupitia API: mionekano, muda wa kutazama na ukamilishaji

API ya TikTok for Business hurejesha vipimo vya maisha yote ya kila chapisho kutoka GET /business/video/list/, vikiombwa kwa majina katika fields: video_views, reach, likes, comments, shares na favorites, total_time_watched na average_time_watched kwa sekunde, full_video_watched_rate, video_view_retention, impression_sources, pamoja na mgawanyo wa watazamaji kama audience_countries. Vipimo vingi hufika baada ya saa 24 hadi 48 na huacha kusasishwa siku 365 baada ya kuchapishwa.

easyCoexistence inasoma vipimo vya video ya TikTok kwa get_social_insights kutoka Claude, ChatGPT au msimbo wako: taja sehemu unazotaka, kama video_views, reach au full_video_watched_rate, kisha toa item_id ya video.

video.insights

Scope inayohitajika kwa muda wa kutazama, ukamilishaji, uhifadhi, vyanzo na mgawanyo wa watazamaji; hesabu za msingi zinahitaji video.list.

7 days

Kipindi cha kutokuwa na shughuli baada ya hapo ufikiaji, muda wa kutazama, vyanzo vya mionekano na audience_countries vinaweza kukosekana kwa video.

10

Maingizo mengi katika orodha ya audience_countries na audience_cities ya video.

24 to 48 h

Muda wa kawaida wa kuchelewa kwa video_views, likes, reach, muda wa kutazama na vyanzo vya mionekano, kwa saa za UTC.

Vipimo gani vinapatikana kwa video?

GET /business/video/list/ hurejesha haya kwa kila chapisho lililotajwa katika fields, yakijumlishwa kwa maisha yote ya chapisho badala ya dirisha la siku 60 la vipimo vya akaunti. Hesabu kama mionekano na likes zinahitaji scope ya video.list kwenye token, huku takwimu za kutazama, ukamilishaji na uhifadhi zinahitaji 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

Unaziombaje?

Zitaje katika fields, safu ya JSON ambayo lazima ijumuishe item_id kila inapoorodhesha zaidi ya sehemu moja, kisha chagua machapisho kwa filters.video_ids. Bila kichujio, endpoint hupitia machapisho ya akaunti, hadi 20 kwa wakati mmoja:

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>"]}'

Jibu linaonekanaje?

Safu ya videos yenye kitu kimoja kwa kila chapisho na sehemu zilizoombwa, pamoja na cursor na has_more kwa kugawa kurasa. Mfano wa TikTok wenyewe, uliofupishwa, unaonyesha vipimo: muda wa kutazama kwa sekunde hadi desimali tatu, na full_video_watched_rate kama desimali, hapa 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
  }
}

Vyanzo vya mionekano vinamaanisha nini?

impression_sources hupanga mahali watazamaji walipogundua chapisho, kutoka sehemu kubwa hadi ndogo, kila ingizo likiwa impression_source yenye asilimia yake. TikTok inaeleza thamani hizi:

  • For You: mlisho wa For You.
  • Follow: mlisho wa Follow.
  • Sound: kurasa za sauti.
  • Personal Profile: kurasa za wasifu binafsi.
  • Search: kurasa za utafutaji.
  • Direct Message: ujumbe wa moja kwa moja, pale TikTok Studio inapoonyesha data hiyo kwa akaunti.
  • Others: kila kitu kingine.

Mgawanyo wa watazamaji ni upi?

Upo nne, zote zikielezea watu waliotazama chapisho hilo badala ya wafuasi wa akaunti, na zote zinahitaji scope ya video.insights:

  • audience_genders: sehemu za watazamaji kwa jinsia, Female, Male au Other.
  • audience_countries: hadi nchi au maeneo 10, kwa misimbo ya ISO 3166-1 alpha-2.
  • audience_cities: hadi miji 10, yenye majina kama US Cincinnati.
  • audience_types: NEW_VIEWER na RETURN_VIEWER, na FOLLOWER_PERCENT dhidi ya NON_FOLLOWER_PERCENT.

Vipimo vingine vinategemea aina ya akaunti?

Mibofyo michache na ziara za wasifu zinatoka TikTok Business Analytics na zinahitaji zaidi ya akaunti binafsi. profile_views, yaani ziara za wasifu zilizotokana na chapisho, zinahitaji akaunti yenye Advanced Access au Verified Business Account. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks na address_clicks zinahitaji Verified Business Account.

Kwa nini kipimo kinaweza kukosekana au kuchelewa?

Kwa sababu TikTok inakokotoa mengi kati yake nje ya mtandao na kutoka TikTok Analytics pekee. Hesabu na vipimo vya kutazama kwa kawaida huchelewa saa 24 hadi 48, huku item_id, caption na links vikiwa vya wakati halisi. Ufikiaji, muda wa kutazama, vyanzo vya mionekano na audience_countries vinaweza kukosekana kwa video ambayo hakuna aliyeitazama, kuipenda, kuitolea maoni au kuishiriki kwa siku 7; ushauri wa TikTok ni kuiingiliana na kujaribu tena baada ya saa 24 hadi 48. Data inaacha kusasishwa siku 365 baada ya kuchapishwa, na machapisho yaliyochujwa kwa ukiukaji, kama hakimiliki ya muziki, hayarudishwi.

easyCoexistence inasoma vipimo vya video vipi?

Kwa get_social_insights: weka item_id ya video kama object_id na majina ya sehemu kama metrics, kisha get_social_insights hurejesha sehemu za chapisho hilo, ikitafuta miongoni mwa machapisho 20 ya hivi karibuni ya akaunti. Kwa chapisho la zamani, msimbo wako mwenyewe huita business/video/list/ ikiwa na fields na filters.video_ids kama vigezo, ukitumia token kutoka 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"]
}

Makosa ya kawaida

  • Kudhani kipimo kimoja cha asilimia kwa kila kitu. Mifano ya TikTok inaonyesha impression_sources kama sehemu zinazojumlisha 1, huku mfano wa audience_cities ukionyesha thamani kama 17.4921.
  • Kuomba sehemu kadhaa bila item_id. Rejeo la TikTok linaonya kwamba ombi kama hilo linaweza kushindwa.
  • Kutarajia ufikiaji kwa video ya zamani tulivu. TikTok inaweza kuacha ufikiaji, muda wa kutazama na vyanzo vikiwa tupu baada ya siku 7 bila mionekano, likes, maoni au kushirikiwa.
  • Kulinganisha vipimo vya chapisho na vipimo vya akaunti vya kila siku. Vipimo vya chapisho vinahusu maisha yake yote, wakati vipimo vya akaunti vinapatikana kwa siku hadi 60.
Kufanya hili ukitumia EasyCoexistence

Kwa machapisho ya zamani, get_social_credentials huipa msimbo wako token ya akaunti. US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, bei inapungua kadri unavyoongeza miunganisho, na siku 3 za kwanza ni bure.

Maswali yanayoulizwa mara kwa mara

Je, API ya TikTok inatoa muda wa kutazama kwa kila video?

Ndiyo. total_time_watched na average_time_watched zinakuja kwa sekunde kutoka /business/video/list/, kwa token zenye scope ya video.insights.

Ninapataje kiwango cha ukamilishaji wa video ya TikTok kupitia API?

Omba full_video_watched_rate katika fields kwenye /business/video/list/. TikTok inaeleza kama asilimia ya watazamaji wanaomaliza kutazama video.

Kwa nini ufikiaji na muda wa kutazama ni tupu kwa video yangu ya TikTok?

TikTok inaweza kuviacha nje kwa video isiyo na mionekano, likes, maoni au kushirikiwa katika siku 7 zilizopita, na data ya hivi karibuni huchelewa saa 24 hadi 48.

Je, API inaweza kurudisha vipimo vya video moja mahususi ya TikTok?

Ndiyo. Weka kitambulisho chake katika filters.video_ids, pamoja na item_id na vipimo unavyotaka katika fields.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye