Phát triển một bộ điều hợp tín hiệu an toàn

Nếu có một SDK nhà cung cấp tín hiệu tạo ra các tín hiệu đặt giá thầu theo thời gian thực (RTB), bạn có thể phát triển một bộ chuyển đổi tín hiệu an toàn để cho phép Google Mobile Ads SDK thu thập tín hiệu từ SDK của bạn.

Google Mobile Ads SDK chuyển tiếp tín hiệu của bạn đến một số Authorized Buyers và người mua Đặt giá thầu mở tham gia.

Sơ đồ sau đây minh hoạ vòng đời yêu cầu-phản hồi để thu thập tín hiệu an toàn:

Bộ chuyển đổi tín hiệu an toàn chịu trách nhiệm về việc khởi chạy bộ chuyển đổi và thu thập tín hiệu.

Triển khai bộ chuyển đổi tín hiệu an toàn

Triển khai bộ chuyển đổi tín hiệu an toàn cho Google Mobile Ads SDK để thu thập tín hiệu từ SDK của bạn.

Hướng dẫn này trình bày cách triển khai một bộ điều hợp tín hiệu an toàn bằng cách mở rộng lớp trừu tượng RtbAdapter.

Ví dụ sau đây mở rộng lớp trừu tượng RtbAdapter:

Java

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

Khởi chạy bộ chuyển đổi

Google Mobile Ads SDK gọi phương thức initialize() khi Google Mobile Ads SDK tạo thực thể cho bộ chuyển đổi tín hiệu an toàn của bạn. Sử dụng phương thức này để khởi chạy SDK.

Khi SDK của bạn khởi chạy hoàn toàn và sẵn sàng để Google Mobile Ads SDK thu thập tín hiệu, hãy gọi lệnh gọi lại InitializationCompleteCallback.

Nếu bộ chuyển đổi tín hiệu an toàn của bạn không gọi lại, thì Google Mobile Ads SDK sẽ không thu thập tín hiệu từ bộ chuyển đổi tín hiệu an toàn của bạn.

Ví dụ sau đây gọi lệnh gọi lại hoàn tất để thông báo cho Google Mobile Ads SDK rằng SDK của bạn đã khởi động thành công:

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

Báo cáo phiên bản bộ chuyển đổi và SDK

Bộ chuyển đổi tín hiệu an toàn phải báo cáo cả phiên bản bộ chuyển đổi và phiên bản SDK. Google Mobile Ads SDK sử dụng các phiên bản này để báo cáo và khắc phục sự cố.

Nếu SDK của bạn triển khai bộ điều hợp này trong cùng một tệp nhị phân, thì bạn có thể trả về cùng một phiên bản cho cả phiên bản bộ điều hợp và SDK.

Ví dụ sau đây trả về phiên bản của bộ chuyển đổi tín hiệu an toàn:

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

Ví dụ sau đây trả về phiên bản SDK mà bộ chuyển đổi tín hiệu an toàn của bạn tương tác:

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

Thay thế SDK_VERSION_STRING bằng chuỗi phiên bản SDK của bạn.

Thu thập tín hiệu

Trong mỗi yêu cầu quảng cáo, Google Mobile Ads SDK sẽ đồng thời thu thập tín hiệu từ tất cả các bộ chuyển đổi trên một luồng nền.

Ví dụ sau đây thu thập và trả về các tín hiệu cho Google Mobile Ads SDK bằng cách gọi phương thức SignalCallbacks.onSuccess():

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

Thay thế SAMPLE_SIGNAL_PLACEHOLDER bằng chuỗi tín hiệu an toàn của bạn.

Quá trình thu thập tín hiệu phải hoàn tất trong vòng một giây. Nếu quá trình thu thập tín hiệu mất hơn một giây, hãy cân nhắc việc lưu tín hiệu vào bộ nhớ đệm trong bộ chuyển đổi tín hiệu an toàn hoặc SDK khi bạn khởi động bộ chuyển đổi.

Nếu bộ chuyển đổi tín hiệu an toàn không thu thập được tín hiệu, hãy truyền một lỗi đến phương thức signalCallbacks.onFailure().

Làm rối mã nguồn tín hiệu

Khi chia sẻ tín hiệu an toàn với bên đặt giá thầu và đối tác tuyển chọn, bạn phải làm rối tín hiệu.