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

במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-InMobi באמצעות תהליך בחירת הרשת (Mediation), שכולל גם שילובים של Waterfall וגם שילובים של בידינג. הוא מסביר איך להוסיף את InMobi ל- הגדרת הגישור של יחידת מודעות, וכיצד לשלב את InMobi SDK את המתאם לאפליקציה Unity .

השילובים והפורמטים של המודעות שנתמכים

שילוב
בידינג  1
מפל
פורמטים
כרזה
מעברון
ההטבה הופעלה
מותאם  2

1 השילוב של הבידינג נמצא בשלבי סגירה בטא, צריך לפנות למנהל החשבון כדי לבקש גישה.

דרישות

  • ה-SDK העדכני של Google Mobile Ads
  • Unity 4 ומעלה
  • לפריסה ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 10.0 ואילך
  • פרויקט Unity פעיל שהוגדר ב-Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
  • השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

שלב 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

הורדת הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ל-InMobi מקישור ההורדה יומן שינויים וחילוץ GoogleMobileAdsInMobiMediation.unitypackage מקובץ ה-ZIP.

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה > Custom (בהתאמה אישית) חבילה ובוחרים את הקובץ GoogleMobileAdsInMobiMediation.unitypackage שרוצים ההורדה הושלמה. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android > אילוץ לפתרון הבעיה. ספריית Unity Play Services resolver תבצע תלות ומעתיקים את יחסי התלות המוצהרים הספרייה Assets/Plugins/Android של אפליקציית Unity.

שלב 4: הטמעה של הגדרות הפרטיות ב-InMobi SDK

בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.

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

חוקי פרטיות במדינות בארה"ב

ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.

לצפייה ב-InMobi מסמכי תיעוד של CCPA לקבלת הנחיות להפעלת הגדרות 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

הגרסה הבאה

  • השם של DummyClient השתנה. השם החדש הוא PlaceholderClient.

גרסה 4.6.2

גרסה 4.6.1

גרסה 4.6.0

גרסה 4.5.1

גרסה 4.5.0

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

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

  • גרסה ראשונה!
  • יש תמיכה בגרסה 6.2.4.0 של מתאם Android.
  • יש תמיכה בגרסה 6.2.1.0 של מתאם iOS.