הגדרה

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

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

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

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

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

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

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

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

שם הכיתה

השם המלא של המחלקה שבה מוטמע מתאם האירועים בהתאמה אישית, למשל com.google.ads.mediation.sample.customevent.SampleCustomEvent. כשיטה מומלצת, מומלץ להשתמש בסוג מתאם אחד לכל הפורמטים של המודעות בהתאמה אישית של אירועים.

תווית

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

פרמטר

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

לאתחל את המתאם

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

Java

package com.google.ads.mediation.sample.customevent;

import com.google.android.gms.ads.AdFormat;
import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.InitializationCompleteCallback;
import com.google.android.gms.ads.mediation.MediationConfiguration;
...

public class SampleAdNetworkCustomEvent extends Adapter {

    private static final String SAMPLE_AD_UNIT_KEY = "parameter";

    private InitializationCompleteCallback initializationCallback;

    @Override
    public void initialize(Context context,
            InitializationCompleteCallback initializationCompleteCallback,
            List<MediationConfiguration> mediationConfigurations) {
        // 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.
        initializationCompleteCallback.onInitializationSucceeded();
    }
}

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

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

Java

package com.google.ads.mediation.sample.customevent;

public class SampleCustomEvent extends Adapter {

  @Override
  public VersionInfo getVersionInfo() {
    String versionString = new VersionInfo(1, 2, 3);
    String[] splits = versionString.split("\\.");

    if (splits.length >= 4) {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]) * 100 + Integer.parseInt(splits[3]);
      return new VersionInfo(major, minor, micro);
    }

    return new VersionInfo(0, 0, 0);
  }

  @Override
  public VersionInfo getSDKVersionInfo() {
    String versionString = SampleAdRequest.getSDKVersion();
    String[] splits = versionString.split("\\.");

    if (splits.length >= 3) {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    }

    return new VersionInfo(0, 0, 0);
  }
}

בקשת מודעה

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

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