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

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

במדריך הזה מוסבר איך להשתמש ב-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 ואילך.
  • ‫[לבידינג]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בפלאגין של Google Mobile Ads לתהליך בחירת הרשת ל-Mintegral בגרסה 1.4.0 ואילך (מומלץ להשתמש בגרסה העדכנית).
  • כדי לפרוס ב-Android
    • רמת API ב-Android‏ 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

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

בידינג

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

Waterfall

כדי להגדיר את מזהה יחידת המודעות ב-Ad Manager, תצטרכו את מפתח ה-API של Mintegral Reporting. עוברים אל חשבון > כלים ל-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, אפשר לעיין במאמר איך קובץ app-ads.txt יכול לעזור במאבק בהונאת מודעות.

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

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 (כלי לניהול חבילות של Unity) ובוחרים באפשרות My Registries (המאגרים שלי) בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads Mintegral Mediation ולוחצים על Install (התקנה).

התקנה מ-OpenUPM

חבילת Unity

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

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

ייבוא מ-Unity

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

אילוץ סימון כנושא שטופל

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

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

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

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

Android

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

iOS

שילוב של SKAdNetwork

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

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

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

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

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

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Mintegral, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Mintegral (Bidding)‎ (בידינג) ו-Mintegral (Waterfall)‎ (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 Mediation

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