הגדרת אירועים בהתאמה אישית

בחירת פלטפורמה: Android iOS Unity Android (גרסה קודמת)

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

במאגר שלנו ב-GitHub יש פרויקט לדוגמה של אירוע בהתאמה אישית.

דרישות מוקדמות

כדי ליצור אירועים מותאמים אישית, צריך קודם לשלב באפליקציה אחד מהפורמטים הבאים של מודעות:

• Banner
• מעברון
• מודעות מותאמות
• מודעות מתגמלות

יצירת אירוע מותאם אישית בממשק המשתמש

קודם צריך ליצור אירוע מותאם אישית בממשק המשתמש של AdMob. אפשר לעיין בהוראות במאמר הוספה של אירוע מותאם אישית.

צריך לספק את הפרטים הבאים:

שם המחלקה

השם המלא של המחלקה שמטמיעה את המתאם של האירוע המותאם אישית – לדוגמה, SampleCustomEvent. אם המחלקה מוטמעת ב-Swift, השם המלא הוא MediationExample.SampleCustomEventSwift.

אם יש כמה יעדים בפרויקט או אם שם הפרויקט שונה משם היעד, צריך לציין את שם היעד. עם שם היעד, זה ייראה כך: appName_targetName.className. בנוסף, חשוב לזכור להחליף כל תווים אלפאנומריים שאינם, כמו מקפים, בקו תחתון. דוגמה.

תווית

שם ייחודי שמגדיר את מקור המודעות.

פרמטר

ארגומנט מחרוזת אופציונלי שמועבר למתאם האירועים בהתאמה אישית.

הטמעה של GADMediationAdapter

השלב הראשון ביצירת אירוע בהתאמה אישית הוא הטמעת הפרוטוקול GADMediationAdapter, כפי שמוצג על ידי המחלקה SampleCustomEvent בדוגמה שלנו.

המחלקה הזו אחראית לקבל הודעות מ-AdMob ולהעביר את האחריות ליצירת פורמט המודעה הנכון.

אתחול המתאם

כש-Google Mobile Ads SDK מופעל, setUpWithConfiguration:completionHandler: מופעל בכל המתאמים הנתמכים של צד שלישי ובאירועים בהתאמה אישית שהוגדרו לאפליקציה בממשק המשתמש של AdMob. השתמשו בשיטה הזו כדי לבצע את כל ההגדרות או ההפעלות הנדרשות ב-SDK של הצד השלישי שנדרש לאירוע המותאם אישית.

Swift

import GoogleMobileAds

class SampleCustomEvent: NSObject, MediationAdapter {

  static func setUpWith(
    _ configuration: MediationServerConfiguration,
    completionHandler: @escaping GADMediationAdapterSetUpCompletionBlock
  ) {
    // This is where you will initialize the SDK that this custom event is built
    // for. Upon finishing the SDK initialization, call the completion handler
    // with success.
    completionHandler(nil)
  }
}

Objective-C

#import "SampleCustomEvent.h"

@implementation SampleCustomEvent

+ (void)setUpWithConfiguration:(nonnull GADMediationServerConfiguration *)configuration
             completionHandler:(nonnull GADMediationAdapterSetUpCompletionBlock)completionHandler {
  // This is where you initialize the SDK that this custom event is built
  // for. Upon finishing the SDK initialization, call the completion handler
  // with success.
  completionHandler(nil);
}

מספרי גרסאות של דוחות

כל האירועים המותאמים אישית חייבים לדווח ל-Google Mobile Ads SDK גם על הגרסה של מתאם האירועים המותאמים אישית עצמו וגם על הגרסה של ה-SDK של הצד השלישי שאיתו האירוע המותאם אישית מתממשק. הגרסאות מדווחות כאובייקטים מסוג GADVersionNumber:

Swift

static func adSDKVersion() -> VersionNumber {
  let versionComponents = String(SampleSDKVersion).components(
    separatedBy: ".")

  if versionComponents.count >= 3 {
    let majorVersion = Int(versionComponents[0]) ?? 0
    let minorVersion = Int(versionComponents[1]) ?? 0
    let patchVersion = Int(versionComponents[2]) ?? 0

    return VersionNumber(
      majorVersion: majorVersion, minorVersion: minorVersion, patchVersion: patchVersion)
  }

  return VersionNumber()
}

static func adapterVersion() -> VersionNumber {
  let versionComponents = String(SampleAdSDK.SampleAdSDKVersionNumber).components(
    separatedBy: ".")
  var version = VersionNumber()
  if versionComponents.count == 4 {
    version.majorVersion = Int(versionComponents[0]) ?? 0
    version.minorVersion = Int(versionComponents[1]) ?? 0
    version.patchVersion = Int(versionComponents[2]) * 100 + Int(versionComponents[3])
  }
  return version
}

Objective-C

+ (GADVersionNumber)adSDKVersion {
  NSArray *versionComponents =
      [SampleSDKVersion componentsSeparatedByString:@"."];
  GADVersionNumber version = {0};
  if (versionComponents.count >= 3) {
    version.majorVersion = [versionComponents[0] integerValue];
    version.minorVersion = [versionComponents[1] integerValue];
    version.patchVersion = [versionComponents[2] integerValue];
  }
  return version;
}

+ (GADVersionNumber)adapterVersion {
  NSArray *versionComponents =
      [SampleCustomEventAdapterVersion componentsSeparatedByString:@"."];
  GADVersionNumber version = {0};
  if (versionComponents.count == 4) {
    version.majorVersion = [versionComponents[0] integerValue];
    version.minorVersion = [versionComponents[1] integerValue];
    version.patchVersion = [versionComponents[2] integerValue] * 100 +
                           [versionComponents[3] integerValue];
  }
  return version;
}

בקשה להצגת מודעה

כדי לבקש מודעה, צריך לפעול לפי ההוראות הספציפיות לפורמט המודעה:

• Banner
• מעברון
• מודעות מותאמות
• מודעות מתגמלות