පුරනය වන්නනොමිලේ trial කාලය ආරම්භ කරන්න
easyCoexistence නිල API

TikTok වීඩියෝ metrics API හරහා: views, watch time සහ completion

TikTok API for Business හි API එක GET /business/video/list/ හරහා සෑම post එකකම ජීවිත කාලය පුරා metrics ලබා දෙයි. fields හි නමින් ඉල්ලන්නේ: video_views, reach, likes, comments, shares, favorites, total_time_watched සහ average_time_watched (තත්පර වලින්), full_video_watched_rate, video_view_retention, impression_sources සහ audience_countries වැනි නරඹන්නන්ගේ විශ්ලේෂණ. බොහෝ ගණන් පැය 24 සිට 48 දක්වා ප්‍රමාදයෙන් පැමිණෙන අතර, පළ කිරීමෙන් දින 365 කට පසු යාවත්කාලීන වීම නවතී.

easyCoexistence, Claude, ChatGPT හෝ ඔබේ කේතයෙන්, get_social_insights මගින් TikTok වීඩියෝවක metrics කියවයි: ඔබට අවශ්‍ය fields නම් කරන්න, උදා video_views, reach හෝ full_video_watched_rate, සහ වීඩියෝවේ item_id දෙන්න.

video.insights

watch time, completion, retention, traffic මූලාශ්‍ර සහ නරඹන්නන්ගේ විශ්ලේෂණ සඳහා අවශ්‍ය scope එක; මූලික ගණන් සඳහා video.list අවශ්‍යයි.

7 days

අක්‍රිය කාලයකින් පසු වීඩියෝවක reach, watch time, traffic මූලාශ්‍ර සහ audience_countries අතුරුදහන් විය හැක.

10

audience_countries සහ audience_cities ලැයිස්තුවල බොහෝ ඇතුළත් කිරීම්.

24 to 48 h

video_views, likes, reach, watch time සහ traffic මූලාශ්‍ර සඳහා සාමාන්‍ය ප්‍රමාදය, UTC වේලාවෙන්.

වීඩියෝවකට ඇත්තේ කුමන metrics ද?

GET /business/video/list/ මගින් fields හි නම් කළ සෑම post එකක් සඳහාම මේවා ලබා දෙයි. එය ගිණුම් metrics හි දින 60 ක කවුළුවට වඩා, post එකේ සම්පූර්ණ ජීවිත කාලය පුරා එකතු කර ඇත. views සහ likes වැනි ගණන් token එකේ video.list scope එක ඉල්ලන අතර, නැරඹීම, සම්පූර්ණ කිරීම සහ retention අගයන්ට 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

ඒවා කෙසේ ඉල්ලන්නේ ද?

fields හි නම් කරන්න, JSON array එකක්, එහි field එකකට වඩා ලැයිස්තු කළ විට item_id ඇතුළත් විය යුතුයි. post තේරීමට filters.video_ids භාවිත කරන්න. filter එකක් නොමැතිව endpoint එක ගිණුමේ post පිටු වශයෙන් යන අතර එක විටෙක 20 දක්වා:

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

ප්‍රතිචාරය කෙසේ පෙනේ ද?

එක් post එකකට එක් object එකක් සහිත videos array එකක් සහ පිටු බෙදීම සඳහා cursor සහ has_more. TikTok ගේම උදාහරණය, කෙටි කළ, ඒකක පෙන්වයි: නැරඹීමේ කාලය තත්පර වලින් දශම තුනක් දක්වා, සහ full_video_watched_rate දශමයක් ලෙස, මෙහි 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
  }
}

traffic මූලාශ්‍ර යනු කුමක් ද?

impression_sources මගින් නරඹන්නන් post එක සොයාගත් ස්ථාන විශාලතම කොටසේ සිට කුඩාම දක්වා ශ්‍රේණිගත කරයි, එක් entry එකක් impression_source එකක් සහ එහි ප්‍රතිශතය සමඟ. TikTok මෙම අගයන් ලේඛනගත කර ඇත:

  • For You: For You feed එක.
  • Follow: Follow feed එක.
  • Sound: sound පිටු.
  • Personal Profile: profile පිටු.
  • Search: search පිටු.
  • Direct Message: සෘජු පණිවිඩ, TikTok Studio මගින් ගිණුමට එම දත්ත පෙන්වන විට.
  • Others: අනෙක් සියල්ල.

