For the complete documentation index, see llms.txt. This page is also available as Markdown.

So arbeiten Sie mit der AdBlock Dynamic Domains API

AdBlock-Tools werden immer ausgefeilter und stellen Publisher, die ihre Einnahmen aus Online-Werbung maximieren möchten, vor erhebliche Herausforderungen. Um diese Herausforderungen zu mindern, können Publisher mit dieser API ihre Skripte dynamisch auf Grundlage aktiver Domains anpassen, wodurch das Risiko, dass Inhalte von AdBlock-Software blockiert werden, deutlich reduziert wird.

Durch die Auslieferung von Anzeigen über regelmäßig rotierte Domains können Publisher Folgendes erreichen:

  • Einnahmequellen aufrechterhalten: Unterbrechungen durch blockierte Anzeigen verhindern.

  • Nutzererlebnis verbessern: Anzeigeninhalte nahtlos ausliefern, ohne die AdBlock-Erkennung auszulösen.

  • Domain-Verwaltung automatisieren: Manuelle Aktualisierungen mit einem automatisierten 7-Tage-Domain-Lebenszyklus eliminieren.

Neue Domains werden alle 3 Tage generiert und sind über die API verfügbar. Die Domains haben einen 6-Tage-Lebenszyklus.

  • 3 Tage aktiv

  • 3 Tage veraltet

Wenn der Lebenszyklus abläuft, wird die Domain deaktiviert. Aus Leistungsgründen wird empfohlen, die Domain 24 Stunden lang zwischenzuspeichern, bevor Sie eine neue Domain von der API anfordern.

Diese API ist nur verfügbar für Popunders Inline-Skript und In-Stream-Video Zonen.

Anforderungen

Um diese API zu verwenden, müssen Publisher:

  • Senden Sie eine GET-Anfrage an den Endpunkt: https://ads.exoclick.com/adblock-domains.php

  • Sie erhalten in der Antwort eine neue Domain für die Anzeigenauslieferung

  • Anschließend müssen Sie den im Tag Ihrer Anzeigenzone verwendeten Syndizierungs-Endpunkt auf den in der API-Antwort bereitgestellten neuen Endpunkt ändern.

Implementierungsschritte

1

Die aktive Domain abrufen

Um die aktive Domain dynamisch abzurufen, müssen Sie einen API-Aufruf Server-zu-Server durchführen. Dies ist entscheidend, da API-Aufrufe blockiert werden können, wenn sie clientseitig aufgerufen werden.

Hier ist ein Beispiel für einen Server-zu-Server-Aufruf in PHP:

Und hier ist die erwartete Antwort der API:

2

Ihr Skript aktualisieren

Verwenden Sie das Domain vom Endpunkt zurückgegeben, um die in Ihrer Anzeigenzone verwendete Domain zu aktualisieren. Die ursprüngliche Domain hängt vom Anzeigenformat ab:

  • Für In-Stream-Video Zonen ändern Sie die VAST-Tag:

    • Vorher : https://s.magsrv.com/v1/vast.php?t={random}&idzone={zoneId}

    • Nachher : https://newsub.newdomain.com/v1/vast.php?t={random}&idzone={zoneId}

  • Für Popunder-Zonen ändern Sie die syndication_host im Inline-Skript:

    • Vorher : s.pemsrv.com

    • Nachher : newsub.newdomain.com

AdBlock erkennen

Um zu erkennen, ob der Nutzer eine aktivierte Adblock-Erweiterung verwendet, müssen Sie hosten ads.js auf der Publisher-Seite (Ihre eigene Domain/CDN) und sie ganz am Anfang Ihres body Tags einbinden.

Rufen Sie nicht ab https://www.exoclick.com/ads.js direkt auf.

Erstellen Sie Ihre eigene ads.js Datei:

  1. Erstellen Sie eine Datei mit dem Namen ads.js in einem öffentlichen Pfad auf Ihrer Website (zum Beispiel /js/ads.js).

  2. Fügen Sie dieser Datei den folgenden Inhalt hinzu.

  3. Laden Sie diese Datei von Ihrer Seite, bevor Ihre Werbeintegrationslogik ausgeführt wird.

Inhalt der Referenzdatei:

Fügen Sie dann die folgende Zeile ganz am Anfang Ihres body Tags hinzu:

Dieses Skript wird von Adblock blockiert, falls der Client es verwendet, aufgrund der Schlüsselwörter "exoclick" und "ads". Nach dem Laden dieses Skripts versucht ein JS-Snippet, eine bestimmte Variable zu lesen. Wenn die Variable undefiniert oder nicht zugänglich ist, können wir feststellen, dass das Skript blockiert wurde.

Integrationsbeispiele

In diesen beiden Beispielen verwenden wir fetchAdblockDomain.php als Namen des Server-zu-Server-Aufrufs zum Abrufen der Adblock-Domain.

In-Stream

Um Dynamic Domains mit In-Stream zu verwenden, stellen Sie sicher, dass Sie den VAST-Player im Skript einbinden, andernfalls lädt der Player die standardmäßige In-Stream-Anzeigenzone anstelle der aktualisierten Domain. In diesem Beispiel verwenden wir den Fluidplayer HTML5-Player.

Popunder

Fehlerbehebung

Keine Domain zurückgegeben

Manchmal kann der Endpunkt leere Domains zurückgeben.

Protokollieren Sie während des Debuggings immer die Antwort des Endpunkts, um potenzielle Probleme zu erkennen. Wenn success false, wenden Sie sich an den Support.

Standarddomain zurückgegeben, obwohl Adblock aktiviert ist

Hier sind einige häufige Gründe, warum Ihr Skript trotz aktiviertem Adblock möglicherweise die Standarddomain verwendet:

  • ads.js wird nicht auf der Publisher-Seite gehostet. Diese Integration erfordert, dass ads.js von Ihrer eigenen Domain bereitgestellt wird (zum Beispiel /js/ads.js). Das direkte Anfordern von https://www.exoclick.com/ads.js wird nicht unterstützt.

  • Die Standarddomain wird vor der Adblock-Domain gerendert. Stellen Sie sicher, dass das Skript, das die Anzeigenzone auf Ihrer Website einfügt, immer auf den Server-zu-Server-Aufruf wartet. Abhängig von der Ausführungskette kann die Standarddomain auf der Website hinzugefügt werden, bevor die Adblock-Domain zurückgegeben wird, wodurch Ihre Website daran gehindert wird, die aktualisierte Domain einzufügen.

Für weitere Unterstützung wenden Sie sich an das Support-Team hier.

Zuletzt aktualisiert

War das hilfreich?