Sichere Signale

Sichere Signale sind codierte Daten, die auf dem Clientgerät erfasst und an ausgewählte Bieter weitergegeben werden. In dieser Anleitung erfahren Sie, wie Sie mit dem IMA SDK sichere Signale erfassen und an Google Ad Manager senden.

Informationen zum Auswählen von Signalen und Bietern und zum Aktivieren der Freigabe sicherer Signale finden Sie unter Sichere Signale für Bieter freigeben.

Signalanbieter von Drittanbietern verwenden

Wenn Sie sichere Signale verwenden möchten, müssen Sie ein Script zum Erfassen von Signalen auf Ihrer Website bereitstellen, um Signale zu erfassen, zu codieren und an das IMA SDK weiterzuleiten.

Sie können Scripts für sichere Signale entweder automatisch oder manuell bereitstellen.

Automatisch bereitstellen

Wenn Sie Signalanbieter in Ad Manager auswählen, wird Ihnen je nach ausgewähltem Signalanbieter möglicherweise die Option Google bitten, das Script zur Signalerfassung in Ihrem Namen bereitzustellen angezeigt. Wenn Sie diese Option auswählen und Ihre Website Google Publisher-Tags enthält, werden die ausgewählten Scripts zur Signalerfassung automatisch geladen.

Hier ein Beispiel für die Ad Manager-Benutzeroberfläche:

Hier ein Beispiel für die index.html-Datei Ihrer Website:

...
<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load gpt.js, which autoloads all signal provider scripts configured to be deployed by Google. -->
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script src="ads.js"></script>
...

Manuell bereitstellen

Wenn Sie in Ad Manager die Option Bereitstellung des Scripts zur Signalerfassung durch Google in Ihrem Namen beantragen nicht sehen oder diese Option nicht aktivieren, müssen Sie einen Script-Link von Ihrem Anbieter für sichere Signale abrufen und manuell in Ihr Projekt einfügen.

Hier ein Beispiel für die Ad Manager-Benutzeroberfläche:

Hier ein Beispiel für die index.html-Datei Ihrer Website:

...
<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load signal provider scripts manually, using the unique instructions given by each signal provider. -->
<script src="//cdn.provider1.com/files/a/e/5/4/7/signalCollector.js"></script>
<script src="//provider2.co.uk/ads/signalcollector/script.min.js"></script>
<script src="/local/path/to/third_party_signal_provider_3.js"></script>
<script src="ads.js"></script>
...

Benutzerdefinierte Daten senden

Sie können Signale nicht nur von einem Drittanbieter erheben, sondern auch mit benutzerdefinierten Daten erfassen, codieren und senden. Bevor Sie sichere Signale mit benutzerdefinierten Daten senden können, müssen Sie benutzerdefinierte Signale in Ad Manager aktivieren.

So gehts bei HTML5-Projekten:

  1. Erstellen Sie ein Objekt mit den folgenden Properties: networkCode und collectorFunction.
  2. Fügen Sie der Property networkCode Ihren Netzwerkcode hinzu.
  3. Fügen Sie der Property „collectorFunction“ eine Funktion hinzu, die ein Versprechen zurückgibt, das auf Ihre codierten Signale verweist.

Gib das Objekt in das googletag.secureSignalProviders-Array ein, bevor du adsLoader instanzierst, damit das IMA SDK darauf zugreifen kann, um deine codierten Signale abzurufen und zu übertragen.

Hier ein Beispiel in JavaScript:

ads.js

...
console.log("initializing IMA");
adContainer = document.getElementById('ad-container');
adDisplayContainer = new google.ima.AdDisplayContainer(adContainer, videoElement);

const NETWORK_CODE = '12345678901';
const signalCollector = () => {
 return new Promise((resolve, reject) => {
   resolve("My encoded signal string");
 });
}
if (!googletag) googletag = {};
if (!googletag.secureSignalProviders) googletag.secureSignalProviders = [];
googletag.secureSignalProviders.push({
 networkCode: NETWORK_CODE,
 collectorFunction: signalCollector
});

adsLoader = new google.ima.AdsLoader(adDisplayContainer);
...