במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של Waterfall. נסביר איך להוסיף את DT Exchange להגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את DT Exchange SDK ואת המתאם באפליקציה Flutter .
השילובים והפורמטים של המודעות הנתמכים
AdMob מתאם התיווך של DT Exchange כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה |
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- Flutter 3.7.0 ואילך
- כדי לפרוס ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פעיל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
- מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של DT Exchange
הוספה של אפליקציה חדשה ומיקום מודעה חדש
נרשמים או נכנסים למסוף DT Exchange.
לוחצים על הלחצן Add App (הוספת אפליקציה) כדי להוסיף את האפליקציה.
בוחרים את הפלטפורמה, ממלאים את שאר הפרטים בטופס ולוחצים על Add Placements (הוספת מיקומי מודעות).
Android
iOS
מזינים שם למיקום המודעה החדש בשדה Name your Placement (שם מיקום המודעה) ובוחרים את Placement Type (סוג מיקום המודעה) הרצוי מהתפריט הנפתח. בסיום, לוחצים על Save Placement.
מזהה האפליקציה ומזהה מיקום המודעה
כדי לפתוח את סרגל הניווט הימני, מעבירים את העכבר מעליו. לאחר מכן, בתפריט השמאלי, לוחצים על Apps (אפליקציות).
בדף ניהול אפליקציות, בודקים מהו מזהה האפליקציה שלצד האפליקציה.
בוחרים את האפליקציה, עוברים לכרטיסייה מיקומים ולוחצים על סמל ההעתקה לצד שם המיקום. חשוב לשים לב למזהה מיקום המודעה.
מזהה בעל אתר, מפתח צרכן וסוד צרכן
בתפריט הימני, לוחצים על שם המשתמש ובוחרים באפשרות User Profile.
שימו לב ל-Publisher ID, לאסימון צרכן ולסוד צרכן, כי כל אלה נחוצים בשלב הבא.
שלב 2: הגדרת ביקוש ב-DT Exchange AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של Fyber לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR וגם בהגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את DT Exchange (מונטיזציה של Fyber) לרשימת התקנות של פלטפורמת ה-GDPR בארה"ב.תקנות ה-GDPR בארה"ב ו
שלב 3: מייבאים את ה-DT Exchange SDK והמתאם
שילוב באמצעות pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK ושל המתאם שלDT Exchange בקובץ pubspec.yaml
של החבילה:
dependencies:
gma_mediation_dtexchange: ^1.0.0
שילוב ידני
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור 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 Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שיכולה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.
הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-DT Exchange לא תומך בהעברת פרטי ההסכמה ל-DT Exchange SDK.
חוקי פרטיות במדינות בארה"ב
חוקי פרטיות של מדינות בארה"ב מחייבים לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה). האפשרות לבטל את ההסכמה מוצעת בקישור בולט בדף הבית של הצד המוכר. המדריך לציות לחוקי הפרטיות במדינות בארה"ב מאפשר להפעיל עיבוד נתונים מוגבל לצורך הצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת ל-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 | ה-SDK של DT Exchange החזיר שגיאה. פרטים נוספים זמינים במאמר קוד. |
iOS
קוד שגיאה | סיבה |
---|---|
0-10 | ה-SDK של DT Exchange החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד. |
101 | הפרמטרים של שרת DT Exchange שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
102 | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-DT Exchange. |
103 | לא ניתן להציג את המודעה כי כבר נעשה שימוש באובייקט המודעה. |
104 | לא הצלחנו להציג מודעות DT Exchange כי המודעה לא מוכנה. |
105 | DT Exchange SDK החזיר שגיאת הפעלה. |
יומן השינויים של מתאם בחירת הרשת (Mediation) של DT Exchange ל-Flutter
הגרסה הבאה
- נוצר ונבדק באמצעות גרסה 5.2.0 של הפלאגין של Google Mobile Ads Flutter.
1.1.0
- התאימות אומתה עם מתאם DT Exchange ל-Android בגרסה 8.3.0.0.
- התאימות אומתה עם מתאם DT Exchange ל-iOS בגרסה 8.3.1.0.
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.
1.0.0
- גרסה ראשונית.
- תאימות מאומתת למתאם DT Exchange ל-Android בגרסה 8.2.7.0.
- התאימות אומתה עם מתאם DT Exchange ל-iOS בגרסה 8.2.8.0.
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.