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

אם יש לכם 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 calls the initialize() method when Google Mobile Ads SDK instantiates your secure signal adapter. משתמשים בשיטה הזו כדי לאתחל את ה-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().

הצפנת אותות

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