במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות בחירת רשת, כולל שילובים של רשתות מודעות ב-Waterfall. במאמר מוסבר איך להוסיף את DT Exchange להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של DT Exchange באפליקציה 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.
מזהה האפליקציה ומזהה מיקום המודעה
כדי לפתוח את סרגל הניווט הימני, מעבירים את העכבר מעליו. לאחר מכן לוחצים על אפליקציות בתפריט שמימין.
בדף App Management, שימו לב למזהה האפליקציה לצד האפליקציה.
בוחרים את האפליקציה, עוברים לכרטיסייה מיקומים ולוחצים על סמל ההעתקה לצד שם המיקום. שימו לב למזהה מיקום המודעה.
מזהה בעל האתר, מפתח צרכן וסוד צרכן
בתפריט הימני, לוחצים על שם המשתמש ובוחרים באפשרות User Profile (פרופיל המשתמש).
חשוב לשים לב למזהה בעל התוכן הדיגיטלי, לטוקן הצרכן ולסוד הצרכן, כי הם נדרשים בשלב הבא.
שלב 2: מגדירים את הביקוש ל-DT Exchange בממשק המשתמש של AdMob
הגדרת הגדרות בחירת הרשת ליחידת המודעות
הוספה של Fyber לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את DT Exchange (מונטיזציה של Fyber) לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob.
שלב 3: מייבאים את ה-SDK והמתאם של DT Exchange
שילוב דרך 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) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.
הפלאגין של Google Mobile Ads לבחירת הרשת ב-DT Exchange לא תומך בהעברת פרטי ההסכמה ל-DT Exchange SDK.
חוקי פרטיות במדינות בארה"ב
חוקי הפרטיות במדינות ארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה למכירת המידע האישי שלהם (בהתאם להגדרה המעוגנת בחוק). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (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 | ה-SDK של DT Exchange טוען מודעה אבל מחזיר בקר לא צפוי. |
| 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
הגרסה הבאה
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.2.0.
1.1.0
- התאימות אומתה עם מתאם DT Exchange ל-Android בגרסה 8.3.0.0.
- התאימות אומתה עם מתאם DT Exchange ל-iOS בגרסה 8.3.1.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
1.0.0
- הגרסה הראשונית.
- תאימות מאומתת למתאם DT Exchange ל-Android בגרסה 8.2.7.0.
- התאימות אומתה עם מתאם DT Exchange ל-iOS בגרסה 8.2.8.0.
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.