במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Liftoff Monetize באמצעות תהליך בחירת רשת, תוך התייחסות לשילובים של בידינג ושל רשימת רשתות. במאמר מוסבר איך להוסיף את Liftoff Monetize להגדרת בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של Vungle באפליקציהFlutter .
השילובים והפורמטים של המודעות הנתמכים
| שילוב | |
|---|---|
| בידינג | |
| מפל | |
| פורמטים | |
| מודעות בפתיחת האפליקציה | 1, 2 |
| מודעת באנר | 1 |
| מעברון | |
| ההטבה הופעלה | |
| מודעות מעברון מתגמלות | 1 |
| מותאם | 1, 2 |
1 השילוב של בידינג בפורמט הזה נמצא בגרסת בטא פתוחה.
השילוב של Waterfall עם הפורמט הזה ב-2 נמצא בגרסת בטא פתוחה.
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- Flutter 3.7.0 ואילך
- כדי לפרוס ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פעיל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת התהליך של תהליך בחירת הרשת המדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Liftoff Monetize
נרשמים או נכנסים לחשבון Liftoff Monetize.
מוסיפים את האפליקציה למרכז הבקרה של Liftoff Monetize בלחיצה על הלחצן Add Application.
ממלאים את הטופס ומזינים את כל הפרטים הנדרשים.
Android
iOS
אחרי שיוצרים את האפליקציה, בוחרים אותה במרכז הבקרה של אפליקציות Liftoff Monetize.
Android
iOS
שימו לב למזהה האפליקציה.
Android
iOS
הוספה של מיקומי מודעות חדשים
כדי ליצור מיקום מודעה חדש לשימוש בתהליך בחירת הרשת (Mediation) של AdMob, עוברים אל לוח הבקרה של מיקומי המודעות לייצור הכנסות ב-Liftoff, לוחצים על הלחצן Add Placement (הוספת מיקום מודעה) ובוחרים את האפליקציה מהרשימה הנפתחת.
בהמשך מפורטים פרטים על הוספת מיקומי מודעות חדשים:
מודעות בפתיחת האפליקציה
בוחרים באפשרות מודעה מעברון ומזינים שם מיקום. לאחר מכן, בוחרים באפשרות כן בשדה ניתן לדילוג וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.
מודעת באנר
בוחרים באפשרות באנר, מזינים שם מיקום וממלאים את שאר הפרטים בטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג בתוך האפליקציה למופעל. לוחצים על הלחצן Continue (המשך) בתחתית הדף כדי ליצור את המיקום.
באנר 300x250
בוחרים באפשרות MREC, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן Continue (המשך) בתחתית הדף כדי ליצור את המיקום.
מעברון
בוחרים באפשרות מעברון, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.
ההטבה הופעלה
בוחרים באפשרות מודעות מתגמלות, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.
מודעות מעברון מתגמלות
בוחרים באפשרות מתגמלת. מזינים שם מיקום, מפעילים את האפשרות ניתן לדילוג וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.
מותאם
בוחרים באפשרות Native, מזינים Location Name וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג בתוך האפליקציה למופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.
מציינים את מזהה ההפניה ולוחצים על בסדר גמור.
מודעות בפתיחת האפליקציה
מודעת באנר
באנר בגודל 300x250
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות
מותאם
איתור מפתח Reporting API
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
בנוסף למזהה האפליקציה ולמזהה העזרה, תצטרכו גם את מפתח ה-Reporting API של Liftoff Monetize כדי להגדיר את מזהה יחידת המודעות ב-AdMob. עוברים אל מרכז הבקרה של דוחות Liftoff Monetize ולוחצים על הלחצן Reporting API Key כדי להציג את מפתח ה-Reporting API.
הפעלת מצב בדיקה
כדי להפעיל מודעות בדיקה, עוברים ללוח הבקרה של Liftoff Monetize ולוחצים על אפליקציות.
בקטע Placement Reference ID (מזהה העזר של מיקום המודעה) באפליקציה, בוחרים את האפליקציה שרוצים להפעיל בה מודעות בדיקה. כדי להפעיל מודעות בדיקה, בקטע Status (סטטוס), בוחרים באפשרות Test Mode (מצב בדיקה) כדי להציג Show test ads only (הצגת מודעות בדיקה בלבד).
Android
iOS
שלב 2: מגדירים את הביקוש ב-Liftoff Monetize ב AdMob ממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של Liftoff לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Liftoff לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob.
שלב 3: מייבאים את ה-SDK של Vungle ואת המתאם של Liftoff Monetize
שילוב באמצעות pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK ושל המתאם שלLiftoff Monetize בקובץ 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");
למידע נוסף על הערכים שאפשר לספק ב-method, תוכלו לעיין בהוראות ההטמעה המומלצות בהתאם ל-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.
שלב 5: מוסיפים את הקוד הנדרש
Android
אין צורך בקוד נוסף לשילוב עם Liftoff Monetize.
iOS
שילוב עם SKAdNetwork
פועלים לפי המסמכים של Liftoff Monetize כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של Liftoff Monetize.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Liftoff Monetize, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Liftoff Monetize (Bidding) ו-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 | כדי לבקש מודעות, נדרש הקשר Activity ב-Liftoff Monetize. |
| 104 | ה-SDK של Vungle לא יכול לטעון כמה מודעות לאותו מזהה מיקום מודעה. |
| 105 | לא הצלחנו לאתחל את ה-SDK של Vungle. |
| 106 | ה-SDK של Vungle החזיר קריאה חוזרת (callback) מוצלחת לטעינה, אבל הפונקציה Banners.getBanner() או הפונקציה Vungle.getNativeAd() החזירו את הערך null. |
| 107 | ה-SDK של Vungle לא מוכן להפעיל את המודעה. |
| 108 | ה-SDK של Vungle החזיר טוקן בידינג לא תקין. |
iOS
| קוד שגיאה | סיבה |
|---|---|
| 101 | פרמטרים לא חוקיים של שרת (למשל, מזהה אפליקציה או מזהה מיקום מודעה). |
| 102 | כבר נטענה מודעה בהגדרת הרשת הזו. ה-SDK של Vungle לא יכול לטעון מודעה שנייה לאותו מזהה מיקום מודעה. |
| 103 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-Liftoff Monetize. |
| 104 | לא ניתן היה להציג את מודעת הבאנר באמצעות Vungle SDK. |
| 105 | ה-SDK של Vungle תומך רק בחיוב של מודעה באנר אחת בכל פעם, ללא קשר למזהה מיקום המודעה. |
| 106 | ה-SDK של Vungle שלח קריאה חוזרת עם הודעה על כך שלא ניתן להפעיל את המודעה. |
| 107 | ה-SDK של Vungle לא מוכן להפעיל את המודעה. |
אם מדובר בשגיאות שמקורן ב-Vungle SDK, אפשר לעיין במאמר קודי שגיאה: Vungle SDK ל-iOS ול-Android.
יומן שינויים של מתאם Flutter Mediation של Liftoff
הגרסה הבאה
- ה-plugin נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin בגרסה 5.2.0.
גרסה 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
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.