Güvenli sinyal adaptörü geliştirme

Gerçek zamanlı teklif verme (GZT) sinyalleri oluşturan bir sinyal sağlayıcı SDK'nız varsa Google Mobile Ads SDK'nın SDK'nızdan sinyal toplamasını sağlamak için güvenli sinyal bağdaştırıcısı geliştirebilirsiniz.

Google Mobile Ads SDK, sinyallerinizi seçili katılımcı Authorized Buyers ve Open Bidding alıcılarına yönlendirir.

Aşağıdaki şemada, güvenli sinyal toplama için istek-yanıt yaşam döngüsü gösterilmektedir:

Güvenli sinyal bağdaştırıcısı, bağdaştırıcıyı ilk kullanıma hazırlamaktan ve sinyal toplamaktan sorumludur.

Güvenli sinyal adaptörü uygulama

SDK'nızdan sinyal toplamak için Google Mobile Ads SDK güvenli sinyal bağdaştırıcısı uygulayın.

Bu kılavuzda, GADRTBAdapter protokolünü uygulayarak güvenli sinyal bağdaştırıcısının nasıl uygulanacağı açıklanmaktadır.

Aşağıdaki örnekte GADRTBAdapter protokolü uygulanmaktadır:

Objective-C

@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end
SampleAdapterSnippets.m

Adaptörü başlatma

Google Mobile Ads SDK, güvenli sinyal bağdaştırıcınızı oluşturduğunda Google Mobile Ads SDK yöntemini çağırır.setUpWithConfiguration:completionHandler: SDK'nızı başlatmak için bu yöntemi kullanın.

SDK'nız tamamen başlatıldığında ve Google Mobile Ads SDK sinyalleri toplamaya hazır olduğunda GADMediationAdapterSetUpCompletionBlock tamamlama bloğunu çağırın.

Güvenli sinyal adaptörünüz geri arama yapmazsa Google Mobile Ads SDK, güvenli sinyal adaptörünüzden sinyal toplamaz.

Aşağıdaki örnekte, SDK'nızın başarıyla başlatıldığını Google Mobile Ads SDK'ya bildirmek için completion handler çağrılıyor:

Objective-C

+ (void)setUpWithConfiguration:(GADMediationServerConfiguration *)configuration
             completionHandler:(GADMediationAdapterSetUpCompletionBlock)completionHandler {
  // Add your SDK initialization logic here.

  // Invoke the completionHandler once initialization completes. Pass a nil
  // error to indicate initialization succeeded.
  completionHandler(nil);
}
SampleAdapterSnippets.m

Bağdaştırıcı ve SDK sürümünü bildirme

Güvenli sinyal bağdaştırıcınız hem bağdaştırıcı sürümünüzü hem de SDK sürümünüzü bildirmelidir. Google Mobile Ads SDK, raporlama ve sorun giderme için bu sürümleri kullanır.

SDK'nız bu bağdaştırıcıyı aynı ikili dosyada uyguluyorsa hem bağdaştırıcı hem de SDK sürümleri için aynı sürümü döndürebilirsiniz.

Aşağıdaki örnek, güvenli sinyal bağdaştırıcınızın sürümünü döndürür:

Objective-C

+ (GADVersionNumber)adapterVersion {
  // If your secure signals SDK implements this adapter in the same binary
  // return the same version as your SDK.
  // return [self adSDKVersion];

  // If you built a separate binary for this secure signals adapter, return
  // the adapter's version here.
  GADVersionNumber version = {};
  version.majorVersion = 4;
  version.minorVersion = 5;
  version.patchVersion = 6;
  return version;
}
SampleAdapterSnippets.m

Aşağıdaki örnek, güvenli sinyal bağdaştırıcınızın etkileşimde bulunduğu SDK sürümünü döndürür:

Objective-C

+ (GADVersionNumber)adSDKVersion {
  // Return your SDK's version string here.
  NSString *versionString = kSDKVersionString;
  NSArray<NSString *> *components = [versionString componentsSeparatedByString:@"."];
  GADVersionNumber version = {};
  if (components.count == 3) {
    version.majorVersion = components[0].integerValue;
    version.minorVersion = components[1].integerValue;
    version.patchVersion = components[2].integerValue;
  } else {
    NSLog(@"Unexpected version string: %@. Returning 0.0.0 for adSDKVersion.", versionString);
  }
  return version;
}
SampleAdapterSnippets.m

kSDKVersionString yerine SDK sürümünüzü içeren dizeyi girin.

Sinyal toplama

Google Mobile Ads SDK, her reklam isteğinde arka plan iş parçacığında tüm bağdaştırıcılardan aynı anda sinyal toplar.

Aşağıdaki örnek, GADRTBSignalCompletionHandler tamamlama işleyicisi çağrılarak Google Mobile Ads SDK için sinyalleri toplar ve döndürür:

Objective-C

- (void)collectSignalsForRequestParameters:(GADRTBRequestParameters *)params
                         completionHandler:(GADRTBSignalCompletionHandler)handler {
  // Add your signal collection logic here.
  NSString *signals = kSampleSignalPlaceholder;

  // Return the signals as a string to the Google Mobile Ads SDK.
  handler(signals, nil);
}
SampleAdapterSnippets.m

kSampleSignalPlaceholder kısmını güvenli sinyal dizenizle değiştirin.

Sinyal toplama işlemi bir saniye içinde tamamlanmalıdır. Sinyal toplama işlemi bir saniyeden uzun sürerse bağdaştırıcıyı başlatırken güvenli sinyal bağdaştırıcınızda veya SDK'nızda sinyalleri önbelleğe almayı düşünebilirsiniz.

Güvenli sinyal bağdaştırıcınız sinyal toplayamazsa, tamamlama işleyicisini nil sinyalleri ve NSError nesnesiyle çağırın.

Sinyalleri karartma

Güvenli sinyalleri teklif verenlerle ve seçim iş ortaklarıyla paylaştığınızda sinyalleri karartmanız gerekir.

Reklam ağı ekstraları için nil değeri döndürme

Güvenli sinyal bağdaştırıcıları için ek ağ parametreleri gerekmez.

Aşağıdaki örnek +networkExtrasClass yöntemi nil değerini döndürür:

Objective-C

+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
  // Network extras are not applicable because signal providers do not request ads.
  return nil;
}
SampleAdapterSnippets.m