Gerçek zamanlı teklif verme (GZT) sinyalleri oluşturan bir sinyal sağlayıcı SDK'nız varsa Google Mobile Ads SDK'ı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çilen 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ının ilk kullanıma hazırlanmasından ve sinyal toplama işleminden sorumludur.
Güvenli sinyal bağdaştırıcısı uygulama
SDK'nızdan sinyal toplamak için Google Mobile Ads SDK için 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
Bağdaştırıcıyı başlatma
Google Mobile Ads SDK, güvenli sinyal bağdaştırıcınızı örneklendirdiğinde Google Mobile Ads SDK,
setUpWithConfiguration:completionHandler: yöntemini
çağırır. 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 tarafından sinyal toplanmaya hazır olduğunda
GADMediationAdapterSetUpCompletionBlock tamamlama bloğunu çağırın.
Güvenli sinyal bağdaştırıcınız geri çağırma yapmazsa Google Mobile Ads SDK, güvenli sinyal bağdaştırıcınızdan sinyal toplamaz.
Aşağıdaki örnekte, SDK'nızın başarıyla başlatıldığını Google Mobile Ads SDK platformuna bildirmek için tamamlama işleyicisi çağrılmaktadır:
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);
}
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, bu sürümleri raporlama ve sorun giderme için kullanır.
SDK'nız bu bağdaştırıcıyı aynı ikili programda 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 örnekte, güvenli sinyal bağdaştırıcınızın sürümü döndürülü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;
}
Aşağıdaki örnekte, güvenli sinyal bağdaştırıcınızın etkileşimde bulunduğu SDK sürümü döndürülür:
Objective-C
kSDKVersionString yerine SDK sürümünüzün dizesini yazın.
Sinyal toplama
Her reklam isteğinde Google Mobile Ads SDK, arka plan iş parçacığındaki tüm bağdaştırıcılardan aynı anda sinyal toplar.
Aşağıdaki örnekte, GADRTBSignalCompletionHandler tamamlama işleyicisi çağrılarak sinyaller toplanır ve Google Mobile Ads SDK
öğesine döndürülür:
Objective-C
kSampleSignalPlaceholder değerini 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ürüyorsa bağdaştırıcıyı başlattığınızda 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
nil sinyalleri ve bir NSError nesnesiyle tamamlama işleyicisini çağırın.
Sinyalleri gizleme
Güvenli sinyalleri teklif verenlerle ve seçim iş ortaklarıyla paylaştığınızda sinyalleri gizlemeniz gerekir.
Reklam ağı ekstraları için nil değeri döndürün
Güvenli sinyal bağdaştırıcıları için ek ağ ekstraları parametreleri gerekmez.
Aşağıdaki örnek +networkExtrasClass yöntemi bir nil değeri döndürür:
Objective-C
+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
// Network extras are not applicable because signal providers do not request ads.
return nil;
}