המדריך הזה מיועד לבעלי אפליקציות שרוצים להשתמש בתהליך בחירת הרשת (Mediation) של Google Mobile Ads עם Zucks. המדריך כולל הסבר איך מגדירים מתאם לבחירת רשת שיפעל עם האפליקציה הנוכחית שלכם ל-Android, ואיך קובעים הגדרות נוספות.
| מקורות מידע בנושא Zucks |
|---|
| מסמכי תיעוד |
| SDK |
| מתאם |
| תמיכת לקוחות |
דרישות מוקדמות
אפליקציה ל-Android שמשולב בה GMA Next-Gen SDK. (אם אין לכם אפליקציה כזו, עיינו בקטע הגדרת GMA Next-Gen SDK).
חשבון Google Ad Manager עם הגדרה של מנגנון בחירת רשת לאפליקציות לנייד.
הוספה של Zucks לפרויקט
הוספת מתאם רשת ו-SDK
מורידים את ה-SDK והמתאם של Zucks מהקישורים שלמעלה.
ב-Android Studio, מוסיפים את קובצי המתאם וה-SDK לתיקייה libs של הפרויקט. מוודאים שקובץ Gradle ברמת האפליקציה כולל את הפרטים הבאים:
Kotlin
dependencies {
implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar", "*.jar"))))
// ...
}
Groovy
dependencies {
implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'])
// ...
}
הגדרת הקובץ AndroidManifest.xml
משנים את הקובץ AndroidManifest.xml לפי ההוראות במסמכי התיעוד של Zucks.
אין צורך להפעיל את Zucks ישירות מהאפליקציה – GMA Next-Gen SDK מפעיל את המתאם של Zucks כדי לאחזר מודעות בשבילכם. אם צריך, אפשר לציין פרמטרים נוספים לבקשה. בהמשך הדף מוסבר איך לספק מידע נוסף ל-Zucks.
מאתחלים את אובייקט המודעה באמצעות מופע של פעילות (Activity)
ב-constructor של אובייקט מודעה חדש (לדוגמה, AdManagerAdView), צריך להעביר אובייקט מסוג Context.
הערך של Context מועבר לרשתות מודעות אחרות כשמשתמשים בתהליך בחירת הרשת (Mediation). רשתות מודעות מסוימות דורשות Context מגביל יותר מסוג Activity, ויכול להיות שהן לא יוכלו להציג מודעות בלי מופע של Activity. לכן, מומלץ להעביר מופע של Activity כשמאתחלים אובייקטים של מודעות, כדי להבטיח חוויה עקבית ברשתות המודעות שמשתתפות בתהליך בחירת הרשת.