במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של Waterfall. במאמר הזה מוסבר איך להוסיף DT Exchange הגדרת הגישור ואיך לשלב את DT Exchange SDK והמתאם לאפליקציה Flutter .
השילובים והפורמטים של המודעות שנתמכים
AdMob למתאם הגישור של DT Exchange יש היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | |
| פורמטים | |
| כרזה | |
| מעברון | |
| ההטבה הופעלה | |
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Flutter 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פעיל שהוגדר ב-Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: קביעת ההגדרות בממשק המשתמש של DT Exchange
הוספת אפליקציה חדשה ומיקום מודעה חדש
הרשמה או התחברות ל-DT Exchange Console
לוחצים על הלחצן Add App (הוספת אפליקציה) כדי להוסיף את האפליקציה.
בוחרים את הפלטפורמה, ממלאים את שאר הטופס ולוחצים על הוספת מיקומים.
Android
iOS
נותנים שם למיקום החדש בשדה בחירת שם למיקום ובוחרים את סוג המיקום הרצוי מהרשימה הנפתחת. בסיום לוחצים על Save Placement.
מזהה אפליקציה ומזהה מיקום מודעה
פותחים את סרגל הניווט הימני על ידי העברת העכבר מעליו. בתפריט השמאלי לוחצים על Apps.
בדף ניהול אפליקציות, שים לב למזהה האפליקציה שלצד האפליקציה.
בחר את האפליקציה שלך, נווט לכרטיסייה מיקומים ולחץ על סמל ההעתקה לצד שם מיקום. חשוב לשים לב למזהה המיקום.
מזהה בעל אפליקציה, מפתח צרכן וסוד צרכן
לוחצים על שם המשתמש בתפריט הימני ובוחרים באפשרות פרופיל משתמש.
שימו לב למזהה בעל האתר, למפתח הצרכן ולסוד צרכן מכיוון שיש צורך בהם בשלב הבא.
שלב 2: הגדרת ביקוש ב-DT Exchange AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Fyber לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Fyber לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-DT Exchange SDK והמתאם
שילוב באמצעות pub.dev
צריך להוסיף את התלות הבאה בגרסאות האחרונות של
DT Exchange ה-SDK והמתאם בחבילה שלך
קובץ pubspec.yaml:
dependencies:
gma_mediation_dtexchange: ^1.0.0
שילוב ידני
כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור
DT Exchange
מחלצים את הקובץ שהורד ומוסיפים את תיקיית יישומי הפלאגין שחולצו
(והתוכן שלו) לפרויקט Flutter. לאחר מכן, פונים לפלאגין
pubspec.yaml על ידי הוספת התלות הבאה:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
שלב 4: מטמיעים את הגדרות הפרטיות ב-DT Exchange SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) עבור DT Exchange לא תומך בהעברה פרטי ההסכמה ל-DT Exchange SDK.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) עבור DT Exchange לא תומך בהעברה פרטי ההסכמה ל-DT Exchange SDK.
שלב 5: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב DT Exchange.
iOS
שילוב של SKAdNetwork
פועלים לפי ההנחיות של DT Exchange
תיעוד
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-DT Exchange, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות DT Exchange (Waterfall) מקורות המודעות.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-DT Exchange, בעלי התוכן הדיגיטלי יכולים לבדוק את
לשגיאה בסיסית מהתגובה באמצעות מודעה באמצעות
ResponseInfo מתחת לקטע
המחלקה הבאה:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
אלו הקודים וההודעות הנלוות שמוצגות על ידי מתאם ה-DT Exchange כשמודעה נכשלת להיטען:
Android
| קוד שגיאה | סיבה |
|---|---|
| 101 | הפרמטרים של שרת DT Exchange שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
| 103 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך על ידי DT Exchange. |
| 105 | DT Exchange SDK טען מודעה אבל החזיר בקר לא צפוי. |
| 106 | המודעה לא מוכנה להצגה. |
| 200-399 | אירעה שגיאה ב-DT Exchange SDK. להצגת הקוד אפשר לקבל פרטים נוספים. |
iOS
| קוד שגיאה | סיבה |
|---|---|
| 0-10 | אירעה שגיאה ב-DT Exchange SDK. לצפייה במסמכי התיעוד אפשר לקבל פרטים נוספים. |
| 101 | הפרמטרים של שרת DT Exchange שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
| 102 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך על ידי DT Exchange. |
| 103 | הצגת המודעה נכשלה כי כבר נעשה שימוש באובייקט המודעה. |
| 104 | הצגת מודעות DT Exchange נכשלה כי המודעה לא מוכנה. |
| 105 | אירעה שגיאת אתחול ב-DT Exchange SDK. |
יומן שינויים של מתאם Flutter Mediation ל-DT
1.0.0
- גרסה ראשונית.
- תאימות מאומתת למתאם DT Exchange ל-Android בגרסה 8.2.7.0.
- תאימות מאומתת למתאם DT Exchange ל-iOS בגרסה 8.2.8.0.
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.