שילוב של Liftoff Monetize עם תהליך בחירת הרשת (Mediation)

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

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

שילוב
בידינג
מפל
פורמטים
מודעות בפתיחת האפליקציה 1, 3
כרזה 2
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות 2

1 בידינג השילוב של הפורמט הזה נמצא בגרסת בטא סגורה.

2 בידינג של הפורמט הזה הוא בגרסת בטא פתוחה.

3 השילוב של Waterfall בפורמט הזה נמצא בגרסת בטא סגורה.

דרישות

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

שלב 1: הגדרת ההגדרות בממשק המשתמש של Liftoff Monetize

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

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

Android

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

iOS

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

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

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

שלב 3: מייבאים את ה-SDK של Vungle ואת המתאם של Liftoff Monetize

שילוב באמצעות pub.dev

צריך להוסיף את התלות הבאה בגרסאות האחרונות של Liftoff Monetize ה-SDK והמתאם בחבילה שלך קובץ pubspec.yaml:

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

שילוב ידני

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

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

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

הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור Liftoff Monetize כולל את השיטה GmaMediationLiftoffmonetize.setGDPRStatus(). הקוד לדוגמה הבא מראים איך להעביר את פרטי ההסכמה ל-Vungle SDK. אם בוחרים קוראים לשיטה הזו, מומלץ להפעיל אותה לפני שליחת הבקשה להצגת מודעות. Google Mobile Ads SDK.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

הוראות להטמעה מומלצת לפי GDPR פרטים נוספים זמינים ב-Android וב-iOS ואת הערכים שניתן לספק בשיטה.

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

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

הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Liftoff Monetize כולל את אמצעי תשלום אחד (GmaMediationLiftoffmonetize.setCCPAStatus()). הקוד לדוגמה הבא מראים איך להעביר את פרטי ההסכמה ל-Vungle SDK. אם בוחרים קוראים לשיטה הזו, מומלץ להפעיל אותה לפני שליחת הבקשה להצגת מודעות. Google Mobile Ads SDK.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

להוראות הטמעה מומלצות של CCPA לפרטים נוספים ול-Android ול-iOS בין הערכים שאפשר לציין ב-method.

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

Android

לא נדרש קוד נוסף לשילוב עם Liftoff Monetize.

iOS

שילוב עם SKAdNetwork

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

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

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

חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב Liftoff Monetize ממשק המשתמש.

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

כדי לוודא שמוצגות לך מודעות לבדיקה מ-Liftoff Monetize, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) מקורות המודעות.

קודי שגיאה

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

Android

פורמט שם הכיתה
מודעות בפתיחת אפליקציה (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות בפתיחת אפליקציה (Waterfall) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעת באנר (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
באנר (Waterfall) com.vungle.mediation.VungleInterstitialAdapter
מודעות מעברון (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות מעברון (Waterfall) com.vungle.mediation.VungleInterstitialAdapter
מודעות מתגמלות (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות מתגמלות (Waterfall) com.vungle.mediation.VungleAdapter
מודעות מעברון מתגמלות (בידינג) com.google.ads.mediation.vungle.VungleMediationAdapter
מודעות מעברון מתגמלות (Waterfall) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

פורמט שם הכיתה
מודעות בפתיחת אפליקציה (בידינג) GADMediationAdapterVungle
מודעות בפתיחת אפליקציה (Waterfall) GADMediationAdapterVungle
מודעת באנר (בידינג) GADMediationAdapterVungle
באנר (Waterfall) GADMAdapterVungleInterstitial
מודעות מעברון (בידינג) GADMediationAdapterVungle
מודעות מעברון (Waterfall) GADMAdapterVungleInterstitial
מודעות מתגמלות (בידינג) GADMediationAdapterVungle
מודעות מתגמלות (Waterfall) GADMAdapterVungleRewardBasedVideoAd
מודעות מעברון מתגמלות (בידינג) GADMediationAdapterVungle
מודעות מעברון מתגמלות (Waterfall) GADMediationAdapterVungle

בטבלה הבאה מפורטים הקודים וההודעות הנלוות ל-Liftoff Monetize כשמודעה נכשלת להיטען:

Android

קוד שגיאה סיבה
101 פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום מודעה).
102 גודל הבאנר המבוקש לא ממופה למודעת Liftoff Monetize חוקית גודל.
103 כדי לשלוח בקשה ב-Liftoff Monetize, צריך להוסיף הקשר Activity מודעות.
104 לא ניתן לטעון ב-Vungle SDK כמה מודעות לאותו מיקום מודעה ID.
105 לא הצלחנו לאתחל את ה-SDK של Vungle.
106 הקריאה החוזרת (callback) של הטעינה החוזרת בוצעה בהצלחה, אבל Banners.getBanner() או Vungle.getNativeAd() החזירו null.
107 ה-SDK של Vungle לא מוכן להפעיל את המודעה.
108 Vungle SDK החזיר אסימון לא חוקי לבידינג.

iOS

קוד שגיאה סיבה
101 פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום מודעה).
102 כבר נטענה מודעה בהגדרת הרשת הזו. ה-SDK של Vungle לא יכול לטעון מודעה שנייה לאותו מזהה מיקום מודעה.
103 גודל המודעה המבוקש לא תואם לערך נתמך של Liftoff Monetize גודל הבאנר.
104 לא ניתן היה לעבד את מודעת הבאנר ב-Vungle SDK.
105 ה-SDK של Vungle תומך רק בחיוב של מודעה באנר אחת בכל פעם, ללא קשר למזהה מיקום המודעה.
106 נשלחה שיחה חוזרת מ-Vungle SDK ואומרת שלא ניתן להפעיל את המודעה.
107 ה-SDK של Vungle לא מוכן להפעיל את המודעה.

אם מדובר בשגיאות שנובעות מ-Vungle SDK, יש לעיין במאמר קודי שגיאה: Vungle SDK ל-iOS ו-Android.

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

גרסה 1.0.0

  • גרסה ראשונית.
  • תאימות מאומתת למתאם Liftoff Monetize ל-Android בגרסה 7.3.1.0
  • תאימות מאומתת למתאם LiftoffMonetize ל-iOS בגרסה 7.3.2.0
  • נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.