TikTok एपीआई मार्फत भिडियो मेट्रिक्स: भ्यूज, हेर्ने समय र पूरा हेर्ने दर
TikTok को एपीआई ले प्रत्येक पोस्टका जीवनभरका मेट्रिक्स 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 चाहिन्छ।
निष्क्रियता जसपछि भिडियोका reach, हेर्ने समय, ट्राफिक स्रोत र audience_countries हराउन सक्छन्।
भिडियोको audience_countries र audience_cities सूचीका अधिकांश प्रविष्टिहरू।
video_views, likes, reach, हेर्ने समय र ट्राफिक स्रोतको सामान्य ढिलाइ, UTC मा।
भिडियोका कुन मेट्रिक्स हुन्छन्?
GET /business/video/list/ ले fields मा नाम दिइएका प्रत्येक पोस्टका यी मेट्रिक्स फर्काउँछ, जुन खाताका मेट्रिक्स (60 दिनको विन्डो) भन्दा फरक, पोस्टको सम्पूर्ण जीवनकालभरको योग हो। भ्यूज र लाइक्स जस्ता गणनाका लागि टोकनमा video.list स्कोप चाहिन्छ, जबकि हेर्ने, पूरा हेर्ने र रिटेन्सनका आँकडाका लागि video.insights:
कसरी अनुरोध गर्ने?
fields लाई JSON array मा नाम दिनुहोस्, जसमा दुईभन्दा बढी फिल्ड दिँदा item_id अनिवार्य हुन्छ, र 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 array मा प्रत्येक पोस्टका एउटा वस्तु र मागिएका फिल्डहरू हुन्छन्, साथमा पेजिङका लागि 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: खोज पेजहरू।
- डाइरेक्ट म्यासेज: डाइरेक्ट म्यासेजहरू, जब 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, क्याप्शन र लिङ्कहरू तुरुन्त आउँछन्। reach, हेर्ने समय, ट्राफिक स्रोत र audience_countries कुनै भिडियो 7 दिनसम्म कसैले नहेरेको, लाइक नगरेको, कमेन्ट नगरेको वा सेयर नगरेको अवस्थामा हराउन सक्छन्; 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 को सन्दर्भले भन्छ, त्यस्तो अनुरोध असफल हुन सक्छ।
- पुरानो, शान्त भिडियोको reach को अपेक्षा गर्नु। TikTok ले 7 दिनसम्म भ्यूज, लाइक, कमेन्ट वा सेयर नभएपछि reach, हेर्ने समय र ट्राफिक स्रोत खाली छोड्न सक्छ।
- पोस्टका मेट्रिक्सलाई दैनिक खाताका मेट्रिक्ससँग तुलना गर्नु। पोस्टका आँकडाले यसको सम्पूर्ण जीवनकाल समेट्छन्, जबकि खाताका मेट्रिक्स 60 दिनसम्म दैनिक रूपमा आउँछन्।
पुराना पोस्टहरूका लागि get_social_credentials ले तपाईंको आफ्नै कोडलाई खाताको टोकन दिन्छ। प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थप्दै जाँदा घट्दै जान्छ, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
TikTok API ले प्रति भिडियो हेर्ने समय दिन्छ?
हो। total_time_watched र average_time_watched, /business/video/list/ बाट सेकेन्डमा आउँछन्, video.insights स्कोप भएको टोकनका लागि।
API मार्फत TikTok भिडियोको पूरा हेर्ने दर कसरी पाउने?
/business/video/list/ मा fields मा full_video_watched_rate माग्नुहोस्। TikTok ले यसलाई भिडियो पूरा हेर्ने दर्शकको प्रतिशतका रूपमा परिभाषित गर्छ।
मेरो TikTok भिडियोको reach र हेर्ने समय किन खाली छन्?
अन्तिम 7 दिनमा भ्यूज, लाइक, कमेन्ट वा सेयर नभएको भिडियोका लागि TikTok ले यी छोड्न सक्छ, र नयाँ डाटा 24 देखि 48 घण्टा ढिलो हुन्छ।
API ले एउटा खास TikTok भिडियोका मेट्रिक्स फर्काउन सक्छ?
हो। यसको ID filters.video_ids मा दिनुहोस्, साथमा item_id र चाहिएका मेट्रिक्स fields मा।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको