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.