במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Unity Ads באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. במאמר הזה מוסבר איך להוסיף מודעות Unity לפלח של יחידת מודעות הגדרת תהליך בחירת הרשת (Mediation), ואיך לשלב את Unity Ads SDK והמתאם אפליקציה Flutter
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם תהליך בחירת הרשת עבור Unity Ads כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | 1 |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה |
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Flutter 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Flutter פעיל שהוגדר ב-Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Unity Ads
נרשמים או מתחברים ל-Unity Ads.
יצירת פרויקט
במרכז הבקרה של Unity Ads, עוברים אל Projects – לוחצים על Create Project.
ממלאים את הטופס ולוחצים על Create Project כדי להוסיף את הפרויקט.
מנווטים אל מונטיזציה > מתחילים ואז לוחצים על תחילת העבודה.
בחלון הגדרת הפרויקט, בוחרים באפשרות אני רוצה להשתמש בתהליך בחירת הרשת (Mediation) ובאפשרות Google AdMob של שותף בתהליך בחירת הרשת (Mediation), ואז לוחצים על הבא.
בוחרים את הגדרות המודעות ולוחצים על הבא.
ממלאים את הטופס ולוחצים על הוספת פרויקט.
מזינים את מזהה המשחק.
יצירה של יחידת מודעות
מנווטים אל מונטיזציה > יחידות מודעות, ולאחר מכן לוחצים על הוספה של יחידת מודעות.
מזינים שם של יחידת מודעות ובוחרים את הפלטפורמה ואת פורמט המודעה.
Android
iOS
לסיום, לוחצים על יצירה כדי לשמור את יחידת המודעות.
הוספת מיקום
בידינג
כדי ליצור מיקומי מודעות לבידינג, צריך לפנות לנציג של חשבון Google שלכם.
מפל
לאחר יצירת הפרויקט, עוברים אל מונטיזציה > מיקומי מודעות. שפת תרגום יוצרים מיקום חדש, לוחצים על הוספת מיקום ליחידת המודעות.
ממלאים את הפרטים הנדרשים ולוחצים על הוספת מיקום.
חשוב לשים לב למזהה מיקום המודעה.
Android
iOS
איתור מפתח Unity Ads Reporting API
בידינג
לא צריך לבצע את השלב הזה בשילוב של בידינג.
מפל
בנוסף למזהה המשחק ולמזהה המיקום, צריך גם את מפתח API ומזהה ליבה של הארגון ב-Unity Ads, לצורך הגדרת AdMob מזהה של יחידת מודעות.
מנווטים אל מונטיזציה > הגדרה > ניהול API וכתיבת הערות של מפתח הגישה ל-API של הנתונים הסטטיסטיים של המונטיזציה.
לאחר מכן עוברים אל מונטיזציה > הגדרות הארגון וכתיבת הערות של Organization Core ID.
הפעלת מצב בדיקה
אפשר להפעיל את מצב הבדיקה דרך מרכז הבקרה של Unity Ads. מתחת לפרויקט בוחרים בכרטיסייה בדיקה.
אפשר לאלץ את מצב הבדיקה של האפליקציה בלחיצה על לחצן העריכה פלטפורמה, בדיקה שינוי מצב בדיקת לקוח ובחירה אילוץ הפעלה של מצב בדיקה (כלומר שימוש במודעות בדיקה) בכל המכשירים.
Android
iOS
אפשר גם להפעיל את מצב הבדיקה במכשירים ספציפיים בלחיצה על לחצן להוספת מכשיר בדיקה.
ממלאים את הטופס ולוחצים על שמירה.
שלב 2: הגדרת ביקוש למודעות Unity ב- AdMob ממשק משתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Unity Ads לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Unity Ads לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-Unity Ads SDK והמתאם
שילוב באמצעות pub.dev
צריך להוסיף את התלות הבאה בגרסאות האחרונות של
Unity Ads ה-SDK והמתאם בחבילה שלך
קובץ pubspec.yaml
:
dependencies:
gma_mediation_unity: ^1.0.0
שילוב ידני
כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור
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 (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-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);
לצפייה במודעות Unity הסכמה בנושא פרטיות וממשקי API של נתונים וגם ציות ל-GDPR לקבלת פרטים נוספים על הערכים שניתן לספק בכל שיטה.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של 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' תיעוד
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 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 ניסתה להציג מודעה עם הקשר null. |
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) של מצב המיקום kUnityAdsStorageStateDisabled. |
108 | כבר נטענה מודעה עבור המיקום הזה. ב-UnityAds SDK לא ניתן לטעון כמה מודעות לאותו מיקום מודעה. |
יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-Unity Ads
גרסה 1.0.0
- גרסה ראשונית.
- תאימות מאומתת למתאם Android של Unity בגרסה 4.10.0.0
- תאימות מאומתת למתאם iOS של Unity בגרסה 4.10.0.0