Adapter für sichere Signale einbinden

Plattform auswählen: HTML5 Android iOS tvOS

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

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

Drittanbieter für Signale verwenden

Wenn Sie sichere Signale verwenden möchten, müssen Sie ein Script zur Signalerfassung auf Ihrer Website bereitstellen, um Signale zu erheben, zu codieren und an das IMA SDK zu übergeben.

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

Automatisch bereitstellen

Wenn Sie in Ad Manager Signalanbieter auswählen, wird je nach Auswahl möglicherweise die Option Google bitten, das Script zur Signalerfassung in Ihrem Namen bereitzustellen angezeigt. Wenn Sie diese Option auswählen und Ihre Website enthält Google Publisher-Tags, 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 Datei index.html Ihrer Website:

<script src="//imasdk.googleapis.com/js/sdkloader/ima3_dai.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="dai.js"></script>

Manuell bereitstellen

Wenn die Option Google bitten, das Script zur Signalerfassung in Ihrem Namen bereitzustellen in Ad Manager nicht angezeigt wird oder Sie sie nicht aktivieren, müssen Sie einen Scriptlink von Ihrem Anbieter für sichere Signale abrufen und ihn manuell in Ihr Projekt einfügen.

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

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

<script src="//imasdk.googleapis.com/js/sdkloader/ima3_dai.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="dai.js"></script>

Benutzerdefinierte Daten senden

Neben der Verwendung eines Drittanbieters für Signale können Sie auch Signale mit benutzerdefinierten Daten erheben, codieren und senden. Bevor Sie sichere Signale mit benutzerdefinierten Daten senden können, müssen Sie in Ad Manager benutzerdefinierte Signale aktivieren.

So gehen Sie bei HTML5-Projekten vor:

  1. Erstellen Sie ein Objekt mit den folgenden Attributen: networkCode und collectorFunction.
  2. Füllen Sie das Attribut networkCode mit Ihrem Netzwerkcode.
  3. Füllen Sie das Attribut collectorFunction mit einer Funktion, die ein Promise zurückgibt, das in Ihre codierten Signale aufgelöst wird.

Übertragen Sie das Objekt in das googletag.secureSignalProviders Array, bevor Sie Ihre `streamManager`-Instanz erstellen, damit das IMA SDK darauf zugreifen kann, um Ihre codierten Signale abzurufen und zu übertragen:

Hier ein JavaScript-Beispiel:

console.log("initializing IMA");
videoElement = document.getElementById('video');
adUiElement = document.getElementById('adUi');

const NETWORK_CODE = '21775744923';

/**
 * Sample signal collector function.
 * @return {!Promise<string>} A promise that resolves to the encoded signals.
 */
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
});

streamManager = new google.ima.dai.api.StreamManager(videoElement, adUiElement);