במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Mintegral באמצעות תהליך בחירת הרשת, כולל שילובים של Waterfall וגם של בידינג. במאמר מוסבר איך להוסיף את Mintegral להגדרות של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של Mintegral בiOS אפליקציה.
השילובים והפורמטים של המודעות הנתמכים
המתאם לתהליך בחירת הרשת (Mediation) ב-Mintegral כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | 1 |
| מפל | 2 |
| פורמטים | |
| מודעות בפתיחת האפליקציה | |
| מודעת באנר | |
| מעברון | |
| ההטבה הופעלה | |
| מודעות מעברון מתגמלות | |
| מותאם | |
2 השילוב עם Waterfall נמצא בגרסת בטא סגורה.
דרישות
- יעד הפריסה של iOS מגרסה 11.0 ואילך
הגרסה העדכנית ביותר של Google Mobile Ads SDK
מדריך לתחילת העבודה בנושא בחירת הרשת
שלב 1: הגדרת ההגדרות בממשק המשתמש של Mintegral
נרשמים או מתחברים לחשבון Mintegral.
איתור מפתח האפליקציה
עוברים לכרטיסייה APP Setting ומתעדים את APP Key.
הוספת אפליקציה חדשה
בכרטיסייה APP Setting, לוחצים על הלחצן Add APP.
בוחרים באפשרות פלטפורמה וממלאים את שאר הטופס. לאחר מכן לוחצים על שמירה.
מומלץ לרשום לפניכם את מזהה האפליקציה של האפליקציה.
יצירת מיקום מודעה
אחרי שיוצרים את הבקשה, עוברים לכרטיסייה Placements & Units ולוחצים על הלחצן Add Placement (הוספת מיקום מודעה), כפי שמוצג בהמשך, כדי ליצור את מיקום המודעה.
מזינים שם מיקום מודעה ופורמט מודעה.
בידינג
בוחרים באפשרות בידינג בכותרות בתור סוג הבידינג. ממלאים את שאר הטופס ולוחצים על שמירה.
מפל
בוחרים באפשרות מסורתית בתור סוג הבידינג. ממלאים את שאר הפרטים בטופס ולוחצים על Save.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה המיקום.
לוחצים על התפריט הנפתח 1 AD Units ומתעדים את מזהה יחידת המודעות.
איתור מפתח ה-Reporting API של Mintegral
בידינג
השלב הזה לא נדרש בשילובי בידינג.
מפל
כדי להגדיר את מזהה יחידת המודעות ב-AdMob, תצטרכו את מפתח ה-API לדיווח של Mintegral. עוברים אל Account (חשבון) > API Tools (כלים ל-API). שומרים על המפתח ועל הסוד.
שלב 2: הגדרת ביקוש ב-Mintegral ב Ad Manager ממשק המשתמש
הוספה של Mintegral לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR ובהגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף בממשק המשתמש של AdMob את Mobvista/Mintegral לרשימת שותפי הפרסום ל-GDPR ולהתקנות במדינות בארה"ב.
שלב 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 לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.
Mintegral SDK כולל את השיטה setConsentStatus להעברת פרטי הסכמה ל-Mintegral SDK.
דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה ל-SDK של Mintegral. צריך להגדיר את האפשרויות האלה לפני שמפעילים את Google Mobile Ads SDK כדי לוודא שהן יועברו כראוי ל-Mintegral SDK.
Swift
import MTGSDK
// ...
MTGSDK.sharedInstance().setConsentStatus(true)
Objective-C
#import <MTGSDK/MTGSDK.h>
// ...
[[MTGSDK sharedInstance] setConsentStatus:YES];
מידע נוסף זמין במסמכי התיעוד של Mintegral בנושא פרטיות.
חוקי פרטיות במדינות בארה"ב
חוקי הפרטיות במדינות ארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה למכירת המידע האישי שלהם (בהתאם להגדרה המעוגנת בחוק). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת המודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.
Mintegral SDK כולל את השיטה setDoNotTrackStatus להעברת פרטי הסכמה ל-Mintegral SDK.
דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה ל-SDK של Mintegral. אם צריך להפעיל את השיטה הזו, צריך להפעיל אותה לפני הפעלת Google Mobile Ads SDK כדי לוודא שהם מועברים כראוי ל-SDK של Mintegral.
Swift
import MTGSDK
// ...
MTGSDK.sharedInstance().setDoNotTrackStatus(false)
Objective-C
#import <MTGSDK/MTGSDK.h>
// ...
[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];
מידע נוסף זמין במסמכי התיעוד של Mintegral בנושא פרטיות.
שלב 5: מוסיפים את הקוד הנדרש
שילוב עם SKAdNetwork
פועלים לפי המסמכים של Mintegral כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בודקים את ההטמעה
שלבים אופציונליים
הוספת Mintegral לרשימת שותפי הפרסום בכפוף ל-CCPA
פועלים לפי השלבים המפורטים בקטע הגדרות CCPA כדי להוסיף את Mintegral לרשימת שותפי הפרסום בכפוף ל-CCPA בממשק המשתמשAd Manager .
מודעות מותאמות
עיבוד מודעות
מתאם Mintegral מחזיר את המודעות המותאמות שלו כאובייקטים מסוג
GADNativeAd
. היא מאכלסת את
השדות
הבאים של
GADNativeAd.
| שדה | נכסים שתמיד נכללים במתאם של Mintegral |
|---|---|
| כותרת | |
| תמונה | 1 |
| גוף | |
| סמל | |
| קריאה לפעולה | |
| Star rating | |
| חנות | |
| מחיר | |
| מפרסם |
1 מתאם Mintegral לא מספק גישה ישירה לנכס התמונה הראשי במודעות הנתמכות שלו. במקום זאת, המתאם מאכלס את
GADMediaView
בסרטון או בתמונה.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-Mintegral, אפשר לבדוק את
השגיאה הבסיסית בתגובה למודעה באמצעות
GADResponseInfo.adNetworkInfoArray
בקטגוריות הבאות:
GADMediationAdapterMintegral
אלה הקודים וההודעות הנלוות שמתקבלים מהמתאם של Mintegral כשלא ניתן לטעון מודעה:
| קוד שגיאה | דומיין | סיבה |
|---|---|---|
| 101 | com.google.mediation.mintegral | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה אפליקציה או מזהה מיקום מודעה). |
| 102 | com.google.mediation.mintegral | ה-SDK של Mintegral החזיר שגיאת 'לא מולאה'. |
| 103 | com.google.mediation.mintegral | ה-SDK של Mintegral נכשל בהצגת מודעה. |
| 104 | com.google.mediation.mintegral | גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-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כך שיכלול שלושה רכיבים במקום ארבעה.
הקוד נוצר ונבדק באמצעות:
- גרסה 11.10.0 של Google Mobile Ads SDK.
- גרסת 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.
- Mintegral SDK גרסה 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.
- Mintegral SDK גרסה 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.
- Mintegral SDK גרסה 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.
הקוד נוצר ונבדק באמצעות:
- גרסה 11.1.0 של Google Mobile Ads SDK.
- גרסת 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.
הקוד נוצר ונבדק באמצעות:
- גרסה 10.10.0 של Google Mobile Ads SDK.
- Mintegral SDK גרסה 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.
הקוד נוצר ונבדק באמצעות:
- גרסה 10.6.0 של Google Mobile Ads SDK.
- גרסת ה-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.
הקוד נוצר ונבדק באמצעות:
- גרסה 10.5.0 של Google Mobile Ads SDK.
- 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.
- גרסת ה-SDK של Mintegral היא 7.3.3.
גרסה 7.3.0.0
- תאימות מאומתת ל-Mintegral SDK בגרסה 7.3.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 10.1.0.
- Mintegral SDK גרסה 7.3.0.
גרסה 7.2.9.1
- נוספה תמיכה במפל המים לפורמטים של מודעות באנר (כולל MREC), מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
- נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.
הקוד נוצר ונבדק באמצעות:
- 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.
הקוד נוצר ונבדק באמצעות:
- גרסה 9.14.0 של Google Mobile Ads SDK
- גרסת 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.