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

אם יש לכם SDK של ספק אותות שמפיק אותות לבידינג בזמן אמת (RTB), אתם יכולים לפתח מתאם אותות מאובטח כדי לאפשר ל-Google Mobile Ads SDK (Legacy) לאסוף אותות מה-SDK שלכם.

‫Google Mobile Ads SDK (Legacy) מעביר את האותות שלכם לקונים משתתפים נבחרים ב-Authorized Buyers וב-Open Bidding.

בתרשים הבא מוצג מחזור החיים של בקשה ותגובה לאיסוף מאובטח של אותות:

מתאם אותות מאובטח אחראי להפעלת המתאם ולאיסוף האותות.

הטמעה של מתאם אותות מאובטח

מטמיעים מתאם אותות מאובטח עבור Google Mobile Ads SDK (Legacy) כדי לאסוף אותות מ-SDK.

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

בדוגמה הבאה מוצג שימוש במחלקה המופשטת RtbAdapter:

Java

public class SampleAdapterSnippets extends RtbAdapter {

אתחול המתאם

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

כשערכת ה-SDK מאותחלת באופן מלא ומוכנה לאיסוף אותות על ידי Google Mobile Ads SDK (Legacy), צריך להפעיל את הקריאה החוזרת InitializationCompleteCallback.

אם המתאם של האותות המאובטחים לא מבצע קריאה חוזרת, Google Mobile Ads SDK (Legacy) לא אוסף אותות מהמתאם של האותות המאובטחים.

בדוגמה הבאה, מתבצעת קריאה ל-callback של השלמת הפעולה כדי להודיע ל-Google Mobile Ads SDK (Legacy) שה-SDK הופעל בהצלחה:

Java

@Override
public void initialize(
    Context context,
    InitializationCompleteCallback initializationCompleteCallback,
    List<MediationConfiguration> configurations) {

  // Add your SDK initialization logic here.

  // Invoke the InitializationCompleteCallback once initialization completes.
  initializationCompleteCallback.onInitializationSucceeded();
}

דיווח על המתאם ועל גרסת ה-SDK

מתאם האותות המאובטח צריך לדווח על גרסת המתאם ועל גרסת ה-SDK. ‫Google Mobile Ads SDK (Legacy) משתמש בגרסאות האלה לדיווח ולפתרון בעיות.

אם ה-SDK מטמיע את המתאם הזה באותו קובץ בינארי, אפשר להחזיר את אותה גרסה גם עבור המתאם וגם עבור גרסת ה-SDK.

בדוגמה הבאה מוחזרת הגרסה של המתאם של האות המאובטח:

Java

@Override
public VersionInfo getVersionInfo() {
  // If your SDK implements this adapter in the same binary, return
  // the same version as your SDK.
  // return getSDKVersionInfo();

  // If you built a separate binary for this adapter, return
  // the adapter's version here.
  int major = 4;
  int minor = 5;
  int micro = 6;
  return new VersionInfo(major, minor, micro);
}

בדוגמה הבאה מוחזרת גרסת ה-SDK שאיתה מתאם האותות המאובטחים שלך מתקשר:

Java

@Override
public VersionInfo getSDKVersionInfo() {

  // Return your SDK's version string here.
  String versionString = SDK_VERSION_STRING;
  String[] splits = versionString.split("\\.");
  if (splits.length >= 3) {
    try {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    } catch (NumberFormatException e) {
      // Fall through to log warning and return 0.0.0.
    }
  }

  Log.w(
      TAG,
      String.format(
          "Unexpected SDK version format: %s. Returning 0.0.0 for SDK version.", versionString));
  return new VersionInfo(0, 0, 0);
}

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

איסוף אותות

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

בדוגמה הבאה נאספים אותות ומוחזרים ל-Google Mobile Ads SDK (Legacy) באמצעות קריאה למתודה SignalCallbacks.onSuccess():

Java

@Override
public void collectSignals(RtbSignalData rtbSignalData, SignalCallbacks signalCallbacks) {

  // Add your signal collection logic here.
  String signals = SAMPLE_SIGNAL_PLACEHOLDER;

  // Return the signals as a string to the Google Mobile Ads SDK.
  signalCallbacks.onSuccess(signals);
}

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

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

אם מתאם האותות המאובטח לא מצליח לאסוף אותות, מעבירים שגיאה לשיטה signalCallbacks.onFailure().

הצפנת אותות

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