פיתוח מתאם אותות מאובטח

אם יש לכם 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 calls the setUpWithConfiguration:completionHandler: method when Google Mobile Ads SDK instantiates your secure signal adapter. משתמשים בשיטה הזו כדי לאתחל את ה-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.

איסוף אותות

בכל בקשה להצגת מודעה, Google Mobile Ads SDK אוסף אותות בו-זמנית מכל המתאמים בשרשור רקע.

בדוגמה הבאה, האותות נאספים ומוחזרים אל Google Mobile Ads SDK באמצעות קריאה אל handler ההשלמה 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 במחרוזת האות המאובטח.

איסוף האותות צריך להסתיים תוך שנייה אחת. אם איסוף האותות נמשך יותר משנייה, כדאי לשקול שמירת אותות במטמון במתאם האותות המאובטחים או ב-SDK כשמפעילים את המתאם.

אם המתאם של אותות מאובטחים לא מצליח לאסוף אותות, צריך להתקשר ל-completion handler עם nil אותות ואובייקט NSError.

טשטוש אותות

כשמשתפים אותות מאובטחים עם מגישי הצעות מחיר ושותפים באוסף, צריך להצפין את האותות.

החזרת ערך nil לתוספים של רשת המודעות

מתאמים של אותות מאובטחים לא דורשים פרמטרים נוספים של רשת.

הדוגמה הבאה מציגה את ה-method +networkExtrasClass שמחזיר ערך nil:

Objective-C

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