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

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

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

המתאם של תהליך בחירת הרשת ב-AdMob ל-Mintegral כולל את היכולות הבאות:

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

בידינג

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

מפל

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

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

Android

iOS

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

Android

iOS

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

בידינג

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

מפל

כדי להגדיר את מזהה יחידת המודעות ב-AdMob, תצטרכו את מפתח 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 לאפליקציה.

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

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

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

Android

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

iOS

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

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

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

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

בתיקיית השורש של הפרויקט, מתקינים את מתאם Google Mobile Ads SDK for React Native לתהליך בחירת הרשת (Mediation) של Mintegral. צריך לבצע את השלבים הבאים:

  1. מעתיקים את קובץ ה-tar של המתאם Google Mobile Ads SDK for React Native מהספרייה gma-sdk-react-native/adapters/mintegral/ לספרייה local_packages/ של הפרויקט. אם התיקייה adapters לא קיימת, עיינו בקטע דרישות מוקדמות.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/mintegral/gma-mediation-mintegral-0.1.0.tgz local_packages/

    מחליפים את EXTRACT_DIR בנתיב לספרייה שבה חילצתם את קובץ הארכיון.

  2. מתקינים את חבילת המתאם באמצעות הכלי המועדף לניהול חבילות:

    npm

    npm install ./local_packages/gma-mediation-mintegral-0.1.0.tgz

    חוטי סריגה

    yarn add ./local_packages/gma-mediation-mintegral-0.1.0.tgz

  3. אם אתם מפתחים ל-Android, הוסיפו את המאגר הבא לקובץ build.gradle בספרייה android של הפרויקט:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
}

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

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

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

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

Android

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

iOS

שילוב של SKAdNetwork

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

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

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

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

כדי לקבל מודעות בדיקה של 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.

גרסה 0.1.0

  • הגרסה הראשונה.