Anleitung

JavaScript (Standalone)-Integration für Nicht-WordPress-Seiten

Zuletzt aktualisiert vor ein paar Tagen

Einführung

Die Verbindung zu Ezoic über JavaScript (manchmal auch als "Standalone"-Integration bezeichnet) ist schnell und einfach und bietet Verlegern vollständige Kontrolle und Anpassungsmöglichkeiten. Diese Integrationsmethode ist mit allen Website-Strukturen kompatibel und erfordert das Einfügen eines kleinen JavaScript-Codes in das HTML Ihrer Website, wodurch Ezoic die Verwaltung und Optimierung von Anzeigenplatzierungen auf Ihrer Seite ermöglicht wird. In diesem Artikel bieten wir eine Schritt-für-Schritt-Anleitung zur Integration von Ezoic mit der JavaScript-Methode.

Anweisungen

Hinweis: Dieser Artikel gilt für Seiten, die ihre Website mithilfe von JavaScript integrieren möchten und nicht WordPress verwenden. Es wird empfohlen, dass Websites, die WordPress verwenden, stattdessen den Anweisungen hier folgen.

Voraussetzungen

Stellen Sie sicher, dass Sie ein Ezoic-Konto erstellt haben. Falls Sie dies noch nicht getan haben, können Sie das hier tun.
Verbinden Sie sich mit Ihrem Ezoic-Onboarding-Spezialisten, falls Sie Hilfe bei der Einrichtung von ads.txt oder bei der Annahme der Google MCM-Einladung benötigen.

Einrichtung der Anzeigen

Das Verbinden Ihrer Seite mit Ezoic ist ein einfacher Prozess, der das Hinzufügen einiger Codezeilen zu Ihrer Seite beinhaltet. Während Sie auf die Genehmigung von Google Ad Manager warten, empfehlen wir, in einer Staging- oder Entwicklungsumgebung sicherzustellen, dass Ihre Anzeigenplatzierungen ordnungsgemäß eingerichtet sind und das Laden der Anzeigen bestätigt ist.

Diese Anleitung führt Sie durch die Schritte zur Implementierung von EzoicAds auf Ihrer Website.

Schritt 1: Anzeigenplatzierungen erstellen

Um EzoicAds zu implementieren, müssen Sie Anzeigenplatzierungen auf Ihrer Website erstellen. Diese Platzierungen werden verwendet, um die Anzeigepositionen auf Ihrer Seite zu definieren, an denen Ezoic-Anzeigen angezeigt werden sollen.

Sie können Anzeigenplatzierungen in Ihrem Ezoic-Dashboard erstellen, oder Sie können mit Ihrem Ezoic-Onboarding-Spezialisten zusammenarbeiten, um die idealen Anzeigenplatzierungen für Ihre Website zu erstellen.

Schritt 2: Header-Skripte hinzufügen

