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

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

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

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

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

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

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

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

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

Java

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

הפעלת המתאם

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

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

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

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

SampleAdapterSnippets.java

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

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

אם ה-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);
}

SampleAdapterSnippets.java

בדוגמה הבאה מוחזרת גרסת ה-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);
}

SampleAdapterSnippets.java

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

איסוף אותות

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

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

SampleAdapterSnippets.java

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

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

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

הצפנת אותות

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