නරඹන්නන්ගේ කුමන විශ්ලේෂණ ඇත ද?

හතරක්, සියල්ලම එම post එක නැරඹූ පුද්ගලයින් විස්තර කරයි, ගිණුමේ අනුගාමිකයින් නොවේ, සියල්ලම video.insights ඉල්ලයි:

  • audience_genders: නරඹන්නන්ගේ ලිංගභේදය අනුව කොටස්, Female, Male හෝ Other.
  • audience_countries: ISO 3166-1 alpha-2 කේත ලෙස රටවල් හෝ කලාප 10 දක්වා.
  • audience_cities: නගර 10 දක්වා, US Cincinnati වැනි නම්වලින්.
  • audience_types: NEW_VIEWER සහ RETURN_VIEWER, සහ FOLLOWER_PERCENT එදිරිව NON_FOLLOWER_PERCENT.

ගිණුම් වර්ගය අනුව කුමන metrics රඳා පවතී ද?

ක්ලික් කිහිපයක් සහ පැතිකඩ නැරඹීම් TikTok Business Analytics වලින් එන අතර පුද්ගලික ගිණුමකට වඩා වැඩි දෙයක් අවශ්‍යයි. profile_views, post එක මගින් ඇති කළ පැතිකඩ නැරඹීම්, Advanced Access හෝ Verified Business Account එකක් අවශ්‍යයි. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks සහ address_clicks සඳහා Verified Business Account එකක් අවශ්‍යයි.

metric එකක් අතුරුදහන් හෝ ප්‍රමාදව පැමිණෙන්නේ ඇයි?

TikTok බොහෝ ඒවා ඔෆ්ලයින් ගණනය කරන අතර TikTok Analytics වලින් පමණක් වන බැවින්. ගණන් සහ නැරඹීම් metrics සාමාන්‍යයෙන් පැය 24 සිට 48 දක්වා පසුවන අතර, item_id, caption සහ links තත්‍ය කාලීනයි. reach, watch time, traffic මූලාශ්‍ර සහ audience_countries දින 7 ක් තුළ කිසිවෙකු නැරඹීම, කැමති වීම, අදහස් දැක්වීම හෝ බෙදාගැනීම නොකළ වීඩියෝවකට අතුරුදහන් විය හැක. TikTok ගේ උපදේශය වන්නේ ඊට සම්බන්ධ වී පැය 24 සිට 48 කට පසු නැවත උත්සාහ කිරීමයි. පළ කිරීමෙන් දින 365 කට පසු දත්ත යාවත්කාලීන වීම නවතී, සහ සංගීත කර්තෘ හිමිකම වැනි උල්ලංඝනයන් හේතුවෙන් පෙරා දමන ලද post ලබා නොදේ.

easyCoexistence වීඩියෝවක metrics කියවන්නේ කෙසේ ද?

get_social_insights සමඟ: වීඩියෝවේ item_id object_id ලෙසත්, field නම් metrics ලෙසත් දෙන්න. එවිට ගිණුමේ අවසාන post 20 අතර සොයමින් එම post එකේ fields ලැබේ. පැරණි post සඳහා, ඔබේ කේතය get_social_credentials වෙතින් ලැබෙන token එක භාවිතයෙන් fields සහ filters.video_ids පරාමිතිවලින් business/video/list/ ඇමතුම් කරයි.

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

