एपीआयद्वारे TikTok व्हिडिओ मेट्रिक्स: व्ह्यूज, पाहण्याचा वेळ आणि पूर्णता
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 लागतो.
निष्क्रियता, ज्यानंतर एखाद्या व्हिडिओसाठी reach, watch time, traffic sources आणि audience_countries गहाळ असू शकतात.
व्हिडिओच्या audience_countries आणि audience_cities यादीतील बहुतेक नोंदी.
video_views, likes, reach, watch time आणि traffic sources साठी नेहमीचा उशीर, 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: शोध पेज.
- 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 रिअल टाइममध्ये असतात. reach, watch time, traffic sources आणि 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 अपेक्षित करणे. 7 दिवस व्ह्यूज, लाईक्स, कमेंट्स किंवा शेअर्स नसतील तर TikTok reach, watch time आणि traffic sources रिकामे ठेवू शकतो.
- पोस्टच्या मेट्रिक्सची दैनिक खाते मेट्रिक्सशी तुलना करणे. पोस्टचे आकडे तिच्या संपूर्ण आयुष्याचे असतात, तर खात्याचे मेट्रिक्स 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 देखरेख
पडताळले: