Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

TikTok-videon mittarit API:n kautta: katselut, katseluaika ja katsomisaste

TikTokin API for Business palauttaa kunkin julkaisun elinaikaiset mittarit päätepisteestä GET /business/video/list/, kun ne pyydetään nimeltä parametrissa fields: video_views, reach, likes, comments, shares ja favorites, total_time_watched ja average_time_watched sekunteina, full_video_watched_rate, video_view_retention, impression_sources sekä katsojajakaumat, kuten audience_countries. Useimmat luvut tulevat 24–48 tuntia myöhässä, ja ne lakkaavat päivittymästä 365 päivän kuluttua julkaisusta.

easyCoexistence lukee TikTok-videon mittarit get_social_insights-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi: nimeä haluamasi kentät, kuten video_views, reach tai full_video_watched_rate, ja anna videon item_id.

video.insights

Katseluaika, katsomisaste, pysyvyys, liikennelähteet ja katsojajakaumat vaativat video.insights-oikeuden; perusluvut video.list-oikeuden.

7 days

Käyttöpoissaolo, jonka jälkeen tavoittavuus, katseluaika, liikennelähteet ja audience_countries voivat puuttua videolta.

10

Useimmat merkinnät videon audience_countries- ja audience_cities-listoissa.

24 to 48 h

Tavallinen viive video_views-, likes- ja reach-luvuille sekä katseluajalle ja liikennelähteille, UTC-ajassa.

Mitä mittareita videolla on?

GET /business/video/list/ palauttaa kullekin kentässä fields nimetylle julkaisulle nämä koko julkaisun elinajan kattavina lukuina, toisin kuin tilin mittarit, jotka kattavat 60 päivän ikkunan. Luvut, kuten katselut ja tykkäykset, vaativat tokenille video.list-oikeuden, kun taas katseluaika, katsomisaste ja pysyvyys vaativat video.insights-oikeuden:

video_viewsViews, counted on the first playback in an impression session
reachPeople who watched the post at least once
likes, comments, sharesLifetime totals; shares include sends to friends inside TikTok
favoritesTimes the post was added to favorites
total_time_watchedSeconds viewers spent watching, in total
average_time_watchedAverage seconds viewers spent watching
full_video_watched_rateShare of viewers who finished the video
video_view_retentionShare of viewers still watching at each second
impression_sourcesWhere viewers found the post, by share
new_followersViewers who started following the account
engagement_likesShare of viewers who liked at each second
video_durationLength of the video in seconds

Miten mittarit pyydetään?

Nimeä ne kentässä fields, JSON-taulukossa, joka sisältää item_id:n aina, kun kenttiä on useampi kuin yksi. Julkaisut valitaan suodattimella filters.video_ids. Ilman suodatinta päätepiste selaa tilin julkaisuja läpi, enintään 20 kerrallaan:

Metrics for one video
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>"]}'

Miltä vastaus näyttää?

Vastauksessa on videos-taulukko, jossa on yksi objekti kullekin julkaisulle pyydetyillä kentillä, sekä cursor ja has_more sivutusta varten. TikTokin oma esimerkki lyhennettynä näyttää yksiköt: katseluajat sekunteina kolmen desimaalin tarkkuudella ja full_video_watched_rate desimaalilukuna, tässä 0.0237:

A video's metrics, from TikTok's example
{
  "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
  }
}

Mitä liikennelähteet tarkoittavat?

impression_sources järjestää paikat, joista katsojat löysivät julkaisun, suurimmasta osuudesta pienimpään. Jokainen merkintä on impression_source-objekti prosenttiosuuksineen. TikTok dokumentoi nämä arvot:

  • For You: For You -syöte.
  • Follow: Follow-syöte.
  • Sound: äänisivut.
  • Personal Profile: profiilisivut.
  • Search: hakusivut.
  • Direct Message: suorat viestit, kun TikTok Studio näyttää nämä tiedot tilille.
  • Others: kaikki muu.

Mitkä katsojajakaumat on saatavilla?

Niitä on neljä. Kaikki kuvaavat julkaisun katsoneita ihmisiä eivätkä tilin seuraajia, ja kaikki vaativat video.insights-oikeuden:

  • audience_genders: katsojien osuudet sukupuolittain, Female, Male tai Other.
  • audience_countries: enintään 10 maata tai aluetta ISO 3166-1 alpha-2 -koodeina.
  • audience_cities: enintään 10 kaupunkia muodossa US Cincinnati.
  • audience_types: NEW_VIEWER ja RETURN_VIEWER sekä FOLLOWER_PERCENT ja NON_FOLLOWER_PERCENT vastakkain.

