พัฒนาอะแดปเตอร์สัญญาณที่ปลอดภัย

หากคุณมี SDK ของผู้ให้บริการสัญญาณที่สร้างสัญญาณการเสนอราคาแบบเรียลไทม์ (RTB) สัญญาณ คุณสามารถพัฒนาอะแดปเตอร์สัญญาณที่ปลอดภัยเพื่อให้ Google Mobile Ads SDK รวบรวม สัญญาณจาก SDK ของคุณได้

Google Mobile Ads SDK จะส่งต่อสัญญาณของคุณไปยังผู้ซื้อที่เข้าร่วมใน Authorized Buyers และ Open Bidding ที่เลือก

แผนภาพต่อไปนี้แสดงวงจรคำขอ-การตอบกลับสำหรับการรวบรวมสัญญาณที่ปลอดภัย

อะแดปเตอร์สัญญาณที่ปลอดภัยมีหน้าที่รับผิดชอบในการเริ่มต้นใช้งานอะแดปเตอร์และการรวบรวมสัญญาณ

ใช้สัญญาณที่ปลอดภัย

ใช้สัญญาณที่ปลอดภัยสำหรับ Google Mobile Ads SDK เพื่อรวบรวมสัญญาณจาก SDK ของคุณ

คู่มือนี้ครอบคลุมวิธีใช้สัญญาณที่ปลอดภัยโดย การขยายคลาส Abstract RtbAdapter

ตัวอย่างต่อไปนี้ ขยายคลาส Abstract RtbAdapter:

Java

public class SampleAdapterSnippets extends RtbAdapter {

เริ่มต้นใช้งานอะแดปเตอร์

Google Mobile Ads SDK เรียกใช้เมธอด initialize() เมื่อ Google Mobile Ads SDK สร้างอินสแตนซ์ของอะแดปเตอร์สัญญาณที่ปลอดภัย ใช้เมธอดนี้เพื่อเริ่มต้นใช้งาน SDK

เมื่อ SDK เริ่มต้นใช้งานอย่างสมบูรณ์และพร้อมให้ Google Mobile Ads SDK รวบรวม สัญญาณแล้ว ให้เรียกใช้ InitializationCompleteCallback การเรียกกลับ

หากอะแดปเตอร์สัญญาณที่ปลอดภัยไม่เรียกกลับ Google Mobile Ads SDK จะไม่รวบรวม สัญญาณจากอะแดปเตอร์สัญญาณที่ปลอดภัย

ตัวอย่างต่อไปนี้เรียกใช้การเรียกกลับการดำเนินการให้เสร็จสมบูรณ์เพื่อแจ้งให้ Google Mobile Ads SDK ทราบว่า SDK ของคุณเริ่มต้นใช้งานเรียบร้อยแล้ว

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();
}

รายงานเวอร์ชันอะแดปเตอร์และ SDK

อะแดปเตอร์สัญญาณที่ปลอดภัยต้องรายงานทั้งเวอร์ชันอะแดปเตอร์และเวอร์ชัน SDK Google Mobile Ads SDK จะใช้เวอร์ชันเหล่านี้สำหรับการรายงานและการแก้ปัญหา

หาก SDK ใช้เวอร์ชันเดียวกันสำหรับทั้งอะแดปเตอร์และ SDK ในไบนารีเดียวกัน คุณสามารถแสดงเวอร์ชันเดียวกันสำหรับทั้ง 2 เวอร์ชันได้

ตัวอย่างต่อไปนี้แสดงเวอร์ชันของอะแดปเตอร์สัญญาณที่ปลอดภัย

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

ตัวอย่างต่อไปนี้แสดงเวอร์ชัน SDK ที่อะแดปเตอร์สัญญาณที่ปลอดภัยโต้ตอบด้วย

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

แทนที่ SDK_VERSION_STRING ด้วยสตริงเวอร์ชัน SDK

รวบรวมสัญญาณ

ในทุกๆ คำขอโฆษณา Google Mobile Ads SDK จะรวบรวมสัญญาณจากอะแดปเตอร์ทั้งหมดพร้อมกันในเธรดเบื้องหลัง

ตัวอย่างต่อไปนี้รวบรวมและแสดงสัญญาณไปยัง Google Mobile Ads SDK โดยการเรียกใช้เมธอด 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);
}

แทนที่ SAMPLE_SIGNAL_PLACEHOLDER ด้วยสตริงสัญญาณที่ปลอดภัย ของคุณ

การรวบรวมสัญญาณต้องเสร็จสมบูรณ์ภายใน 1 วินาที หากการรวบรวมสัญญาณใช้เวลานานกว่า 1 วินาที ให้พิจารณาแคชสัญญาณในอะแดปเตอร์สัญญาณที่ปลอดภัยหรือ SDK เมื่อเริ่มต้นใช้งานอะแดปเตอร์

หากอะแดปเตอร์สัญญาณที่ปลอดภัยรวบรวมสัญญาณไม่สำเร็จ ให้ส่งข้อผิดพลาดไปยังเมธอด signalCallbacks.onFailure()

ปกปิดสัญญาณ

เมื่อคุณแชร์สัญญาณที่ปลอดภัยกับผู้เสนอราคาและพาร์ทเนอร์การดูแลจัดการ คุณต้องปกปิด สัญญาณ