Docs

Das Anzeigenobjekt und die IDs

Jede Anzeige jeder Plattform kommt in derselben Form zurück. IDs, Datumsangaben, Status, Creatives, EU-Daten und was null bedeutet.

AdLib bildet das Format jeder Plattform auf ein einziges Ad-Objekt ab. Ein Feld, das eine Plattform nicht veröffentlicht, ist null. Wir schätzen es nie. Plattformspezifische Zusatzdaten stehen in extra.

IDs

IDs haben die Form <platform>:<platform id> und ändern sich nie:

Art Beispiel
Anzeige meta:1187430977361020
Werbetreibender meta:15087023444, google:AR18378488041124659201, tiktok:6876453864464188162

Die Plattformen heißen meta, google, tiktok, linkedin, pinterest, x, snapchat, apple, amazon und microsoft. YouTube- und Google-Play-Anzeigen kommen aus Googles Transparency Center und behalten deshalb ihre google:-IDs. Du fragst sie mit platform=youtube oder platform=play ab.

Die wichtigsten Felder

Feld Bedeutung
advertiser id und name des Kontos, das die Anzeige geschaltet hat
status active, inactive oder unknown
first_shown, last_shown Die Daten, die die Plattform für die Anzeige veröffentlicht
first_seen_by_us, last_seen_by_us Wann unsere Crawler sie zum ersten und zum letzten Mal gesehen haben
formats image, video, carousel oder text
creatives[] Text, Überschrift, CTA, Landing-URL und Medien jeder Variante
countries, placements Wo sie lief, soweit veröffentlicht
eu_data EU-Reichweite (gesamt und pro Land), Targeting, Zahler und Begünstigter, für Anzeigen, die in der EU liefen
spend_range, impressions_range Nur wo die Plattform sie veröffentlicht: Ausgaben bei politischen Anzeigen; Impressionen bei politischen Anzeigen, bei jeder Snapchat-Anzeige in der EU und bei den EU-Anzeigen von Google, LinkedIn, Microsoft und X
derived.days_running Tage zwischen erster und letzter Ausspielung, beide mitgezählt
derived.signals, derived.stage Regelbasierte Performance-Signale und testing, scaling oder proven; siehe Performance-Signale
removed_from_library_at Seit wann die Bibliothek der Plattform die Anzeige nicht mehr zeigt. In AdLib bleibt sie erhalten. null, solange sie noch dort steht
library_url Die Anzeige in der Bibliothek der Plattform selbst

Status

Meta und Snapchat geben an, ob eine Anzeige aktiv ist, Google bei manchen Anzeigen. Bei Amazon gilt eine Anzeige als active, wenn sie in den letzten 48 Stunden ausgespielt wurde. TikTok verrät es uns nur, wenn du mit status=active oder status=inactive suchst. Sonst sind seine Anzeigen unknown. LinkedIn, Pinterest, X, der Apple App Store und Microsoft sagen es gar nicht, ihre Anzeigen haben also den Status unknown. Nimm dann last_shown und last_seen_by_us mit einer eigenen Regel, zum Beispiel „in den letzten 3 Tagen ausgespielt“.

Medien

Bildlinks liegen immer auf unseren eigenen Hosts und laufen nicht ab. Du kannst also media.adlibapi.com und api.adlibapi.com auf deine Allowlist setzen. Medien-URLs der Plattformen laufen nach Stunden oder Tagen ab.

Wir speichern Bilder, während wir deine Anfrage beantworten, mit einem Zeitlimit. url kann deshalb auf beiden Hosts liegen. Bei der Abfrage einer einzelnen Anzeige warten wir bis zu 8 Sekunden darauf, bei einer Suche bis zu 3. Dauert ein Bild länger, bekommt es einen Link auf api.adlibapi.com/m/... und wird im Hintergrund fertig gespeichert.

Feld Inhalt
url, Bild media.adlibapi.com, sobald das Bild archiviert ist. Bis dahin ein Link auf api.adlibapi.com/m/..., der das Bild beim ersten Aufruf archiviert und auf die Kopie weiterleitet. Links, die du schon gespeichert hast, funktionieren weiter
url, Video media.adlibapi.com für archivierte Videos. Die behalten wir für Werbetreibende auf einer Watchlist. Sonst die ablaufende URL der Plattform
preview_url Auf unseren Hosts: ein 320 px breites Vorschaubild eines archivierten Bilds oder Videos oder das Posterbild eines Videos. Bei einem noch nicht archivierten Bild derselbe Link wie url
original_url Die URL der Plattform, nur bis die Datei archiviert ist. Sie läuft ab, nimm sie also nur als Referenz
sha256 Gesetzt, sobald wir eine archivierte Kopie haben, bis dahin null

Medienlinks brauchen keinen API-Key, ein Browser kann sie in einem <img>-Tag laden. Ein Link antwortet mit 404, wenn die Anzeige gelöscht wurde oder wenn das Bild nie archiviert wurde und die Plattform es nicht mehr liefert. Zu Löschungen siehe den Takedown-Feed. Ein Profilbild in extra.page_profile_picture_url (Meta) funktioniert genauso wie eine Bild-url.

Zwei Sätze Datumsangaben

first_shown und last_shown stammen von der Plattform. first_seen_by_us und last_seen_by_us sind unsere. Wenn eine Plattform eine Anzeige nicht mehr listet, bleibt ihr Datensatz mit beiden Sätzen Datumsangaben in unserem Archiv. Siehe Anzeigenverlauf und Archiv.