שילוב של Unity Ads עם תהליך בחירת הרשת (Mediation)

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

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

המתאם של AdMob תהליך בחירת הרשת ב-Unity Ads כולל את היכולות הבאות:

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

דרישות

  • ה-SDK העדכני של מודעות Google לנייד
  • Unity מגרסה 4 ואילך
  • כדי לפרוס ב-Android
    • Android API ברמת 21 ואילך
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Unity עבודה שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
  • השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה

שלב 1: הגדרת הגדרות בממשק המשתמש של Unity Ads

נרשמים או מתחברים ל-Unity Ads.

יוצרים פרויקט

במרכז הבקרה של Unity Ads, נכנסים אל Projects ולוחצים על Create Project.

ממלאים את הטופס ולוחצים על Create Project כדי להוסיף את הפרויקט.

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

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

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

ממלאים את הטופס ולוחצים על הוספת פרויקט.

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

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

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

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

Android

iOS

לסיום, לוחצים על יצירה כדי לשמור את יחידת המודעות.

הוספת מיקום

לאחר יצירת הפרויקט, עוברים אל מונטיזציה > מיקומי מודעות. כדי ליצור מיקום חדש, לוחצים על Add Placement של יחידת המודעות.

ממלאים את הפרטים הנדרשים ולוחצים על הוספת מיקום.

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

Android

iOS

אחזור פרטי הכניסה

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

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

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

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

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

כדי לאלץ את מצב הבדיקה של האפליקציה, לוחצים על לחצן העריכה בכל פלטפורמה, מסמנים את האפשרות שינוי מצב הבדיקה של הלקוח ובוחרים באפשרות אילוץ מצב בדיקה מופעל (כלומר שימוש במודעות בדיקה) בכל המכשירים.

Android

iOS

לחלופין, אפשר להפעיל את מצב הבדיקה למכשירים ספציפיים באמצעות לחיצה על הלחצן Add Test Device.

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

שלב 2: הגדרת הביקוש למודעות ב-Unity AdMob בממשק המשתמש

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

Android

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

iOS

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

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

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

שלב 3: מייבאים את ה-SDK ואת המתאם של Unity Ads Ads

מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור Unity Ads מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsUnityAdsMediation.unitypackage מהקובץ zip.

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

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

שימוש במתאם ה-Unity בשירותי המודעות של Unity

אם אתם משלבים את Unity Ads SDK דרך החלונית 'שירותים', מנהל החבילות או חנות הנכסים, כבר יש לכם עותק של ה-SDK של Unity Ads ל-Android באפליקציה. כדי להימנע מבעיות עם סמלים כפולים במהלך הפיתוח ל-Android, תצטרכו להסיר את ההפניה ל-Unity Ads SDK.

מעדכנים את הקובץ Assets/GoogleMobileAds/Editor/UnityMediationDependencies.xml ומסירים את התלות של Unity Ads SDK:

<!-- If using the Unity Ads Service from Unity3D, comment out this dependency to
avoid including the Unity Ads Android SDK twice. -->
<androidPackage spec="com.unity3d.ads:unity-ads:x.y.z">
  <repositories>
    <repository>https://repo.maven.apache.org/maven2/</repository>
  </repositories>
</androidPackage>

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

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

פלאגין תהליך בחירת הרשת של Google Mobile Ads עבור Unity Ads גרסה 3.3.0 כולל את השיטה UnityAds.SetConsentMetaData() . הקוד לדוגמה הבא מראה איך להעביר פרטי הסכמה ל-Unity Ads SDK. אם תבחרו לקרוא לשיטה הזו, מומלץ לעשות זאת לפני שתבקשו מודעות דרך Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("gdpr.consent", true);

למידע נוסף ולערכים שאפשר לספק בכל שיטה, תוכלו לעיין במדריכים של Unity Ads Privacy Consent and data API (הסכמה בנושא פרטיות ונתונים) ו-ציות לתקנת ה-GDPR.

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

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

פלאגין תהליך בחירת הרשת של Google Mobile Ads עבור Unity Ads גרסה 3.3.0 כולל את השיטה UnityAds.SetConsentMetaData() . הקוד לדוגמה הבא מראה איך להעביר פרטי הסכמה ל-Unity Ads SDK. אם תבחרו לקרוא לשיטה הזו, מומלץ לעשות זאת לפני שתבקשו מודעות דרך Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("privacy.consent", true);

למידע נוסף ולערכים שאפשר לספק בכל שיטה, ניתן לעיין במדריכים של Unity Ads Privacy Consent and data APIs ו-ציות ל-CCPA.

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

Android

לא נדרש קוד נוסף לשילובים של Unity Ads ב-Android.

iOS

שילוב של SKAdNetwork

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

הידור של השגיאות

במתאם של Unity Ads מגרסה 3.4.0 ואילך, עליכם לבצע את שלבי השילוב במסמכי התיעוד של Unity.

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

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

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

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

כדי לוודא שמוצגות לך מודעות לבדיקה מ-Unity Ads, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Unity Ads (Waterfall) מקורות המודעות.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-Unity Ads, בעלי אפליקציות יכולים לבדוק את השגיאה הבסיסית מתגובת המודעה באמצעות ResponseInfo במחלקות הבאות:

Android

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS

GADMAdapterUnity
GADMediationAdapterUnity

ריכזנו כאן את הקודים וההודעות הנלוות שהתקבלו ממתאם UnityAds כשטעינת מודעה נכשלה:

Android

קוד שגיאה סיבה
0-10 התקבלה שגיאה מ-UnityAds SDK. לפרטים נוספים, ראו קוד.
101 חסרים פרמטרים של שרת UnityAds שהוגדרו בממשק המשתמש של AdMob.
102 מערכת UnityAds החזירה מיקום עם מצב NO_FILL.
103 מערכת UnityAds החזירה מיקום עם מצב מושבת.
104 המערכת של UnityAds ניסתה להציג מודעה עם הקשר ריק.
105 ההקשר שמשמש להפעלה, לטעינה או להצגה של מודעות מ-Unity Ads אינו מופע של פעילות.
106 מערכת UnityAds ניסתה להציג מודעה שלא מוכנה להצגה.
107 אין תמיכה ב-UnityAds במכשיר הזה.
108 מערכת UnityAds יכולה לטעון רק מודעה אחת לכל מיקום בכל פעם.
109 UnityAds סיימה עם מצב ERROR.
200-204 שגיאה ספציפית במודעת הבאנר של UnityAds. לפרטים נוספים, ראו קוד.

iOS

0-9 התקבלה שגיאה מ-UnityAds SDK. אפשר לקרוא פרטים נוספים במסמכי התיעוד של Unity.
101 חסרים פרמטרים של שרת UnityAds שהוגדרו בממשק המשתמש של AdMob.
102 המכשיר לא נתמך על ידי UnityAds.
103 ההצגה של UnityAds הסתיימה עם מצב השגיאה kUnityAdsFinishStateError.
104 אובייקט המודעה ב-Unity נשאר אפס לאחר קריאה למפעיל שלו.
105 ההצגה של מודעות Unity נכשלה כי המודעה לא מוכנה.
106 מערכת UnityAds קראה למיקום השתנתה קריאה חוזרת (callback) עם מצב המיקום kUnityAdsPositionStateNoFill.
107 מערכת UnityAds קראה למיקום השתנתה קריאה חוזרת (callback) עם מצב המיקום kUnityAdsPositionStateDisabled.
108 כבר נטענה מודעה עבור המיקום הזה. UnityAds SDK לא תומך בטעינה של מספר מודעות לאותו מיקום.

יומן שינויים של פלאגין תהליך בחירת הרשת של Unity Ads

גרסה 3.9.1

גרסה 3.9.0

גרסה 3.8.0

גרסה 3.7.1

גרסה 3.7.0

גרסה 3.6.1

גרסה 3.6.0

גרסה 3.5.0

גרסה 3.4.1

גרסה 3.4.0

גרסה 3.3.0

גרסה 3.2.1

גרסה 3.2.0

גרסה 3.1.0

גרסה 3.0.1

גרסה 3.0.0

גרסה 2.7.2

גרסה 2.7.1

גרסה 2.7.0

גרסה 2.6.0

גרסה 2.5.1

גרסה 2.5.0

גרסה 2.4.7

גרסה 2.4.6

גרסה 2.4.5

גרסה 2.4.4

גרסה 2.4.3

גרסה 2.4.2

גרסה 2.4.1

גרסה

גרסה

גרסה

גרסה

  • יש תמיכה במתאם Android של Unity Ads בגרסה 3.1.0.0.
  • יש תמיכה במתאם Unity Ads ל-iOS בגרסה 3.1.0.0.

גרסה 2.0.3

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

גרסה 2.0.2

  • יש תמיכה במתאם Android של Unity Ads בגרסה 3.0.0.0.
  • יש תמיכה במתאם iOS של Unity Ads בגרסה 3.0.0.1.

גרסה 2.0.1

  • תוקנה השגיאה 'סוג לא תואם' שגרמה לבעיות במהלך הבנייה עבור iOS.

גרסה

  • יש תמיכה במתאם Android של Unity Ads בגרסה 3.0.0.0.
  • יש תמיכה במתאם iOS של Unity Ads בגרסה 3.0.0.0.

גרסה 1.2.0

  • יש תמיכה במתאם Android Unity Ads בגרסה 2.3.0.0.
  • יש תמיכה במתאם Unity Ads ל-iOS בגרסה 2.3.0.0.

גרסה 1.1.3

  • יש תמיכה במתאם Android של Unity Ads בגרסה 2.2.1.0.
  • יש תמיכה במתאם Unity Ads ל-iOS בגרסה 2.2.1.0.

גרסה 1.1.2

  • יש תמיכה ב-Unity Ads Android SDK בגרסה 2.2.0.
  • יש תמיכה ב-Unity Ads iOS SDK בגרסה 2.2.0.
  • השיטה UnityAds.SetGdprConsentMetaData() נוספה כדי לבקש באופן ידני הבעת הסכמה של משתמש לפרסום מטורגט.

גרסה 1.1.1

  • יש תמיכה ב-Unity Ads Android SDK בגרסה 2.2.0.
  • יש תמיכה ב-Unity Ads iOS SDK בגרסה 2.2.1.

גרסה 1.1.0

  • יש תמיכה ב-Unity Ads Android SDK בגרסה 2.2.0.
  • יש תמיכה ב-Unity Ads iOS SDK בגרסה 2.2.0.

גרסה 1.0.0

  • השקה ראשונה!
  • יש תמיכה ב-Unity Ads Android SDK בגרסה 2.1.2.
  • יש תמיכה ב-Unity Ads iOS SDK בגרסה 2.1.2.