API ద్వారా TikTok వీడియో మెట్రిక్స్: వ్యూస్, వాచ్ టైమ్ మరియు పూర్తి వీక్షణ
TikTok వ్యాపార API ప్రతి పోస్ట్ జీవితకాల మెట్రిక్స్ను 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 వీడియో మెట్రిక్స్ చదువుతుంది: మీకు కావాల్సిన fields పేర్లు ఇవ్వండి, ఉదాహరణకు video_views, reach లేదా full_video_watched_rate, మరియు వీడియో item_id ఇవ్వండి.
వాచ్ టైమ్, కంప్లీషన్, రిటెన్షన్, ట్రాఫిక్ మూలాలు మరియు వీక్షకుల విభజనలకు అవసరమైన స్కోప్; ప్రాథమిక కౌంట్లకు video.list కావాలి.
ఒక వీడియోకు రీచ్, వాచ్ టైమ్, ట్రాఫిక్ మూలాలు మరియు audience_countries కనిపించకుండా పోయేలా చేసే నిష్క్రియత కాలం.
video_views, likes, reach, వాచ్ టైమ్ మరియు ట్రాఫిక్ మూలాలకు సాధారణ ఆలస్యం, UTC లో.
ఒక వీడియో యొక్క audience_countries మరియు audience_cities జాబితాల్లో ఎక్కువ ఎంట్రీలు.
ఒక వీడియోకు ఏ మెట్రిక్స్ ఉంటాయి?
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>"]}'ప్రతిస్పందన ఎలా ఉంటుంది?
ప్రతి పోస్ట్కు ఒక ఆబ్జెక్ట్ మరియు అడిగిన fields తో 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 వ్యాపార విశ్లేషణ నుండి వస్తాయి, వ్యక్తిగత ఖాతా కంటే ఎక్కువ అవసరం. పోస్ట్ తీసుకువచ్చిన ప్రొఫైల్ సందర్శనలైన profile_views కు Advanced Access ఉన్న ఖాతా లేదా ధృవీకరించబడిన వ్యాపార ఖాతా కావాలి. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks మరియు address_clicks కు ధృవీకరించబడిన వ్యాపార ఖాతా కావాలి.
ఒక మెట్రిక్ ఎందుకు కనిపించకపోవచ్చు లేదా ఆలస్యం కావచ్చు?
ఎందుకంటే TikTok చాలా మెట్రిక్స్ను ఆఫ్లైన్లో, TikTok Analytics నుండి మాత్రమే లెక్కిస్తుంది. కౌంట్లు మరియు వాచ్ మెట్రిక్స్ సాధారణంగా 24 నుండి 48 గంటలు వెనుకబడి ఉంటాయి, item_id, క్యాప్షన్ మరియు లింక్లు మాత్రం రియల్ టైమ్లో ఉంటాయి. ఎవరూ 7 రోజులుగా చూడని, లైక్ చేయని, కామెంట్ చేయని లేదా షేర్ చేయని వీడియోకు రీచ్, వాచ్ టైమ్, ట్రాఫిక్ మూలాలు మరియు audience_countries కనిపించకపోవచ్చు; 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 లేకుండా అనేక fields అడగడం. TikTok రిఫరెన్స్ అలాంటి అభ్యర్థన విఫలం కావచ్చని హెచ్చరిస్తుంది.
- పాత, నిశ్శబ్ద వీడియోకు రీచ్ ఆశించడం. 7 రోజులు వ్యూస్, లైక్లు, కామెంట్లు లేదా షేర్లు లేకపోతే TikTok రీచ్, వాచ్ టైమ్ మరియు ట్రాఫిక్ మూలాలను ఖాళీగా వదిలేయవచ్చు.
- పోస్ట్ మెట్రిక్స్ను రోజువారీ ఖాతా మెట్రిక్స్తో పోల్చడం. పోస్ట్ గణాంకాలు దాని మొత్తం జీవితకాలాన్ని కవర్ చేస్తాయి, అయితే ఖాతా మెట్రిక్స్ 60 రోజుల వరకు రోజువారీగా వస్తాయి.
పాత పోస్ట్ల కోసం, get_social_credentials మీ స్వంత కోడ్కు ఖాతా టోకెన్ను ఇస్తుంది. కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించే కొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
TikTok API ప్రతి వీడియోకు వాచ్ టైమ్ ఇస్తుందా?
అవును. total_time_watched మరియు average_time_watched, video.insights స్కోప్ ఉన్న టోకెన్ల కోసం /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 పర్యవేక్షణ
ధృవీకరించిన తేదీ