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

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

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

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

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

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

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

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

ตัวอย่างต่อไปนี้ ใช้โปรโตคอล GADRTBAdapter

Objective-C

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

เริ่มต้นอะแดปเตอร์

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

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

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

ตัวอย่างต่อไปนี้เรียกใช้ตัวแฮนเดิล completion handler เพื่อแจ้งให้ Google Mobile Ads SDK ทราบว่า SDK เริ่มต้นทํางานสําเร็จแล้ว

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

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

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

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

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

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

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

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 ด้วยเวอร์ชัน SDK string

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

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

ตัวอย่างต่อไปนี้จะรวบรวมและแสดงสัญญาณไปยัง Google Mobile Ads SDK โดยการเรียกใช้ตัวแฮนเดิลการดำเนินการ GADRTBSignalCompletionHandler ให้เสร็จสมบูรณ์

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 ด้วย สตริงสัญญาณที่ปลอดภัย

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

หากอแดปเตอร์สัญญาณที่ปลอดภัยรวบรวมสัญญาณไม่สำเร็จ ให้เรียกตัวแฮนเดิลการดำเนินการให้เสร็จสมบูรณ์ด้วยnilสัญญาณและออบเจ็กต์ NSError

ปิดบังสัญญาณ

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

แสดงค่า nil สำหรับส่วนเสริมของเครือข่ายโฆษณา

Secure Signal Adapters ไม่จำเป็นต้องมีพารามิเตอร์เพิ่มเติมในเครือข่าย

ตัวอย่างต่อไปนี้ เมธอด +networkExtrasClass จะแสดงค่า nil

Objective-C

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