Fügen Sie das Ezoic-Privacy-Script hinzu (dies setzt voraus, dass Sie Ezoics Consent-Modal verwenden. Wenn Sie ein Drittanbieter-Modal verwenden, siehe https://support.ezoic.com/kb/article/javascript-standalone-integration) und Header-Skript ganz oben im <head>-Tag ein (für eine schnellere Anzeigeneinrichtung und -bereitstellung empfehlen wir, diese Header-Skripte innerhalb des <head>-Tags einzufügen. Ist dies im Head nicht möglich, ist die nächstbeste Option, sie ganz oben im <body>-Tag zu positionieren). Bitte stellen Sie sicher, dass Sie das Privacy-Script vor dem Header-Skript laden.

Privacy-Script:

<script src="https://the.gatekeeperconsent.com/cmp.min.js" data-cfasync="false"></script>
<script src="https://cmp.gatekeeperconsent.com/min.js" data-cfasync="false"></script>

*Bitte beachten Sie, dass die Privacy-Scripte nicht verzögert werden dürfen, da sonst persönliche Informationen verarbeitet werden könnten, bevor eine Einwilligung gegeben wurde.

Der Ezoic CMP kann angepasst werden, indem Sie den Datenschutzbereich im Ezoic-Dashboard besuchen.

Ezoic wird automatisch die Zustimmung von Drittanbieter-CMPs erkennen, die konform mit TCF 2.2 sind: https://iabeurope.eu/cmp-list/.

Header-Skript:

<script async src="//www.ezojs.com/ezoic/sa.min.js"></script>
<script>
  window.ezstandalone = window.ezstandalone || {};
  ezstandalone.cmd = ezstandalone.cmd || [];
</script>

Schritt 3: Anzeigepositionen einfügen

Dieser Code wird für jede Anzeigeposition aufgerufen. Es ist wichtig zu beachten, dass die 3-stellige 101-ID eine spezifische Anzeigeposition darstellt, und jede Anzeigeposition eine andere 3-stellige ID hat. Anzeigencodes werden in Ihrem EzoicAds-Dashboard generiert.

Jede Anzeigeposition wird die folgende Struktur haben:

<div id="ezoic-pub-ad-placeholder-101"></div>
<script>
    ezstandalone.cmd.push(function() {
        ezstandalone.showAds(101)
    });
</script>

Fügen Sie diesen Code für jede Anzeigeposition auf Ihrer Website ein.

FÜGEN SIE KEIN Styling zum eigentlichen Platzhalter-div hinzu. Das Hinzufügen von Stilen oder das Reservieren von Platz für die Anzeige kann zu unerwünschten Ergebnissen führen (z. B. wenn ein Platzhalter nicht von unserem System ausgewählt wird, kann es leeren Raum auf der Seite geben).

Der Aufruf von ezstandalone.showAds() ohne Angabe eines Platzhalterwerts wird die Funktion für jeden Platzhalter auf dieser Seite aufrufen.

Dynamischer Inhalt

Wenn der Inhalt Ihrer Website dynamisch geladen oder geändert wird, kann eine zusätzliche Konfiguration erforderlich sein. Weitere Anweisungen finden Sie hier: https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic

Hybride Integration

Eine Hybridintegration liegt vor, wenn eine Website über Nameserver oder Cloudflare integriert und den clientseitigen Code-Snippet zum Aufrufen von Anzeigen verwendet. Der Vorteil der Hybridintegration besteht darin, dass sie die anderen Produkte von Ezoic (z. B. Site Speed, SEO) mit der Fähigkeit erweitert, Anzeigen dynamisch zu laden. Weitere Anweisungen finden Sie hier: https://support.ezoic.com/kb/article/hybrid-integration

Humix-Videos

Der Embed-Code-Generator aus Ihrem Humix-Dashboard kann verwendet werden, um unseren Video-Player zu Ihrer Website hinzuzufügen.

Erweitert

EzoicAds bietet erweiterte Funktionen, mit denen Publisher das Verhalten der Anzeigenbibliothek feinabstimmen können. Diese Funktionen können verwendet werden, um das Verhalten der Anzeigenbibliothek den Bedürfnissen Ihrer Seite besser anzupassen. Weitere Anweisungen finden Sie hier: https://support.ezoic.com/kb/article/javascript-standalone-integration-advanced-features-for-non-wordpress-sites

Fehlerbehebung

Wenn Sie EzoicAds auf Ihrer Website einrichten, ist es wichtig sicherzustellen, dass alles ordnungsgemäß funktioniert. Wir bieten einen integrierten JavaScript-Integrations-Debugger, mit dem Sie Probleme mit Ihrer Anzeigeneinrichtung schnell diagnostizieren können. Nachfolgend finden Sie eine Schritt-für-Schritt-Anleitung zur Verwendung dieses Debuggers und zur Interpretation seiner Ausgaben.

Schritt 1: Den Debugger auslösen

Um den Debugger zu aktivieren, fügen Sie einfach den folgenden Abfrageparameter an die URL der Seite an, auf der Ihre EzoicAds integriert sind:

ez_js_debugger=1

Zum Beispiel:

https://www.ihrewebsite.com?ez_js_debugger=1

Sobald der Abfrageparameter hinzugefügt und die Seite geladen ist, erscheint ein grüner modaler Dialog in der unteren Mitte des Bildschirms. Dies ist der JavaScript-Integrations-Debugger.

Schritt 2: Verstehen der Debugger-Ausgabe

Der Debugger-Modal enthält mehrere wichtige Informationen, die Ihnen bei der Fehlersuche in Ihrer Einrichtung helfen. Hier ist eine Aufgliederung der bereitgestellten Informationen:

Skripterkennung: Der Debugger überprüft, ob das Ezoic-Skript korrekt auf Ihrer Seite eingebunden ist. Wenn das Skript nicht gefunden wird, sehen Sie eine Fehlermeldung. Stellen Sie sicher, dass das Ezoic-Skript-Tag an der richtigen Stelle auf Ihrer Seite platziert ist.
Platzhalterrkennung: Die Anzahl der auf Ihrer Seite definierten Platzhalter wird angezeigt. Dies hilft zu überprüfen, ob die Platzhalter vom Ezoic-System erfolgreich erkannt wurden.
Anzeigenstatus: Für jeden Platzhalter zeigt der Debugger an, ob eine Anzeige erfolgreich gerendert wurde. Es zeigt:
- Ob einer bestimmten Platzhalter eine Anzeige zugewiesen ist.
- Ob eine Anfrage an Ezoic gesendet wurde, um eine Anzeige für diesen Platzhalter abzurufen.
Anfrageerfolg: Der Debugger überwacht auch, ob die Anzeigenanfrage erfolgreich gesendet wurde. Bei Problemen zeigt das Dialogfeld Fehlerdetails an, um die Ursache zu identifizieren (z.B. Netzwerkprobleme, Fehlkonfiguration).

Schritt 3: Verwendung des Debuggers zur Fehlerbehebung

Die im Debugger-Modal bereitgestellten Informationen sind wertvoll für die Diagnose häufiger Probleme wie:

Anzeigen werden nicht angezeigt: Überprüfen Sie die Platzhalterrkennung und den Anzeigenstatus, um sicherzustellen, dass Platzhalter definiert und Anzeigen zugewiesen sind.
Anfragen für Anzeigen scheitern: Wenn Anfragen für Anzeigen nicht gesendet werden oder fehlschlagen, liefert der Debugger Fehlermeldungen, die auf mögliche Fehlkonfigurationen hinweisen.
Ladeprobleme des Skripts: Wenn das Skript nicht ordnungsgemäß geladen wird, verifizieren Sie, dass der Skript-Tag in Ihrem Quellcode vorhanden und korrekt konfiguriert ist.

Kontaktinformationen für weitere Unterstützung

Wenn Sie weitere Unterstützung bei der JavaScript (Standalone) Integration benötigen, loggen Sie sich bitte über https://support.ezoic.com/ ein, um unsere speziellen Ressourcen für den Support zu nutzen. Wir sind hier, um zu helfen!

War dieser Artikel hilfreich?