உள்நுழைஇலவசமாகத் தொடங்குங்கள்
easyCoexistence அதிகாரப்பூர்வ API-கள்

TikTok API வழியாக வீடியோ அளவீடுகள்: பார்வைகள், பார்க்கும் நேரம், முழுமையான பார்வை

TikTok-இன் API for Business, GET /business/video/list/ வழியாக ஒவ்வொரு பதிவின் வாழ்நாள் அளவீடுகளைத் திருப்பி அனுப்புகிறது. 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 வீடியோவின் அளவீடுகளைப் படிக்கிறது: video_views, reach அல்லது full_video_watched_rate போன்ற புலங்களைப் பெயரிடுங்கள், வீடியோவின் item_id ஐக் கொடுங்கள்.

video.insights

பார்க்கும் நேரம், முழுமையான பார்வை, ரீடென்ஷன், போக்குவரத்து மூலங்கள் மற்றும் பார்வையாளர் பிரிவுகளுக்குத் தேவையான ஸ்கோப்; அடிப்படை எண்ணிக்கைகளுக்கு video.list தேவை.

7 days

செயலற்ற நிலைக்குப் பிறகு, ஒரு வீடியோவுக்கு ரீச், பார்க்கும் நேரம், போக்குவரத்து மூலங்கள் மற்றும் audience_countries விடுபடலாம்.

10

ஒரு வீடியோவின் audience_countries மற்றும் audience_cities பட்டியல்களில் பெரும்பாலான உள்ளீடுகள்.

24 to 48 h

video_views, likes, reach, பார்க்கும் நேரம் மற்றும் போக்குவரத்து மூலங்களுக்கான வழக்கமான தாமதம், UTC நேரப்படி.

ஒரு வீடியோவுக்கு என்ன அளவீடுகள் உள்ளன?

GET /business/video/list/ fields-இல் பெயரிடப்பட்ட ஒவ்வொரு பதிவுக்கும் இவற்றைத் திருப்பி அனுப்புகிறது; இவை கணக்கின் 60 நாள் சாளர அளவீடுகளுக்குப் பதிலாக, பதிவின் முழு ஆயுள்காலத்தின் கூட்டுத்தொகை. பார்வைகள், லைக்குகள் போன்ற எண்ணிக்கைகளுக்கு டோக்கனில் video.list scope தேவை; பார்க்கும், முழுமையான பார்வை மற்றும் ரீடென்ஷன் புள்ளிவிவரங்களுக்கு 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-இல் பெயரிடுங்கள்; ஒன்றுக்கு மேற்பட்ட புலங்கள் இருந்தால் item_id சேர்க்கப்பட வேண்டிய JSON அணி அது. filters.video_ids மூலம் பதிவுகளைத் தேர்ந்தெடுங்கள். வடிகட்டி இல்லாவிட்டால், எண்ட்பாயிண்ட் கணக்கின் பதிவுகளை ஒரே நேரத்தில் 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>"]}'

பதில் எப்படி இருக்கும்?

ஒவ்வொரு பதிவுக்கும் ஒரு பொருள் கொண்ட videos அணி, கேட்ட புலங்களுடன், மற்றும் பக்கமிடலுக்கான 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
  }
}

போக்குவரத்து மூலங்கள் என்ன அர்த்தம்?

impression_sources, பார்வையாளர்கள் பதிவை எங்கே கண்டறிந்தார்கள் என்பதை, அதிக பங்கிலிருந்து குறைந்த பங்கு வரை வரிசைப்படுத்துகிறது; ஒவ்வொரு உள்ளீடும் ஒரு impression_source, அதன் சதவீதத்துடன். TikTok பின்வரும் மதிப்புகளை ஆவணப்படுத்துகிறது:

  • For You: For You ஊட்டம்.
  • Follow: Follow ஊட்டம்.
  • Sound: ஒலிப் பக்கங்கள்.
  • Personal Profile: சுயவிவரப் பக்கங்கள்.
  • Search: தேடல் பக்கங்கள்.
  • Direct Message: நேரடி மெசேஜ்கள், TikTok Studio அந்தக் கணக்குக்கு அந்தத் தரவைக் காட்டும்போது.
  • Others: மற்ற அனைத்தும்.

எந்த பார்வையாளர் பிரிவுகள் உள்ளன?

