תחילת העבודה

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

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

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

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

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

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

הפעלה של Mobile Ads SDK

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

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

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();
    }
}

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...
      }
    }
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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