Näin tarkistat TikTokin mainosilmoitukset julkisista videoista

Voit poimia julkisia TikTok-videoita, joissa mainitaan brändi ja käytetään selviä mainosilmauksia, kokoamalla tuloksia useilla hakulausekkeilla, poimimalla kuvatekstit ja merkitsemällä avainsanat. Tuloksena on CSV-tiedosto, jossa on linkkejä ja saatavilla olevia mittareita – siis ihmisen tarkistusta odottava jono, ei automaattinen päätelmä sääntöjen noudattamisesta.

Tällainen prosessi sopii esimerkiksi toimistolle, joka vertaa kampanjaa toimeksiantoon, tai sisäiselle tiimille, joka ylläpitää luetteloa julkisista brändimaininnoista. Se auttaa jäsentämään hakutuloksia ja säilyttää ne merkit, joiden perusteella analyytikko päättää, minkä videon avaa ja tarkistaa.

Mitä videoista pitäisi etsiä?

Mainonnan tarkistuksessa olennaista on tekijän yhteys brändiin ja se, miten yhteys tuodaan esiin suosituksen yhteydessä. FTC:n vaikuttajaopas selittää, että olennainen yhteys voi olla taloudellinen, työperäinen, henkilökohtainen tai perhesuhde ja että ilmoituksen on oltava helposti havaittava ja ymmärrettävä. Videolla esitettävän suosituksen yhteydessä FTC:n mukaan ilmoitus pitää sijoittaa itse videoon, ei pelkästään kuvaukseen. Kuvateksti on siis hyödyllinen lajittelussa, mutta se ei yksin kerro, mitä katsoja näki videolla tai kuuli äänessä.

Tämän skriptin tavoite on rajatumpi: etsiä palautetuista hakutuloksista videoita, joiden kuvatekstit sisältävät brändiin liittyviä ilmauksia ja mahdollisia merkintöjä, kuten ”mainos”, ”sponsori” tai ”yhteistyö”. Sanasto kannattaa mukauttaa kampanjan kieleen ja terminologiaan. Jos kuvatekstistä ei löydy merkintää, avaa video ja tarkista sen sisältö: tekstiosuma ei osoita, onko itse videossa ilmoitus.

Miten hakutuloksista muodostetaan tarkistusjono?

Laadi lyhyt luettelo hakulausekkeista: brändin nimi, kampanjan nimi ja tuotteen yleinen kirjoitusasu. Suorita haut erikseen ja tallenna hakulausekkeet tulosten yhteyteen. Näin tiimi näkee, millä haulla video löytyi, ja voi toistaa haun tarvittaessa.

Tiedon keräämiseen sopii jsonscraperin TikTok Scraper API. Dokumentoitu GET-reitti /searchVideo sijaitsee osoitteessa https://tiktok.evelode.com ja hyväksyy parametrit keyword, count, date_posted, sort_by, region ja cursor. Havaitussa vastauksessa TikTok-tiedot sisälsivät videoita kohdassa search_item_list[].aweme_info; aweme_list saattoi olla tyhjä. Alla oleva jäsennin tarkistaa molemmat sijainnit.

Avain välitetään parametrissa license_key. Tallenna se ympäristömuuttujaan, älä skriptiin tai koodivarastoon. TikTok-reittien dokumentaatio sisältää hakuparametrien nimet; seuraavalle sivulle siirryttäessä käytä palautettua cursor-arvoa. Tallenna käsiteltyjen kohteiden määrä ja itse hakulauseke: sivutus auttaa jatkamaan tulosten hakua, mutta ei yksin takaa aineiston kattavuutta.

Yksinkertainen Python-esimerkki

Skripti tekee yhden pyynnön kutakin hakulauseketta kohti, kokoaa tuloksen molemmat dokumentoidut muodot, poistaa videoiden ID-tunnisteiden perusteella kaksoiskappaleet, merkitsee kuvatekstin sanat ja kirjoittaa CSV-tiedoston. Asenna requests-paketti komennolla python -m pip install requests, määritä JSONSCRAPER_TIKTOK_LICENSE_KEY ympäristömuuttujaan ja suorita tiedosto. Esimerkki toimii Python 3.8:ssa ja sitä uudemmissa versioissa.

import csv
import os
import sys
import requests

BASE_URL = "https://tiktok.evelode.com/searchVideo"
KEY = os.environ.get("JSONSCRAPER_TIKTOK_LICENSE_KEY")
if not KEY:
    raise SystemExit("Set JSONSCRAPER_TIKTOK_LICENSE_KEY first")

