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

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

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

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

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

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

דרישות

  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • Unity 4 ואילך
  • (לבידינג): הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Liftoff Monetize בגרסה 3.8.2 ואילך (מומלץ בגרסה האחרונה)
  • כדי לפרוס ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Unity פעיל שהוגדרה בו 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 (הוספת מיקום מודעה) ובוחרים את האפליקציה מהרשימה הנפתחת.

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

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

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

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

באנר 300x250

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

מעברון

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

ההטבה הופעלה

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

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

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

מותאם

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

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

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

באנר בגודל 300x250

מעברון

ההטבה הופעלה

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

מותאם

איתור מפתח Reporting API

בידינג

לא צריך לבצע את השלב הזה בשילוב של בידינג.

מפל

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

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

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

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

Android

iOS

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

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

Android

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

iOS

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

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

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

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

מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת (Mediation) של Google Mobile Ads עבור Liftoff Monetize מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsVungleMediation.unitypackage מקובץ ה-ZIP.

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package > Custom Package ומאתרים את הקובץ GoogleMobileAdsVungleMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

לאחר מכן, בוחרים באפשרות נכסים > פותר של Play Services > פותר של Android > פתרון בכוח. ספריית Unity Play Services Resolver תבצע פתרון של יחסי התלות מהתחלה ותעתיק את יחסי התלות שהוצהרו לתיקייה Assets/Plugins/Android של אפליקציית Unity.

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

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

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

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

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

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

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

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

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.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
באנר (מפל מים) 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 ההפעלה של Vungle SDK נכשלה.
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.

יומן השינויים של הפלאגין של Liftoff Monetize לבחירת רשת ב-Unity

גרסה 5.2.1

גרסה 5.2.0

גרסה 5.1.1

גרסה 5.1.0

  • תוקנה בעיה ב-NullPointerException שגרמה לכישלון build בזמן הייצוא כפרויקט ל-Android.
  • עדכנו את ממשקי ה-API לשמירה על הפרטיות:
    • הוסר השיטה UpdateConsentStatus() והשיטה UpdateCCPAStatus().
    • הוסרו המאפיינים המפורטים של VungleConsentStatus ו-VungleCCPAStatus.
    • עודכנה השיטה SetGDPRStatus(bool) ל-SetGDPRStatus(bool, String).
  • הסרתם את השיטות הבאות מהקלאס LiftoffMonetizeMediationExtras:
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • תמיכה במתאם Android של Liftoff Monetize בגרסה 7.3.1.0.
  • תמיכה במתאם Liftoff Monetize ל-iOS בגרסה 7.3.1.0.
  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 9.1.0.

גרסה 5.0.0

גרסה 4.0.0

  • פלאגין מיתוג מחדש של תהליך בחירת הרשת ב-Unity, מ-Vungle ל-Liftoff Monetize.
  • תוכן המתאם הועבר אל GoogleMobileAds/Mediation/LiftoffMonetize/.
  • שינוי מרחב השמות של המתאם כך שישתמש ב-GoogleMobileAds.Mediation.LiftoffMonetize.
  • נוספו למחלקה LiftoffMonetize את השיטות הבאות:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • יש תמיכה במתאם ל-Android של Liiftoff Monetize בגרסה 6.12.1.1.
  • יש תמיכה במתאם ל-iOS של Liiftoff Monetize בגרסה 7.0.1.0.
  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 8.4.1.

גרסה 3.9.2

גרסה 3.9.1

גרסה 3.9.0

גרסה 3.8.2

גרסה 3.8.1

גרסה 3.8.0

גרסה 3.7.5

גרסה 3.7.4

גרסה 3.7.3

גרסה 3.7.2

גרסה 3.7.1

גרסה 3.7.0

גרסה 3.6.0

גרסה 3.5.1

גרסה 3.5.0

גרסה 3.4.1

גרסה 3.4.0

גרסה 3.3.1

גרסה 3.3.0

גרסה 3.2.0

גרסה 3.1.4

  • תומך בגרסה 6.3.24.1 של מתאם Android.
  • תומך בגרסה 6.3.2.3 של מתאם iOS.

גרסה 3.1.3

  • תומך בגרסה 6.3.24.1 של מתאם Android.
  • התמיכה במתאם ל-iOS היא בגרסה 6.3.2.2.

גרסה 3.1.2

  • עדכנו את הפלאגין כך שיתמוך ב-Rewarded API החדש בגרסת בטא פתוחה.
  • תמיכה במתאם Android בגרסה 6.3.24.1.
  • תומך בגרסה 6.3.2.1 של מתאם iOS.

גרסה 3.1.1

  • התמיכה במתאם ל-Android מגיעה לגרסה 6.3.24.0.
  • יש תמיכה בגרסה 6.3.2.0 של מתאם iOS.
  • עדכנו את השיטה Vungle.UpdateConsentStatus() כדי שהפרמטר consentMessageVersion יהיה אופציונלי. עכשיו המערכת מתעלמת מהערך של consentMessageVersion ב-iOS.
  • Vungle.GetCurrentConsentMessageVersion() הוצא משימוש ב-iOS.

גרסה 3.1.0

  • תמיכה במתאם Android בגרסה 6.3.17.0.
  • יש תמיכה בגרסה 6.3.0.0 של מתאם iOS.
  • השיטה Vungle.UpdateConsentStatus() עודכנה כדי להוסיף פרמטר String נוסף לגרסת ההודעה לבקשת הסכמה שסופקה על ידי המפרסם.
  • נוספה השיטה Vungle.GetCurrentConsentMessageVersion() כדי לקבל את הגרסה של הודעת ההסכמה שסופקה על ידי בעל התוכן הדיגיטלי.

גרסה 3.0.1

  • תמיכה במתאם Android מגרסה 6.2.5.1.
  • תמיכה במתאם iOS בגרסה 6.2.0.3.

גרסה 3.0.0

  • התמיכה במתאם ל-Android מגיעה לגרסה 6.2.5.0.
  • תמיכה במתאם iOS בגרסה 6.2.0.2.
  • נוספו השיטות הבאות:
    • Vungle.UpdateConsentStatus() כדי להגדיר את סטטוס ההסכמה שיירשם ב-Vungle SDK.
    • שיטה אחת (Vungle.GetCurrentConsentStatus()) לקבלת סטטוס ההסכמה הנוכחי של המשתמש.

גרסה 2.0.0

  • יש תמיכה במתאם Android בגרסה 5.3.2.1.
  • תמיכה במתאם iOS בגרסה 6.2.0.0.

גרסה 1.1.0

  • יש תמיכה במתאם Android בגרסה 5.3.2.1.
  • תמיכה במתאם iOS בגרסה 5.4.0.0.

גרסה 1.0.0

  • גרסה ראשונה!
  • יש תמיכה בגרסה 5.3.0.0 של מתאם ל-Android.
  • תמיכה במתאם iOS בגרסה 5.3.0.0.