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

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

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

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

מתאם תהליך הבחירה של רשת מודעות ב-Ad Manager ל-Mintegral כולל את היכולות הבאות:

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

דרישות מוקדמות

לפני שממשיכים, צריך לוודא את הפרטים הבאים:

  • הגרסה העדכנית של Google Mobile Ads Unity Plugin.
  • ‫Unity Editor בגרסה 5.6 ואילך.
  • ‫[לבידינג]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בגרסה 1.4.0 ואילך של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת ל-Mintegral (מומלץ להשתמש בגרסה העדכנית).
  • כדי לפרוס ב-Android
    • ‫Android API ברמה 24 ואילך.
  • כדי לפרוס ב-iOS
    • יעד פריסה 13.0 ומעלה ב-iOS.
  • פרויקט Unity פעיל שמוגדר עם Google Mobile Ads Unity Plugin. פרטים נוספים מופיעים במאמר הגדרת Google Mobile Ads Unity Plugin.
  • הגדרת תהליך בחירת הרשת.

    • שלב 1: קובעים את ההגדרות בממשק המשתמש של Mintegral

    נרשמים או מתחברים לחשבון ב-Mintegral.

    איתור מפתח האפליקציה

    עוברים לכרטיסייה APP Setting ורושמים את הערך של APP Key.

    הוספת אפליקציה חדשה

    בכרטיסייה APP Setting, לוחצים על הכפתור Add APP.

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

    Android

    iOS

    שימו לב למזהה האפליקציה.

    Android

    iOS

    יצירת מיקום מודעה

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

    Android

    iOS

    מזינים את שם מיקום המודעה ופורמט המודעה.

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

    אחרי שיוצרים את מיקום המודעה, שומרים את מזהה מיקום המודעה.

    Android

    iOS

    לוחצים על התפריט הנפתח 1 יחידות של מודעות ורושמים את מזהה יחידת המודעות.

    Android

    iOS

    איך מאתרים את מפתח ה-Reporting API של Mintegral

    בידינג

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

    Waterfall

    כדי להגדיר את מזהה יחידת המודעות ב-Ad Manager, תצטרכו את מפתח Reporting API של Mintegral. עוברים אל Account (חשבון) > API Tools (כלי API). רושמים בצד את ה-Skey ואת ה-Secret.

    עדכון של הקובץ app-ads.txt

    ‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt ל-Ad Manager.

    כדי להטמיע את app-ads.txt ב-Mintegral, אפשר לעיין במאמר How app-Ads.txt Can Help Fight Ad Fraud.

    שלב 2: מגדירים את הביקוש של Mintegral בממשק המשתמש של Ad Manager

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

    Android

    הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.

    iOS

    הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

    הוספת Mobvista/Mintegral לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב

    כדי להוסיף בממשק המשתמש של Ad Manager את Mobvista/Mintegral לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

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

    OpenUPM-CLI

    אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין בפרויקט את הפלאגין של Google Mobile Ads לתהליך בחירת הרשת ב-Mintegral ל-Unity. כדי לעשות את זה, מריצים את הפקודה הבאה מתיקיית השורש של הפרויקט:

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

    OpenUPM

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

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

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

    פרטי OpenUPM

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

    מאגרי Unity

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

    התקנה מ-OpenUPM

    חבילת Unity

    מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור Mintegral מהקישור להורדה ביומן השינויים, ומחלצים את הקובץ GoogleMobileAdsMintegralMediation.unitypackage מקובץ ה-ZIP.

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

    ייבוא מ-Unity

    אחר כך בוחרים באפשרות Assets (נכסים) > External Dependency Manager (מנהל יחסי תלות חיצוניים) > Android Resolver (מזהה Android) > Force Resolve (זיהוי מאולץ). ספריית External Dependency Manager תפתור את יחסי התלות מאפס ותעתיק את יחסי התלות שהוצהרו לספרייה Assets/Plugins/Android של אפליקציית Unity.

    אילוץ פתרון

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

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

    המתאם של Mintegral ל-Unity בגרסה 2.2.3 ואילך תומך בהעברת אותות הסכמה בהתאם ל-GDPR מפלטפורמות לניהול הסכמה (CMP) שמשולבות עם Transparency and Consent Framework (‏TCF – מסגרת השקיפות וההסכמה) של IAB אל ה-SDK של Mintegral. מידע נוסף זמין במסמכי התיעוד של Mintegral בנושא הצהרה על עמידה בדרישות הפרטיות של ערכת ה-SDK ל-Android ול-iOS.

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

    Android

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

    iOS

    שילוב של SKAdNetwork

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

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

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

    חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager.

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

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

    כדי לוודא שאתם מקבלים מודעות לבדיקה מ-Mintegral, הפעילו את האפשרות בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Mintegral (בידינג) ו-Mintegral (Waterfall).

    קודי שגיאה

    אם המתאם לא מצליח לקבל מודעה מ-Mintegral, אפשר לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo במחלקות הבאות:

    Android

    com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

    iOS

    GADMediationAdapterMintegral

    אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של Mintegral כשהטעינה של מודעה נכשלת:

    Android

    קוד שגיאה דומיין סיבה
    100 com.mbridge.msdk ‫Mintegral SDK החזיר קריאה חוזרת (callback) של כשל.
    101 com.google.ads.mediation.mintegral פרמטרים לא תקינים של השרת (למשל, מזהה אפליקציה או מזהה מיקום מודעה חסרים).
    102 com.google.ads.mediation.mintegral גודל המודעה שביקשתם לא תואם לגודל הבאנר שנתמך ב-Mintegral.
    103 com.google.ads.mediation.mintegral התגובה לבקשה להצעת מחיר חסרה או לא תקינה.
    104 com.google.ads.mediation.mintegral ‫Mintegral SDK החזיר שגיאת הצגה (no fill).
    105 com.mbridge.msdk ההפעלה של Mintegral SDK נכשלה.
    106 com.google.ads.mediation.mintegral מודעה למיקום המודעה ב-Mintegral כבר נטענה ועדיין לא הוצגה.

    iOS

    קוד שגיאה דומיין סיבה
    101 com.google.mediation.mintegral פרמטרים לא תקינים של השרת (למשל, מזהה אפליקציה או מזהה מיקום מודעה חסרים).
    102 com.google.mediation.mintegral ‫Mintegral SDK החזיר שגיאת הצגה (no fill).
    103 com.google.mediation.mintegral ‫Mintegral SDK לא הצליח להציג מודעה.
    104 com.google.mediation.mintegral גודל המודעה שביקשתם לא תואם לגודל הבאנר שנתמך ב-Mintegral.

    יומן השינויים של הפלאגין של Mintegral לתהליך בחירת הרשת ב-Unity

    גרסה 2.2.6

    גרסה 2.2.5

    גרסה 2.2.4

    גרסה 2.2.3

    גרסה 2.2.2

    גרסה 2.2.1

    גרסה 2.2.0

    גרסה 2.1.0

    גרסה 2.0.6

    גרסה 2.0.5

    גרסה 2.0.4

    גרסה 2.0.3

    גרסה 2.0.2

    גרסה 2.0.1

    גרסה 2.0.0

    גרסה 1.9.8

    גרסה 1.9.7

    גרסה 1.9.6

    גרסה 1.9.5

    גרסה 1.9.4

    גרסה 1.9.3

    גרסה 1.9.2

    גרסה 1.9.1

    גרסה 1.9.0

    גרסה 1.8.4

    גרסה 1.8.3

    גרסה 1.8.2

    גרסה 1.8.1

    גרסה 1.8.0

    גרסה 1.7.0

    גרסה 1.6.5

    גרסה 1.6.4

    גרסה 1.6.3

    גרסה 1.6.2

    גרסה 1.6.1

    גרסה 1.6.0

    גרסה 1.5.0

    גרסה 1.4.0

    גרסה 1.3.0

    גרסה 1.2.1

    גרסה 1.2.0

    גרסה 1.1.0

    גרסה 1.0.0