במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-InMobi באמצעות תהליך בחירת הרשת (Mediation), שכולל גם שילובים של Waterfall וגם של בידינג. מידע נוסף על הוספת InMobi להגדרת הגישור של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של InMobi באפליקציה Unity .
השילובים והפורמטים של המודעות שנתמכים
שילוב | |
---|---|
בידינג | 1 |
מפל | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה | |
מותאם | 2 |
1 השילוב של הבידינג נמצא בגרסת בטא סגורה, צריך לפנות למנהל החשבון ולבקש גישה.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity מגרסה 4 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-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, בוחרים באפשרות Assets > Import Package > Custom
Package (חבילה בהתאמה אישית) ואז בוחרים את הקובץ GoogleMobileAdsInMobiMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
לאחר מכן, בוחרים נכסים > Play Services Resolutionr > Android resolver > אילוץ פתרון. ספריית Unity Play Services Resolutionr תפתור את יחסי התלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
באפליקציה ל-Unity.
שלב 4: הטמעה של הגדרות הפרטיות ב-InMobi SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם חייבים לוודא שהודעות גילוי נאות מסוימות נשלחות למשתמשים באזור הכלכלי האירופי (EEA) ושהסכמתם לקבל מהם הסכמה בנוגע לשימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שיכולה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב הזה, Google לא יכולה להעביר לרשתות כאלה באופן אוטומטי את הבחירות של המשתמשים בנושא פרטיות.
בפלאגין של Google Mobile Ads לתהליך בחירת הרשת ב-InMobi בגרסה 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);
מידע נוסף על המפתחות והערכים האפשריים ש-InMobi מקבל באובייקט ההסכמה הזה מופיע במאמר פרטי ההטמעה של GDPR ב-InMobi.
חוקי פרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב מחייבים לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה). אפשרות ביטול ההסכמה מוצעת בקישור בולט בדף הבית של הצד המוכר. המדריך לציות לחוקי הפרטיות במדינות בארה"ב מאפשר להפעיל עיבוד נתונים מוגבל לצורך הצגת מודעות ב-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 | שגיאות SDK מסוג InMobi. לפרטים נוספים, אפשר לעיין בקוד. |
100 | פרמטרים של שרת InMobi שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
101 | אתחול ה-SDK של InMobi נכשל. |
102 | גודל המודעה המבוקש אינו תואם לגודל באנר שנתמך ב-InMobi. |
103 | בקשה להצגת מודעה אינה בקשה מאוחדת למודעות מותאמות. |
104 | בוצע ניסיון לבקש מודעת InMobi בלי לאתחל את ה-SDK של InMobi. זה אמור לקרות אף פעם לא מכיוון שהמתאם מפעיל את 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 Mediation
גרסה 4.6.1
- תומך במתאם InMobi ל-Android בגרסה 10.7.4.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.7.2.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.6.0
- תומך במתאם InMobi ל-Android בגרסה 10.7.3.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.7.2.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.5.1
- תומך במתאם InMobi ל-Android בגרסה 10.6.7.1.
- תומך במתאם InMobi ל-iOS בגרסה 10.7.2.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.5.0
- תומך במתאם InMobi ל-Android בגרסה 10.6.7.1.
- תומך במתאם InMobi ל-iOS בגרסה 10.7.1.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 4.4.1
- תומך במתאם InMobi ל-Android בגרסה 10.6.2.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.6.0.0.
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.4.0
- תומך במתאם InMobi ל-Android בגרסה 10.6.0.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.6.0.0.
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.3.3
- תומך במתאם InMobi ל-Android בגרסה 10.5.8.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.5.8.0.
- נוצר ונבדק באמצעות גרסה 8.5.2 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.3.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/InMobi/
. - מרחב השמות של המתאם עבר ארגון מחדש לשימוש ב-
GoogleMobileAds.Mediation.InMobi
. - תומך במתאם InMobi ל-Android בגרסה 10.5.4.1.
- תומך במתאם InMobi ל-iOS בגרסה 10.5.4.0.
- נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.2.2
- תומך במתאם InMobi ל-Android בגרסה 10.1.2.1.
- תומך במתאם InMobi ל-iOS בגרסה 10.1.2.1.
- נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.2.1
- תומך במתאם InMobi ל-Android בגרסה 10.1.2.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.1.2.0.
- נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.2.0
- תומך במתאם InMobi ל-Android בגרסה 10.1.1.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.1.1.0.
- נוצר ונבדק באמצעות גרסה 7.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.1.0
- תומך במתאם InMobi ל-Android בגרסה 10.0.9.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.1.0.0.
- נוצר ונבדק באמצעות גרסה 7.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.0.4
- תומך במתאם InMobi ל-Android בגרסה 10.0.7.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.0.7.0.
- נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Google Mobile Ads Unity.
גרסה 4.0.3
- תומך במתאם InMobi ל-Android בגרסה 10.0.5.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.0.5.0.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.0.2
- תומך במתאם InMobi ל-Android בגרסה 10.0.3.0.
- תומך במתאם InMobi ל-iOS בגרסה 10.0.2.1.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.0.1
גרסה 4.0.0
גרסה 3.2.0
גרסה 3.1.2
גרסה 3.1.1
גרסה 3.1.0
גרסה 3.0.3
גרסה 3.0.2
גרסה 3.0.1
גרסה 3.0.0
גרסה 2.4.0
גרסה 2.3.0
- תומך בגרסה 7.2.9.0 של מתאם Android.
- יש תמיכה בגרסה 7.3.2.0 של מתאם iOS.
גרסה 2.2.2
- הפלאגין עודכן כך שיתמוך ב-Rewarded API החדש.
- יש תמיכה בגרסה 7.2.7.0 של מתאם ל-Android.
- יש תמיכה בגרסה 7.2.7.0 של מתאם iOS.
גרסה 2.2.1
- תומך בגרסה 7.2.2.0 של מתאם Android.
- יש תמיכה בגרסה 7.2.4.0 של מתאם iOS.
גרסה 2.2.0
- תומך בגרסה 7.2.1.0 של מתאם Android.
- יש תמיכה בגרסה 7.2.0.0 של מתאם iOS.
גרסה 2.1.2
- תומך בגרסה 7.1.1.1 של מתאם Android.
- יש תמיכה בגרסה 7.1.2.0 של מתאם iOS.
גרסה 2.1.1
- תומך בגרסה 7.1.1.1 של מתאם Android.
- תומך בגרסה 7.1.1.2 של מתאם iOS.
גרסה 2.1.0
- יש תמיכה בגרסה 7.1.0.0 של מתאם ל-Android.
- תומך בגרסה 7.1.1.1 של מתאם iOS.
- השיטה
InMobi.UpdateGDPRConsent()
נוספה.
גרסה 2.0.0
- יש תמיכה בגרסה 7.0.4.0 של מתאם ל-Android.
- יש תמיכה בגרסה 7.1.1.0 של מתאם iOS.
גרסה 1.0.0
- גרסה ראשונה!
- יש תמיכה במתאם ל-Android בגרסה 6.2.4.0.
- יש תמיכה בגרסה 6.2.1.0 של מתאם iOS.