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

במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Unity Ads באמצעות תהליך בחירת רשת (Mediation), כולל שילובים של רשימת רשתות (Waterfall). במאמר מוסבר איך להוסיף את Unity Ads להגדרת בחירת הרשת של יחידת מודעות, ואיך לשלב את 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. פרטים נוספים זמינים במאמר תחילת השימוש.
  • מדריך לתחילת העבודה בנושא בחירת הרשת

שלב 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 שלכם.

מפל

לאחר יצירת הפרויקט, עוברים אל מונטיזציה > מיקומי מודעות. כדי ליצור מיקום מודעה חדש, לוחצים על Add Placement (הוספת מיקום מודעה) עבור יחידת המודעות.

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

חשוב לשים לב למזהה מיקום המודעה.

Android

iOS

איתור מפתח Unity Ads Reporting API

בידינג

השלב הזה לא נדרש בשילובי בידינג.

מפל

בנוסף למזהה המשחק ולמזהה המיקום, צריך גם את מפתח API ומזהה ליבה של הארגון ב-Unity Ads, לצורך הגדרת מזהה של יחידת מודעות ב-AdMob.

מנווטים אל מונטיזציה > הגדרה > ניהול API וכתיבת הערות של מפתח הגישה ל-API של הנתונים הסטטיסטיים של המונטיזציה.

לאחר מכן, עוברים אל Monetization (מונטיזציה) > Organization Settings (הגדרות הארגון) ומתעדים את Organization core ID (מזהה הליבה של הארגון).

הפעלת מצב בדיקה

אפשר להפעיל את מצב הבדיקה דרך מרכז הבקרה של Unity Ads. מתחת לפרויקט בוחרים בכרטיסייה בדיקה.

אפשר לאלץ את מצב הבדיקה של האפליקציה בלחיצה על לחצן העריכה פלטפורמה, בדיקה שינוי מצב בדיקת לקוח ובחירה אילוץ הפעלה של מצב בדיקה (כלומר שימוש במודעות בדיקה) בכל המכשירים.

Android

iOS

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

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

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

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

Android

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

iOS

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

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

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

שילוב באמצעות pub.dev

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

הפלאגין של 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. פרטים נוספים זמינים ב-code.
101 פרמטרים של שרת UnityAds שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
102 מערכת UnityAds החזירה מיקום מודעה במצב NO_FILL.
103 מערכת UnityAds החזירה מיקום מודעה במצב DISABLED.
104 מערכת UnityAds ניסתה להציג מודעה עם הקשר null.
105 ההקשר שמשמש לאתחול, טעינה או הצגה של מודעות מ-Unity Ads אינו מופע פעילות.
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 הוא אפס אחרי קריאה למאתחל שלו.
105 ההצגה של מודעות Unity נכשלה כי המודעה לא מוכנה.
106 מערכת UnityAds התקשרה להודעה חוזרת על שינוי מיקום מודעה עם סטטוס מיקום המודעה kUnityAdsPlacementStateNoFill.
107 ‏UnityAds הפעילה קריאה חוזרת (callback) על שינוי מיקום מודעה עם סטטוס מיקום מודעה kUnityAdsPlacementStateDisabled.
108 כבר נטענה מודעה עבור המיקום הזה. ‏UnityAds SDK לא תומך בחיוב של כמה מודעות באותו מיקום מודעה.

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

גרסה 1.1.0

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

גרסה 1.0.0

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