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

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

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

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

דרישות

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

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

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

באנר 300x250

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

מעברון

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

ההטבה הופעלה

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

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

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

מותאם

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

רושמים את מזהה ההפניה ולוחצים על נשמע טוב.

באנר 300x250

מעברון

ההטבה הופעלה

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

מותאם

איתור מפתח Reporting API

בידינג

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

מפל

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

עדכון של קובץ app-ads.txt

Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt ל-Ad Manager.

כדי להטמיע את app-ads.txt ב-Liftoff Monetize, צריך להוריד את הרשומות של app-ads.txt ב-Liftoff Monetize ולצרף אותן לקובץ app-ads.txt הקיים. מידע נוסף זמין במאמר בנושא app-ads.txt.

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

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

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

Android

iOS

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין את הפלאגין Google Mobile Ads Liftoff Monetize Mediation Plugin for Unity בפרויקט שלכם על ידי הפעלת הפקודה הבאה מספריית הבסיס של הפרויקט:

openupm add com.google.ads.mobile.mediation.liftoffmonetize

OpenUPM

בכלי לעריכת פרויקטים ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את ההגדרות של מנהל החבילות ב-Unity.

בכרטיסייה Scoped Registries (מאגרי חבילות עם היקף), מוסיפים את OpenUPM כמאגר חבילות עם היקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפי הרשאות: com.google

פרטים על OpenUPM

לאחר מכן, עוברים אל Window > Package Manager (חלון > מנהל החבילות) כדי לפתוח את Unity Package Manager (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המאגרים שלי) בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads LiftoffMonetize Mediation ולוחצים על Install (התקנה).

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה האחרונה של פלאגין הגישור של Google Mobile Ads ל-Liftoff Monetize מקישור ההורדה ביומן השינויים ומחלצים את GoogleMobileAdsLiftoffMonetizeMediation.unitypackage מקובץ ה-ZIP.

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל תלות חיצוני > Android Resolver > Force Resolve (פתרון בכוח). ספריית External Dependency Manager (ניהול יחסי תלות חיצוניים) תבצע פתרון של יחסי תלות מאפס ותעתיק את יחסי התלות שהוגדרו לספרייה Assets/Plugins/Android של אפליקציית Unity.

אילוץ פתרון

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

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

החל מגרסה 5.2.2 של הפלאגין Unity ב-Liftoff Monetize, המערכת של Liftoff Monetize קוראת באופן אוטומטי את ההסכמה לתקנות GDPR שהוגדרה בפלטפורמות לניהול הסכמה שתומכות במפרט ההסכמה הנוספת של Google, כולל UMP SDK. מידע נוסף זמין בהוראות המומלצות להטמעה של GDPR ב-Android וב-iOS.

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

חוקי הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (בהתאם להגדרה המעוגנת בחוק זה). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אל תמכרו את המידע האישי שלי". במדריך בנושא עמידה בדרישות של חוקי הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (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: בדיקת ההטמעה

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

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

אימות מודעות בדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Liftoff Monetize, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Liftoff Monetize (Bidding)‎ (Liftoff Monetize (בידינג)) ו-Liftoff Monetize (Waterfall)‎ (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 מקור המודעות Liftoff Monetize דורש Activityהקשר כדי לשלוח בקשות להצגת מודעות.
104 ‫Vungle SDK לא יכול לטעון כמה מודעות לאותו מזהה מיקום מודעה.
105 האתחול של Vungle SDK נכשל.
106 ‫Vungle SDK החזיר קריאה חוזרת (callback) של טעינה מוצלחת, אבל הפונקציות Banners.getBanner() או Vungle.getNativeAd() החזירו ערך null.
107 ‫Vungle SDK לא מוכן להפעלת המודעה.
108 ‫Vungle SDK החזיר טוקן בידינג לא תקין.

iOS

קוד שגיאה סיבה
101 פרמטרים לא תקינים של השרת (לדוגמה, מזהה אפליקציה או מזהה מיקום).
102 כבר נטענה מודעה להגדרת הרשת הזו. ‫Vungle SDK לא יכול לטעון מודעה שנייה לאותו מזהה מיקום מודעה.
103 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך על ידי Liftoff Monetize.
104 לא הייתה אפשרות להציג את מודעת הבאנר ב-Vungle SDK.
105 ספריית Vungle SDK תומכת בטעינה של מודעת באנר אחת בלבד בכל פעם, ללא קשר למזהה המיקום.
106 ‫Vungle SDK שלח קריאה חוזרת שאומרת שהמודעה לא ניתנת להפעלה.
107 ‫Vungle SDK לא מוכן להפעלת המודעה.

אם השגיאות מגיעות מ-Vungle SDK, אפשר לעיין במאמר קודי שגיאה: Vungle SDK ל-iOS ול-Android.

יומן השינויים של פלאגין Liftoff Monetize Unity Mediation

גרסה 5.3.5 (בתהליך)

גרסה 5.3.4

גרסה 5.3.3

  • תוקנה בעיה שבה התקנה דרך OpenUPM גרמה לכך שהפלאגין לא ייבא את החבילות בצורה תקינה.

גרסה 5.3.2

  • תוקנה בעיה שבה התקנה דרך OpenUPM גרמה לכך שהפלאגין לא ייבא את החבילות בצורה תקינה.

גרסה 5.3.1

גרסה 5.3.0

גרסה 5.2.6

גרסה 5.2.5

גרסה 5.2.4

גרסה 5.2.3

גרסה 5.2.2

גרסה 5.2.1

גרסה 5.2.0

גרסה 5.1.1

גרסה 5.1.0

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

גרסה 5.0.0

גרסה 4.0.0

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

Version 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

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

גרסה 3.1.1

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

גרסה 3.1.0

  • תמיכה בגרסה 6.3.17.0 של המתאם ל-Android.
  • תמיכה בגרסת המתאם ל-iOS‏ 6.3.0.0.
  • עדכון של שיטת 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.
  • תמיכה בגרסת המתאם ל-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.