הגדרת תהליך בחירת הרשת

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

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

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

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

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

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

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

מפעילים את Google Mobile Ads SDK (Legacy)

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

חשוב: כדי להשתמש במתאמי בידינג, צריך לאתחל באופן מפורש את Google Mobile Ads SDK (Legacy).

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

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)

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

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

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

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

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

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

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

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

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

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

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

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