Anfrage

Die Anzeigenplatzierungs-API kann entweder von der Client- oder der Server-Seite aus aufgerufen werden.

Bei der client-seitigen Implementierung kann der Browser eine Vorabanfrage stellen. Wenn Sie dies vermeiden möchten, verwenden Sie in der Kopfzeile der Anfrage "Content-Type: text/plain". Dadurch wird sichergestellt, dass der Browser die Anfrage als "einfach" einstuft und daher die Preflight-Anfrage überspringt.

Auch beim Aufruf der API auf der Client-Seite sind IPs nicht erforderlich, da es schwierig sein kann, die IP mit Frontend und Javascript zu erkennen. Stattdessen erkennt unsere API die IP aus der Verbindung, wenn die Anfrage gestellt wird.

Bei der server-seitigen Implementierung sollte die korrekte IP des Nutzers explizit übergeben werden, um ein korrektes Targeting zu gewährleisten. Andernfalls werden die Anzeigen auf den Serverstandort ausgerichtet, was dazu führen kann, dass Impressionen später durch eine IP-Fehlanpassung ungültig werden.

Unabhängig davon, ob es sich um einen Client oder einen Server handelt, wird bei der Übermittlung einer IP-Adresse dieser Vorrang vor der von uns ermittelten IP-Adresse eingeräumt.

Um eine Anfrage an die Anzeigenplatzierungs-API zu stellen, müssen Sie zwei Objekte übergeben: Benutzer und Zonen. Die Anfrage wird in JSON mittels HTTP POST gestellt.

benutzer

Parameter	Erforderlich?	Beschreibung
id	Nein	Die ID des Benutzers
ip	Empfohlen	Die IP-Adresse des Benutzers.
ua	Ja	Der Benutzer-Agent: Eine Zeichenfolge, die den Browser/die Anwendung und das Gerät/Betriebssystem des Benutzers enthält.
sprache	Nein	Legt die Sprache der Anfrage unter Verwendung des zweistelligen ISO-Standardcodes plus eines optionalen zweistelligen Regionalcodes fest. z. B. "en-us" für Englisch in den Vereinigten Staaten.
referent	Nein	Die Adresse der Website, auf der die Anzeige erscheinen soll.
el	Nein	Die Base64-kodierte E-Mail des Benutzers.
bildschirm_auflösung	Nein	Bildschirmauflösung des vom Nutzer verwendeten Geräts
fenster_ausrichtung	Nein	Dies sollte "Hochformat" sein, wenn die Website ein mobiles Layout hat, und "Querformat", wenn es sich um ein Desktop-Layout handelt.
gdpr	Nein	Datenschutzgerechte Erweiterungen (Objekt).

benutzer.gdpr

Parameter	Beschreibung
gdpr	Dies sollte 0 sein, wenn der Anrufer glaubt, dass der Nutzer nicht unter die DSGVO fällt, und 1, wenn der Nutzer unter die DSGVO fällt.
zustimmung	Dies ist die in den IAB-Standards geforderte Zustimmungskette.

zonen

Parameter	Erforderlich?	Beschreibung
id	Ja	Die ID der Anzeigenzone
unter	Nein	Die Sub-ID der Anzeigenzone
schlüsselwörter	Nein	Alle Schlüsselwörter, die mit dem Datenverkehr verbunden sind und zu einer bestimmten Art von Werbung passen könnten. Wenn es keine Schlüsselwörter gibt, wird die URL der Website für den Abgleich verwendet
benutzerdefiniertes_Targeting	Nein	Benutzerdefinierte Zonenwerte (Objekt)

zones.custom_targeting

Parameter	Beschreibung
ex_av	Dieser Wert sollte 0 sein, wenn er nicht definiert ist, 1, wenn das Alter überprüft wurde und 2, wenn das Alter nicht überprüft wurde

Beispiel

Es ist möglich, mehrere Anzeigenbereiche in einer einzigen Anfrage anzufordern. Jede Zone hat eine andere ID, wie Sie im folgenden Beispiel sehen können.

{
    "user": {
        "id": "abdef8u9",
        "ip": "10.42.0.1",
        "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
        "language": "en-US",
        "referer": "https://blabla.com",
        "gdpr" : {
                "gdpr" : 1,
                "consent": "CPAoZRHPArq3hBcADBENBJCgAAAAAAAAAAqIHKQAAOUgAAAA"
        }
    },
    "zones": [
        {
            "id": 4031007,
            "sub": 111,
            "keywords": "humour, general"
        },
        {
            "id": 4031015,
            "sub": 222 
        },
        {
            "id": 4031019,
            "sub": 222             
        }
    ]
}