Mitkä mittarit riippuvat tilityypistä?

Muutama klikkaus ja profiilikäynti tulee TikTokin Business Analyticsista, ja ne vaativat muun kuin henkilökohtaisen tilin. profile_views, julkaisun aiheuttamat profiilikäynnit, vaatii tilin, jolla on Advanced Access, tai vahvistetun yritystilin. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks ja address_clicks vaativat vahvistetun yritystilin.

Miksi mittari voi puuttua tai myöhästyä?

Koska TikTok laskee suurimman osan niistä jälkikäteen ja vain TikTok Analyticsin tiedoista. Luvut ja katseluun liittyvät mittarit jäävät yleensä 24–48 tuntia myöhässä, kun taas item_id, caption ja linkit ovat reaaliaikaisia. Tavoittavuus, katseluaika, liikennelähteet ja audience_countries voivat puuttua videolta, jota kukaan ei ole katsonut, tykännyt, kommentoinut tai jakanut 7 päivään. TikTokin vinkki on olla vuorovaikutuksessa videon kanssa ja yrittää uudelleen 24–48 tunnin kuluttua. Tiedot lakkaavat päivittymästä 365 päivän kuluttua julkaisusta, eikä rikkomusten, kuten musiikin tekijänoikeusrikkomusten, takia suodatettuja julkaisuja palauteta.

Miten easyCoexistence lukee videon mittarit?

get_social_insights-työkalulla annat videon item_id:n object_id-arvona ja kenttien nimet metrics-arvoina, jolloin se palauttaa julkaisun kentät ja etsii niitä tilin 20 uusimman julkaisun joukosta. Vanhemmalle julkaisulle oma koodisi kutsuu business/video/list/-päätepistettä parametreina fields ja filters.video_ids käyttäen tokenia, jonka saat get_social_credentials-työkalulla.

One video's metrics through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<ITEM_ID>",
  "metrics": ["video_views", "reach", "average_time_watched", "full_video_watched_rate", "impression_sources"]
}

Yleiset virheet

  • Oletetaan yksi asteikko kaikille prosenteille. TikTokin esimerkeissä impression_sources on murtolukuina, jotka summautuvat 1:een, kun taas audience_cities-esimerkissä on arvoja kuten 17.4921.
  • Pyydetään useita kenttiä ilman item_id:tä. TikTokin viite varoittaa, että tällainen pyyntö voi epäonnistua.
  • Odotetaan tavoittavuutta vanhalle, hiljaiselle videolle. TikTok voi jättää tavoittavuuden, katseluajan ja liikennelähteet tyhjiksi 7 päivän jälkeen ilman katselukertoja, tykkäyksiä, kommentteja tai jakoja.
  • Verrataan julkaisun mittareita tilin päivittäisiin mittareihin. Julkaisun luvut kattavat koko sen elinajan, kun taas tilin mittarit tulevat päivittäin enintään 60 päivältä.
Näin teet tämän EasyCoexistencen avulla

Vanhempia julkaisuja varten get_social_credentials antaa omalle koodillesi tilin tokenin. Hinta alkaen US$ 9 per yhteys kuukaudessa ja laskee US$ 0,75:een yhteyksien lisääntyessä. Ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Antaako TikTok API katseluajan videokohtaisesti?

Kyllä. total_time_watched ja average_time_watched tulevat sekunteina päätepisteestä /business/video/list/ tokeneille, joilla on video.insights-oikeus.

Miten saan TikTok-videon katsomisasteen API:n kautta?

Pyydä full_video_watched_rate kentässä fields päätepisteessä /business/video/list/. TikTok määrittelee sen prosenttiosuutena katsojista, jotka katsovat videon loppuun.

Miksi tavoittavuus ja katseluaika ovat tyhjiä TikTok-videollani?

TikTok voi jättää ne pois videolta, jolla ei ole katselukertoja, tykkäyksiä, kommentteja tai jakoja viimeisen 7 päivän aikana, ja tuoreet tiedot viivästyvät 24–48 tuntia.

Voiko API palauttaa mittarit yhdelle tietylle TikTok-videolle?

Kyllä. Anna sen tunnus filters.video_ids-kentässä sekä item_id ja haluamasi mittarit kentässä fields.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu