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

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

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

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

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

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

3 השילוב של Waterfall בפורמט הזה נמצא בגרסת בטא סגורה.

דרישות

  • ה-SDK העדכני של Google Mobile Ads
  • 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

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

LiftoffMonetize.SetCCPAStatus(true);

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

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

Android

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

iOS

שילוב של SKAdNetwork

פועלים לפי מסמכי התיעוד של Liiftoff 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 ואומרת שלא ניתן להפעיל את המודעה.

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

גרסה 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 של Liiftoff Monetize בגרסה 7.3.1.0.
  • יש תמיכה במתאם ל-iOS של Liiftoff Monetize בגרסה 7.3.1.0.
  • נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.

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

גרסה 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.
  • תומך בגרסה 6.3.2.2 של מתאם iOS.

גרסה 3.1.2

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

גרסה 3.1.1

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

גרסה 3.1.0

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

גרסה 3.0.1

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

גרסה 3.0.0

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

גרסה 2.0.0

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

גרסה 1.1.0

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

גרסה 1.0.0

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