שילוב DT Exchange עם תהליך בחירת הרשת (Mediation)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות תהליך בחירת הרשת (Mediation), שכולל מידע על שילובים ב-Waterfall. נסביר איך להוסיף את DT Exchange להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של DT Exchange באפליקציה Flutter .

שילובים נתמכים ופורמטים נתמכים של מודעות

מתאם הגישור של DT Exchange AdMob כולל את היכולות הבאות:

שילוב
בידינג
מפל
פורמטים
כרזה
פרסומת מרווח ביניים
ההטבה הופעלה

דרישות

  • ה-SDK העדכני של מודעות Google לנייד
  • Flutter 3.7.0 ואילך
  • כדי לפרוס ב-Android
    • Android API ברמת 21 ואילך
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Flutter עבודה שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
  • השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה

שלב 1: הגדרת תצורות בממשק המשתמש של DT Exchange

הוספת אפליקציה חדשה ומיקום מודעה חדש

הרשמה או התחברות ל-DT Exchange Console

לוחצים על הלחצן Add App (הוספת אפליקציה) כדי להוסיף את האפליקציה.

ניהול האפליקציות

בוחרים את הפלטפורמה, ממלאים את שאר הטופס ולוחצים על הוספת מיקומים.

Android

iOS

נותנים שם למיקום החדש בשדה בחירת שם למיקום ובוחרים את סוג המיקום הרצוי מהרשימה הנפתחת. בסיום לוחצים על Save Placement.

הגדרה

מזהה אפליקציה ומזהה מיקום מודעה

פותחים את סרגל הניווט הימני על ידי העברת העכבר מעליו. בתפריט השמאלי לוחצים על Apps.

תפריט

בדף ניהול אפליקציות, שים לב למזהה האפליקציה שלצד האפליקציה.

מזהה אפליקציה

בחר את האפליקציה שלך, נווט לכרטיסייה מיקומים ולחץ על סמל ההעתקה לצד שם מיקום. חשוב לשים לב למזהה המיקום.

מזהה של מיקום המודעה

מזהה בעל אפליקציה, מפתח צרכן וסוד צרכן

לוחצים על שם המשתמש בתפריט הימני ובוחרים באפשרות פרופיל משתמש.

תפריט פרופיל המשתמש

שימו לב למזהה בעל האתר, למפתח הצרכן ולסוד צרכן מכיוון שיש צורך בהם בשלב הבא.

פרופיל משתמש

שלב 2: הגדרת ביקוש ב-DT Exchange AdMob בממשק המשתמש

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

הוספה של Fyber לרשימת שותפי הפרסום של תקנות GDPR ותקנות במדינות בארה"ב

פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Fyber לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .

שלב 3: מייבאים את ה-SDK והמתאם של DT Exchange

שילוב דרך pub.dev

מוסיפים את יחסי התלות הבאים עם הגרסאות העדכניות שלDT Exchange ה-SDK והמתאם בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_dtexchange: ^1.0.0

שילוב ידני

הורד את הגרסה האחרונה של פלאגין הגישור של Google Mobile Ads עבור DT Exchange, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter שלכם. לאחר מכן, מוסיפים את התלות הבאה לפלאגין בקובץ pubspec.yaml:

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

שלב 4: מטמיעים את הגדרות הפרטיות ב-DT Exchange SDK

בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.

הפלאגין של Google Mobile Ads לבחירת רשת עבור DT Exchange לא תומך בהעברת פרטי הסכמה ל-DT Exchange SDK.

חוקי הפרטיות במדינות בארה"ב

חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.

הפלאגין של Google Mobile Ads לבחירת רשת עבור DT Exchange לא תומך בהעברת פרטי הסכמה ל-DT Exchange SDK.

שלב 5: מוסיפים את קוד החובה

Android

לא נדרש קוד נוסף לשילוב DT Exchange.

iOS

שילוב של SKAdNetwork

כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט, פועלים לפי מסמכי התיעוד של DT Exchange.

שלב 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.

1.0.0

  • גרסה ראשונית.
  • תאימות מאומתת עם מתאם DT Exchange ל-Android בגרסה 8.2.6.1
  • תאימות מאומתת עם מתאם DT Exchange iOS בגרסה 8.2.7.0