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

הערה: זירת המסחר של Fyber נקראת עכשיו DT Exchange.

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

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

למתאם של Flutter לבחירת רשתות ב-DT Exchange יש את היכולות הבאות:

שילוב
בידינג	^1
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה	^2

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

^‫2 מודעות מתגמלות נתמכות רק בתהליך בחירת הרשת מסוג רשימת רשתות.

דרישות

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

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

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

נרשמים או מתחברים ל-DT Exchange Console.

לוחצים על הוספת אפליקציה.

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

Android

iOS

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

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

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

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

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

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

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

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

עדכון של קובץ app-ads.txt

Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

כדי להטמיע app-ads.txt ב-DT Exchange, מוסיפים את DT לקובץ app-ads.txt.

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

הגדרת הגדרות הגישור ליחידת המודעות

Android

הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

הוספת DT Exchange לרשימת שותפי הפרסום שמספקים שירותים שקשורים לבקשת הסכמה בהתאם ל-GDPR ולתקנות במדינות בארה"ב

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

כדי להוסיף את DT Exchange (Fyber Monetization) לרשימת שותפי הפרסום שעומדים בדרישות התקנות האירופאיות והתקנות במדינות בארה"ב בממשק המשתמש של AdMob, צריך לפעול לפי השלבים שמפורטים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

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

הערה: אם לא משלבים את הגרסאות התואמות של DT Exchange ו-Google Mobile Ads SDK, עלולות להיווצר בעיות ב-build.

שילוב דרך pub.dev

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

dependencies:
  gma_mediation_dtexchange: ^

שילוב ידני

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

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

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

הסכמה בהתאם ל-GDPR והסכמה באיחוד האירופי

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

התוסף של Google Mobile Ads לגישור ב-DT Exchange לא תומך בהעברת מידע על הסכמה ל-DT SDK.

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

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

התוסף של Google Mobile Ads לגישור ב-DT Exchange לא תומך בהעברת מידע על הסכמה ל-DT SDK.

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

Android

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

iOS

שילוב של SKAdNetwork

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

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

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

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

חשוב: לפני השקת האפליקציה, צריך להשבית את מצב הבדיקה ב-AdMob וב-DT Exchange.

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-DT Exchange, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות DT Exchange (Bidding)‎ ו-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 טען מודעה אבל החזיר בקר לא צפוי.
106	המודעה לא מוכנה להצגה.
107	ההקשר הוא לא מופע של פעילות.
200-399	ה-SDK של DT החזיר שגיאה. פרטים נוספים מופיעים במאמר בנושא קוד.

iOS

קוד שגיאה	סיבה
0-10	ה-SDK של DT החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד.
101	פרמטרים של שרת DT Exchange שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
102	גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-DT Exchange.
103	הצגת המודעה נכשלה כי אובייקט המודעה כבר נמצא בשימוש.
104	הצגת המודעות ב-DT Exchange נכשלה כי המודעה לא מוכנה.
105	ה-SDK של DT החזיר שגיאת אתחול.

יומן השינויים של DT Exchange Flutter Mediation Adapter

גרסה 1.1.5 (בשלבי פיתוח)

גרסה 1.1.4

• תמיכה ב-DT Exchange Android adapter version 8.3.7.0.
• תמיכה בגרסה 8.3.7.0 של מתאם DT Exchange ל-iOS.
• התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 1.1.3

• תמיכה ב-DT Exchange Android adapter version 8.3.7.0.
• תמיכה ב-DT Exchange iOS adapter version 8.3.6.0.
• התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 1.1.2

• תמיכה בגרסה 8.3.6.1 של מתאם DT Exchange ל-Android.
• תמיכה ב-DT Exchange iOS adapter version 8.3.6.0.
• התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.

גרסה 1.1.1

• תמיכה בגרסה 8.3.6.0 של המתאם ל-Android של DT Exchange.
• תמיכה בגרסה 8.3.5.0 של מתאם DT Exchange ל-iOS.
• התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.

גרסה 1.1.0

• פלאגין iOS הוא עכשיו מסגרת סטטית.
• תמיכה בגרסה 8.3.5.0 של המתאם ל-Android של DT Exchange.
• תמיכה בגרסה 8.3.4.0 של מתאם DT Exchange ל-iOS.
• התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.

גרסה 1.0.0

• זו הגרסה הראשונה.
• תמיכה ב-DT Exchange Android adapter version 8.2.7.0.
• תמיכה בגרסה 8.2.8.0 של מתאם DT Exchange ל-iOS.
• התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 5.1.0.