Güvenli sinyaller

Güvenli sinyaller, istemci cihazda toplanan ve belirli teklif verenlerle paylaşılan kodlanmış verilerdir. Bu kılavuzda, IMA SDK'sını kullanarak güvenli sinyalleri nasıl toplayacağınız ve Google Ad Manager'a nasıl göndereceğiniz gösterilmektedir.

Güvenli sinyaller API'si, iOS için IMA SDK'sının 3.18.1 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 başlıklı makaleyi inceleyin.

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

Güvenli sinyalleri kullanmak için uygulamanızda sinyal toplamak, kodlamak ve IMA SDK'sına iletmek amacıyla bir sinyal toplayıcı adaptör sınıfı dağıtmanız gerekir.

Üçüncü taraf sağlayıcınızın talimatlarını uygulayarak onlarla hesap oluşturun, çerçeveleri dahil edin ve güvenli sinyal bağdaştırıcısını uygulamanızda ayarlayın.

iOS için IMA SDK'sı, kodunuzda herhangi bir 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ı ekleyeceğinize dair bir örnek aşağıda verilmiştir:

Özel veriler gönderme

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

Her reklam isteği için kodlanmış özel verilerinizi dize olarak içeren bir IMASecureSignals nesnesi oluşturun. Ardından, IMAAdsRequest.secureSignals özelliğini çağırarak IMASecureSignals nesnesini reklam isteğinize ekleyin.

Objective-C ve Swift'teki örnekleri aşağıda bulabilirsiniz:

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