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

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

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

שילוב
בידינג
מפל
פורמטים
כרזה 1
פרסומת מרווח ביניים
ההטבה הופעלה
מודעת מעברון מתגמלת 1, 2

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

2 מודעות מעברון מתגמלות צריכות עזרה בהגדרה. תוכלו לפנות למנהל החשבון שלכם ב-Liftoff Monetize או ב-monetize@liftoff.io.

דרישות

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

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

לוחצים על 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) ביחידת המודעות

Android

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

iOS

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

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

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

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

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

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

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

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

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

הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור גרסה 4.0.0 של Liftoff Monetize מכיל שיטות להעברת מידע על הסכמה ל-Vungle SDK.

Android

יש שני ערכים אפשריים שאפשר לציין כשמעדכנים את סטטוס ההסכמה:

  • VungleConsentStatus.OPTED_IN
  • VungleConsentStatus.OPTED_OUT

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

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

LiftoffMonetize.UpdateConsentStatus(VungleConsentStatus.OPTED_IN, "1.0.0");

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

iOS

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

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

LiftoffMonetize.SetGDPRStatus(true);
LiftoffMonetize.SetGDPRMessageVersion("1.0.0");

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

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

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

הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור גרסה 4.0.0 של Liftoff Monetize מכיל שיטות להעברת מידע על הסכמה ל-Vungle SDK.

Android

יש שני ערכים אפשריים שאפשר לציין כשמעדכנים את סטטוס ההסכמה:

  • VungleCCPAStatus.OPTED_IN
  • VungleCCPAStatus.OPTED_OUT

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

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

LiftoffMonetize.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);

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

iOS

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

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

LiftoffMonetize.SetCCPAStatus(true);

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

שלב 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 שלח קריאה חוזרת (callback) שלפיה לא ניתן להפעיל את המודעה.

יומן שינויים של Liftoff Monetize Unity Mediation Plugin

גרסה 5.1.0

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

גרסה 5.0.0

גרסה 4.0.0

  • פלאגין תהליך בחירת הרשת (Mediation) ב-Unity, שעבר מיתוג מחדש, מ-Vungle ל-Liftoff Monetize.
  • תוכן המתאם הועבר אל GoogleMobileAds/Mediation/LiftoffMonetize/.
  • מרחב השמות של המתאם שהוגדר מחדש לצורך שימוש ב-GoogleMobileAds.Mediation.LiftoffMonetize.
  • נוספו למחלקה LiftoffMonetize את השיטות הבאות:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • יש תמיכה במתאם Android Liftoff Monetize בגרסה 6.12.1.1.
  • יש תמיכה במתאם ל-iOS של Liftoff 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

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

גרסה 3.1.3

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

גרסה 3.1.2

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

גרסה 3.1.1

  • תמיכה במתאם Android בגרסה 6.3.24.0.
  • יש תמיכה בגרסה 6.3.2.0 של מתאם iOS.
  • עודכנה שיטת Vungle.UpdateConsentStatus() כך שהפרמטר consentMessageVersion יהיה אופציונלי. ב-iOS, המערכת מתעלמת עכשיו מהערך של consentMessageVersion.
  • 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.
  • יש תמיכה בגרסה 6.2.0.3 של מתאם iOS.

גרסה 3.0.0

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

גרסה

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

גרסה 1.1.0

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

גרסה 1.0.0

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