תחילת העבודה

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

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

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

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

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

לבידינג: SDK של מודעות Google לנייד בגרסה 18.3.0 ומעלה.

הפעלה של Mobile Ads SDK

במדריך למתחילים מוסבר איך לאתחל את Mobile Ads 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() לקבלת פרטים על השיטה הזו.

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

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

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

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

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

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

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

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

להשתמש ב-loadAd() במקום ב-loadAds()

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

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

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

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