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.list தேவை.
செயலற்ற நிலைக்குப் பிறகு, ஒரு வீடியோவுக்கு ரீச், பார்க்கும் நேரம், போக்குவரத்து மூலங்கள் மற்றும் audience_countries விடுபடலாம்.
ஒரு வீடியோவின் audience_countries மற்றும் audience_cities பட்டியல்களில் பெரும்பாலான உள்ளீடுகள்.
video_views, likes, reach, பார்க்கும் நேரம் மற்றும் போக்குவரத்து மூலங்களுக்கான வழக்கமான தாமதம், UTC நேரப்படி.
ஒரு வீடியோவுக்கு என்ன அளவீடுகள் உள்ளன?
GET /business/video/list/ fields-இல் பெயரிடப்பட்ட ஒவ்வொரு பதிவுக்கும் இவற்றைத் திருப்பி அனுப்புகிறது; இவை கணக்கின் 60 நாள் சாளர அளவீடுகளுக்குப் பதிலாக, பதிவின் முழு ஆயுள்காலத்தின் கூட்டுத்தொகை. பார்வைகள், லைக்குகள் போன்ற எண்ணிக்கைகளுக்கு டோக்கனில் video.list scope தேவை; பார்க்கும், முழுமையான பார்வை மற்றும் ரீடென்ஷன் புள்ளிவிவரங்களுக்கு video.insights தேவை:
இவற்றை எப்படிக் கேட்பது?
fields-இல் பெயரிடுங்கள்; ஒன்றுக்கு மேற்பட்ட புலங்கள் இருந்தால் item_id சேர்க்கப்பட வேண்டிய JSON அணி அது. filters.video_ids மூலம் பதிவுகளைத் தேர்ந்தெடுங்கள். வடிகட்டி இல்லாவிட்டால், எண்ட்பாயிண்ட் கணக்கின் பதிவுகளை ஒரே நேரத்தில் 20 வரை பக்கமாகக் கடந்து செல்லும்:
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:
{
"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/ ஐ அழைக்கிறது.
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 நாட்கள் வரை நாள்வாரியாக வரும்.
பழைய பதிவுகளுக்கு, 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 இல் வையுங்கள்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: