דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

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

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

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

דרישות

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

הגרסה העדכנית ביותר של Google Mobile Ads SDK
מבצעים את ההוראות שבמדריך לתחילת העבודה.

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

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

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

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

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

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

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

מומלץ לרשום לפניכם את מזהה האפליקציה של האפליקציה.

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

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

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

בידינג

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

מפל

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

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

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

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

בידינג

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

מפל

כדי להגדיר את מזהה יחידת המודעות ב-AdMob, תצטרכו את מפתח ה-API לדיווח של Mintegral. עוברים אל Account (חשבון) > API Tools (כלים ל-API). שימו לב ל-Skey ול-Secret.

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

הוספה של 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) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שיכולה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.

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

דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה ל-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: בדיקה מעשית של ההטמעה

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

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

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

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

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

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

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

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

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

עיבוד מודעות

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

שדה	הנכסים תמיד נכללים במתאם Mintegral
כותרת
תמונה	1
גוף
סמל
קריאה לפעולה
Star rating
חנות
מחיר
מפרסם

¹ מתאם 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 כך שיכלול שלושה רכיבים במקום ארבעה.

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

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.
Mintegral SDK גרסה 7.6.8.

גרסה 7.6.7.0

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

פותח ונבדק בעזרת:

Google Mobile Ads SDK בגרסה 11.6.0.
Mintegral SDK גרסה 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.

פותח ונבדק בעזרת:

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.

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

גרסה 11.0.1 של Google Mobile Ads SDK.
גרסת 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.
Mintegral SDK גרסה 7.4.1.

גרסה 7.3.9.0

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

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

Google Mobile Ads SDK בגרסה 10.7.0.
Mintegral SDK גרסה 7.3.9.

גרסה 7.3.8.0

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

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

Google Mobile Ads SDK בגרסה 10.6.0.
Mintegral SDK גרסה 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.

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

גרסה 10.1.0 של Google Mobile Ads SDK.
Mintegral SDK גרסה 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.