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

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

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

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

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

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 ולוחצים על 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

איתור מפתח Reporting 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 בממשק המשתמש של AdMob

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

Android

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

iOS

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

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

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

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

שילוב דרך 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

בהתאם למדיניות 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) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.

הפלאגין של 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
  • ה-plugin נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin בגרסה 5.0.0.