במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Moloco באמצעות גישור, כולל שילובים של בידינג. המאמר מסביר איך להוסיף את Moloco להגדרת הגישור של יחידת מודעות, ואיך לשלב את Moloco SDK ואת המתאם באפליקציית Android.
שילובים נתמכים ופורמטים נתמכים של מודעות
מתאם הגישור של Moloco כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | |
| פורמטים | |
| מודעה בפתיחת אפליקציה | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מודעות מעברון מתגמלות | |
| מותאם | |
דרישות
רמת API 23 ואילך ב-Android
גרסה 3.8.0.0 ומעלה של המתאם של Moloco
הגרסה העדכנית של Google Mobile Ads SDK
צריך לקרוא את המדריך לתחילת העבודה עם תהליך בחירת הרשת (Mediation).
שלב 1: הגדרת תצורות בממשק המשתמש של Moloco
מתחברים ל-Moloco Publisher Portal.
עוברים לכרטיסייה אפליקציות בדף סקירה כללית ולוחצים על הלחצן הוספת אפליקציה כדי ליצור אפליקציה חדשה.
בוחרים את מערכת ההפעלה והגדרות הפרטיות של האפליקציה, ממלאים את שאר הפרטים בטופס ולוחצים על יצירה.
אחרי שיוצרים את האפליקציה, בוחרים אותה בכרטיסייה Apps כדי לראות את הפרטים שלה ורושמים את App Key.
עוברים לכרטיסייה סקירה כללית > יחידות מודעות, בוחרים את האפליקציה מהתפריט הנפתח ולוחצים על יחידת מודעות חדשה.
בוחרים באפשרות בידינג באפליקציה בתור שיטת המכרז וממלאים את שאר הפרטים בטופס. לאחר מכן, לוחצים על יצירה.
עוברים ליחידת המודעות החדשה בכרטיסייה יחידות של מודעות כדי לראות את הפרטים שלה. חשוב לשים לב למזהה יחידת המודעות.
שלב 2: הגדרת הביקוש של Moloco בממשק המשתמש של Ad Manager
נכנסים לחשבון Ad Manager.
הפעלת שיתוף אותות מאובטח
עוברים אל Admin (אדמין) > Global settings (הגדרות גלובליות). עוברים לכרטיסייה הגדרות החשבון ב-Ad Exchange, בודקים את ההגדרה שיתוף אותות מאובטח ומפעילים אותה. לוחצים על שמירה.
שיתוף אותות מאובטחים בבקשות להצעות מחיר
עוברים אל Inventory (מלאי שטחי פרסום) > Secure Signals (אותות מאובטחים). בקטע אותות מאובטחים, מחפשים את Moloco Ads SDK ומפעילים את האפשרות הפעלת שילוב האפליקציה.
לוחצים על שמירה.
איך מאפשרים שיתוף אותות מאובטחים בבידינג מבוסס SDK
עוברים אל הצגת מודעות > ההגדרות של ערוץ הביקוש. בכרטיסייה הגדרות ברירת מחדל, מפעילים את האפשרות הפעלת שיתוף אותות מאובטחים עבור בידינג ב-SDK.
לוחצים על שמירה.
הגדרת בידינג ב-Moloco
עוברים אל אספקה > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.
לוחצים על משתתף חדש במכרז.
בוחרים באפשרות Moloco Ads בתור הצעת המחיר.
לוחצים על המשך כדי להפעיל בידינג SDK עבור מגיש הצעות המחיר הזה.
לוחצים על סיום.
הגדרת מיפוי של יחידות מודעות
עוברים אל אספקה > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.
בוחרים את החברה עבור Moloco Ads SDK.
עוברים לכרטיסייה מיפוי יחידות של מודעות ולוחצים על מיפוי חדש של יחידת מודעות.
בוחרים באפשרות יחידת מודעות ספציפית. בוחרים יחידת מודעות ופורמט, אפליקציה לנייד בתור סוג מלאי שטחי הפרסום ואפליקציה לנייד. לאחר מכן, מזינים את מפתח האפליקציה ואת המזהה של יחידת המודעות שהתקבלו בקטע הקודם.
לבסוף, לוחצים על שמירה.
הוספה של Moloco Ads לרשימת שותפי הפרסום בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב
כדי להוסיף את Moloco Ads לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות שקשורות לתקנות האירופאיות והגדרות שקשורות לתקנות במדינות בארה"ב בממשק המשתמש של Ad Manager.
שלב 3: מייבאים את ה-SDK והמתאם של Moloco
שילוב עם Android Studio (מומלץ)
בקובץ build.gradle.kts ברמת האפליקציה, מוסיפים את התלות וההגדרות הבאות של ההטמעה. חשוב להשתמש בגרסאות העדכניות ביותר של Moloco SDK והמתאם:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:moloco:3.12.1.0")
}
שלב 4: הטמעה של הגדרות פרטיות ב-Moloco SDK
הסכמה בהתאם ל-GDPR ולתקנות האירופאיות
כדי לעמוד בדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לחשוף מידע מסוים למשתמשים באזור הכלכלי האירופי (EEA), בבריטניה ובשווייץ, ולקבל מהם הסכמה לשימוש בקובצי Cookie או באחסון מקומי אחר במקרים שבהם הדבר נדרש על פי חוק, וכן לאיסוף, לשיתוף ולשימוש במידע אישי לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. באחריותך לוודא שהסכמה מועברת לכל מקור מודעות בשרשרת הגישור. Google לא יכולה להעביר את בחירת ההסכמה של המשתמש לרשתות כאלה באופן אוטומטי.
Moloco SDK כולל את הדגל
isUserConsent
להעברת פרטי הסכמה אל Moloco SDK.
קוד לדוגמה שמראה איך להעביר מידע על הסכמה ל-SDK של Moloco. אם בוחרים להגדיר את הדגלים האלה, מומלץ לעשות זאת לפני שליחת בקשות להצגת מודעות דרך Google Mobile Ads SDK.
Kotlin
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ true,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ false);
MolocoPrivacy.setPrivacy(privacySettings);
מידע נוסף זמין במסמכי התיעוד של Moloco SDK ל-Android.
חוקי פרטיות במדינות בארה"ב
חוקי הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (בהתאם להגדרה המעוגנת בחוק זה). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אל תמכרו את המידע האישי שלי". במדריך בנושא עמידה בדרישות של חוקי הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.
Moloco SDK כולל את הדגל isDoNotSell להעברת מידע על הסכמה אל Moloco SDK.
קוד לדוגמה שמראה איך להעביר מידע על הסכמה ל-SDK של Moloco. אם בוחרים להגדיר את הדגלים האלה, מומלץ לעשות זאת לפני שליחת בקשות להצגת מודעות דרך Google Mobile Ads SDK.
Kotlin
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ false,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ true);
MolocoPrivacy.setPrivacy(privacySettings);
מידע נוסף זמין במסמכי התיעוד של Moloco SDK ל-Android.
שלב 5: בדיקת ההטמעה
הפעלת מודעות בדיקה
חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Moloco Ads SDK, אתם צריכים להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Moloco (Bidding).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-Moloco, אפשר לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות ResponseInfo.getAdapterResponses() במחלקות הבאות:
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
אלה הקודים וההודעות הנלוות שמוחזרים על ידי מתאם Moloco כשטעינת מודעה נכשלת:
| קוד שגיאה | דומיין | סיבה |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | מפתח האפליקציה של Moloco חסר או לא תקין. |
| 102 | com.google.ads.mediation.moloco | מזהה יחידת המודעות של Moloco חסר או לא תקין. |
| 103 | com.google.ads.mediation.moloco | אובייקט המודעה של Moloco שהוחזר היה null. |
| -1 עד 5000 | com.moloco.sdk | ה-SDK של Moloco החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Moloco. |
אימות בצד השרת של מודעות מתגמלות
אם מאמתים קריאות חוזרות (callback) של אימות בצד השרת (SSV), מזהה מקור המודעה של Moloco הוא 8267622065755668722.
יומן השינויים של Moloco Android Mediation Adapter
גרסה 4.0.0.0 (בתהליך)
גרסה 3.12.1.0
- תאימות מאומתת ל-Moloco SDK 3.12.1.
נבנה ונבדק באמצעות:
- גרסה 24.5.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.12.1.
גרסה 3.12.0.0
- תאימות מאומתת עם Moloco SDK 3.12.0.
נבנה ונבדק באמצעות:
- גרסה 24.4.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.12.0.
גרסה 3.11.0.0
- תאימות מאומתת ל-Moloco SDK 3.11.0.
נבנה ונבדק באמצעות:
- גרסה 24.4.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.11.0.
גרסה 3.10.0.0
- תאימות מאומתת ל-Moloco SDK 3.10.0.
נבנה ונבדק באמצעות:
- Google Mobile Ads SDK גרסה 24.3.0.
- גרסת Moloco SDK 3.10.0.
גרסה 3.9.0.0
- תאימות מאומתת ל-Moloco SDK 3.9.0.
נבנה ונבדק באמצעות:
- גרסה 24.2.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.9.0.
גרסה 3.8.0.1
- הוספנו תמיכה בגודל מודעת באנר מלבנית בינונית.
נבנה ונבדק באמצעות:
- גרסה 24.1.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.8.0.
גרסה 3.8.0.0
- נוספה תמיכה בבידינג על פורמט של מודעה מותאמת.
- תאימות מאומתת ל-Moloco SDK 3.8.0.
נבנה ונבדק באמצעות:
- גרסה 24.1.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.8.0.
גרסה 3.7.2.0
- תאימות מאומתת ל-Moloco SDK 3.7.2.
נבנה ונבדק באמצעות:
- גרסה 24.0.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.7.2.
גרסה 3.7.1.0
- עדכנו את רמת ה-API המינימלית הנדרשת ב-Android ל-23.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-24.0.0.
- תאימות מאומתת ל-Moloco SDK 3.7.1.
נבנה ונבדק באמצעות:
- גרסה 24.0.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.7.1.
גרסה 3.7.0.0
- תאימות מאומתת ל-Moloco SDK 3.7.0.
נבנה ונבדק באמצעות:
- גרסה 23.6.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.7.0.
גרסה 3.6.1.0
- תאימות מאומתת ל-Moloco SDK 3.6.1.
נבנה ונבדק באמצעות:
- גרסה 23.6.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.6.1.
גרסה 3.6.0.0
- תאימות מאומתת ל-Moloco SDK 3.6.0.
נבנה ונבדק באמצעות:
- גרסה 23.6.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.6.0.
גרסה 3.5.0.0
- זו הגרסה הראשונה.
- הוספנו תמיכה בפורמטים של מודעות באנר, מודעות מעברון ומודעות מתגמלות.
- תאימות מאומתת ל-Moloco SDK 3.5.0.
נבנה ונבדק באמצעות:
- גרסה 23.6.0 של Google Mobile Ads SDK.
- גרסת Moloco SDK 3.5.0.