במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-InMobi באמצעות תהליך בחירת הרשת (Mediation), תוך שימוש בשילובים של Waterfall ושל בידינג. נסביר איך להוסיף את InMobi להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את InMobi SDK ואת המתאם באפליקציה של Unity.
שילובים נתמכים ופורמטים נתמכים של מודעות
שילוב | |
---|---|
בידינג | 1 |
מפל | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה |
1 השילוב של תכונת הבידינג נמצא בגרסת בטא סגורה. צריך לפנות למנהל החשבון ולבקש גישה.
דרישות
- Unity 4 ואילך
- ה-SDK העדכני של מודעות Google לנייד
- כדי לפרוס ב-Android
- Android API ברמת 19 ואילך
- כדי לפרוס ב-iOS
- יעד פריסת iOS של 10.0 ומעלה
- פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה
שלב 1: הגדרת הגדרות בממשק המשתמש של InMobi
נרשמים לחשבון InMobi.
בידינג
בוחרים באפשרות Use InMobi SSP with Google Open Bidding (שימוש ב-InMobi SSP with Google Open Bidding) ומזינים את מזהה בעל התוכן הדיגיטלי ב-Google.
מפל
לא נדרש שלב נוסף כדי לשלב Waterfall.
לאחר האימות, מתחברים לחשבון InMobi.
הוספת אפליקציה
כדי להוסיף את האפליקציה למרכז הבקרה של InMobi, לוחצים על מלאי > הגדרות מלאי.
לחץ על הוספת מלאי ובחר בערוץ האפליקציה לנייד מהתפריט הנפתח.
מתחילים להקליד את כתובת ה-URL של חנות האפליקציות שפרסמתם בסרגל החיפוש, ובוחרים את האפליקציה מתוך התוצאות שמופיעות. לוחצים על Continue (המשך).
אם האפליקציה לא פורסמה, לוחצים על Link manually (קישור ידני) ומזינים את הפרטים הנדרשים. לוחצים על Continue (המשך).
בודקים את ההגדרות של App &Website Compliance ולוחצים על שמירה ויצירה של מיקומי מודעות.
מיקומי מודעות
אחרי שמגדירים את המלאי, המערכת מפנה אתכם לתהליך העבודה של יצירת מיקומי מודעות.
בידינג
בוחרים את הסוג של יחידת המודעות. מזינים שם מיקום, בוחרים את האפשרויות On ו-Google Open Bidding עבור Audience Bidding ו-Partner בהתאמה, וממלאים את שאר הטופס. בסיום, לוחצים על Create Placement.
מפל
בוחרים את הסוג של יחידת המודעות. מזינים שם מיקום, בוחרים באפשרות השבתה עבור בידינג על הקהל וממלאים את שאר הטופס. בסיום, לוחצים על Create Placement.
לאחר יצירת מיקום המודעה, הפרטים שלו מוצגים. חשוב לזכור את מזהה מיקום המודעה, שישמש להגדרת יחידת המודעותAdMob .
מספר חשבון
מזהה חשבון InMobi שלך זמין בקטע פיננסים > הגדרות תשלום > פרטי תשלום.
איתור מפתח של InMobi Reporting API
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
עוברים אל החשבון שלי > הגדרות חשבון. מנווטים לכרטיסייה API Key ולוחצים על Generate API Key.
בוחרים את כתובת האימייל של המשתמש שעבורו המפתח נדרש, ולוחצים על Generate API Key. ייווצר קובץ שמכיל את מפתח ה-API ואת שם המשתמש או שם ההתחברות.
רק האדמין של בעל האפליקציה בחשבון יוכל ליצור מפתח API לכל המשתמשים. אם שכחתם את מפתח ה-API שנוצר בעבר, תוכלו לאפס את מפתח ה-API על ידי העברת העכבר מעל כתובת האימייל שלכם בכרטיסייה API Key.
הפעלת מצב בדיקה
הפעילו את מצב הבדיקה עבור המיקום בכל החשיפות בזמן אמת או רק במכשירי בדיקה מסוימים.
שלב 2: הגדרת ביקוש ב-InMobi AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של InMobi לרשימת שותפי הפרסום של תקנות GDPR ותקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את InMobi לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK ואת המתאם של InMobi
מורידים את הגרסה האחרונה של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור InMobi דרך קישור ההורדה ב-Changelog, וחלצו את GoogleMobileAdsInMobiMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקטים ב-Unity, בוחרים באפשרות נכסים > ייבוא חבילה > חבילה מותאמת אישית ובוחרים את GoogleMobileAdsInMobiMediation.unitypackage
הקובץ שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.
לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force
resolve. ספריית Unity Play Services Solutionr תבצע פתרון בעיות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-InMobi SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.
בפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads בגרסה 2.1.0 נוספה השיטה InMobi.UpdateGDPRConsent()
, שמאפשרת להעביר מידע על הסכמה ל-InMobi. הקוד לדוגמה הבא מראה איך להעביר פרטי הסכמה ל-InMobi SDK. אם תבחרו לקרוא לשיטה הזו, מומלץ לעשות זאת לפני שתבקשו מודעות באמצעות Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...
Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");
InMobi.UpdateGDPRConsent(consentObject);
בפרטי ההטמעה של GDPR ב-InMobi מפורט מידע נוסף על המפתחות והערכים האפשריים ש-InMobi מקבלת באובייקט ההסכמה הזה.
חוקי הפרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.
במסמכי התיעוד בנושא CCPA של InMobi מפורטות הנחיות להפעלת הגדרות CCPA ב-InMobi.
שלב 5: מוסיפים את הקוד הנדרש
Android
שילוב InMobi לא נדרש קוד נוסף.
iOS
שילוב של SKAdNetwork
פועלים לפי מסמכי העזרה של InMobi כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב InMobi ממשק המשתמש.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-InMobi, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות InMobi (Bidding) and InMobi (Waterfall) מקורות המודעות.
שלבים אופציונליים
Android
הרשאות
כדי להשיג ביצועים אופטימליים, ההמלצה של InMobi היא להוסיף את ההרשאות האופציונליות הבאות לקובץ AndroidManifest.xml
של האפליקציה.
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
אפשר להוסיף את ההרשאות האלה לקובץ Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
.
iOS
אין צורך לבצע שלבים נוספים לשילוב עם iOS.
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-InMobi, בעלי תוכן דיגיטלי יוכלו לבדוק את השגיאה הבסיסית מתגובת המודעה באמצעות ResponseInfo
במחלקות הבאות:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
ריכזנו כאן את הקודים וההודעות הנלוות שהתקבלו ממתאם InMobi כשטעינת מודעה נכשלה:
Android
קוד שגיאה | סיבה |
---|---|
0-99 | שגיאות InMobi SDK. לפרטים נוספים, ראו קוד. |
100 | הפרמטרים של שרת InMobi שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים. |
101 | אתחול ה-SDK של InMobi נכשל. |
102 | גודל המודעה המבוקש אינו תואם גודל מודעת באנר הנתמך על ידי InMobi. |
103 | בקשה להצגת מודעה אינה בקשה מאוחדת להצגת מודעה מותאמת. |
104 | ניסית לבקש מודעת InMobi בלי להפעיל את InMobi SDK. בתיאוריה, זה לא אמור לקרות, כי המתאם מפעיל את InMobi SDK לפני הבקשה להצגת מודעות InMobi. |
105 | המודעה של InMobi עדיין לא מוכנה להצגה. |
106 | המודעה לא הוצגה ב-InMobi. |
107 | InMobi החזירה מודעה מותאמת שחסר בה נכס נדרש. |
108 | נכסי התמונות המותאמות של InMobi כוללים כתובת URL בפורמט שגוי. |
109 | המתאם לא הצליח להוריד את נכסי התמונה המותאמים למודעות המותאמות של InMobi. |
iOS
קוד שגיאה | סיבה |
---|---|
101 | הפרמטרים של שרת InMobi שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים. |
102 | מתאם InMobi לא תומך בפורמט המודעה המבוקש. |
103 | כבר נטענה מודעת InMobi להגדרת הרשת הזו. |
אחר | InMobi SDK החזיר שגיאה. את יכולה לראות עוד פרטים בכתובת IMRequestStatus.h . |
יומן שינויים של פלאגין תהליך בחירת הרשת של InMobi Unity
גרסה 4.4.1
- יש תמיכה במתאם InMobi Android בגרסה 10.6.2.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.6.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.6.0.
גרסה 4.4.0
- יש תמיכה במתאם InMobi Android בגרסה 10.6.0.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.6.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.6.0.
גרסה 4.3.3
- יש תמיכה במתאם InMobi Android בגרסה 10.5.8.0.
- תומך במתאם InMobi iOS בגרסה 10.5.8.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.5.2 נוצרה ונבדקה.
גרסה 4.3.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/InMobi/
. - מרחב השמות של המתאם שהוגדר מחדש לצורך שימוש ב-
GoogleMobileAds.Mediation.InMobi
. - יש תמיכה במתאם InMobi Android בגרסה 10.5.4.1.
- תומך במתאם InMobi iOS בגרסה 10.5.4.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.1.0 נוצרה ונבדקה.
גרסה 4.2.2
- יש תמיכה במתאם InMobi Android גרסה 10.1.2.1.
- יש תמיכה במתאם InMobi iOS בגרסה 10.1.2.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.1.
גרסה 4.2.1
- יש תמיכה במתאם InMobi Android בגרסה 10.1.2.0.
- יש תמיכה במתאם InMobi ל-iOS בגרסה 10.1.2.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.1.
גרסה 4.2.0
- יש תמיכה במתאם InMobi Android בגרסה 10.1.1.0.
- יש תמיכה במתאם InMobi ל-iOS בגרסה 10.1.1.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.0.
גרסה 4.1.0
- יש תמיכה במתאם InMobi Android בגרסה 10.0.9.0.
- יש תמיכה במתאם InMobi iOS בגרסה 10.1.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.0.
גרסה 4.0.4
- יש תמיכה במתאם InMobi Android גרסה 10.0.7.0.
- תומך במתאם InMobi iOS בגרסה 10.0.7.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.2.
גרסה 4.0.3
- יש תמיכה במתאם InMobi Android בגרסה 10.0.5.0.
- תומך במתאם InMobi iOS בגרסה 10.0.5.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 4.0.2
- יש תמיכה במתאם InMobi Android בגרסה 10.0.3.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.0.2.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 4.0.1
- יש תמיכה במתאם InMobi Android בגרסה 10.0.3.0.
- תומך במתאם InMobi iOS בגרסה 10.0.2.0.
גרסה 4.0.0
- יש תמיכה במתאם InMobi Android גרסה 10.0.1.0.
- תומך במתאם InMobi iOS בגרסה 10.0.1.0.
גרסה 3.2.0
- יש תמיכה במתאם InMobi Android בגרסה 9.2.0.0.
- תומך במתאם InMobi iOS בגרסה 9.2.1.0.
גרסה 3.1.2
- יש תמיכה במתאם InMobi Android בגרסה 9.1.9.0.
- תומך במתאם ל-InMobi iOS בגרסה 9.1.7.0.
גרסה 3.1.1
- יש תמיכה במתאם InMobi Android בגרסה 9.1.1.0.
- יש תמיכה במתאם InMobi iOS בגרסה 9.1.1.0.
גרסה 3.1.0
- יש תמיכה במתאם InMobi Android בגרסה 9.1.0.0.
- יש תמיכה במתאם InMobi iOS בגרסה 9.1.0.0.
גרסה 3.0.3
- יש תמיכה במתאם InMobi Android בגרסה 9.0.7.1.
- תומך במתאם ל-InMobi iOS בגרסה 9.0.7.2.
גרסה 3.0.2
- יש תמיכה במתאם InMobi Android בגרסה 9.0.7.0.
- תומך במתאם InMobi iOS בגרסה 9.0.7.0.
גרסה 3.0.1
- יש תמיכה במתאם ל-InMobi Android בגרסה 9.0.6.0.
- תומך במתאם InMobi iOS בגרסה 9.0.7.0.
גרסה 3.0.0
- יש תמיכה במתאם InMobi Android בגרסה 9.0.4.0.
- תומך במתאם InMobi iOS בגרסה 9.0.4.0.
גרסה
- יש תמיכה במתאם InMobi Android בגרסה 7.3.0.1.
- תומך במתאם InMobi iOS בגרסה 7.4.0.0.
גרסה
- יש תמיכה במתאם Android בגרסה 7.2.9.0.
- יש תמיכה בגרסה 7.3.2.0 של מתאם iOS.
גרסה 2.2.2
- הפלאגין עודכן כך שיתמוך בממשק ה-API החדש של מתגמלות.
- יש תמיכה במתאם Android בגרסה 7.2.7.0.
- יש תמיכה במתאם iOS בגרסה 7.2.7.0.
גרסה 2.2.1
- יש תמיכה במתאם Android בגרסה 7.2.2.0.
- יש תמיכה במתאם iOS בגרסה 7.2.4.0.
גרסה
- יש תמיכה במתאם Android בגרסה 7.2.1.0.
- יש תמיכה בגרסה 7.2.0.0 של מתאם iOS.
גרסה 2.1.2
- יש תמיכה במתאם Android בגרסה 7.1.1.1.
- יש תמיכה במתאם iOS בגרסה 7.1.2.0.
גרסה 2.1.1
- יש תמיכה במתאם Android בגרסה 7.1.1.1.
- יש תמיכה במתאם iOS בגרסה 7.1.1.2.
גרסה
- יש תמיכה במתאם Android בגרסה 7.1.0.0.
- יש תמיכה במתאם iOS בגרסה 7.1.1.1.
- השיטה
InMobi.UpdateGDPRConsent()
נוספה.
גרסה
- יש תמיכה במתאם Android בגרסה 7.0.4.0.
- יש תמיכה בגרסה 7.1.1.0 של מתאם iOS.
גרסה 1.0.0
- השקה ראשונה!
- יש תמיכה במתאם Android בגרסה 6.2.4.0.
- יש תמיכה בגרסה 6.2.1.0 של מתאם iOS.