במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads Flutter Plugin כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות תהליך בחירת הרשת (Mediation). המדריך כולל הסברים על שילובים של שיטת ה-Waterfall. המאמר מסביר איך להוסיף את DT Exchange להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של DT Exchange באפליקציית Flutter.
שילובים ופורמטים נתמכים של מודעות
מתאם תהליך בחירת הרשת של Flutter ל-DT Exchange כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| Waterfall | |
| פורמטים | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מותאמת | |
דרישות מוקדמות
לפני שממשיכים, חשוב לוודא את הפרטים הבאים:
- הגרסה העדכנית של Google Mobile Ads Flutter Plugin.
- Flutter framework בגרסה 3.7.0 ואילך.
- כדי לפרוס ב-Android
- רמת API ב-Android 24 ומעלה.
- כדי לפרוס ב-iOS
- יעד פריסה 15.0 ומעלה ב-iOS.
- פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads Flutter Plugin. פרטים נוספים מופיעים במאמר בנושא הגדרת Google Mobile Ads Flutter Plugin.
שלב 1: קובעים את ההגדרות בממשק המשתמש של DT Exchange
הוספת אפליקציה חדשה ומיקום מודעה חדש
נרשמים או נכנסים למסוף DT Exchange.
לוחצים על הוספת אפליקציה.
בוחרים את הפלטפורמה והמיקומים, ממלאים את שאר הטופס ולוחצים על יצירת אפליקציה.
Android
iOS
מזינים את השמות ובוחרים את הסוגים של מיקומי המודעות. אחר כך לוחצים על שמירת המיקום.
מזהה האפליקציה ומזהה המיקום
מעבירים את העכבר מעל סרגל הניווט הימני כדי לפתוח אותו, ואז לוחצים על ניהול אפליקציות.
בדף ניהול אפליקציות, רושמים את מזהה האפליקציה לצד האפליקציה.
בוחרים את האפליקציה ועוברים לכרטיסייה מיקומי מודעות. חשוב לשמור את מזהה מיקום המודעה.
מזהה בעל אפליקציה, טוקן צרכן וסוד לשימוש עם טוקן צרכן
בתפריט הימני, לוחצים על שם המשתמש ובוחרים באפשרות פרופיל משתמש.
חשוב לשים לב למזהה בעל אפליקציה, לטוקן הצרכן ולסוד לשימוש עם טוקן צרכן, כי תצטרכו אותם בשלב הבא.
עדכון של הקובץ app-ads.txt
Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt.
אם עדיין לא עשיתם זאת, צריך ליצור קובץ app-ads.txt עבור Ad Manager.
כדי להטמיע את app-ads.txt ב-DT Exchange,
צריך להוסיף את DT לקובץ app-ads.txt.
שלב 2: מגדירים את הביקוש של DT Exchange בממשק המשתמש של Ad Manager
קביעת ההגדרות של תהליך בחירת הרשת ליחידת המודעות
Android
הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.
iOS
הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.
הוספת DT Exchange לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב
כדי להוסיף בממשק המשתמש של Ad Manager את DT Exchange (Fyber Monetization) לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.
שלב 3: מייבאים את DT Exchange SDK ואת המתאם
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות העדכניות של ה-SDK והמתאם של DT Exchange בקובץ pubspec.yaml של החבילה:
dependencies:
gma_mediation_dtexchange: ^1.3.7
שילוב ידני
מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור DT Exchange, מחלצים את הקובץ שירד ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט ה-Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
שלב 4: הטמעה של הגדרות פרטיות ב-DT Exchange SDK
GDPR והסכמה בהתאם ולתקנות האירופאיות
כדי לעמוד בדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם להציג הודעות גילוי נאות מסוימות למשתמשים שנמצאים באזור הכלכלי האירופי (EEA), בבריטניה ובשוויץ. במקומות שבהם זה נדרש על פי חוק, אתם צריכים גם לקבל את הסכמתם לשימוש בקובצי cookie או באמצעים אחרים לאחסון מקומי. נוסף לכך אתם צריכים לקבל את ההסכמה שלהם לאיסוף ולשיתוף של המידע האישי שלהם ולשימוש בו לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. באחריותכם לוודא שההסכמה מועברת לכל מקור מודעות בשרשרת לבחירת רשת.
גרסה 1.1.0 ומעלה של מתאם DT Exchange Flutter תומכת בהעברת אותות הסכמה בהתאם ל-GDPR ממערכות לניהול הסכמה (CMP) שמשולבות עם Transparency and Consent Framework (TCF – מסגרת השקיפות וההסכמה) של IAB אל DT Exchange SDK. מידע נוסף זמין במסמכי התיעוד בנושא GDPR ל-Android ול-iOS.
דיני פרטיות במדינות בארה"ב
דיני הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהמונחים האלה מוגדרים בחוק). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אין למכור את המידע האישי שלי". במדריך בנושא עמידה בדרישות של דיני הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל בהצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת ב-DT Exchange לא תומך בהעברת פרטי ההסכמה ל-SDK של DT Exchange.
שלב 5: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב עם DT Exchange.
iOS
שילוב של SKAdNetwork
פועלים לפי מאמרי העזרה של DT Exchange כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager.
אימות מודעות לבדיקה
כדי לוודא שאתם מקבלים מודעות לבדיקה מ-DT Exchange, צריך להפעיל את האפשרות בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות DT Exchange (בידינג) ו-DT Exchange (רשימת רשתות בתהליך בחירת הרשת).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-DT Exchange, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo במחלקה הבאה:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של DT Exchange כשהטעינה של מודעה נכשלת:
Android
| קוד שגיאה | סיבה |
|---|---|
| 101 | הפרמטרים של שרת DT Exchange שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים. |
| 103 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-DT Exchange. |
| 105 | DT SDK טען מודעה אבל החזיר בקר לא צפוי. |
| 106 | המודעה לא מוכנה להצגה. |
| 107 | ההקשר הוא לא מופע של פעילות. |
| 108 | הצגת המודעה נכשלה. |
| 200-399 | ה-SDK של DT החזיר שגיאה. פרטים נוספים זמינים בקוד. |
iOS
| קוד שגיאה | סיבה |
|---|---|
| 0-10 | ה-SDK של DT החזיר שגיאה. פרטים נוספים מופיעים במאמרי העזרה. |
| 101 | פרמטרים של שרת DT Exchange שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים. |
| 102 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-DT Exchange. |
| 103 | הצגת המודעה נכשלה כי אובייקט המודעה כבר היה בשימוש. |
| 104 | הצגת המודעות של DT Exchange נכשלה כי המודעה לא מוכנה. |
| 105 | ה-SDK של DT החזיר שגיאת אתחול. |
יומן השינויים של המתאם של DT Exchange מנגנון בחירת הרשת ל-Flutter
גרסה 1.3.7
- תמיכה בגרסה 8.4.7.1 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.4.10.0 של המתאם של DT Exchange ל-iOS.
- נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.
גרסה 1.3.6
- העדכון כולל תמיכה בגרסה 9.1.0 של Google Mobile Ads Flutter Plugin.
- הוספנו תמיכה ב-Swift Package Manager.
- תמיכה בגרסה 8.4.7.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.4.10.0 של המתאם של DT Exchange ל-iOS.
- נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 9.1.0.
גרסה 1.3.5
- תמיכה בגרסה 8.4.5.1 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.4.8.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 9.0.0 של Google Mobile Ads Flutter Plugin.
גרסה 1.3.4
- הגרסה המינימלית של Flutter עודכנה ל-3.38.1
- עודכן כדי לתמוך בגרסה 8.0.0 של הפלאגין של Google Mobile Ads ל-Flutter
- תמיכה בגרסה 8.4.4.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.4.6.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 8.0.0.
גרסה 1.3.3
- תמיכה בגרסה 8.4.2.1 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.4.3.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 7.0.0.
גרסה 1.3.2
- הגרסה המינימלית של Flutter עודכנה ל-3.35.1
- עודכן כדי לתמוך בגרסה 7.0.0 של הפלאגין של Google Mobile Ads ל-Flutter
- תמיכה בגרסה 8.4.0.1 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.4.2.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם Google Mobile Ads Flutter Plugin גרסה 7.0.0.
גרסה 1.3.1
- תמיכה בגרסה 8.4.0.1 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.4.2.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.2.0
- תמיכה בגרסה 8.4.0.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.3.8.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.1.5
- תמיכה בגרסה 8.3.8.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.3.8.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.1.4
- תמיכה בגרסה 8.3.7.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.3.7.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.1.3
- תמיכה בגרסה 8.3.7.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.3.6.0 של המתאם של DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.1.2
- תמיכה בגרסה 8.3.6.1 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.3.6.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 6.0.0 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.1.1
- תמיכה בגרסה 8.3.6.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.3.5.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 5.3.1 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.1.0
- פלאגין iOS הוא עכשיו מסגרת סטטית.
- תמיכה בגרסה 8.3.5.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.3.4.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 5.3.1 של הפלאגין למודעות לנייד של Google ל-Flutter.
גרסה 1.0.0
- הגרסה הראשונה.
- תמיכה בגרסה 8.2.7.0 של מתאם DT Exchange ל-Android.
- תמיכה בגרסה 8.2.8.0 של מתאם DT Exchange ל-iOS.
- נבנה ונבדק עם גרסה 5.1.0 של הפלאגין למודעות לנייד של Google ל-Flutter.