Werbefunktionen

In diesem Leitfaden wird beschrieben, wie Sie das Plug-in für Werbefunktionen für analytics.js verwenden.

Überblick

Google Analytics-Werbefunktionen (einschließlich Remarketing-Listen für Suchanzeigen) können in Google Analytics unter Property-Einstellungen > Datenerhebung aktiviert werden. Mit dem Plug-in für Werbefunktionen für analytics.js lassen sich Werbefunktionen programmatisch aktivieren und alle Funktionen für Werbeberichte und Remarketing, die in der Google Analytics-Benutzeroberfläche verfügbar sind, überschreiben und deaktivieren.

Implementierung

Wir empfehlen, Funktionen für Werbeberichte in den Property-Einstellungen von Google Analytics zu aktivieren.

Wenn Sie das Plug-in für Werbefunktionen aktivieren möchten, fügen Sie einen require-Aufruf hinzu und geben Sie das Plug-in displayfeatures an.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'displayfeatures');
ga('send', 'pageview');

Das Plug-in sendet eine Anfrage an stats.g.doubleclick.net, mit der Werbefunktionen aktiviert werden. Das Plug-in erstellt ein neues Cookie mit dem Namen _gat mit einem Zeitlimit von einer Minute. Mit diesem Cookie werden keine Nutzerinformationen gespeichert. Es dient lediglich dazu, die Anzahl der an doubleclick.net zu sendenden Anfragen zu begrenzen.

Der Standard-Cookie-Name lautet _gat. Sie können es ändern, indem Sie die Option cookieName festlegen, wenn Sie das Plug-in benötigen:

ga('require', 'displayfeatures', {cookieName: 'display_features_cookie'});

Beachten Sie, dass normalerweise das dritte Argument verwendet wird, um den Speicherort des Skripts anzugeben. Da dieses Plug-in in analytics.js enthalten ist, können Sie einfach undefined übergeben.

Mehrere Tracker verwenden

Wenn Sie das Plug-in für Werbefunktionen mit mehreren Trackern verwenden möchten, stellen Sie dem Aufruf require den Namen des Trackers voran:

// create a tracker named 'foo' for property UA-XXXXX-Y
ga('create', 'UA-XXXXX-Y', {name: 'foo'});
ga('foo.require', 'displayfeatures');
ga('foo.send', 'pageview');

// create a second tracker named 'bar' for a different property UA-XXXX-Z
ga('create', 'UA-XXXXX-Z', {name: 'bar'});
ga('bar.require', 'displayfeatures');
ga('bar.send', 'pageview');

Wenn das Plug-in für Werbefunktionen für einen benannten Tracker geladen wird, wird der Name des Trackers an den Cookie-Namen angehängt. Im obigen Beispiel werden die Cookies _gat_foo und _gat_bar erstellt.

Werbefunktionen deaktivieren

Da Werbefunktionen über die Administratoreinstellungen in Google Analytics aktiviert werden können, kann es Fälle geben, in denen Sie sie programmatisch deaktivieren müssen.

Wenn Sie alle Werbefunktionen mit analytics.js deaktivieren möchten, setzen Sie allowAdFeatures auf false nach dem Befehl create und vor dem Befehl send.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdFeatures', false);
ga('send', 'pageview');

Wenn true (Standardwert) festgelegt ist, können das displayfeatures-Plug-in und die Einstellungen für Werbefunktionen in Google Analytics in allowAdFeatures verwendet werden. Durch dieses Feld werden diese Funktionen nicht automatisch aktiviert.

Setzen Sie allowAdFeatures auf false, um Beacons für Google Analytics-Werbefunktionen zu deaktivieren, unabhängig davon, ob sie über das displayfeatures-Plug-in oder in Google Analytics aktiviert wurden.

Wenn Sie nur Funktionen für personalisierte Anzeigen deaktivieren möchten, setzen Sie allowAdPersonalizationSignals auf false nach dem Befehl create und vor dem Befehl send.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdPersonalizationSignals', false);
ga('send', 'pageview');