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, RtbAdapter soyut sınıfını genişleterek güvenli sinyal adaptörünün nasıl uygulanacağı açıklanmaktadır.

Aşağıdaki örnekte RtbAdapter soyut sınıfı genişletilmektedir:

Java

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

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.initialize() SDK'nızı başlatmak için bu yöntemi kullanın.

SDK'nız tamamen ilk kullanıma hazırlandığında ve Google Mobile Ads SDK'nın sinyal toplamasına hazır olduğunda InitializationCompleteCallback geri çağırmasını ç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 tamamlama geri çağırması çağrılıyor: callback to inform Google Mobile Ads SDK that your SDK has initialized successfully:

Java

@Override
public void initialize(
    Context context,
    InitializationCompleteCallback initializationCompleteCallback,
    List<MediationConfiguration> configurations) {

  // Add your SDK initialization logic here.

  // Invoke the InitializationCompleteCallback once initialization completes.
  initializationCompleteCallback.onInitializationSucceeded();
}

SampleAdapterSnippets.java

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:

Java

@Override
public VersionInfo getVersionInfo() {
  // If your SDK implements this adapter in the same binary, return
  // the same version as your SDK.
  // return getSDKVersionInfo();

  // If you built a separate binary for this adapter, return
  // the adapter's version here.
  int major = 4;
  int minor = 5;
  int micro = 6;
  return new VersionInfo(major, minor, micro);
}

SampleAdapterSnippets.java

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:

Java

@Override
public VersionInfo getSDKVersionInfo() {

  // Return your SDK's version string here.
  String versionString = SDK_VERSION_STRING;
  String[] splits = versionString.split("\\.");
  if (splits.length >= 3) {
    try {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    } catch (NumberFormatException e) {
      // Fall through to log warning and return 0.0.0.
    }
  }

  Log.w(
      TAG,
      String.format(
          "Unexpected SDK version format: %s. Returning 0.0.0 for SDK version.", versionString));
  return new VersionInfo(0, 0, 0);
}

SampleAdapterSnippets.java

SDK_VERSION_STRING 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, SignalCallbacks.onSuccess() yöntemi çağrılarak Google Mobile Ads SDK için sinyaller toplar ve döndürür:

Java

@Override
public void collectSignals(RtbSignalData rtbSignalData, SignalCallbacks signalCallbacks) {

  // Add your signal collection logic here.
  String signals = SAMPLE_SIGNAL_PLACEHOLDER;

  // Return the signals as a string to the Google Mobile Ads SDK.
  signalCallbacks.onSuccess(signals);
}

SampleAdapterSnippets.java

SAMPLE_SIGNAL_PLACEHOLDER yerine güvenli sinyal dizenizi girin.

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 toplamayı başaramazsa, signalCallbacks.onFailure() yöntemine bir hata iletin.

Sinyalleri karartma

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