chevron_right
chevron_right
JavaScript (Standalone) Integration
How-To/Instructional

JavaScript (Standalone) Integration

Last Updated over a month ago
Article Navigation
Einführung
Anweisungen
Fehlerbehebung
Kontaktdaten 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 Publishern vollständige Kontrolle und Anpassungsmöglichkeiten. Diese Integrationsmethode ist mit allen Website-Konfigurationen kompatibel und beinhaltet das Einfügen eines kleinen JavaScript-Codes in das HTML Ihrer Website, wodurch Ezoic die Anzeigenplatzierungen auf Ihrer Website verwalten und optimieren kann. In diesem Artikel geben wir eine Schritt-für-Schritt-Anleitung, wie Sie Ezoic mit der JavaScript-Methode integrieren können.

Anweisungen

  1. Stellen Sie sicher, dass Sie ein Ezoic-Konto erstellt haben. Wenn Sie dies noch nicht getan haben, können Sie das hier tun.
  2. Kontaktieren Sie Ihren Ezoic-Einrichtungsspezialisten, wenn Sie Hilfe beim Einrichten von ads.txt oder beim Akzeptieren der Google MCM-Einladung benötigen.


Einrichtung von Anzeigen

Die Verbindung Ihrer Website mit Ezoic ist ein einfacher Vorgang, der das Hinzufügen einiger Codezeilen zu Ihrer Website erfordert. Während Sie auf die Genehmigung von Google Ad Manager warten, empfehlen wir, die Einrichtung in einer Staging- oder Entwicklungsumgebung vorzunehmen, um sicherzustellen, dass Ihre Anzeigenplatzierungen ordnungsgemäß eingerichtet sind und das Laden der Anzeigen bestätigt wird.

Dieser Leitfaden 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 Anzeigenplatzierungen werden verwendet, um die Anzeigebereiche auf Ihrer Website zu definieren, in denen Ezoic-Anzeigen angezeigt werden.

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

Fügen Sie das Ezoic-Datenschutz-Skript (dies setzt voraus, dass Sie das Einwilligungsmodul von Ezoic verwenden. Wenn Sie ein Drittanbieter-Modul verwenden, folgen Sie den hier beschriebenen Schritten) und das Header-Skript ganz oben im <head>-Tag ein (für eine schnellere Anzeigeneinrichtung und -auslieferung empfehlen wir, diese Header-Skripte innerhalb des <head>-Tags einzufügen. Wenn dies im Head nicht möglich ist, ist die nächstbeste Option, sie ganz oben im <body>-Tag zu platzieren). Bitte stellen Sie sicher, dass Sie das Datenschutskript vor dem Header-Skript laden.

<script src="https://the.gatekeeperconsent.com/cmp.min.js" data-cfasync="false"></script>
<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 jeden Anzeigebereich aufgerufen. Es ist wichtig zu beachten, dass die 3-stellige 101-ID einen bestimmten Anzeigebereich darstellt und jeder Anzeigebereich eine andere 3-stellige ID haben wird. Anzeigencodes werden in Ihrem EzoicAds-Dashboard generiert.

Jeder Anzeigebereich 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 jeden Anzeigebereich auf Ihrer Website ein.

Fügen Sie dem tatsächlichen Platzhalter div KEIN Styling hinzu. Das Hinzufügen von Styles 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 auf der Seite ein leerer Bereich entstehen).

Das Aufrufen von ezstandalone.showAds() ohne die Definition eines Platzhalterwertes 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 bedeutet, dass eine Website über Nameserver oder Cloudflare integriert wird, während der clientseitige Code-Snippet verwendet wird, um Anzeigen aufzurufen. Der Vorteil der hybriden Integration besteht darin, dass sie die Verwendung anderer Produkte von Ezoic (z. B. Site SpeedSEO) ermöglicht, indem Anzeigen dynamisch geladen werden. Weitere Anweisungen finden Sie hier: https://support.ezoic.com/kb/article/hybrid-integration


Humix Videos

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


Erweitert

EzoicAds bietet erweiterte Funktionen, die es Publishern ermöglichen, das Verhalten der Anzeigenbibliothek fein abzustimmen. Diese Funktionen können verwendet werden, um das Verhalten der Anzeigenbibliothek anzupassen, um besser den Bedürfnissen Ihrer Website zu entsprechen. Weitere Anweisungen finden Sie hier: https://support.ezoic.com/kb/article/javascript-standalone-integration-advanced-features

Fehlerbehebung

Beim Einrichten von EzoicAds auf Ihrer Website ist es wichtig, sicherzustellen, dass alles ordnungsgemäß funktioniert. Wir bieten einen integrierten JavaScript-Integrations-Debugger, der es Ihnen ermöglicht, Probleme mit Ihrer Anzeigeneinrichtung schnell zu diagnostizieren. Im Folgenden 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 zur URL der Seite hinzu, 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 wurde und die Seite geladen ist, erscheint ein grünes modales Dialogfeld unten in der Mitte des Bildschirms. Dies ist der JavaScript-Integrations-Debugger.

Das modale Fenster des Debuggers enthält mehrere wichtige Informationen, die Ihnen bei der Fehlerbehebung Ihrer Einrichtung helfen. Hier ist eine Aufschlüsselung 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.

  • Platzhalter-Erkennung: Die Anzahl der definierten Platzhalter auf Ihrer Seite 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 dargestellt wurde. Er zeigt:

    • Ob einer bestimmten Platzhalter eine Anzeige zugewiesen ist.
    • Ob eine Anfrage an Ezoic gesendet wurde, um eine Anzeige für diesen Platzhalter abzurufen.
  • Anfragenerfolg: Der Debugger überwacht auch, ob die Anzeigenanfrage erfolgreich gesendet wurde. Wenn es ein Problem gibt, zeigt das modale Fenster Fehlerdetails an, die helfen, die Ursache zu identifizieren (z. B. Netzwerkprobleme, Fehlkonfiguration).

Die im modalen Fenster des Debuggers bereitgestellten Informationen sind unschätzbar für die Diagnose häufiger Probleme wie:

  • Anzeigen werden nicht angezeigt: Überprüfen Sie die Platzhalter-Erkennung und den Anzeigenstatus, um sicherzustellen, dass Platzhalter definiert sind und Anzeigen zugewiesen sind.

  • Anzeigenanfragen schlagen fehl: Wenn Anzeigenanfragen nicht gesendet oder fehlschlagen, bietet der Debugger Fehlermeldungen, die auf mögliche Fehlkonfigurationen hinweisen.

  • Ladeprobleme mit Skripten: Wenn das Skript nicht ordnungsgemäß geladen wird, überprüfen Sie, ob das Skript-Tag in Ihrem Quellcode vorhanden und korrekt konfiguriert ist.

Kontaktdaten für weitere Unterstützung

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

× Enlarged Image

Loading ...