Mulai menggunakan sinyal aman

Sinyal aman adalah data yang dienkode yang dikumpulkan di perangkat klien dan dibagikan kepada bidder tertentu. Panduan ini menunjukkan cara mengumpulkan dan mengirim sinyal aman ke Google Ad Manager menggunakan IMA SDK.

API sinyal aman memerlukan IMA SDK untuk iOS versi 3.18.1 atau yang lebih tinggi.

Untuk memilih sinyal dan bidder, serta mengaktifkan berbagi sinyal aman, lihat Membagikan sinyal aman kepada bidder.

Menggunakan penyedia sinyal pihak ketiga

Untuk menggunakan sinyal aman, Anda harus men-deploy class adaptor pengumpul sinyal di aplikasi Anda untuk mengumpulkan sinyal, mengenkodnya, dan meneruskannya ke IMA SDK.

Ikuti petunjuk penyedia pihak ketiga untuk menyiapkan akun di sana, sertakan framework, dan siapkan adaptor sinyal aman mereka di aplikasi Anda.

IMA SDK untuk iOS secara otomatis menginisialisasi setiap adaptor sinyal aman, tanpa perubahan tambahan pada kode Anda.

Berikut adalah contoh cara menambahkan adaptor sinyal aman ke project Anda:

Mengirim data kustom

Selain menggunakan penyedia sinyal pihak ketiga, Anda juga dapat mengumpulkan, mengenkode, dan mengirim sinyal dengan data kustom. Sebelum dapat mengirim sinyal aman dengan data kustom, Anda harus mengaktifkan sinyal kustom di Ad Manager.

Untuk setiap permintaan iklan, buat objek IMASecureSignals yang berisi data kustom yang dienkode sebagai string. Kemudian, tambahkan objek IMASecureSignals ke permintaan iklan Anda dengan memanggil atribut IMAAdsRequest.secureSignals.

Berikut adalah contoh dalam Objective-C dan Swift:

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