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

אם יש לכם 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

אתחול המתאם

‫Google Mobile Ads SDK קורא ל-method‏ setUpWithConfiguration:completionHandler: כש-Google Mobile Ads SDK יוצר מופע של מתאם האותות המאובטחים. משתמשים ב-method הזה כדי להפעיל את ה-SDK.

כשה-SDK מופעל באופן מלא ומוכן לאיסוף אותות על ידי Google Mobile Ads SDK, צריך להפעיל את בלוק ההשלמה (completion block) של 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);
}

דיווח על גרסת המתאם וגרסת ה-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

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

מחליפים את kSDKVersionString במחרוזת של גרסת ה-SDK.

איסוף אותות

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

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

מחליפים את kSampleSignalPlaceholder במחרוזת האותות המאובטחים.

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

אם המתאם של האותות המאובטחים לא מצליח לאסוף אותות, צריך להפעיל את ה-completion handler עם אותות מסוג 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;
}