QUERIES = ["Example Brand", "Example Product", "Example Campaign"]
MARKERS = ("#реклама", "реклама", "спонсор", "партнерство", "партнёрство", "#ad", "sponsored")


def videos_from(payload):
    data = payload.get("tiktok") or {}
    videos = data.get("aweme_list") or []
    if not videos:
        videos = [
            item.get("aweme_info")
            for item in (data.get("search_item_list") or [])
            if isinstance(item, dict) and isinstance(item.get("aweme_info"), dict)
        ]
    return [video for video in videos if isinstance(video, dict)]


rows = {}
for query in QUERIES:
    response = requests.get(
        BASE_URL,
        params={"keyword": query, "count": 20, "date_posted": "this-month", "license_key": KEY},
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()
    if payload.get("status") != "ok":
        print("Unexpected API status for query:", query, file=sys.stderr)
        continue

    for video in videos_from(payload):
        video_id = video.get("aweme_id")
        if not video_id:
            continue
        author = video.get("author") or {}
        stats = video.get("statistics") or {}
        caption = video.get("desc") or ""
        matched = [word for word in MARKERS if word in caption.casefold()]
        row = rows.setdefault(str(video_id), {
            "video_id": str(video_id),
            "url": video.get("share_url") or "",
            "author": author.get("unique_id") or author.get("nickname") or "",
            "caption": caption,
            "queries": set(),
            "disclosure_markers": set(),
            "play_count": stats.get("play_count"),
            "digg_count": stats.get("digg_count"),
            "comment_count": stats.get("comment_count"),
            "review_status": "manual_review",
        })
        row["queries"].add(query)
        row["disclosure_markers"].update(matched)

with open("tiktok_disclosure_review.csv", "w", newline="", encoding="utf-8-sig") as file:
    fields = ["video_id", "url", "author", "caption", "queries", "disclosure_markers",
              "play_count", "digg_count", "comment_count", "review_status"]
    writer = csv.DictWriter(file, fieldnames=fields)
    writer.writeheader()
    for row in rows.values():
        row["queries"] = " | ".join(sorted(row["queries"]))
        row["disclosure_markers"] = " | ".join(sorted(row["disclosure_markers"]))
        writer.writerow(row)

print("Saved", len(rows), "unique returned videos")

Tarkista ulkoisen vastauksen tila ja sen jälkeen tiktok-kentän tiedot ennen tallennusta. Normalisointitoiminto lukee videot kummastakin sijainnista. Seuraavalle sivulle voi välittää palautetun cursor-arvon sellaisenaan; tämä yksinkertainen esimerkki rajoittuu tarkoituksella yhteen sivuun hakua kohti.

Mitä CSV-tiedosto näyttää?

Jokaisella rivillä on video-ID ja linkki, saatavilla oleva tekijätunniste, kuvateksti, hakulausekkeet sekä osuneet merkinnät. Jos vastauksessa on katselu-, tykkäys- ja kommenttimäärät, ne tallennetaan tarkistusjärjestyksen valintaa tukevaksi taustatiedoksi. Nämä kentät voivat puuttua; skripti jättää ne tyhjiksi sen sijaan, että asettaisi nollan.

Avaa sen jälkeen video, tarkista, onko ilmoitus itse videossa ja erottuuko se selvästi, ja kirjaa tulos sovittujen luokkien avulla, esimerkiksi ”löytyi”, ”vaatii lisätarkistusta” tai ”ei havaittu katselussa”. Koodi etsii vain kuvatekstistä täsmällisiä tekstimerkintöjä; se ei tarkastele kuvaa tai ääntä eikä ratkaise sääntöjenmukaisuutta.

Jos prosessi toistuu säännöllisesti, suorita keruu aikataulutetusti, kirjaa kyselyn ajankohta ja säilytä alkuperäinen JSON CSV-tiedoston kanssa. Rajaa hakulausekkeet tarpeellisiin ja määritä kerättyjen tietojen säilytysaika. jsonscraperin vastuullisen tiedonkeruun käytännössä käsitellään kohtuullista pyyntötiheyttä, tietojen minimointia ja tekoälyn tulosten tarkistamista ennen jatkotoimia.

Tuloksena on toistettava jono julkisista videoista, joiden mainosilmoitukset tarkistetaan manuaalisesti: hakutulokset ja saatavilla olevat mittarit auttavat päättämään, mitkä videot avataan ensin, mutta itse videon arvioi tarkistaja. Parametrien nimet voi tarkistaa TikTok API:n dokumentaatiosta, ja tuotetiedot TikTok Scraper API -sivulta.