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

הערה: Vungle הוא עכשיו Liftoff Monetize.

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

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

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

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

השילוב של Waterfall עם הפורמט הזה ב-² נמצא בגרסת בטא פתוחה.

דרישות

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

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

נרשמים או נכנסים לחשבון Liftoff Monetize.

לוחצים על הלחצן Add Application כדי להוסיף את האפליקציה למרכז הבקרה של Liftoff Monetize.

ממלאים את הטופס ומזינים את כל הפרטים הנדרשים.

Android

iOS

אחרי שיוצרים את האפליקציה, בוחרים אותה במרכז הבקרה של אפליקציות Liftoff Monetize.

Android

iOS

שימו לב למזהה האפליקציה.

Android

iOS

הוספת מיקומי מודעות חדשים

כדי ליצור מיקום מודעה חדש לשימוש בתהליך בחירת הרשת (Mediation) של AdMob, עוברים אל לוח הבקרה של מיקומי המודעות לייצור הכנסות ב-Liftoff, לוחצים על הלחצן Add Placement (הוספת מיקום מודעה) ובוחרים את האפליקציה מהרשימה הנפתחת.

הערה: כשאתם יוצרים את האפליקציה בפעם הראשונה, מערכת Liftoff Monetize יוצרת באופן אוטומטי מיקום 'ברירת מחדל'. עם זאת, מומלץ ליצור מיקום חדש לבחירת הרשת (Mediation) באמצעות AdMob.

בהמשך מפורטים פרטים על הוספת מיקומי מודעות חדשים:

מודעות בפתיחת האפליקציה

בוחרים באפשרות מודעה מעברון ומזינים שם מיקום. לאחר מכן, בוחרים באפשרות כן בשדה ניתן לדילוג וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.

מודעת באנר

בוחרים באפשרות באנר, מזינים שם מיקום וממלאים את שאר הפרטים בטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.

מודעת באנר 300x250

בוחרים באפשרות MREC, מזינים שם של מיקום מודעה וממלאים את שאר הפרטים בטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.

מעברון

בוחרים באפשרות מעברון, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.

ההטבה הופעלה

בוחרים באפשרות Rewarded, מזינים שם מיקום וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.

מודעות מעברון מתגמלות

הערה: כדי להגדיר מודעות מעברון מתגמלות, נדרשת עזרה. אפשר לפנות למנהל החשבון שלכם ב-Liftoff Monetize או ל[e-mail].

בוחרים באפשרות מתגמלת. מזינים שם מיקום, מפעילים את האפשרות ניתן לדילוג וממלאים את שאר הטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.

חשוב: במודעות מעברון עם פרסים, הזמן שאפשר לדלג עליו לא יכול להיות 0. כדי לשנות את ההגדרה, פנו למנהל החשבון שלכם ב-Liftoff Monetize.

מותאם

בוחרים באפשרות Native, מזינים Placement Name וממלאים את שאר הפרטים בטופס. [בידינג בלבד] בקטע מונטיזציה, מעבירים את המתג בידינג מתוך האפליקציה למצב מופעל. לוחצים על הלחצן המשך בתחתית הדף כדי ליצור את מיקום המודעות.

הערה: המתג בידינג בתוך האפליקציה לא זמין כברירת מחדל למודעות מותאמות. כדי להפעיל את התכונה, פנו למנהל החשבון שלכם ב-Liftoff Monetize.

מציינים את מזהה ההפניה ולוחצים על בסדר גמור.

מודעות בפתיחת האפליקציה

מודעת באנר

מודעת באנר 300x250

מעברון

ההטבה הופעלה

מודעות מעברון מתגמלות

מותאם

איתור מפתח Reporting API

בידינג

השלב הזה לא נדרש בשילובי בידינג.

מפל

בנוסף למזהה האפליקציה ולמזהה העזרה, תצטרכו גם את מפתח ה-Reporting API של Liftoff Monetize כדי להגדיר את מזהה יחידת המודעות ב-AdMob. עוברים אל מרכז הבקרה של דוחות Liftoff Monetize ולוחצים על הלחצן Reporting API Key כדי להציג את מפתח ה-Reporting API.

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

כדי להפעיל מודעות בדיקה, עוברים ללוח הבקרה של Liftoff Monetize ולוחצים על Applications (אפליקציות).

בוחרים את האפליקציה שרוצים להפעיל בה מודעות בדיקה בקטע Placement Reference ID (מזהה העזר של מיקום המודעה) באפליקציה. כדי להפעיל מודעות בדיקה, בוחרים באפשרות Test Mode (מצב בדיקה) כדי להגדיר את האפשרות Show test ads only (הצגת מודעות בדיקה בלבד) בקטע Status (סטטוס).

Android

iOS

שלב 2: הגדרת Liftoff Monetize demand בממשק המשתמש של AdMob

הגדרת הגדרות בחירת הרשת ליחידת המודעות

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.

iOS

להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.

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

חשוב: עליכם לוודא שיש לכם הרשאת ניהול חשבון כדי להשלים את ההגדרה של הסכמה באיחוד האירופי ו-GDPR,‏ CPRA ו-User Messaging Platform. פרטים נוספים זמינים במאמר ניהול הגישה של משתמשים לחשבון.

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

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

הערה: אי-שילוב של הגרסאות התואמות של Vungle ו-Google Mobile Ads SDK עלול להוביל לבעיות ב-build.

שילוב דרך 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) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת פרסום בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, 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.

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

Android

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

iOS

שילוב עם SKAdNetwork

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

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

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

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

חשוב: לפני השקת האפליקציה, צריך להשבית את מצב הבדיקה ב-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
באנר (מפל מים)	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	ה-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.

יומן השינויים של מתאם בחירת הרשת (Mediation) של Liftoff Monetize ל-Flutter

הגרסה הבאה

• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 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

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