במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Unity Ads באמצעות תהליך בחירת הרשת, כולל שילובים של רשתות מודעות ב-Waterfall. במאמר מוסבר איך להוסיף את Unity Ads להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את Unity Ads SDK ואת המתאם שלו באפליקציה Flutter .
השילובים והפורמטים של המודעות הנתמכים
ל Ad Manager מתאם התהליך של בחירת הרשת ל-Unity Ads יש את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | 1 |
| מפל | |
| פורמטים | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
1 השילוב של הבידינג נמצא בגרסת בטא סגורה. כדי לבקש גישה, פנו למנהל החשבון שלכם.
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- Flutter מגרסה 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פעיל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
- מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של Unity Ads
נרשמים או נכנסים ל-Unity Ads.
יצירת פרויקט
במרכז הבקרה של Unity Ads, עוברים אל Projects ולוחצים על Create Project.
ממלאים את הטופס ולוחצים על Create Project (יצירת פרויקט) כדי להוסיף את הפרויקט.
עוברים אל מונטיזציה > תחילת העבודה ולוחצים על תחילת העבודה.
בחלון הדו-שיח Project Setup (הגדרת הפרויקט), בוחרים באפשרות I plan to use Mediation (אני מתכנן להשתמש בתהליך בחירת הרשת) ובאפשרות Google AdMob עבור Mediation Partner (שותף תהליך בחירת הרשת), ואז לוחצים על Next (הבא).
בוחרים את הגדרות המודעות ולוחצים על הבא.
ממלאים את הטופס ולוחצים על הוספת פרויקט.
שימו לב למזהה המשחק.
יצירת יחידת מודעות
עוברים אל מונטיזציה > יחידות מודעות ולוחצים על הוספת יחידת מודעות.
מזינים שם של יחידת מודעות ובוחרים את הפלטפורמה ואת פורמט המודעה.
Android
iOS
בסיום, לוחצים על יצירה כדי לשמור את יחידת המודעות.
הוספת מיקום מודעה
בידינג
כדי ליצור מיקומי מודעות לבידינג, פנו למנהל חשבון Google שלכם.
מפל
אחרי שיוצרים את הפרויקט, עוברים אל Monetization (מונטיזציה) > Placements (מיקומי מודעות). כדי ליצור מיקום מודעה חדש, לוחצים על Add Placement (הוספת מיקום מודעה) עבור יחידת המודעות.
ממלאים את הפרטים הנדרשים ולוחצים על הוספת מיקום.
שימו לב למזהה מיקום המודעה.
Android
iOS
איתור מפתח API לדיווח של Unity Ads
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
בנוסף למזהה המשחק ולמזהה מיקום המודעה, תצטרכו גם את מפתח ה-API ומזהה הליבה של הארגון ב-Unity Ads כדי להגדיר את מזהה יחידת המודעות ב-AdMob.
עוברים אל Monetization > Setup > API Management ומתעדים את מפתח הגישה ל-Monetization Stats API.
לאחר מכן, עוברים אל Monetization (מונטיזציה) > Organization Settings (הגדרות הארגון) ומתעדים את Organization core ID (מזהה הליבה של הארגון).
הפעלת מצב בדיקה
אפשר להפעיל את מצב הבדיקה דרך מרכז הבקרה של Unity Ads. בהגדרות הפרויקט, בוחרים בכרטיסייה Testing.
כדי לאלץ את מצב הבדיקה באפליקציה, לוחצים על לחצן העריכה של כל פלטפורמה, מסמנים את האפשרות Override client test mode ובוחרים באפשרות Force test mode ON (i.e. use test ads) for all devices.
Android
iOS
לחלופין, אפשר להפעיל את מצב הבדיקה במכשירים ספציפיים בלחיצה על הלחצן הוספת מכשיר בדיקה.
ממלאים את הטופס ולוחצים על שמירה.
שלב 2: מגדירים את הביקוש מ-Unity Ads בממשק המשתמש של Ad Manager
הגדרת הגדרות בחירת הרשת ליחידת המודעות
הוספה של Unity Ads לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Unity Ads לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob.
שלב 3: מייבאים את ה-SDK ואת המתאם של Unity Ads
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK ושל המתאם שלUnity Ads בקובץ pubspec.yaml של החבילה:
dependencies:
gma_mediation_unity: ^1.0.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);
פרטים נוספים על הערכים שאפשר לספק בכל שיטה מופיעים במדריך Privacy Consent and data APIs ובמדריך Complying with 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: מוסיפים את הקוד הנדרש
Android
אין צורך בקוד נוסף לשילובים של Unity Ads ל-Android.
iOS
שילוב עם SKAdNetwork
פועלים לפי המסמכים של Unity Ads כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בדיקה מעשית של ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של Unity Ads.
אימות מודעות לבדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-Unity Ads, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות Unity Ads (Bidding) ו-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 החזיר שגיאה. פרטים נוספים זמינים ב-code. |
| 101 | פרמטרים של שרת UnityAds שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים. |
| 102 | מערכת UnityAds החזירה מיקום מודעה במצב NO_FILL. |
| 103 | מערכת UnityAds החזירה מיקום מודעה במצב DISABLED. |
| 104 | מערכת UnityAds ניסתה להציג מודעה עם הקשר null. |
| 105 | ההקשר שמשמש להפעלה, לטעינה ו/או להצגת מודעות מ-Unity Ads הוא לא מופע של Activity. |
| 106 | מערכת UnityAds ניסתה להציג מודעה שלא מוכנה להצגה. |
| 107 | אין תמיכה ב-UnityAds במכשיר. |
| 108 | מערכת UnityAds יכולה לטעון רק מודעה אחת בכל מיקום מודעה בכל רגע נתון. |
| 109 | הקריאה ל-UnityAds הסתיימה במצב ERROR. |
| 200-204 | UnityAds Banner a specific error. פרטים נוספים זמינים במאמר קוד. |
iOS
| 0-9 | UnityAds SDK החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד של Unity. |
| 101 | פרמטרים של שרת UnityAds שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים. |
| 102 | המכשיר לא נתמך על ידי UnityAds. |
| 103 | המודעות של UnityAds הוצגו במצב השגיאה kUnityAdsFinishStateError. |
| 104 | אובייקט המודעה ב-Unity הוא nil אחרי הקריאה למפעיל שלו. |
| 105 | לא הצלחנו להציג מודעה של Unity Ads כי המודעה לא מוכנה. |
| 106 | מערכת UnityAds התקשרה להודעה חוזרת על שינוי במיקום מודעה עם סטטוס מיקום המודעה kUnityAdsPlacementStateNoFill. |
| 107 | מערכת UnityAds התקשרה ל-call back של שינוי מיקום מודעה עם סטטוס מיקום מודעה kUnityAdsPlacementStateDisabled. |
| 108 | כבר נטענה מודעה במיקום הזה. ה-SDK של UnityAds לא תומך בחיוב של כמה מודעות באותו מיקום מודעה. |
יומן השינויים של מתאם בחירת הרשת (Mediation) של Unity Ads ל-Flutter
גרסה 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.