Erste Schritte mit sicheren Signalen

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.

Für die API für sichere Signale ist Version 3.29.0 oder höher des IMA SDK für Android erforderlich.

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 in Ihrer App eine Adapterklasse für die Signalerhebung bereitstellen, um Signale zu erheben, zu codieren und an das IMA SDK zu übergeben.

Folgen Sie der Anleitung des Drittanbieters, um ein Konto einzurichten, Build-Abhängigkeiten hinzuzufügen, und den Adapter für sichere Signale in Ihrer App einzurichten.

Das IMA SDK für Android initialisiert automatisch jeden Adapter für sichere Signale, ohne dass Sie Änderungen am Code vornehmen müssen.

So fügen Sie Ihrem Projekt beispielsweise einen Adapter für sichere Signale hinzu:

Benutzerdefinierte Daten senden

Sie können nicht nur einen Drittanbieter für Signale verwenden, sondern 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.

Führen Sie für jede Streamanfrage die folgenden Schritte aus:

  1. Erstellen Sie ein SecureSignals-Objekt, das Ihre codierten benutzerdefinierten Daten als String enthält.
  2. Fügen Sie das SecureSignals Objekt Ihrer Streamanfrage hinzu , indem Sie die streamRequest.setSecureSignals() Methode aufrufen:

app/src/main/java/com/example/project name/SampleAdsWrapper.java

 public void requestAndPlayAds() {
    adsLoader.addAdErrorListener(this);
    adsLoader.addAdsLoadedListener(this);
    StreamRequest request = buildStreamRequest();
    SecureSignals signal = SecureSignals.create("My encoded signal string");
    request.setSecureSignals(signal);
    request.setFormat(StreamFormat.HLS);
    adsLoader.requestStream(request);
  }