שילוב של 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 ואילך
  • כדי לפרוס ב-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

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

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

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

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

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) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שיכולה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.

הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Unity Ads כולל את ה-method 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 כולל את ה-method 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 נכשלה כי המודעה לא מוכנה.
106 UnityAds שנקראה מיקום מודעה שינתה את הקריאה החוזרת (callback) של מצב המיקום kUnityAdsStorageStateNoFill.
107 ‏UnityAds הפעילה קריאה חוזרת (callback) על שינוי מיקום מודעה עם סטטוס מיקום מודעה kUnityAdsPlacementStateDisabled.
108 כבר נטענה מודעה במיקום הזה. ב-UnityAds SDK לא ניתן לטעון כמה מודעות לאותו מיקום מודעה.

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

גרסה 1.1.0

  • תאימות מאומתת עם מתאם Unity Android בגרסה 4.12.3.0
  • תאימות מאומתת עם מתאם Unity ל-iOS מגרסה 4.12.3.1
  • ה-plugin נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin בגרסה 5.2.0.

גרסה 1.0.0

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