chevron_right
chevron_right
Wie man Ezoic mit JavaScript integriert
How-To/Instructional

Wie man Ezoic mit JavaScript integriert

Last Updated over a month ago
Article Navigation
Einführung
Anweisungen
Fehlerbehebung
Kontaktinformationen für weitere Unterstützung

Einführung

Die Verbindung zu Ezoic über JavaScript (manchmal als "standalone" Integration bezeichnet) ist schnell und einfach und bietet Verlagen vollständige Kontrolle und Anpassungsmöglichkeiten. Diese Integrationsmethode ist mit allen Website-Builds kompatibel und erfordert das Einfügen eines kleinen JavaScript-Codes in das HTML Ihrer Website, wodurch Ezoic die Verwaltung und Optimierung der Anzeigenplatzierungen auf Ihrer Seite ermöglicht wird. 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 Onboarding Specialist, wenn Sie Hilfe beim Einrichten von ads.txt oder beim Akzeptieren der Google MCM-Einladung benötigen.


Einrichten von Anzeigen

Das Verbinden Ihrer Website mit Ezoic ist ein einfacher Prozess, der das Hinzufügen einiger Codezeilen zu Ihrer Website beinhaltet. 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 richtig eingerichtet sind und das Laden der Anzeigen bestätigt wird.

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

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

Fügen Sie das Ezoic-Datenschutzskript hinzu (dies setzt voraus, dass Sie das Ezoic-Zustimmungsmodul 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 Einrichtung und Lieferung von Anzeigen empfehlen wir, diese Header-Skripte innerhalb des <head>-Tags einzufügen. Wenn dies im Kopf nicht möglich ist, ist die nächstbeste Option, sie ganz oben im <body>-Tag zu positionieren.) Bitte stellen Sie sicher, dass das Datenschutzskript vor dem Header-Skript geladen wird.

<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 Anzeigenplatz aufgerufen. Es ist wichtig zu beachten, dass die 3-stellige ID 101 einen bestimmten Anzeigenplatz darstellt und jeder Anzeigenplatz eine andere 3-stellige ID hat. Anzeigencodes werden in Ihrem EzoicAds-Dashboard generiert.

Jeder Anzeigenplatz hat die folgende Struktur:

<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 Anzeigenplatz auf Ihrer Website ein.

Fügen Sie dem tatsächlichen Platzhalter div KEINE Stile 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 von unserem System nicht ausgewählt wird, könnte es leeren Raum auf der Seite geben).

Das Aufrufen von ezstandalone.showAds() ohne Angabe eines Platzhalterwerts ruft die Funktion für jeden auf dieser Seite vorhandenen Platzhalter auf.


Dynamische Inhalte

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

Die hybride Integration erfolgt, wenn eine Website über Nameserver oder Cloudflare integriert wird und gleichzeitig der clientseitige Code-Snippet verwendet wird, um Anzeigen abzurufen. Der Vorteil der hybriden Integration besteht darin, dass sie die dynamische Ladefähigkeit der anderen Ezoic-Produkte (z. B. Site SpeedSEO) ermöglicht. Weitere Anweisungen finden Sie hier: https://support.ezoic.com/kb/article/hybrid-integration


Humix Videos

Der Einbettungscode-Generator Ihres Humix-Dashboards kann verwendet werden, um unseren Video-Player zu Ihrer Website hinzuzufügen.


Erweitert

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

Fehlerbehebung

```html

Beim Einrichten von EzoicAds auf Ihrer Website 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. 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

Beispielsweise:

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

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

Der Debugger-Modal 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.

  • Platzhaltererkennung: 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 gibt der Debugger an, ob eine Anzeige erfolgreich gerendert wurde. Es zeigt:

    • Ob eine Anzeige einem bestimmten Platzhalter 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. Wenn es ein Problem gibt, zeigt das Modal Fehlermeldungen an, um die Ursache zu identifizieren (z.B. Netzwerkprobleme, Fehlkonfiguration).

Die im Debugger-Modal bereitgestellten Informationen sind von unschätzbarem Wert für die Diagnose häufiger Probleme wie:

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

  • Anfragen für Anzeigen schlagen fehl: Wenn Anzeigenanfragen nicht gesendet werden oder fehlschlagen, bietet der Debugger Fehlermeldungen, die auf mögliche Fehlkonfigurationen hinweisen.

  • Skriptladeprobleme: Wenn das Skript nicht richtig geladen wird, überprüfen Sie, ob das 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, melden Sie sich bitte über https://support.ezoic.com/ an, um unsere speziellen Ressourcen für den Support zu nutzen. Wir sind hier, um Ihnen zu helfen!

× Enlarged Image

Loading ...