Μετρικές βίντεο TikTok μέσω του API: προβολές, χρόνος θέασης και ολοκλήρωση
Το API for Business του 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 διαβάζει τις μετρικές ενός βίντεο TikTok με το get_social_insights από το Claude, το ChatGPT ή τον δικό σας κώδικα: ονομάστε τα πεδία που θέλετε, όπως video_views, reach ή full_video_watched_rate, και δώστε το item_id του βίντεο.
Το scope που χρειάζεται για τον χρόνο θέασης, την ολοκλήρωση, τη διατήρηση, τις πηγές επισκεψιμότητας και τις αναλύσεις θεατών. Οι βασικές καταμετρήσεις χρειάζονται το video.list.
Διάστημα αδράνειας μετά το οποίο η εμβέλεια, ο χρόνος θέασης, οι πηγές επισκεψιμότητας και το audience_countries μπορεί να λείπουν από ένα βίντεο.
Οι περισσότερες εγγραφές στις λίστες audience_countries και audience_cities ενός βίντεο.
Συνήθης καθυστέρηση για τα video_views, likes, reach, χρόνο θέασης και πηγές επισκεψιμότητας, σε UTC.
Ποιες μετρικές έχει ένα βίντεο;
Το GET /business/video/list/ επιστρέφει αυτές τις τιμές για κάθε ανάρτηση που ορίζεται στο fields, αθροισμένες σε όλη τη διάρκεια ζωής της ανάρτησης και όχι στο παράθυρο 60 ημερών των μετρικών λογαριασμού. Οι καταμετρήσεις, όπως οι προβολές και τα likes, χρειάζονται το scope video.list στο token, ενώ τα στοιχεία θέασης, ολοκλήρωσης και διατήρησης χρειάζονται το video.insights:
Πώς τις ζητάτε;
Ονομάστε τα στο fields, έναν πίνακα JSON που πρέπει να περιλαμβάνει το item_id όταν έχει περισσότερα από ένα πεδία, και επιλέξτε αναρτήσεις με το filters.video_ids. Χωρίς το φίλτρο, το endpoint σελιδοποιεί τις αναρτήσεις του λογαριασμού, 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.
Ποιες μετρικές εξαρτώνται από τον τύπο λογαριασμού;
Μερικά κλικ και επισκέψεις προφίλ προέρχονται από το Business Analytics του TikTok και απαιτούν κάτι περισσότερο από έναν προσωπικό λογαριασμό. Το 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, η λεζάντα και οι σύνδεσμοι είναι σε πραγματικό χρόνο. Η εμβέλεια, ο χρόνος θέασης, οι πηγές επισκεψιμότητας και το audience_countries μπορεί να λείπουν για βίντεο που κανείς δεν έχει δει, δεν έχει λάβει like, σχόλιο ή κοινοποίηση για 7 ημέρες. Η συμβουλή του TikTok είναι να αλληλεπιδράσετε με αυτό και να δοκιμάσετε ξανά μετά από 24 έως 48 ώρες. Τα δεδομένα σταματούν να ενημερώνονται 365 ημέρες μετά τη δημοσίευση, και οι αναρτήσεις που φιλτράρονται για παραβιάσεις, όπως πνευματικά δικαιώματα μουσικής, δεν επιστρέφονται.
Πώς το easyCoexistence διαβάζει τις μετρικές ενός βίντεο;
Με το get_social_insights: δώστε το item_id του βίντεο ως object_id και τα ονόματα των πεδίων ως metrics. Επιστρέφει τα πεδία της ανάρτησης, αναζητώντας ανάμεσα στις 20 πιο πρόσφατες αναρτήσεις του λογαριασμού. Για παλαιότερη ανάρτηση, ο δικός σας κώδικας καλεί το business/video/list/ με fields και filters.video_ids ως παραμέτρους, με το token από το 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 προειδοποιεί ότι ένα τέτοιο αίτημα μπορεί να αποτύχει.
- Αναμονή εμβέλειας για παλιό, ήσυχο βίντεο. Το TikTok μπορεί να αφήσει κενά την εμβέλεια, τον χρόνο θέασης και τις πηγές επισκεψιμότητας μετά από 7 ημέρες χωρίς προβολές, likes, σχόλια ή κοινοποιήσεις.
- Σύγκριση μετρικών ανάρτησης με ημερήσιες μετρικές λογαριασμού. Τα στοιχεία μιας ανάρτησης καλύπτουν όλη τη διάρκεια ζωής της, ενώ οι μετρικές λογαριασμού έρχονται ανά ημέρα για έως 60 ημέρες.
Για παλαιότερες αναρτήσεις, το get_social_credentials δίνει στον δικό σας κώδικα το token του λογαριασμού. Από US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με πτώση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Το API του TikTok δίνει χρόνο θέασης ανά βίντεο;
Ναι. Τα total_time_watched και average_time_watched έρχονται σε δευτερόλεπτα από το /business/video/list/, για tokens με το scope video.insights.
Πώς παίρνω το ποσοστό ολοκλήρωσης ενός βίντεο TikTok μέσω του API;
Ζητήστε το full_video_watched_rate στο fields του /business/video/list/. Το TikTok το ορίζει ως το ποσοστό των θεατών που ολοκληρώνουν την παρακολούθηση του βίντεο.
Γιατί η εμβέλεια και ο χρόνος θέασης είναι κενά στο βίντεό μου στο TikTok;
Το TikTok μπορεί να τα παραλείψει για βίντεο χωρίς προβολές, likes, σχόλια ή κοινοποιήσεις τις τελευταίες 7 ημέρες, και τα πρόσφατα δεδομένα καθυστερούν 24 έως 48 ώρες.
Μπορεί το API να επιστρέψει μετρικές για ένα συγκεκριμένο βίντεο TikTok;
Ναι. Περάστε το ID του στο filters.video_ids, με το item_id και τις μετρικές που θέλετε στο fields.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις