במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Liftoff Monetize באמצעות תהליך בחירת הרשת (Mediation), שכולל גם בידינג וגם שילובים של Waterfall. במאמר הזה מוסבר איך להוסיף את Liftoff Monetize לנכס של יחידת מודעות להגדרת תהליך בחירת הרשת, ואיך לשלב את Vungle SDK והמתאם אפליקציה אחת (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
נרשמים או מתחברים לחשבון Liftoff Monetize.
מוסיפים את האפליקציה למרכז הבקרה של Liftoff Monetize בלחיצה על הלחצן Add Application (הוספת אפליקציה).
ממלאים את הטופס ומזינים את כל הפרטים הנדרשים.
Android
iOS
אחרי שיוצרים את האפליקציה, בוחרים אותה ממרכז הבקרה של Liftoff Monetize.
Android
iOS
חשוב לשים לב למזהה האפליקציה.
Android
iOS
הוספה של מיקומי מודעות חדשים
כדי ליצור מיקום מודעה חדש לשימוש עם AdMob תהליך בחירת הרשת, נכנסים אל מרכז הבקרה של Liftoff Monetize, לוחצים על Add Placement ובוחרים את האפליקציה מהרשימה הנפתחת.
פרטים על הוספת מיקומים חדשים מופיעים בהמשך:
מודעות בפתיחת האפליקציה
בוחרים באפשרות מעברון ומזינים שם של מיקום מודעה. לאחר מכן, בוחרים באפשרות כן בשדה ניתנת לדילוג וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את בידינג בתוך האפליקציה למצב מופעל. לחץ על הלחצן Continue (המשך) בתחתית הדף על מנת ליצור את המיקום.
כרזה
לוחצים על Banner, מזינים שם של מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג בתוך האפליקציה למצב מופעל. לחץ על הלחצן Continue (המשך) בתחתית הדף על מנת ליצור את מיקום המודעה.
מודעת באנר 300x250
בוחרים באפשרות MREC, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג בתוך האפליקציה למצב מופעל. לחץ על הלחצן Continue (המשך) בתחתית הדף על מנת ליצור את מיקום המודעה.
פרסומת מרווח ביניים
בוחרים באפשרות מעברון, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג בתוך האפליקציה למצב מופעל. לחץ על הלחצן Continue (המשך) בתחתית הדף על מנת ליצור את מיקום המודעה.
ההטבה הופעלה
בוחרים באפשרות מתגמלת, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג בתוך האפליקציה למצב מופעל. לחץ על הלחצן Continue (המשך) בתחתית הדף על מנת ליצור את מיקום המודעה.
מודעת מעברון מתגמלת
בוחרים באפשרות מתגמלת. מזינים שם מיקום, מפעילים את האפשרות ניתנת לדילוג וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את בידינג בתוך האפליקציה למצב מופעל. לחץ על הלחצן Continue (המשך) בתחתית הדף על מנת ליצור את מיקום המודעה.
מותאם
בוחרים באפשרות Native, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג בתוך האפליקציה למצב מופעל. לחץ על הלחצן Continue (המשך) בתחתית הדף על מנת ליצור את מיקום המודעה.
מציינים את מזהה ההפניה ולוחצים על צלילים טובים.
מודעות בפתיחת האפליקציה
כרזה
מודעת באנר 300x250
פרסומת מרווח ביניים
ההטבה הופעלה
מודעת מעברון מתגמלת
מותאם
איתור מפתח ה-Reporting API
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
בנוסף למזהה האפליקציה ולמזהה ההפניה, תצטרכו גם את מפתח ה-Reporting API של Liftoff Monetize כדי להגדיר אתAdMob המזהה של יחידת המודעות. נכנסים למרכז הבקרה של Liftoff Monetize Reports ולוחצים על Reporting API Key כדי להציג את מפתח Reporting API.
הפעלת מצב בדיקה
כדי להפעיל מודעות בדיקה, נכנסים למרכז הבקרה של Liftoff Monetize ועוברים לקטע Applications (אפליקציות).
בקטע מזהה מיקום באפליקציה בוחרים את האפליקציה שבה רוצים להפעיל את מודעות הבדיקה. בקטע סטטוס בוחרים באפשרות מצב בדיקה כדי להפעיל את מודעות הבדיקה.
Android
iOS
שלב 2: מגדירים את הביקוש ב-Liftoff Monetize ב AdMob ממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Liftoff לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Liftoff לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את Vungle SDK ומתאם 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
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של 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 לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של 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
במחלקות הבאות:
iOS
פורמט | שם הכיתה |
---|---|
כרזה | GADMAdapterVungleInterstitial |
מעברון | GADMAdapterVungleInterstitial |
ההטבה הופעלה | GADMAdapterVungleRewardBasedVideoAd |
בטבלה הבאה מפורטים הקודים וההודעות הנלוות ל-Liftoff Monetize כשמודעה נכשלת להיטען:
iOS
קוד שגיאה | סיבה |
---|---|
1-100 | Vungle SDK החזיר שגיאה. להצגת הקוד אפשר לקבל פרטים נוספים. |
101 | הפרמטרים של שרת Liftoff Monetize שהוגדרו ב AdMob ממשק המשתמש חסרים או לא תקינים. |
102 | כבר נטענה מודעה לתצורת הרשת הזו. Vungle SDK לא יכול לטעון מודעה שנייה עבור אותו מזהה מיקום. |
103 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-Liftoff Monetize. |
104 | לא ניתן היה לעבד את מודעת הבאנר ב-Vungle SDK. |
105 | ב-Vungle SDK יש תמיכה בטעינה של מודעת באנר אחת בלבד בכל פעם, ללא קשר למזהה מיקום המודעה. |
106 | נשלחה שיחה חוזרת מ-Vungle SDK ואומרת שלא ניתן להפעיל את המודעה. |
יומן שינויים של מתאם 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.