taskType ADS mit einer von zwei Plattformen, und action wählt, was gelesen wird. Zur Auswahl zwischen den Werbebibliotheken siehe Werbebibliotheken im Vergleich.
tiktok_ad_libraryliest die TikTok-Werbebibliothek (die Commercial Content Library). Sie listet die Anzeigen auf, die in 34 Regionen ausgespielt wurden: den EU- und EWR-Ländern, dem Vereinigten Königreich, der Schweiz, Türkiye und Brasilien. Jede Anzeige enthält ihren ersten und letzten Ausspielungstag und eine Impressionen-Spanne, undadergänzt die Zielseite, den Zahler, das Targeting und die Impressionen nach Land, Alter und Geschlecht. Nutzen Sie sie, um alle Anzeigen eines Wettbewerbers zu sehen.tiktok_creative_centerliest die Top-Anzeigen des TikTok Creative Center. Es listet die Anzeigen auf, die in einem Land in den letzten 7, 30 oder 180 Tagen am besten abgeschnitten haben, mit Klickrate, Likes und Branche, für 28 Länder, darunter die USA, Korea und Japan. Nutzen Sie es, um zu sehen, welche Creatives in einem Markt funktionieren.
advertisers und ad kosten je 0.5 Credits.
TikTok-Werbebibliothek
Anfrage
GET /v1/async/task/{id} ab oder empfangen Sie den Webhook. Siehe Asynchrone Tasks. Eine Suche nach 300 Anzeigen dauert etwa eine Minute.
Anzeigen eines Wettbewerbers analysieren
Drei Anfragen decken eine Wettbewerbsanalyse ab:advertisersmit dem Anfang des Namens des Wettbewerbers liefert die genauen Namen und IDs, die die Bibliothek kennt.searchmit diesem Namen inadvertiserNamelistet die Anzeigen des Werbetreibenden auf.sortByordnet sie nach Veröffentlichungsdatum, Datum der letzten Ausspielung oder Impressionen,activeStatusbehält die laufenden oder die beendeten Anzeigen, undsummaryzählt die Formate und die Anzeigen, die in jeder Woche gestartet sind.admit derlibraryIdeiner Anzeige liefert die Zielseite, wer bezahlt hat, das Targeting, die Zielgruppengröße und die Impressionen nach Land, Alter und Geschlecht.
query statt advertiserName: Es durchsucht den Text, die Hashtags und die Namen der Werbetreibenden.
Parameter
action:search(Standard),advertisersoderad.country: Bei jeder Aktion erforderlich. Eines vonAT,BE,BG,BR,CH,CY,CZ,DE,DK,EE,ES,FI,FR,GB,GR,HR,HU,IE,IS,IT,LI,LT,LU,LV,MT,NL,NO,PL,PT,RO,SE,SI,SKundTR.ALLund Länder außerhalb der Liste, etwaUS,KRundJP, werden mit400 VALIDATION_ERRORabgelehnt, weil die Bibliothek nur diese Regionen abdeckt.query: Ein Stichwort. Beisearchpasst es nach Relevanz auf Text, Hashtags und Werbetreibende, und die Bibliothek zählt höchstens 5,000 Anzeigen. Beiadvertisersist es der Anfang des Namens eines Werbetreibenden und erforderlich.searchbrauchtqueryoderadvertiserName, aber nicht beides.advertiserName: Der genaue Name eines Werbetreibenden, etwaNIKE Retail B.V.. Die Bibliothek zählt alle seine Anzeigen.libraryId: Die numerische ID einer Anzeige, etwa1879578148398450.adverlangt sie.activeStatus:all(Standard),activeoderinactive.mediaType:all(Standard),videooderimage.startDate,endDate:YYYY-MM-DD. Behält die Anzeigen, die zwischen den beiden Tagen ausgespielt wurden. Standard sind die letzten 365 Tage.sortBy:published_desc(Standard),published_asc,last_shown_desc,last_shown_asc,impressions_descoderimpressions_asc. Es gilt für eine Suche mitadvertiserName, und eine Suche mitqueryfolgt immer der Relevanz.limit: 1 bis 300 Anzeigen. Standard 30.cursor: DernextCursoreiner früheren Antwort, um die darauffolgenden Anzeigen zu lesen.
search liest alle Felder oben außer libraryId. advertisers liest query und country, und ad liest libraryId und country. Ein Wert, den die Bibliothek nicht durchsuchen kann, oder ein Feld, das die Aktion nicht liest, wird mit 400 VALIDATION_ERROR abgelehnt, und details nennt das Feld.
Weitere Anzeigen lesen
Eine Antwort mit weiteren zu lesenden Anzeigen enthältnextCursor. Senden Sie ihn mit derselben Suche als cursor, um die nächsten Anzeigen zu erhalten, wieder bis zu limit. nextCursor ist null, sobald die Bibliothek keine weiteren hat. Ein Cursor funktioniert nur mit der Suche, die ihn geliefert hat: Eine andere query, advertiserName, country, activeStatus, mediaType, ein anderer Datumsbereich oder sortBy wird mit 400 VALIDATION_ERROR abgelehnt, während sich limit ändern darf. Bei einer query-Suche, die die Bibliothek nach Relevanz ordnet, können einige Anzeigen an der Grenze zweier Seiten doppelt vorkommen oder fehlen; libraryId unterscheidet die Duplikate.
Werbetreibenden finden
action advertisers liefert bis zu 20 Werbetreibende, deren Namen mit query beginnen. Senden Sie den genauen Namen als advertiserName, um die Anzeigen dieses Werbetreibenden zu suchen.
advertiserId und advertiserName. country, adCount und verified sind null, weil die Vorschläge der Bibliothek nicht mehr liefern. Eine Werbetreibenden-Suche kostet 0.5 Credits.
Such-Antwort
- Die Antwort gibt
platform,action,country,queryoderadvertiserName,activeStatus,mediaTypeundsortByzurück.totalCountist die Zählung der Bibliothek für die passenden Anzeigen, die bei einerquery-Suche bei 5,000 endet.returnedCountzählt die Anzeigen inads,hasMoreisttrue, wenn die Bibliothek mehr hat, dienextCursorliest, undlibraryUrlöffnet dieselbe Suche in der Werbebibliothek. - Jede Anzeige hat
position,libraryId,libraryUrl,advertiserName,title,format(VIDEO,IMAGEoderTEXT),images,videos(url,previewUrl),startDate,endDate,activeDays,impressions(min,max),estimatedAudience(die Spanne der Bibliothek, etwa400K-500K) undplatforms(TIKTOK). startDateundendDatesind der erste und der letzte Tag, an dem die Bibliothek die Anzeige zeigt (Tage in UTC).activeDayszählt die Tage vonstartDatebisendDate, beide mitgezählt. Die Bibliothek liefert keine Ausgaben.isActiveisttrueoderfalse, wennactiveStatusactiveoderinactiveist, undnull, wenn esallist.advertiserId,payer,linkUrl,landingDomain,utmundtargetingsind in einer Suchenull.adfüllt sie.summaryzählt die Anzeigen dieser Antwort:ads,activeAds,advertisers(die 10 mit den meisten Anzeigen),formats,platforms,oldestStartDate,newestStartDateundmedianActiveDays, mitlaunchesByWeek(die Anzeigen, die in jeder ISO-Woche starteten) undlongestRunning(die 5 Anzeigen mit den meistenactiveDays). Es enthält wederlandingDomainsnochutmCampaigns, weil eine Suche keine Zielseiten enthält.- Bild- und Video-URLs sind signiert und laufen etwa 5 bis 6 Stunden nach dem Lesen ab. Speichern Sie die Dateien, die Sie brauchen.
- Eine Suche ohne passende Anzeigen endet mit leerem
adsund einersummarymit0Anzeigen.
Was die Bibliothek aufbewahrt
Die Bibliothek zeigt in ihren 34 Regionen ausgespielte Anzeigen und bewahrt sie etwa 13 Monate auf. Sie liefert zu jeder Anzeige den ersten und letzten Ausspielungstag und eine Impressionen-Spanne. Ausgaben veröffentlicht sie nicht.Eine Anzeige öffnen
action ad öffnet die Anzeige mit der libraryId und dem country, die Sie senden.
adenthält die Felder einer Suchanzeige sowielinkUrl,landingDomain,payer(wer die Anzeige bezahlt hat),category,objective,ctaText,advertiserId,reachedCountriesundtargeting.targetingenthältbyCountry(dieagesundgendersjedes Landes),provinces,cities,languages,interests,targetAudienceSize(die Spanne der Bibliothek, etwa15.5M-18.9M),customAudience,excludesAudience,highSpendingPower,operatingSystems,deviceModels,videoInteractionsundcreatorInteractions. Ein Teil, den die Bibliothek für die Anzeige nicht veröffentlicht, istnulloder leer.advertiserenthältadvertiserId,advertiserName,payer,registryCountryund das TikTok-accounthinter den Anzeigen (username,displayName,verified,followers,accountType,profileUrl,avatarUrl).transparencyenthälttotalImpressionsundbyCountry: dieimpressionsjedes Landes und ihrebreakdownsnachageundgender.- Eine
libraryId, zu der die Bibliothek keine Anzeige hat, schlägt mitPAGE_UNAVAILABLEfehl.
TikTok Creative Center
Das Creative Center listet die leistungsstärksten Anzeigen eines Landes auf, die Anzeigen, die TikTok für die letzten 7, 30 oder 180 Tage auswählt. Es ist eine gereihte Stichprobe, nicht die vollständige Anzeigenmenge eines Werbetreibenden: Der Name des Werbetreibenden ist oft leer, und die Bibliothek liefert weder Daten noch Ausgaben noch Impressionen. Sie liefert Klickrate, Likes, Kostenniveau, Branche und Ziele jeder Anzeige. Nutzen Sie es, um herauszufinden, welche Hooks, Formate und Produkte in einem Markt funktionieren.Anfrage
Parameter
action:search(Standard) oderad.advertiserswird mit400 VALIDATION_ERRORabgelehnt, weil das Creative Center keine Suche nach Werbetreibenden bietet.country: Beisearcherforderlich. Eines vonAE,AR,AU,BR,CA,CO,DE,ES,FR,GB,ID,IT,JP,KR,MX,MY,NL,PH,PK,RO,SA,SE,SG,TH,TR,US,VNundZA.ALLwird abgelehnt.query: Ein Stichwort.period:7,30(Standard) oder180Tage.industry: Eine Branchen-ID, etwa21103000000(Hardware & Electrical), wie sie dieindustry.ideiner Anzeige nennt.objective:traffic,app_installs,conversions,video_views,reach,lead_generation,product_salesoderapp_promotion.adLanguage: Ein Sprachcode:en,es,ar,vi,th,de,id,pt,fr,ms,nl,ja,it,ro,zh-Hantoderko.adFormat:spark(Anzeigen, die den Beitrag eines Creators bewerben) odernon_spark.sortBy:for_you(Standard),impression,ctr,play_2s_rate,play_6s_rate,cvroderlike.limit: 1 bis 200 Anzeigen. Standard 30.cursor: DernextCursoreiner früheren Antwort.libraryId: Die numerische ID einer Top-Anzeige.adverlangt sie.
search liest alle Felder oben außer libraryId, und ad liest nur libraryId. Das Creative Center listet für ein Land, einen Zeitraum und einen Filtersatz höchstens etwa 400 bis 500 Anzeigen auf (totalCount).
Such-Antwort
- Die Antwort gibt
platform,action,country,period,sortByund die erhaltenen Filter zurück.totalCountist die Zahl der Top-Anzeigen für diese Kombination. - Jede Anzeige hat
position,libraryId,title,advertiserName(oftnull),format,ctrPercent(die Klickrate in Prozent),costLevel,likes,industry(id,name),objectives,durationSeconds,width,height,voiceOver,images,videosundvideoUrls(die Videodatei je Auflösung, etwa360pund1080p). - Das Creative Center liefert weder
startDatenochendDate,impressionsoderlibraryUrl, daher sind diesenull, undsummaryzählt nur die Formate, Werbetreibenden und Plattformen. - Video- und Bild-URLs sind signiert und laufen etwa 5 bis 6 Stunden nach dem Lesen ab.
Eine Anzeige öffnen
action ad öffnet eine Top-Anzeige über libraryId und ergänzt linkUrl, landingDomain, reachedCountries, comments, shares und source (wo die Anzeige erstellt wurde, etwa TikTok Ads Manager).
libraryId, zu der das Creative Center keine Anzeige hat, schlägt mit PAGE_UNAVAILABLE fehl.
Preis
Eine Suche reserviert 0.5 Credits je 30 Anzeigen, die ihrlimit verlangt, und berechnet 0.5 Credits je 30 gelieferte Anzeigen, mindestens 0.5 Credits. Die Standardsuche mit 30 Anzeigen kostet 0.5 Credits, und eine Suche mit limit 300 in der Werbebibliothek reserviert 5 Credits. advertisers und ad kosten je 0.5 Credits. Nur abgeschlossene Anfragen werden berechnet.