המדריך הזה מיועד לבעלי אפליקציות שרוצים להשתמש בתהליך בחירת הרשת (Mediation) של Google Mobile Ads עם Zucks. המדריך כולל הסבר איך מגדירים מתאם לבחירת רשת שיפעל עם האפליקציה הנוכחית שלכם ל-Android, ואיך קובעים הגדרות נוספות.
| מקורות מידע בנושא Zucks |
|---|
| מסמכי תיעוד |
| SDK |
| מתאם |
| תמיכת לקוחות |
דרישות מוקדמות
אפליקציה ל-Android שמשולב בה Google Mobile Ads SDK (Legacy). (אם אין לכם אפליקציה כזו, עיינו בקטע הגדרת Google Mobile Ads SDK (Legacy)).
חשבון 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 ישירות – Google Mobile Ads SDK (Legacy) שולחת קריאה אל המתאם של Zucks כדי לאחזר מודעות בשמך. אם צריך, אפשר לציין פרמטרים נוספים לבקשה. בהמשך הדף מוסבר איך לספק מידע נוסף ל-Zucks.
מאתחלים את אובייקט המודעה באמצעות מופע של פעילות (Activity)
בבונה של אובייקט מודעה חדש (לדוגמה, AdManagerAdView), צריך להעביר אובייקט מהסוג Context.
הערך של Context מועבר לרשתות מודעות אחרות כשמשתמשים בתהליך בחירת הרשת. רשתות מודעות מסוימות דורשות Context מגביל יותר מסוג Activity, ויכול להיות שהן לא יוכלו להציג מודעות בלי מופע של Activity. לכן, מומלץ להעביר מופע של Activity כשמפעילים אובייקטים של מודעות כדי להבטיח חוויה עקבית עם רשתות המודעות שמשתתפות בתהליך בחירת הרשת.