Näin löydät TikTok-videoita, joissa mainosyhteistyö on ilmoitettu, ja ohjaat ne tarkistettaviksi

Jos tiimin on tarkistettava, miten sisällöntuottajat ilmoittavat brändiyhteydestään julkisissa TikTok-videoissa, hyödyllinen ensimmäinen tulos ei ole automaattinen tuomio vaan tiivis lista videoista, joissa on kuvaus, linkki ja löydetyt ilmaisut. Alla on toimiva malli: lähetetään hakupyyntö TikTok Scraper API jsonscraperin kautta, muunnetaan vastauksen kaksi mahdollista rakennetta samaan muotoon ja tallennetaan CSV asiantuntijan tarkistettavaksi.

Tavoite: löytää tarkistettavat videot

Yrityksen nimen manuaalista hakua on vaikea toistaa yhdenmukaisesti: tulokset on kerättävä yksi kerrallaan, ja valinnan perusteet jäävät selaimeen. Automatisoidun haun avulla kysely, ajankohta ja löydetyt materiaalit voidaan tallentaa taulukkoon, jotta tiimi voi tarkistaa videot yhdenmukaisen listan avulla.

Tässä käyttötapauksessa ”tarkistettava ehdokas” tarkoittaa vain hakutuloksissa näkyvää videota, jonka kuvauksesta löytyy ennalta määritetty sana tai ilmaus. Tällaisia voivat olla esimerkiksi ”mainos”, ”kumppanuus” tai ”sponsoroitu”. Tekstisuodatin auttaa suuntaamaan ihmisen huomion, mutta se ei arvioi itse videota eikä ratkaise, täyttyvätkö sovellettavat vaatimukset.

Ero on markkinointitiimille tärkeä. Yhdysvaltain liittovaltion kauppakomission ohjeissa materiaalisen brändiyhteyden ilmoittamista käsitellään velvoitteena, joka riippuu viestin asiayhteydestä; videoiden osalta FTC suosittelee huomioimaan ilmoituksen näkyvän ja kuultavan muodon. Kuvauksen haku voi tuoda esiin yksittäisiä tekstisignaaleja, mutta päätös edellyttää julkaisun katsomista ja sen asiayhteyden arviointia. FTC:n sisällöntuottajille tarkoitettu opas selittää näitä ehtoja esimerkkien avulla.

Tulos: CSV, jossa näkyvät valinnan perusteet

Putki kirjaa yhden rivin kutakin yksilöllistä videotunnistetta kohden ja lisää mukaan kuvauksen, linkin, sisällöntuottajan nimen, saatavilla olevat julkiset mittarit sekä osuneet merkit. Lisäksi tallennetaan alkuperäinen hakukysely ja keräysaika. Näin taulukko sopii työjonoon siirrettäväksi, ja myöhemmin voidaan selvittää, miksi tietty video päätyi siihen.

Merkkisanaston määrittelee editoija tai vaatimustenmukaisuudesta vastaava asiantuntija. Aloita kielestä ja termeistä, joita kampanjassasi todella käytetään, tarkista tulokset ja laajenna listaa tarvittaessa. Alla olevan koodin arvot ovat tarkoituksella yksinkertaisia: ne on mukautettava brändiin, markkina-alueeseen ja sisällön kieleen.

Yhdistäminen TikTok Scraper APIin

jsonscraperin dokumentaation mukaan videoiden hakuun käytetään reittiä GET /searchVideo perusosoitteessa https://tiktok.evelode.com. Pakollinen parametri on keyword; valinnaisia parametreja ovat muun muassa count, date_posted, sort_by ja region. Avain välitetään muodossa license_key, joten säilytä se ympäristömuuttujassa, älä koodissa tai CSV-tiedostossa. Parametrien ja reitin tarkat nimet löytyvät TikTokin päätepisteiden dokumentaatiosta; tuotetta ja käyttöoikeuksia koskevat tiedot ovat TikTok Scraper API -tuotesivulla.

Vastauksen yksi olennainen piirre vaikuttaa paikallisen jäsentimen kattavuuteen: tiedot voivat olla joko kohdassa tiktok.aweme_list tai kohdassa tiktok.search_item_list[].aweme_info. Siksi skripti tarkistaa molemmat taulukot. Jos haku palauttaa tyhjän listan, skripti luo tyhjän CSV-tiedoston eikä korvaa tulosten puuttumista keksityillä riveillä.

Python-esimerkki: haku, suodatus ja CSV

Esimerkissä käytetään vain Python 3.8:n ja sitä uudempien versioiden vakiokirjastoa. Aseta ennen suorittamista JSONSCRAPER_TIKTOK_LICENSE_KEY ympäristöön. Pyynnössä käytetään parametria keyword, ja avain välitetään kyselyparametrissa license_key määrittelyn mukaisesti.

import csv
import json
import os
import sys
from datetime import datetime, timezone
from urllib.parse import urlencode
from urllib.request import Request, urlopen

API_KEY = os.environ["JSONSCRAPER_TIKTOK_LICENSE_KEY"]
KEYWORD = "Acme"
MARKERS = ["реклама", "партнерство", "партнёрство", "спонсор", "ad", "sponsored"]

params = {
    "license_key": API_KEY,
    "keyword": KEYWORD,
    "count": 30,
    "sort_by": "date-posted",
    "date_posted": "this-month",
    "region": "US",
}
url = "https://tiktok.evelode.com/searchVideo?" + urlencode(params)
request = Request(url, headers={"Accept": "application/json"})

with urlopen(request, timeout=30) as response:
    payload = json.load(response)

if payload.get("status") != "ok":
    raise RuntimeError("API returned a non-ok outer status")

