במדריך הזה מוסבר איך לשלב מתאם תהליך בחירת הרשת באפליקציה ל-Android.
דרישות מוקדמות
כדי לשלב גישור לפורמט מודעה, צריך לשלב את פורמט המודעה באפליקציה:
זו הפעם הראשונה שאתם משתמשים בתהליך בחירת הרשת (Mediation)? מבוא לתהליך בחירת הרשת
לבידינג: 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 של אובייקט מודעה חדש (לדוגמה, AdManagerAdView
), צריך להעביר אובייקט מסוג Context
.
הערך של Context
מועבר לרשתות מודעות אחרות כשמשתמשים בתהליך בחירת הרשת. רשתות מודעות מסוימות דורשות Context
מגביל יותר מסוג Activity
, וייתכן שהן לא יוכלו להציג מודעות בלי מכונה של Activity
. לכן, מומלץ להעביר מופע של Activity
בזמן האינטוליזציה של אובייקטי המודעות כדי להבטיח חוויה עקבית עם רשתות המודעות שמשתתפות בתהליך בחירת הרשת.
שימוש במודעות באנר עם תהליך בחירת הרשת
חשוב להשבית את הרענון בכל ממשקי המשתמש של מקורות המודעות של הצד השלישי, עבור יחידות של מודעות באנר שמשמשות בתהליך בחירת הרשת. כך אפשר למנוע רענון כפול, כי מערכת Ad Manager מפעילה גם רענון על סמך קצב הרענון של יחידת המודעות בבאנר.
שימוש במודעות מותאמות עם תהליך בחירת הרשת
ריכזנו כאן כמה שיטות מומלצות שכדאי להביא בחשבון כשמטמיעים תהליך בחירת רשת (Mediation) מקורי.
- המדיניות בנושא הצגת מודעות מותאמות
- לכל רשת מודעות יש מדיניות משלה. כשמשתמשים בתהליך בחירת הרשת, חשוב לזכור שהאפליקציה עדיין צריכה לציית למדיניות של הרשת שבחרה את המודעה.
- צריך להשתמש ב-
loadAd()
במקום ב-loadAds()
- השיטה
loadAds()
מציגה רק מודעות של Google. במודעות שמנוהלות על ידי רשת, צריך להשתמש ב-loadAd()
במקום זאת.
חוקי הפרטיות במדינות בארה"ב ו-GDPR
אם אתם צריכים לפעול בהתאם לחוקי הפרטיות במדינות ארה"ב או לתקנה הכללית להגנה על מידע (GDPR), עליכם לפעול לפי השלבים שמפורטים בהגדרות בנושא תקנות במדינות בארה"ב או בהגדרות בנושא GDPR כדי להוסיף את שותפי התיווך לרשימת שותפי המודעות במדינות ארה"ב או ב-GDPR שבכלי 'פרטיות והודעות' ב-Ad Manager. אם לא תעשו זאת, יכול להיות שהשותפים לא יצליחו להציג מודעות באפליקציה.
מידע נוסף על הפעלת עיבוד נתונים מוגבל (RDP) ועל קבלת הסכמה בהתאם ל-GDPR באמצעות Google User Messaging Platform (UMP) SDK