> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/de/api-fur-anzeigenplatzierung/ad-plac-request.md). # Anfrage Die Ad-Placement-API kann entweder von **Client** Seite oder **Server** Seite. Bei Verwendung der **Client** Seitenimplementierung kann der Browser eine **Preflight-** Anfrage durchführen. Wenn Sie dies vermeiden möchten, verwenden Sie im Anfrage-Header `Content-Type: text/plain`. Dadurch wird sichergestellt, dass der Browser die Anfrage als „einfach“ einstuft und daher die Preflight-Anfrage überspringt. Außerdem gilt beim Aufrufen der API auf der **Client** Seite, **IPs werden tatsächlich nicht benötigt** da es schwierig sein kann, IPs mit Frontend und JavaScript zu erkennen. Stattdessen erkennt unsere API die IP aus der Verbindung, wenn die Anfrage gestellt wird. Bei Verwendung der **Server** Seitenimplementierung, um ein korrektes Targeting sicherzustellen, **sollte die korrekte IP des Benutzers explizit übergeben werden**. Andernfalls werden Anzeigen auf den Serverstandort ausgerichtet, und dies kann dazu führen, dass Impressionen später aufgrund einer IP-Abweichung ungültig werden. Unabhängig davon, ob Client oder Server verwendet wird, hat eine übergebene IP Vorrang vor der von uns erkannten. Um eine Anfrage an die Ad-Placement-API auszuführen, müssen Sie zwei Objekte übergeben: **user** und **zones**. Die Anfrage wird in JSON per HTTP POST gesendet. ## user | Parameter | Erforderlich? | Beschreibung | | ------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Nein | Die ID des Benutzers | | ip | Empfohlen | Die IP-Adresse des Benutzers. | | ua | Ja | Der User-Agent: Eine Zeichenfolge, die den Browser/die App und das Gerät/Betriebssystem des Benutzers enthält. | | language | Nein | Legt die Sprache der Anfrage mithilfe des [standardmäßigen zweistelligen ISO-Codes](https://www.andiamo.co.uk/resources/iso-language-codes/) plus eines optionalen 2-stelligen Regionscodes fest, z. B. `en-us` für Englisch der Vereinigten Staaten. | | referer | Nein | Die Adresse der Website, auf der die Anzeige angezeigt wird. | | el | Nein | Die Base64-codierte E-Mail des Benutzers. | | screen\_resolution | Nein | Bildschirmauflösung des vom Benutzer verwendeten Geräts | | window\_orientation | Nein | Dies sollte "portrait" sein, wenn die Website ein mobiles Layout hat, und "landscape", wenn es eine Desktop-Version ist. | | gdpr | Nein | Datenschutzempfohlene Erweiterungen (Objekt). | ### user.gdpr | Parameter | Beschreibung | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | gdpr | Dies sollte **0** sein, wenn der Aufrufer glaubt, dass der Benutzer nicht unter die DSGVO fällt, und **1** sein, wenn der Benutzer unter die DSGVO fällt. | | consent | Dies ist die Zustimmungszeichenfolge, die von den IAB-Standards benötigt wird. | ## zones | Parameter | Erforderlich? | Beschreibung | | ----------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Ja | Die ID der Anzeigenzone | | sub | Nein | Die Sub-ID der Anzeigenzone | | keywords | Nein | Beliebige [keywords](/advertisers/campaigns/creating-a-campaign/create-campaign-step3.md#keywords) mit dem Traffic verknüpft, der mit einer bestimmten Art von Werbung übereinstimmen könnte. Wenn keine Schlüsselwörter vorhanden sind, wird die URL der Website für den Abgleich verwendet | | custom\_targeting | Nein | Benutzerdefinierte Zonenwerte (Objekt) | ### zones.custom\_targeting | Parameter | Beschreibung | | --------- | ------------------------------------------------------------------------------------------------------- | | ex\_av | Dies sollte **0** wenn undefiniert, **1** wenn Alter verifiziert und **2** wenn Alter nicht verifiziert | ## Beispiel Es ist möglich, mehrere Anzeigenzonen in einer einzelnen Anfrage anzufordern. Jede Zone hat eine andere ID, wie Sie im folgenden Beispiel sehen können. ```json { "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": "Humor, allgemein" }, { "id": 4031015, "sub": 222 }, { "id": 4031019, "sub": 222 } ] } ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/api/de/api-fur-anzeigenplatzierung/ad-plac-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.