chevron_right
chevron_right
JavaScript (Standalone)-Integration für Nicht-WordPress-Seiten
How-To/Instructional

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

Last Updated today
Article Navigation
Einführung
Anweisungen
Fehlerbehebung
Kontaktinformationen für weitere Unterstützung

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

  1. Stellen Sie sicher, dass Sie ein Ezoic-Konto erstellt haben. Falls Sie dies noch nicht getan haben, können Sie das hier tun.
  2. 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.

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.

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.

<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>

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/

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

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

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 SpeedSEO) 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.

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.

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).

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!

× Enlarged Image

Loading ...