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

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

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

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

שילוב
בידינג	^1
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה

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

דרישות

• הגרסה העדכנית ביותר של Google Mobile Ads SDK
• Flutter מגרסה 3.7.0 ואילך
• [לבידינג]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש בפלאגין של Google Mobile Ads לבחירת רשת ב-Unity Ads בגרסה 3.11.1 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
• לפריסה ב-Android
  • Android API ברמה 21 ואילך
• לפריסה ב-iOS
  • יעד הפריסה של iOS מגרסה 12.0 ואילך
• פרויקט Flutter פעיל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
• מדריך לתחילת העבודה בנושא בחירת הרשת

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

נרשמים או נכנסים ל-Unity Ads.

יצירת פרויקט

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

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

עוברים אל מונטיזציה ב-Unity Ads ולוחצים על שנתחיל?.

בחלון הדו-שיח New Project, בוחרים באפשרות I will use Mediation ובאפשרות Google AdMob בשדה Mediation Partner, ואז לוחצים על Next.

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

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

בידינגמפל

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

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

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

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

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

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

AndroidiOS

בידינגמפל

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

שימו לב למזהה מיקום המודעה.

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

שימו לב למזהה מיקום המודעה.

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

איתור מפתח Unity Ads Reporting API

בידינגמפל

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

עוברים אל Monetization ב-Unity Ads > ניהול API ומתעדים את מפתח ה-API בקטע גישה ל-API של נתוני המונטיזציה.

לאחר מכן, עוברים אל Unity Ads Monetization‏ > Organization Settings ומתעדים את Organization core ID.

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

אפשר להפעיל את מצב הבדיקה דרך מרכז הבקרה של Unity Ads. עוברים אל Unity Ads Monetization (מונטיזציה ב-Unity Ads) > Testing (בדיקה).

כדי לאלץ מצב בדיקה באפליקציה, לוחצים על לחצן העריכה של כל פלטפורמה, מפעילים את האפשרות Override client test mode ובוחרים באפשרות Force test mode ON (i.e. use test ads) for all devices.

AndroidiOS

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

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

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

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

AndroidiOS

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

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

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

חשוב: עליכם לוודא שיש לכם הרשאת ניהול חשבון כדי להשלים את ההגדרה של הסכמה באיחוד האירופי, GDPR, ‏ CPRA ו-User Messaging Platform. פרטים נוספים זמינים במאמר ניהול הגישה של המשתמשים לחשבון.

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

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

הערה: אם לא תשתלבו את הגרסאות התואמות של Unity Ads ו-Google Mobile Ads SDK, יכול להיות שיהיו בעיות בגרסה הבנויה.

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK והמתאם של Unity Ads בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_unity: ^1.2.0

שילוב ידני

מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ל-Unity Ads, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את הפלאגין לקובץ pubspec.yaml באמצעות יחסי התלות הבאים:

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

הסכמה באיחוד האירופי ו-GDPR

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

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

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

פרטים נוספים על הערכים שאפשר לספק בכל שיטה מופיעים במדריך API להסכמה ולנתונים בנושא פרטיות ובמדריך תאימות ל-GDPR של Unity Ads.

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

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

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

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

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

AndroidiOS

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

שילוב עם SKAdNetwork

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

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

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

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

חשוב: לפני השקת האפליקציה, צריך להשבית את מצב הבדיקה ב-AdMob וב-Unity Ads.

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

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

קודי שגיאה

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

AndroidiOS

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

GADMAdapterUnity
GADMediationAdapterUnity

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

AndroidiOS

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

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

יומן השינויים של מתאם בחירת הרשת (Mediation) של Unity Ads ל-Flutter

גרסה 1.2.0

• תמיכה במתאם Unity ל-Android בגרסה 4.13.0.0.
• תמיכה במתאם Unity ל-iOS בגרסה 4.12.5.0.

• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.3.1.

גרסה 1.1.0

• תמיכה במתאם Unity ל-Android בגרסה 4.12.3.0.
• תמיכה במתאם Unity ל-iOS בגרסה 4.12.3.1.

• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.2.0.

גרסה 1.0.0

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

• הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.0.0.