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

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

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

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

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

דרישות

• יעד הפריסה ב-iOS מגרסה 11.0 ואילך

• [לבידינג]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש במתאם Mintegral בגרסה 7.5.3.0 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)

• הגרסה העדכנית ביותר של Google Mobile Ads SDK

• מדריך לתחילת העבודה בנושא בחירת הרשת

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

נרשמים או נכנסים לחשבון Mintegral.

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

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

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

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

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

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

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

אחרי שיוצרים את הבקשה, עוברים לכרטיסייה Placements & Units ולוחצים על הלחצן Add Placement (הוספת מיקום מודעה), כפי שמתואר בהמשך, כדי ליצור את מיקום המודעה.

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

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

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

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

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

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

צריך להוסיף את Mintegral להגדרת תהליך בחירת הרשת של יחידת המודעות.

קודם כול, נכנסים לחשבון AdMob. לאחר מכן, עוברים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש לכם קבוצה קיימת לבחירת רשת שרוצים לשנות, לוחצים על השם שלה כדי לערוך אותה ועוברים לקטע הוספת Mintegral כמקור מודעות.

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

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

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

משייכים את הקבוצה לבחירת רשת (Mediation) הזו לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. לאחר מכן לוחצים על סיום.

כרטיס יחידות המודעות אמור להיות מאוכלס עכשיו ביחידות המודעות שבחרתם:

הוספת Mintegral כמקור מודעות

בידינג

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

מפל

בקטע מקורות מודעות, בכרטיס Waterfall, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים באפשרות Mintegral.

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



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

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

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

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

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

שימוש ב-CocoaPods (מומלץ)

• מוסיפים את השורה הבאה ל-Podfile של הפרויקט:

  pod 'GoogleMobileAdsMediationMintegral'
  

• מריצים את הפקודה הבאה בשורת הפקודה:

  pod install --repo-update

שילוב ידני

• מורידים את הגרסה העדכנית של Mintegral SDK ל-iOS ומקשרים את כל הקבצים והחבילות של .framework בפרויקט.
• מורידים את הגרסה האחרונה של המתאם של Mintegral מהקישור להורדה בChangelog ומקשרים את MintegralAdapter.xcframework בפרויקט.

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

הסכמה באיחוד האירופי ו-GDPR

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

ערכת ה-SDK של Mintegral כוללת את השיטה setConsentStatus להעברת פרטי ההסכמה ל-SDK של Mintegral.

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

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setConsentStatus:YES];

מידע נוסף זמין במסמכי התיעוד של Mintegral בנושא פרטיות.

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

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

ערכת ה-SDK של Mintegral כוללת את השיטה setDoNotTrackStatus להעברת פרטי ההסכמה ל-SDK של Mintegral.

בקוד לדוגמה הבא מוסבר איך להעביר את פרטי ההסכמה ל-SDK של Mintegral. אם צריך להפעיל את השיטה הזו, צריך להפעיל אותה לפני הפעלת Google Mobile Ads SDK כדי לוודא שהאירועים יועברו כראוי ל-Mintegral SDK.

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

מידע נוסף זמין במסמכי התיעוד של Mintegral בנושא פרטיות.

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

שילוב עם SKAdNetwork

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

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

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

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

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

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

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

שלבים אופציונליים

הוספת Mintegral לרשימת שותפי הפרסום בכפוף ל-CCPA

פועלים לפי השלבים המפורטים בקטע הגדרות CCPA כדי להוסיף את Mintegral לרשימת שותפי הפרסום בכפוף ל-CCPA בממשק המשתמש של AdMob.

מודעות מותאמות

עיבוד מודעות

המתאם של Mintegral מחזיר את המודעות המותאמות שלו כאובייקטים מסוג GADNativeAd. הוא מאכלס את השדות הבאים של GADNativeAd.

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

קודי שגיאה

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

GADMediationAdapterMintegral

אלה הקודים וההודעות שמופיעים במתאם Mintegral כשלא ניתן לטעון מודעה:

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

גרסה 7.7.3.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.7.3.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.10.0.
• גרסת ה-SDK של Mintegral היא 7.7.3.

גרסה 7.7.2.1

• המתאם לא בודק יותר אם מודעות מעברון ומודעות מעברון מתגמלות מוכנות לפני שהן מוצגות.
• עדכנו את CFBundleShortVersionString כך שיכלול שלושה רכיבים במקום ארבעה.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.10.0.
• גרסת Mintegral SDK‏ 7.7.2.

גרסה 7.7.2.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.7.2.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.9.0.
• גרסת Mintegral SDK‏ 7.7.2.

גרסה 7.7.1.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.7.1.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.8.0.
• גרסת Mintegral SDK‏ 7.7.1.

גרסה 7.7.0.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.7.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.8.0.
• גרסת ה-SDK של Mintegral היא 7.7.0.

גרסה 7.6.9.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.6.9.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.7.0.
• גרסת SDK של Mintegral‏ 7.6.9.

גרסה 7.6.8.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.6.8.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.7.0.
• גרסת SDK של Mintegral‏ 7.6.8.

גרסה 7.6.7.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.6.7.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.6.0.
• גרסת ה-SDK של Mintegral היא 7.6.7.

גרסה 7.6.6.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.6.6.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.5.0.
• גרסת SDK של Mintegral‏ 7.6.6.

גרסה 7.6.4.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.6.4.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.4.0.
• גרסת Mintegral SDK‏ 7.6.4.

גרסה 7.6.3.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.6.3.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.3.0.
• גרסת Mintegral SDK‏ 7.6.3.

גרסה 7.6.2.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.6.2.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.3.0.
• גרסת Mintegral SDK‏ 7.6.2.

גרסה 7.6.1.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.6.1.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.3.0.
• גרסת Mintegral SDK‏ 7.6.1.

גרסה 7.6.0.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.6.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.2.0.
• גרסת ה-SDK של Mintegral היא 7.6.0.

גרסה 7.5.9.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.5.9.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.2.0.
• גרסת Mintegral SDK‏ 7.5.9.

גרסה 7.5.8.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.5.8.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.1.0.
• גרסת Mintegral SDK‏ 7.5.8.

גרסה 7.5.7.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.5.7.
• עכשיו נדרשת גרסת iOS מגרסה 12.0 ואילך.
• מעכשיו נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
• Info.plist נכלל במסגרות שב-MintegralAdapter.xcframework.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.0.1.
• גרסת Mintegral SDK‏ 7.5.7.

גרסה 7.5.6.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.5.6.
• הפכתם את הכותרת GADMediationAdapterMintegral.h לכותרת ציבורית.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 11.0.0.
• גרסת Mintegral SDK‏ 7.5.6.

גרסה 7.5.3.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.5.3.
• הוספנו תמיכה בבידינג בפורמט מודעות לפתיחת אפליקציה.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.14.0.
• גרסת Mintegral SDK‏ 7.5.3.

גרסה 7.4.8.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.4.8.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.13.0.
• גרסת Mintegral SDK‏ 7.4.8.

גרסה 7.4.7.0

• עדכנו את קובץ ה-podspec כך שיהיה תלוי ב-MintegralAdSDK/All במקום ב-MintegralAdSDK.
• תאימות מאומתת ל-Mintegral SDK בגרסה 7.4.7.
• הוספנו תמיכה ב-Waterfall לפורמט מודעות בפתיחת אפליקציה.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.12.0.
• גרסת Mintegral SDK‏ 7.4.7.

גרסה 7.4.4.0

• נוספה תמיכה בסימני מים למודעות לבידינג.
• תאימות מאומתת עם Mintegral SDK בגרסה 7.4.4.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.10.0.
• גרסת ה-SDK של Mintegral היא 7.4.4.

גרסה 7.4.3.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.4.3.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.9.0.
• גרסת Mintegral SDK‏ 7.4.3.

גרסה 7.4.1.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.4.1.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.7.0.
• גרסת ה-SDK של Mintegral היא 7.4.1.

גרסה 7.3.9.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.3.9.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.7.0.
• גרסת ה-SDK של Mintegral היא 7.3.9.

גרסה 7.3.8.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.3.8.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.6.0.
• גרסת ה-SDK של Mintegral היא 7.3.8.

גרסה 7.3.7.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.3.7.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.5.0.
• גרסת Mintegral SDK‏ 7.3.7.

גרסה 7.3.6.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.3.6.
• הסרת התמיכה בארכיטקטורה armv7.
• עכשיו נדרשת גרסת iOS מגרסה 11.0 ואילך.
• מעכשיו נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.5.0.
• Mintegral SDK גרסה 7.3.6.

גרסה 7.3.4.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.3.4.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.2.0.
• גרסת Mintegral SDK‏ 7.3.4.

גרסה 7.3.3.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.3.3.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.2.0.
• גרסת Mintegral SDK‏ 7.3.3.

גרסה 7.3.0.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.3.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.1.0.
• גרסת ה-SDK של Mintegral היא 7.3.0.

גרסה 7.2.9.1

• נוספה תמיכה במפל המים לפורמטים של מודעות באנר (כולל MREC), מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• נדרשת גרסת Google Mobile Ads SDK 10.0.0 ואילך.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 10.0.0.
• גרסת Mintegral SDK‏ 7.2.9.

גרסה 7.2.9.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 7.2.9.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 9.14.0.
• גרסת Mintegral SDK‏ 7.2.9.

גרסה 7.2.8.0

• תאימות מאומתת עם Mintegral SDK בגרסה 7.2.8.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 9.14.0.
• גרסת Mintegral SDK‏ 7.2.8.

גרסה 7.2.6.0

• זו הגרסה הראשונה
• נוספה תמיכה בבידינג בפורמטים של מודעות באנר (כולל מודעות MREC), מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• תאימות מאומתת ל-Mintegral SDK בגרסה 7.2.6.
• נדרשת גרסה 9.8.0 ואילך של Google Mobile Ads SDK.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 9.13.0.
• גרסת Mintegral SDK‏ 7.2.6.