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

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

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

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

שילוב
בידינג  1
מפל
פורמטים
כרזה
מעברון
ההטבה הופעלה
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) ביחידת המודעות

Android

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

iOS

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

הוספה 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

בכפוף להסכמת משתמשים של 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