tiktok = payload.get("tiktok") or {}
items = list(tiktok.get("aweme_list") or [])
for entry in tiktok.get("search_item_list") or []:
    info = entry.get("aweme_info") or {}
    if info:
        items.append(info)

seen = set()
rows = []
collected_at = datetime.now(timezone.utc).isoformat()

for item in items:
    video_id = item.get("aweme_id")
    if not video_id or video_id in seen:
        continue
    seen.add(video_id)

    description = item.get("desc") or ""
    lowered = description.casefold()
    matched = [word for word in MARKERS if word.casefold() in lowered]
    if not matched:
        continue

    author = item.get("author") or {}
    stats = item.get("statistics") or {}
    rows.append({
        "collected_at_utc": collected_at,
        "search_keyword": KEYWORD,
        "video_id": video_id,
        "share_url": item.get("share_url") or "",
        "description": description,
        "matched_markers": "; ".join(matched),
        "author_name": author.get("nickname") or "",
        "author_id": author.get("unique_id") or "",
        "play_count": stats.get("play_count", ""),
        "digg_count": stats.get("digg_count", ""),
        "comment_count": stats.get("comment_count", ""),
        "share_count": stats.get("share_count", ""),
    })

fields = [
    "collected_at_utc", "search_keyword", "video_id", "share_url",
    "description", "matched_markers", "author_name", "author_id",
    "play_count", "digg_count", "comment_count", "share_count",
]
with open("tiktok_review_queue.csv", "w", newline="", encoding="utf-8-sig") as output:
    writer = csv.DictWriter(output, fieldnames=fields)
    writer.writeheader()
    writer.writerows(rows)

print(f"Saved {len(rows)} review candidates to tiktok_review_queue.csv")

Skripti tarkistaa ensin ulkoisen tilan, lukee sitten tiktok-olion ja yhdistää saatavilla olevat taulukkorakenteet. aweme_id-tunnisteeseen perustuva kaksoiskappaleiden poisto estää saman videon kirjaamisen kahdesti, jos se esiintyy vastauksen molemmissa rakenteissa. Mittarit tallennetaan sellaisinaan; puuttuva arvo jätetään tyhjäksi eikä muuteta nollaksi.

Esimerkissä käytetään /searchVideo-reitin dokumentoituja parametreja: date_posted-parametrin arvo voi olla this-month, sort_by-parametrin date-posted, ja region hyväksyy maakoodin. count-arvo määrittää pyydettävien tulosten määrän, mutta ei takaa täydellistä julkaisuluetteloa. Jos jatkat sivutusta, tallenna palautettu kohdistin läpinäkymättömänä arvona ja välitä se cursor-parametrissa.

Ihmisen tekemä tarkistus ja ajastettu automaatio

Toimita CSV tarkistuksesta vastaavalle henkilölle ja liitä mukaan lyhyt ohje: avaa linkki, katso video ja kuvauksen asiayhteys, kirjaa tulos ja lisää kommentti, jos merkki esiintyy toisessa merkityksessä. Automaattinen suodatus ei esimerkiksi erota mainosilmoitusta mainontaa käsittelevästä keskustelusta. Ihmisen tekemä tarkistus kuroo umpeen tämän merkityseron.

Toistettavaa keruuta varten aja skripti ajastetusti cronilla, CI-ajastimella tai tehtävien orkestroijalla. Tallenna CSV ajopäivämäärällä tai vie rivit taulukkoon, jossa yksilöllinen avain muodostuu videotunnisteesta ja havaintopäivästä. Jos tarvitset auditointilokia, säilytä myös alkuperäinen JSON-vastaus käyttöoikeuksien hallinta huomioiden: sen avulla muunnoksen voi tarkistaa uudelleen ja selvittää kunkin rivin alkuperän.

Tuotantoversioon kannattaa lisätä verkko- ja HTTP-virheiden käsittely, uudelleenyritysten rajoitus sekä ilmoitus epäonnistumisesta. Älä tulosta pyynnön koko URL-osoitetta, sillä se sisältää käyttöavaimen. Jos tiimissä on useita käyttäjiä, salaisuus kannattaa säilyttää suoritusympäristön salaisuuksien hallintapalvelussa ja rajata tulostiedostojen käyttö sisäisten sääntöjen mukaisesti.

Mitä tällaisesta listasta saa irti

Ajettuaan putken tiimillä on toistettavissa oleva otos avainsanalla löydetyistä videoista sekä selkeä peruste kunkin ehdokkaan lisäämiselle tarkistusjonoon. Taulukosta voi poistaa käsin asiaankuulumattomat osumat, nimetä tarkistajan ja ryhmitellä tuloksia merkin tai sisällöntuottajan mukaan. Jos haku toistetaan säännöllisesti, mukaan kertyy historiaa siitä, mitkä videot olivat mukana palautetussa tulosjoukossa tiettynä päivänä.

Tämä lähestymistapa sopii materiaalien alustavaan löytämiseen ja ohjaamiseen, ei sääntöjen noudattamista koskevaan automaattiseen päätökseen. Sitä rajoittavat hakutulokset, valittu avainsana, kyselyn asetukset ja tekstimerkit. Jos haluat tarkistaa tietyn yhteistyön, vertaa videota briiffiin ja tiimisi käytettävissä oleviin tietoihin ja arvioi sitten itse viesti sovellettavien sääntöjen perusteella.

Aloita tarkistamalla ajantasaiset käyttöoikeudet ja parametrit TikTok Scraper API -tuotesivulta. Tarkista vastausrakenne ja integraatiovaihtoehdot API:n virallisesta dokumentaatiosta.