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

במדריך הזה מוסבר איך להשתמש ב-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) ביחידת המודעות

Android

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

iOS

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

הוספה של 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

בהתאם למדיניות 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.