Erste Schritte mit sicheren Signalen

Plattform auswählen: HTML5 Android iOS tvOS

Sichere Signale sind codierte Daten, die auf dem Clientgerät erhoben und mit ausgewählten Bietern geteilt werden. In diesem Leitfaden erfahren Sie, wie Sie mit dem IMA SDK sichere Signale erfassen und an Google Ad Manager senden.

Für die Secure Signals API ist Version 4.8.2 oder höher des IMA SDK für tvOS 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.

Signalprovider eines Drittanbieters verwenden

Wenn Sie sichere Signale verwenden möchten, müssen Sie in Ihrer App eine Adapterklasse für die Signalerfassung bereitstellen, um Signale zu erfassen, zu codieren und an das IMA SDK zu übergeben.

Folgen Sie der Anleitung des Drittanbieters, um ein Konto bei ihm einzurichten, Frameworks einzubinden und den Adapter für sichere Signale in Ihrer App einzurichten.

Das IMA SDK für tvOS initialisiert jeden Adapter für sichere Signale automatisch, ohne dass zusätzliche Änderungen am Code erforderlich sind.

Hier ein Beispiel dafür, wie Sie Ihrem Projekt einen Adapter für sichere Signale hinzufügen können:

Benutzerdefinierte Daten senden

Zusätzlich zur Verwendung eines Drittanbieters für Signale können Sie auch Signale 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.

Gehen Sie für jede Anzeigenanfrage so vor:

1. Erstellen Sie ein IMASecureSignals-Objekt, das Ihre codierten benutzerdefinierten Daten als String enthält.
2. Fügen Sie das Objekt IMASecureSignals Ihrer Anzeigenanfrage hinzu, indem Sie das Attribut IMAAdsRequest.secureSignals festlegen:

Objective-C

BasicExample/ViewController.m

...
- (void)requestAds {
  // Create an ad display container for ad rendering.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];
  // Create an ad request with our ad tag, display container, and optional user context.
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kTestAppAdTagUrl
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:self.contentPlayhead
                                                       userContext:nil];
  
  IMASecureSignals *signals =
      [[IMASecureSignals alloc] initWithCustomData:@"My encoded signal string"];
  request.secureSignals = signals;
  
  [self.adsLoader requestAdsWithRequest:request];
}
...

Swift

BasicExample/ViewController.swift

...
private func requestAds() {
  // Create ad display container for ad rendering.
  let adDisplayContainer = IMAAdDisplayContainer(
    adContainer: videoView, viewController: self, companionSlots: nil)
  // Create an ad request with our ad tag, display container, and optional user context.
  let request = IMAAdsRequest(
    adTagUrl: ViewController.testAppAdTagURL,
    adDisplayContainer: adDisplayContainer,
    contentPlayhead: contentPlayhead,
    userContext: nil)
  
  let signals = IMASecureSignals(customData: "My encoded signal string")
  request.secureSignals = signals
  
  adsLoader.requestAds(with: request)
}
...