หากคุณมี SDK ของผู้ให้บริการสัญญาณที่สร้างสัญญาณการเสนอราคาแบบเรียลไทม์ (RTB) คุณสามารถพัฒนาอะแดปเตอร์สัญญาณที่ปลอดภัยเพื่อให้ Google Mobile Ads SDK รวบรวมสัญญาณจาก SDK ของคุณได้
Google Mobile Ads SDK จะส่งต่อสัญญาณของคุณไปยังผู้ซื้อ Authorized Buyers และการเสนอราคาแบบเปิดที่เข้าร่วมและได้รับเลือก
แผนภาพต่อไปนี้แสดงวงจรคำขอ-การตอบกลับสำหรับการรวบรวมสัญญาณที่ปลอดภัย
อะแดปเตอร์สัญญาณที่ปลอดภัยมีหน้าที่รับผิดชอบในการเริ่มต้นอะแดปเตอร์และการรวบรวมสัญญาณ
ติดตั้งใช้งานอะแดปเตอร์สัญญาณที่ปลอดภัย
ติดตั้งใช้งานอะแดปเตอร์สัญญาณที่ปลอดภัยสำหรับ Google Mobile Ads SDK เพื่อรวบรวมสัญญาณจาก SDK ของคุณ
คู่มือนี้จะอธิบายวิธีติดตั้งใช้งานอะแดปเตอร์สัญญาณที่ปลอดภัยโดยการติดตั้งใช้งานโปรโตคอล GADRTBAdapter
ตัวอย่างต่อไปนี้ใช้โปรโตคอล GADRTBAdapter
Objective-C
@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end
เริ่มต้นอะแดปเตอร์
Google Mobile Ads SDK จะเรียกใช้เมธอด setUpWithConfiguration:completionHandler: เมื่อ Google Mobile Ads SDK สร้างอินสแตนซ์ของอะแดปเตอร์สัญญาณที่ปลอดภัย ใช้เมธอดนี้เพื่อเริ่มต้น SDK
เมื่อ SDK เริ่มต้นอย่างสมบูรณ์และพร้อมให้ Google Mobile Ads SDK รวบรวมสัญญาณ ให้เรียกบล็อกการดำเนินการ GADMediationAdapterSetUpCompletionBlock ให้เสร็จสมบูรณ์
หากอะแดปเตอร์สัญญาณที่ปลอดภัยไม่เรียกกลับ Google Mobile Ads SDK จะไม่รวบรวมสัญญาณจากอะแดปเตอร์สัญญาณที่ปลอดภัย
ตัวอย่างต่อไปนี้จะเรียกใช้ตัวแฮนเดิลการดำเนินการเสร็จสมบูรณ์เพื่อแจ้งให้ 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);
}
รายงานเวอร์ชันอะแดปเตอร์และ 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;
}
ตัวอย่างต่อไปนี้จะแสดงผลเวอร์ชันของ SDK ที่อะแดปเตอร์สัญญาณที่ปลอดภัยโต้ตอบด้วย
Objective-C
แทนที่ kSDKVersionString ด้วยสตริงเวอร์ชัน SDK ของคุณ
รวบรวมสัญญาณ
ในคำขอโฆษณาทุกรายการ Google Mobile Ads SDK จะรวบรวมสัญญาณพร้อมกันจากอะแดปเตอร์ทั้งหมดในชุดข้อความเบื้องหลัง
ตัวอย่างต่อไปนี้จะรวบรวมและแสดงผลสัญญาณไปยัง Google Mobile Ads SDK โดยเรียกใช้แฮนเดิลการดำเนินการเสร็จสมบูรณ์ GADRTBSignalCompletionHandler
Objective-C
แทนที่ kSampleSignalPlaceholder ด้วยสตริงสัญญาณที่ปลอดภัย
การรวบรวมสัญญาณต้องเสร็จสมบูรณ์ภายใน 1 วินาที หากการรวบรวมสัญญาณใช้เวลานานกว่า 1 วินาที ให้พิจารณาแคชสัญญาณในอะแดปเตอร์สัญญาณที่ปลอดภัยหรือ SDK เมื่อคุณเริ่มต้นอะแดปเตอร์
หากอะแดปเตอร์สัญญาณที่ปลอดภัยรวบรวมสัญญาณไม่สำเร็จ
ให้เรียกใช้แฮนเดิลการดำเนินการเสร็จสมบูรณ์ด้วยสัญญาณ nil และออบเจ็กต์ NSError
สร้างความสับสนให้กับสัญญาณ
เมื่อแชร์สัญญาณที่ปลอดภัยกับผู้เสนอราคาและพาร์ทเนอร์การดูแลจัดการ คุณต้องสร้างความสับสนให้สัญญาณ
แสดงผลค่า nil สำหรับข้อมูลเพิ่มเติมของเครือข่ายโฆษณา
อะแดปเตอร์สัญญาณที่ปลอดภัยไม่จำเป็นต้องใช้พารามิเตอร์ข้อมูลเพิ่มเติมของเครือข่าย
เมธอด +networkExtrasClass ตัวอย่างต่อไปนี้จะแสดงผลค่า nil
Objective-C
+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
// Network extras are not applicable because signal providers do not request ads.
return nil;
}