සාමාන්‍ය වැරදි

  • සියලු ප්‍රතිශතවලට එක් පරිමාණයක් ඇතැයි උපකල්පනය කිරීම. TikTok උදාහරණවල impression_sources එකතුව 1 වන භාග ලෙස දක්වන අතර, audience_cities උදාහරණය 17.4921 වැනි අගයන් පෙන්වයි.
  • item_id නොමැතිව fields කිහිපයක් ඉල්ලීම. TikTok ගේ යොමුව අනතුරු අඟවන්නේ එවැනි request එකක් අසාර්ථක විය හැකි බවයි.
  • පැරණි, නිශ්ශබ්ද වීඩියෝවක reach බලාපොරොත්තු වීම. දින 7 ක් views, likes, comments හෝ shares නොමැතිව ගිය පසු TikTok reach, watch time සහ traffic මූලාශ්‍ර හිස්ව තැබිය හැක.
  • post metrics දෛනික ගිණුම් metrics සමඟ සංසන්දනය කිරීම. post එකක අගයන් එහි සම්පූර්ණ ජීවිත කාලය ආවරණය කරන අතර, ගිණුම් metrics දින 60 ක් දක්වා දිනෙන් දින පැමිණේ.
EasyCoexistence සමඟ මෙය කිරීම

පැරණි post සඳහා, get_social_credentials ඔබේ කේතයට ගිණුමේ token එක දෙයි. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩුවේ, පළමු දින 3 නොමිලේ.

නිතර අසන ප්‍රශ්න

TikTok API මගින් වීඩියෝවකට නැරඹීමේ කාලය ලබා දෙන්නේ ද?

ඔව්. total_time_watched සහ average_time_watched, /business/video/list/ වලින් තත්පර වලින් පැමිණේ, video.insights scope එක ඇති token සඳහා.

TikTok වීඩියෝවක සම්පූර්ණ කිරීමේ අනුපාතය API හරහා ලබා ගන්නේ කෙසේ ද?

/business/video/list/ හි fields තුළ full_video_watched_rate ඉල්ලන්න. TikTok එය නිරූපණය කරන්නේ වීඩියෝව අවසානය දක්වා නරඹන නරඹන්නන්ගේ ප්‍රතිශතයක් ලෙසයි.

මගේ TikTok වීඩියෝවේ reach සහ watch time හිස් වන්නේ ඇයි?

දින 7 ක් තුළ views, likes, comments හෝ shares නොමැති වීඩියෝවකට TikTok ඒවා ඉවත් කළ හැක, සහ මෑත දත්ත පැය 24 සිට 48 දක්වා ප්‍රමාදයි.

API එකෙන් එක් නිශ්චිත TikTok වීඩියෝවක metrics ලබා දිය හැකි ද?

ඔව්. එහි ID filters.video_ids තුළ දෙන්න, item_id සහ ඔබට අවශ්‍ය metrics fields තුළ සමඟ.

තවදුරටත් කියවන්න

API හරහා TikTok ප්‍රේක්ෂක ජනවිකාශනTikTok API for Business ගෙන් අනුගාමිකයන්ගේ වයස, ලිංගය, රට, නගර, පැය අනුව ක්‍රියාකාරිත්වය සහ අනුගාමික 100 රීතිය.API හරහා TikTok ගිණුමේ videos ලැයිස්තුගත කිරීමTikTok API for Business හරහා ගිණුමක posts ලැයිස්තුගත කරන ආකාරය: /business/video/list/, fields, cursor pagination සහ ID අනුව filter කිරීම.TikTok analytics API: ගිණුම් insights සහ වීඩියෝ metricsAPI for Business හරහා ලැබෙන TikTok metrics: ගිණුමේ followers, views සහ likes දිනෙන් දින, සහ වීඩියෝ එකකට views, likes, comments සහ shares.TikTok API for Business scopes: එක් එක් අවසරය විවෘත කරන දේTikTok ම දෙන නම්වලින් Accounts API අවසර: ඒවා විවෘත කරන දේ, field අනුව token scopes, සහ token එකක් පරීක්ෂා කරන ආකාරය.API හරහා TikTok වෙත වීඩියෝවක් publish කරන ආකාරයAPI for Business හරහා TikTok වෙත වීඩියෝවක් post කරන්න: publish endpoint එක, එහි JSON body එක, එය ලබා දෙන share_id සහ status call එක, curl සහ Python හි.

ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.

වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්‍ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්‍රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.

  • දින 3ක් නොමිලේ
  • ඕනෑම වේලාවක අවලංගු කරන්න
  • නිල API පමණි
  • 24/7 නිරීක්ෂණය කෙරේ

සත්‍යාපනය කළේ