API-এর মাধ্যমে 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 দিন।
watch time, completion, retention, traffic sources ও দর্শক-বিভাজনের জন্য প্রয়োজনীয় স্কোপ; মৌলিক সংখ্যার জন্য 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 অ্যারে যেখানে একাধিক ফিল্ড থাকলে 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 অ্যারে থাকে, প্রতিটি পোস্টের জন্য একটি অবজেক্ট এবং চাওয়া ফিল্ডগুলো নিয়ে, সঙ্গে পেজিংয়ের জন্য 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, ক্যাপশন ও লিংক রিয়েল টাইমে আসে। reach, দেখার সময়, ট্রাফিক উৎস ও audience_countries এমন একটি ভিডিওর জন্য অনুপস্থিত থাকতে পারে যাতে 7 দিন কেউ ভিউ, লাইক, কমেন্ট বা শেয়ার করেনি; TikTok-এর পরামর্শ, ওটির সঙ্গে ইন্টারঅ্যাক্ট করে 24 থেকে 48 ঘণ্টা পর আবার চেষ্টা করা। প্রকাশের 365 দিন পর ডেটা আপডেট হওয়া বন্ধ হয়, এবং লঙ্ঘনের কারণে ফিল্টার হওয়া পোস্ট, যেমন মিউজিক কপিরাইট, ফেরত আসে না।
easyCoexistence কীভাবে একটি ভিডিওর মেট্রিক পড়ে?
get_social_insights দিয়ে: ভিডিওর item_id object_id হিসেবে এবং ফিল্ডের নামগুলো metrics হিসেবে দিন, তখন অ্যাকাউন্টের সাম্প্রতিক 20টি পোস্টের মধ্যে খুঁজে ওই পোস্টের ফিল্ডগুলো ফেরত দেয়। পুরোনো পোস্টের জন্য আপনার নিজের কোড fields ও filters.video_ids প্যারামিটার হিসেবে নিয়ে business/video/list/ কল করে, get_social_credentials থেকে পাওয়া টোকেন দিয়ে।
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 /business/video/list/ থেকে সেকেন্ডে আসে, video.insights স্কোপের টোকেনের জন্য।
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 পর্যবেক্ষণ
যাচাই করা হয়েছে