תחילת העבודה

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

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

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

זו הפעם הראשונה שאתם משתמשים בתהליך בחירת הרשת (Mediation)? סקירה כללית על תהליך בחירת הרשת (Mediation) ב-AdMob

לבידינג: Google Mobile Ads SDK מגרסה 18.3.0 ואילך.

איך מפעילים את Mobile Ads SDK

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

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

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        new Thread(
                () ->
                    // Initialize the Google Mobile Ads SDK on a background thread.
                    MobileAds.initialize(
                        this,
                        initializationStatus -> {
                          Map<String, AdapterStatus> statusMap =
                              initializationStatus.getAdapterStatusMap();
                          for (String adapterClass : statusMap.keySet()) {
                            AdapterStatus status = statusMap.get(adapterClass);
                            Log.d(
                                "MyApp",
                                String.format(
                                    "Adapter name: %s, Description: %s, Latency: %d",
                                    adapterClass, status.getDescription(), status.getLatency()));
                          }
                          // Start loading ads here...
                        }))
            .start();
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) { initializationStatus ->
        val statusMap =
          initializationStatus.adapterStatusMap
        for (adapterClass in statusMap.keys) {
          val status = statusMap[adapterClass]
          Log.d(
            "MyApp", String.format(
              "Adapter name: %s, Description: %s, Latency: %d",
              adapterClass, status!!.description, status.latency
            )
          )
        }
        // Start loading ads here...
      }
    }
  }
}

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

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

Java

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

Kotlin

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

למידע נוסף על השיטה הזו, עיינו במשאבי העזרה של ResponseInfo בנושא getMediationAdapterClassName().

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

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

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

שימוש במודעות מותאמות בתהליך בחירת הרשת (Mediation) ב-AdMob

ריכזנו כאן כמה שיטות מומלצות שחשוב להביא בחשבון כשמטמיעים מודעות מותאמות בתהליך בחירת הרשת (Mediation) ב-AdMob.

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

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

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

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