Güvenli sinyalleri kullanmaya başlayın

Platform seçin: HTML5 Android iOS tvOS

Güvenli sinyaller, istemci cihazda toplanan ve belirli teklif verenlerle paylaşılan kodlanmış verilerdir. Bu kılavuzda, IMA SDK'yı kullanarak güvenli sinyalleri nasıl toplayıp Google Ad Manager'a göndereceğiniz açıklanmaktadır.

Güvenli sinyaller API'si, tvOS için IMA SDK'nın 4.8.2 veya sonraki bir sürümünü gerektirir.

Sinyalleri ve teklif verenleri seçmek ve güvenli sinyal paylaşımını etkinleştirmek için Güvenli sinyalleri teklif verenlerle paylaşma bölümüne bakın.

Üçüncü taraf sinyal sağlayıcı kullanma

Güvenli sinyalleri kullanmak için uygulamanızda sinyal toplayıcı bağdaştırıcı sınıfı dağıtarak sinyalleri toplamanız, kodlamanız ve IMA SDK'ya iletmeniz gerekir.

Üçüncü taraf sağlayıcınızda hesap oluşturmak, çerçeveleri eklemek ve uygulamanızda güvenli sinyal bağdaştırıcısını ayarlamak için sağlayıcınızın talimatlarını uygulayın.

tvOS için IMA SDK'sı, kodunuzda ek değişiklik yapmadan her güvenli sinyal bağdaştırıcısını otomatik olarak başlatır.

Projenize nasıl güvenli sinyal bağdaştırıcısı ekleyebileceğinizle ilgili bir örneği aşağıda bulabilirsiniz:

Müşteri verileri gönderme

Üçüncü taraf sinyal sağlayıcı kullanmanın yanı sıra müşteri verileriyle sinyal toplayabilir, kodlayabilir ve gönderebilirsiniz. Özel verilerle güvenli sinyaller gönderebilmek için Ad Manager'da özel sinyalleri etkinleştirmeniz gerekir.

Her reklam isteği için aşağıdakileri yapın:

1. Kodlanmış özel verilerinizi dize olarak içeren bir IMASecureSignals nesnesi oluşturun.
2. IMAAdsRequest.secureSignals özelliğini ayarlayarak reklam isteğinize IMASecureSignals nesnesini ekleyin:

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)
}
...