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

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

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

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

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

דרישות

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

שלב 1: הגדרת ההגדרות בממשק המשתמש של InMobi

נרשמים לחשבון InMobi. כשיוצרים חשבון, משאירים את התיבה שימוש ב-InMobi SSP עם Google Open Bidding לא מסומנת.

אחרי שהחשבון יאומת, נכנסים אליו.

הוספת אפליקציה

כדי להוסיף את האפליקציה ללוח הבקרה של InMobi, לוחצים על מלאי שטחי פרסום > הגדרות מלאי שטחי הפרסום.

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

מתחילים להקליד את כתובת ה-URL של האפליקציה שפורסמה בחנות בסרגל החיפוש, ובוחרים באפליקציה מתוך התוצאות שמופיעות. לוחצים על המשך.

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

בודקים את ההגדרות של אפליקציות ואתרים ואז לוחצים על שמירה ויצירת מיקומי מודעות.

מיקומי מודעות

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

בידינג

בוחרים את סוג יחידת המודעות. מזינים שם מיקום מודעה, בוחרים באפשרות מופעל ובאפשרות Google Open Bidding עבור בידינג לפי קהל ושותף, בהתאמה, וממלאים את שאר הטופס. כשמסיימים, לוחצים על Create Placement.

מפל

בוחרים את סוג יחידת המודעות. לאחר מכן מזינים שם מיקום, בוחרים באפשרות מושבת עבור בידינג לפי קהל וממלאים את שאר הטופס. כשמסיימים, לוחצים על Create Placement.

אחרי שיוצרים את מיקום המודעות, המערכת מציגה את הפרטים שלו. שימו לב למזהה המיקום, שישמש להגדרת יחידת המודעות ב-AdMob.

מספר חשבון

מספר החשבון ב-InMobi זמין בקטע Finance > Payment Settings > Payment Information.

איתור מפתח API לדיווח של InMobi

בידינג

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

מפל

עוברים אל החשבון שלי > הגדרות חשבון. עוברים לכרטיסייה API Key ולוחצים על Generate API Key.

בוחרים את כתובת האימייל של המשתמש שעבורו נדרש המפתח ולוחצים על יצירת מפתח API. ייווצר קובץ שמכיל את מפתח ה-API ואת שם המשתמש/שם ההתחברות.

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

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

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

שלב 2: הגדרת הביקוש מ-InMobi בממשק המשתמש של Ad Manager

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

Android

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

iOS

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

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

פועלים לפי השלבים המפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את InMobi לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob.

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Google Mobile Ads InMobi Mediation ל-Unity בפרויקט שלכם על ידי הפעלת הפקודה הבאה מהספרייה ברמה הבסיסית של הפרויקט:

openupm add com.google.ads.mobile.mediation.inmobi

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.

בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר ברמת ההיקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפים: com.google

פרטי OpenUPM

לאחר מכן עוברים אל Window > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries מהתפריט הנפתח.

מערכות רישום של Unity

בוחרים את החבילה Google Mobile Ads InMobi Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

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

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

ייבוא מ-Unity

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

אילוץ פתרון

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

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

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

במסמכי התיעוד של InMobi בנושא CCPA מפורטות הנחיות להפעלת הגדרות CCPA ב-InMobi.

שלב 5: מוסיפים את הקוד הנדרש

Android

לא נדרש קוד נוסף בשילוב InMobi.

iOS

שילוב עם SKAdNetwork

פועלים לפי מסמכי התיעוד של InMobi כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 6: בדיקה מעשית של ההטמעה

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

צריך לרשום את מכשיר הבדיקה ל-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של InMobi.

אימות מודעות לבדיקה

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-InMobi, צריך להפעיל את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות InMobi (בידינג) ו-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. פרטים נוספים זמינים ב-code.
100 פרמטרים של שרת InMobi שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
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 שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
102 מתאם InMobi לא תומך בפורמט המודעה המבוקש.
103 מודעת InMobi כבר נטענה עבור תצורת הרשת הזו.
אחר InMobi SDK החזיר שגיאה. פרטים נוספים זמינים בכתובת IMRequestStatus.h.

יומן שינויים של פלאגין InMobi Unity Mediation

גרסה 4.6.7

גרסה 4.6.6

גרסה 4.6.5

גרסה 4.6.4

גרסה 4.6.3

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

  • תמיכה במתאם Android בגרסה 7.2.9.0.
  • תמיכה במתאם iOS בגרסה 7.3.2.0.

גרסה 2.2.2

  • עדכנו את הפלאגין כך שיתמוך ב-Rewarded API החדש.
  • תמיכה במתאם Android בגרסה 7.2.7.0.
  • תמיכה במתאם iOS בגרסה 7.2.7.0.

גרסה 2.2.1

  • תומך בגרסה 7.2.2.0 של מתאם Android.
  • תמיכה במתאם iOS בגרסה 7.2.4.0.

גרסה

  • תומך בגרסה 7.2.1.0 של מתאם Android.
  • תמיכה במתאם iOS בגרסה 7.2.0.0.

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

גרסה 2.1.0

  • התמיכה במתאם Android היא בגרסה 7.1.0.0.
  • תומך בגרסה 7.1.1.1 של מתאם iOS.
  • השיטה InMobi.UpdateGDPRConsent() נוספה.

גרסה 2.0.0

  • התמיכה במתאם Android היא בגרסה 7.0.4.0.
  • תמיכה במתאם iOS בגרסה 7.1.1.0.

גרסה 1.0.0

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