நான்கு; அனைத்தும் அந்தப் பதிவைப் பார்த்தவர்களை விவரிக்கின்றன, கணக்கின் பின்தொடர்பவர்களை அல்ல; அனைத்துக்கும் video.insights தேவை:

  • audience_genders: பார்வையாளர்களின் பாலின விகிதங்கள், Female, Male அல்லது Other.
  • audience_countries: அதிகபட்சம் 10 நாடுகள் அல்லது பகுதிகள், ISO 3166-1 alpha-2 குறியீடுகளாக.
  • audience_cities: அதிகபட்சம் 10 நகரங்கள், US Cincinnati போன்ற பெயர்களில்.
  • audience_types: NEW_VIEWER மற்றும் RETURN_VIEWER, மற்றும் FOLLOWER_PERCENT எதிர் NON_FOLLOWER_PERCENT.

கணக்கு வகையைப் பொறுத்து எந்த அளவீடுகள் மாறுபடும்?

சில கிளிக்குகளும் சுயவிவரப் பார்வைகளும் TikTok-இன் Business Analytics-இலிருந்து வருகின்றன; தனிப்பட்ட கணக்கை விட அதிகம் தேவை. profile_views, அதாவது ஒரு பதிவு ஈர்த்த சுயவிவரப் பார்வைகள், Advanced Access அல்லது Verified Business Account கொண்ட கணக்கு தேவை. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks மற்றும் address_clicks ஆகியவற்றுக்கு Verified Business Account தேவை.

ஓர் அளவீடு ஏன் விடுபடலாம் அல்லது தாமதமாகலாம்?

ஏனெனில் TikTok பெரும்பாலானவற்றை ஆஃப்லைனில், TikTok Analytics-இலிருந்து மட்டுமே கணக்கிடுகிறது. எண்ணிக்கைகளும் பார்க்கும் அளவீடுகளும் பொதுவாக 24 முதல் 48 மணி நேரம் பின்தங்கும்; item_id, caption மற்றும் links நேரடியாக வரும். 7 நாட்களாக யாரும் பார்க்காத, லைக் செய்யாத, கருத்திடாத அல்லது பகிராத வீடியோவுக்கு ரீச், பார்க்கும் நேரம், போக்குவரத்து மூலங்கள் மற்றும் audience_countries விடுபடலாம்; TikTok-இன் ஆலோசனை: அதனுடன் தொடர்பு கொண்டு 24 முதல் 48 மணி நேரம் கழித்து மீண்டும் முயலுங்கள். வெளியிட்ட 365 நாட்களுக்குப் பிறகு தரவு புதுப்பிக்கப்படுவது நின்றுவிடும்; இசைப் பதிப்புரிமை போன்ற மீறல்களுக்காக வடிகட்டப்பட்ட பதிவுகள் திருப்பி அனுப்பப்படுவதில்லை.

easyCoexistence ஒரு வீடியோவின் அளவீடுகளை எப்படிப் படிக்கிறது?

get_social_insights மூலம்: வீடியோவின் item_id-ஐ object_id ஆகவும், புலப் பெயர்களை metrics ஆகவும் கொடுங்கள்; கணக்கின் சமீபத்திய 20 பதிவுகளுக்குள் தேடி அந்தப் பதிவின் புலங்களைத் திருப்பித் தரும். பழைய பதிவுக்கு, உங்கள் சொந்தக் குறியீடு get_social_credentials தரும் டோக்கனுடன், 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 இல்லாமல் பல புலங்களைக் கேட்பது. TikTok-இன் குறிப்பு அத்தகைய கோரிக்கை தோல்வியடையக்கூடும் என எச்சரிக்கிறது.
  • பழைய, அமைதியான வீடியோவுக்கு ரீச்சை எதிர்பார்ப்பது. 7 நாட்களாகப் பார்வைகள், லைக்குகள், கருத்துகள் அல்லது பகிர்வுகள் இல்லாவிட்டால் TikTok ரீச், பார்க்கும் நேரம் மற்றும் போக்குவரத்து மூலங்களை வெற்றிடமாக விடலாம்.
  • பதிவின் அளவீடுகளைத் தினசரி கணக்கு அளவீடுகளுடன் ஒப்பிடுவது. பதிவின் எண்கள் அதன் முழு ஆயுள்காலத்தையும் உள்ளடக்கும்; கணக்கு அளவீடுகள் 60 நாட்கள் வரை நாள்வாரியாக வரும்.
