אני רוצה לנסות

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

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

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

• מודעות באנר
• מודעות מעברון
• מודעות מותאמות
• מודעות מתגמלות
• מודעות מעברון מתגמלות

משתמשים חדשים בתהליך בחירת הרשת (Mediation)? כדאי לקרוא את המאמר מבוא לתהליך בחירת הרשת (Mediation).

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

הפעלה של Mobile Ads SDK

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

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

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().

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

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

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

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

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

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

מדיניות בנושא הצגת מודעות מותאמות

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

שימוש ב-loadAd() במקום ב-loadAds()

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

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

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

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