במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Liftoff Monetize באמצעות תהליך בחירת רשת, כולל שילובים של בידינג ושל רשימת רשתות. במאמר מוסבר איך להוסיף את Liftoff Monetize להגדרת בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של Vungle באפליקציהFlutter .
השילובים והפורמטים של המודעות הנתמכים
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
מודעות בפתיחת האפליקציה | 1, 2 |
כרזה | 1 |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות | 1 |
מותאם | 1, 2 |
1 שילוב הבידינג בפורמט הזה נמצא בגרסת בטא פתוחה.
2 מפל של הפורמט הזה הוא בגרסת בטא פתוחה.
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- Flutter 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פעיל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Liftoff Monetize
נרשמים או מתחברים ל-Liftoff ייצור הכנסות מהחשבון.
מוסיפים את האפליקציה למרכז הבקרה של Liftoff Monetize באמצעות לחיצה על הלחצן Add Application (הוספת אפליקציה).
ממלאים את הטופס ומזינים את כל הפרטים הנדרשים.
Android
iOS
אחרי יצירת האפליקציה, בוחרים אותה מרכז הבקרה של האפליקציות של Liftoff Monetize
Android
iOS
חשוב לשים לב למזהה האפליקציה.
Android
iOS
הוספת מיקומי מודעות חדשים
כדי ליצור מיקום חדש לשימוש עם AdMob בתהליך בחירת הרשת, עוברים אל מרכז הבקרה של מיקומי מודעות Liftoff Monetize, לוחצים על הלחצן הוספת מיקום ובוחרים את האפליקציה שלכם מהתפריט הנפתח חדשה.
בהמשך מפורטים פרטים על הוספת מיקומי מודעות חדשים:
מודעות בפתיחת האפליקציה
בוחרים באפשרות מודעה מעברון ומזינים שם מיקום. לאחר מכן, בוחרים באפשרות כן בשדה ניתן לדילוג וממלאים את שאר הטופס. [בידינג בלבד] מתחת מונטיזציה, מעבירים את המתג בידינג בתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את במיקום מודעה מסוים.
כרזה
בוחרים באפשרות באנר, מזינים שם מיקום וממלאים את שאר הפרטים בטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.
באנר 300x250
בוחרים באפשרות MREC, מזינים שם של מיקום מודעה וממלאים את שאר הפרטים בטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית המסך. כדי ליצור את המיקום.
מעברון
בוחרים באפשרות מעברון, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מחליפים את המצב של בידינג בתוך האפליקציה עובר למצב מופעל. לוחצים על הלחצן המשך ב התחתון של הדף כדי ליצור את המיקום.
ההטבה הופעלה
בוחרים באפשרות Rewarded, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית המסך. כדי ליצור את המיקום.
מודעות מעברון מתגמלות
בוחרים באפשרות מודעות מתגמלות. מזינים שם מיקום, מפעילים את האפשרות ניתן לדילוג וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מחליפים את מצב המתג מעבירים את בידינג בתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך. שבתחתית הדף כדי ליצור את המיקום.
מותאם
בוחרים באפשרות מודעות מותאמות, מזינים שם מיקום וממלאים את שאר הטופס הזה. [בידינג בלבד] בקטע מונטיזציה, מפעילים את האפשרות בידינג בתוך האפליקציה עוברים למצב מופעל. לוחצים על הלחצן המשך בתחתית המסך. כדי ליצור את המיקום.
בודקים את מזהה ההפניה ולוחצים על נשמע טוב.
מודעות בפתיחת האפליקציה
כרזה
באנר בגודל 300x250
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות
מותאם
איתור מפתח Reporting API
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
בנוסף למזהה האפליקציה ולמזהה העזרה, תצטרכו גם את מפתח ה-Reporting API של Liftoff Monetize כדי להגדיר את מזהה יחידת המודעות ב-AdMob. עוברים אל מרכז הבקרה של הדוחות של Liftoff Monetize וגם ללחוץ על מפתח Reporting API כדי להציג את Reporting API מקש.
הפעלת מצב בדיקה
כדי להפעיל מודעות בדיקה, עוברים ללוח הבקרה של Liftoff Monetize ולוחצים על Applications (אפליקציות).
בוחרים את האפליקציה שבה רוצים להפעיל מודעות בדיקה בקטע Placement Reference ID (מזהה העזר של מיקום המודעה) באפליקציה. כדי להפעיל מודעות בדיקה, בוחרים באפשרות Test Mode (מצב בדיקה) כדי להגדיר את האפשרות Show test ads only (הצגת מודעות בדיקה בלבד) בקטע Status (סטטוס).
Android
iOS
שלב 2: מגדירים את הביקוש ב-Liftoff Monetize ב AdMob ממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Liftoff לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
שלב 3: מייבאים את Vungle SDK ומתאם Liftoff Monetize
שילוב באמצעות pub.dev
צריך להוסיף את התלות הבאה בגרסאות האחרונות של
Liftoff Monetize ה-SDK והמתאם בחבילה שלך
קובץ pubspec.yaml
:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
שילוב ידני
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור Liftoff Monetize, מנתקים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את הפלאגין לקובץ pubspec.yaml
באמצעות יחסי התלות הבאים:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
שלב 4: הטמעת הגדרות הפרטיות ב-Liftoff Monetize SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, 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 לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של 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 |
באנר (מפל מים) | 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 |
באנר (מפל מים) | GADMAdapterVungleInterstitial |
מודעות מעברון (בידינג) | GADMediationAdapterVungle |
מודעות מעברון (Waterfall) | GADMAdapterVungleInterstitial |
מתגמלות (בידינג) | GADMediationAdapterVungle |
מודעות מתגמלות (Waterfall) | GADMAdapterVungleRewardBasedVideoAd |
מודעות מעברון מתגמלות (בידינג) | GADMediationAdapterVungle |
מודעות מעברון מתגמלות (Waterfall) | GADMediationAdapterVungle |
בטבלה הבאה מפורטים הקודים וההודעות הנלוות ל-Liftoff Monetize כשמודעה נכשלת להיטען:
Android
קוד שגיאה | סיבה |
---|---|
101 | פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום מודעה). |
102 | גודל הבאנר המבוקש לא ממופה למודעת Liftoff Monetize חוקית גודל. |
103 | כדי לבקש מודעות, נדרש הקשר Activity ב-Liftoff Monetize. |
104 | ה-SDK של Vungle לא יכול לטעון כמה מודעות לאותו מזהה מיקום מודעה. |
105 | לא הצלחנו לאתחל את ה-SDK של Vungle. |
106 | הקריאה החוזרת (callback) של הטעינה החוזרת בוצעה בהצלחה, אבל Banners.getBanner() או Vungle.getNativeAd() החזירו null. |
107 | Vungle SDK לא מוכן להפעלת המודעה. |
108 | Vungle SDK החזיר אסימון לא חוקי לבידינג. |
iOS
קוד שגיאה | סיבה |
---|---|
101 | פרמטרים לא חוקיים של השרת (למשל מזהה אפליקציה או מזהה מיקום מודעה). |
102 | כבר נטענה מודעה בהגדרת הרשת הזו. Vungle SDK לא ניתן לטעון מודעה שנייה עבור אותו מזהה מיקום. |
103 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-Liftoff Monetize. |
104 | לא ניתן היה להציג את מודעת הבאנר באמצעות Vungle SDK. |
105 | Vungle SDK תומך בטעינה של מודעת באנר אחת בלבד בכל פעם, ללא קשר ל מזהה של מיקום המודעה. |
106 | נשלחה שיחה חוזרת מ-Vungle SDK ואומרת שלא ניתן להפעיל את המודעה. |
107 | Vungle SDK לא מוכן להפעלת המודעה. |
אם מדובר בשגיאות שמקורן ב-Vungle SDK, אפשר לעיין במאמר קודי שגיאה: Vungle SDK ל-iOS ול-Android.
יומן השינויים של מתאם בחירת הרשת (Mediation) של Liftoff Monetize ל-Flutter
גרסה 1.1.0
- תאימות מאומתת למתאם Liftoff Monetize ב-Android גרסה 7.4.0.1
- תאימות מאומתת עם מתאם LiftoffMonetize ל-iOS בגרסה 7.4.0.1
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
גרסה 1.0.0
- הגרסה הראשונית.
- תאימות מאומתת עם מתאם Liftoff Monetize ל-Android בגרסה 7.3.1.0
- תאימות מאומתת למתאם LiftoffMonetize ל-iOS בגרסה 7.3.2.0
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.