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

במדריך הזה מוסבר איך להשתמש ב-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) ביחידת המודעות

Android

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

iOS

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

הוספה של 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

בהתאם למדיניות 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

גרסה 4.4.0

גרסה 4.3.3

גרסה 4.3.0

גרסה 4.2.2

גרסה 4.2.1

גרסה 4.2.0

גרסה 4.1.0

גרסה 4.0.4

גרסה 4.0.3

גרסה 4.0.2

גרסה 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

גרסה

גרסה

  • יש תמיכה במתאם 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.