EasyCoexistence மூலம் இதைச் செய்வது

பழைய பதிவுகளுக்கு, get_social_credentials உங்கள் சொந்தக் குறியீட்டுக்குக் கணக்கின் டோக்கனைத் தரும். ஓர் இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகளைச் சேர்க்கும்போது குறைகிறது; முதல் 3 நாட்கள் இலவசம்.

அடிக்கடி கேட்கப்படும் கேள்விகள்

TikTok API ஒரு வீடியோவுக்குப் பார்க்கும் நேரத்தைத் தருமா?

ஆம். total_time_watched மற்றும் average_time_watched, video.insights scope கொண்ட டோக்கன்களுக்கு, /business/video/list/ இலிருந்து வினாடிகளில் வருகின்றன.

API வழியாக TikTok வீடியோவின் முழுமையான பார்வை விகிதத்தை எப்படிப் பெறுவது?

/business/video/list/ இல் fields-இல் full_video_watched_rate ஐக் கேளுங்கள். வீடியோவை முழுமையாகப் பார்த்த பார்வையாளர்களின் சதவீதம் என்று TikTok இதை வரையறுக்கிறது.

என் TikTok வீடியோவுக்கு ரீச்சும் பார்க்கும் நேரமும் ஏன் காலியாக உள்ளன?

கடந்த 7 நாட்களில் பார்வைகள், லைக்குகள், கருத்துகள் அல்லது பகிர்வுகள் இல்லாத வீடியோவுக்கு TikTok அவற்றை விட்டுவிடலாம்; சமீபத்திய தரவு 24 முதல் 48 மணி நேரம் பின்தங்கும்.

API ஒரு குறிப்பிட்ட TikTok வீடியோவுக்கான அளவீடுகளைத் திருப்பித் தர முடியுமா?

ஆம். அதன் ID ஐ filters.video_ids இல் கொடுங்கள், item_id மற்றும் நீங்கள் விரும்பும் அளவீடுகளை fields இல் வையுங்கள்.

தொடர்ந்து படிக்கவும்

API வழியாக TikTok பின்தொடர்பவர்களின் மக்கள்தொகை விவரங்கள்TikTok-இன் API for Business தரும் பின்தொடர்பவர் வயது, பாலினம், நாடு, நகரம் விவரங்கள், மணிநேர செயல்பாடு, மற்றும் 100 பின்தொடர்பவர் விதி.API மூலம் TikTok கணக்கின் வீடியோக்களைப் பட்டியலிடுதல்/business/video/list/ மூலம் கணக்கின் பதிவுகளைப் பட்டியலிடுதல்: புலங்கள், கர்சர் பக்கமிடல், ஒரு பக்கத்திற்கு 20 பதிவுகள், ID வடிகட்டல்.TikTok அனலிட்டிக்ஸ் API: கணக்கு இன்சைட்ஸ் மற்றும் வீடியோ அளவீடுகள்API for Business வழங்கும் TikTok அளவீடுகள்: கணக்கின் தினசரி பின்தொடர்பவர்கள், பார்வைகள், லைக்ஸ்; ஒவ்வொரு வீடியோவுக்கும் பார்வைகள், லைக்ஸ், கருத்துகள், பகிர்வுகள்.TikTok API for Business ஸ்கோப்ஸ்: ஒவ்வொரு அனுமதியும் திறப்பது என்னTikTok Accounts API அனுமதிகள்: ஒவ்வொன்றும் திறப்பது, ஒவ்வொரு புலத்தின் டோக்கன் ஸ்கோப், டோக்கனைச் சரிபார்ப்பது எப்படி.API வழியாக TikTok-க்கு வீடியோ பதிவிடுவது எப்படிAPI for Business வழியாக TikTok-க்கு வீடியோ பதிவிடுங்கள். பப்ளிஷ் எண்ட்பாயிண்ட், JSON body, share_id, ஸ்டேட்டஸ் அழைப்பு; curl, Python உதாரணங்களுடன்.

உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.

காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.

  • 3 நாட்கள் இலவசம்
  • எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
  • அதிகாரப்பூர்வ API-கள் மட்டுமே
  • 24/7 கண்காணிப்பு

இதில் சரிபார்க்கப்பட்டது: