שילוב Mintegral בבידינג (בטא)

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון מודעות מ-Mintegral ולהציג אותן באמצעות תהליך בחירת הרשת, תוך התייחסות לשילובים של רשימת הרשתות ולשילוב של בידינג. במדריך מוסבר איך להוסיף את 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 בממשק המשתמש של Ad Manager

נכנסים לחשבון Ad Manager.

הוספת Mintegral ב'חברות'

הפעלת שיתוף אותות מאובטחים

הגדרת בידינג ב-Mintegral

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

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

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

שלב 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: בדיקה מעשית של ההטמעה

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

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

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

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

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

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

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

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

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

עיבוד מודעות

מתאם 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.
• גרסת SDK של Mintegral‏ 7.2.6.