מתחילים

במדריך הזה מוסבר איך לשלב מתאם גישור באפליקציית Android.

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

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

לא התנסיתם בתהליך בחירת הרשת (Mediation) בעבר? מידע נוסף זמין במאמר מבוא לתהליך בחירת הרשת (Mediation).

לבידינג: Google Mobile Ads SDK 18.3.0 ומעלה.

הפעלה של Google Mobile Ads SDK

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

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

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}
MediationSnippets.java

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

MediationSnippets.kt

בדיקה של המחלקה של המתאם של רשת המודעות שטענה את המודעה

הנה קוד לדוגמה שמתעד את שם המחלקה של רשת המודעות עבור מודעת באנר:

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);
ResponseInfoSnippets.java

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)
ResponseInfoSnippets.kt

פרטים על השיטה הזו מופיעים בResponseInfoמסמכי התיעוד בנושא getMediationAdapterClassName().

הפעלת אובייקט המודעה באמצעות מופע של Activity

בבונה של אובייקט מודעה חדש (לדוגמה, AdManagerAdView), צריך להעביר אובייקט מסוג Context. הערך Context מועבר לרשתות מודעות אחרות כשמשתמשים בתהליך בחירת הרשת (Mediation). חלק מרשתות המודעות דורשות Context מגביל יותר, מסוג Activity, ויכול להיות שלא יוכלו להציג מודעות ללא מופע של Activity. לכן, מומלץ להעביר מופע של Activity כשמפעילים אובייקטים של מודעות כדי לוודא שחוויית השימוש ברשתות המודעות המגשרות עקבית.

שימוש במודעות באנר עם תהליך בחירת רשת

חשוב להשבית את הרענון בכל ממשקי המשתמש של מקורות מודעות מצד שלישי עבור יחידות של מודעות באנר שמשמשות לבחירת רשת. כך נמנע רענון כפול, כי מערכת Ad Manager מפעילה רענון גם על סמך קצב הרענון של יחידת מודעות הבאנר.

שימוש במודעות מותאמות עם תהליך בחירת הרשת

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

המדיניות בנושא הצגה של מודעות מותאמות
לכל רשת מודעות יש מדיניות משלה. כשמשתמשים בתהליך בחירת רשת, חשוב לזכור שהאפליקציה עדיין צריכה לפעול בהתאם למדיניות של הרשת שסיפקה את המודעה.
במקום loadAds(), צריך להשתמש ב-loadAd()
‫
השיטה loadAds() מציגה רק מודעות Google. למודעות בתיווך, צריך להשתמש ב-loadAd() במקום.

דיני הפרטיות במדינות בארה"ב וה-GDPR

אם אתם צריכים לפעול בהתאם לדיני הפרטיות במדינות בארה"ב או לתקנה הכללית להגנה על מידע (GDPR), אתם צריכים לפעול לפי השלבים שמפורטים במאמרים בנושא הגדרות בנושא תקנות במדינות בארה"ב או הגדרות בנושא GDPR כדי להוסיף את שותפי הגישור שלכם לרשימת שותפי המודעות בנושא GDPR או בנושא תקנות במדינות בארה"ב בכלי 'פרטיות והודעות' ב-Ad Manager. אם לא תעשו את זה, יכול להיות שהשותפים לא יוכלו להציג מודעות באפליקציה שלכם.

מידע נוסף על הפעלה של עיבוד נתונים מוגבל (RDP) וקבלת הסכמה בהתאם ל-GDPR באמצעות Google User Messaging Platform (UMP) SDK

הבא
בחירת הרשתות