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

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות בחירת רשת, כולל שילובים של רשימת הרשתות. במאמר מוסבר איך להוסיף את DT Exchange להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של DT Exchange באפליקציה 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. פרטים נוספים זמינים במאמר תחילת השימוש.
• מבצעים את ההוראות שבמדריך לתחילת העבודה.

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

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

נרשמים או נכנסים למסוף DT Exchange.

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

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

מזינים שם למיקום המודעה החדש בשדה Name your Placement (שם מיקום המודעה) ובוחרים את Placement Type (סוג מיקום המודעה) הרצוי מהתפריט הנפתח. לסיום, לוחצים על Save Placement.

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

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

בדף App Management, שימו לב למזהה האפליקציה לצד האפליקציה.

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

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

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

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

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

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

הוספה של 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 לבחירת רשת (Mediation) ב-DT Exchange לא תומך בהעברת פרטי ההסכמה ל-DT Exchange SDK.

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

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

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

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

שלב 6: בדיקה מעשית של ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-AdMob.

אימות מודעות לבדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה מ-DT Exchange, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות DT Exchange (Waterfall).

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-DT Exchange, בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo בכיתה הבאה:

com.google.ads.mediation.fyber.FyberMediationAdapter

GADMediationAdapterFyber

אלו הקודים וההודעות הנלוות שמתאם DT Exchange שולח כשמודעה לא נטענת:

יומן שינויים של מתאם Flutter Mediation ל-DT

הגרסה הבאה

• ה-plugin נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin בגרסה 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.
• נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.