במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Chartboost באמצעות תהליך בחירת הרשת (Mediation), עם שילובים של Waterfall. המאמר מסביר איך להוסיף את Chartboost להגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Chartboost באפליקציית Unity.
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם תהליך בחירת הרשת עבור Chartboost כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | |
| פורמטים | |
| כרזה | |
| פרסומת מרווח ביניים | |
| ההטבה הופעלה | |
דרישות
- Unity 4 ומעלה
- ה-SDK העדכני של Google Mobile Ads
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת התהליך של תהליך בחירת הרשת המדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Chartboost
נרשמים לחשבון Chartboost ומתחברים אחרי אימות החשבון. לאחר מכן עוברים לכרטיסייה ניהול אפליקציות.
לוחצים על הלחצן Add new app (הוספת אפליקציה חדשה) כדי ליצור את האפליקציה.
מלאו את שאר הטופס ולחצו על הלחצן Add App כדי לסיים את תהליך היצירה של האפליקציה.
לאחר יצירת האפליקציה תועברו למרכז הבקרה שלה. חשוב לשים לב למזהה האפליקציה ולחתימת האפליקציה של האפליקציה.
Android
iOS
AdMob כדי להגדיר את AdMob מזהה יחידת המודעות, יש צורך ב-User ID ובחתימת משתמש ב-Chartboost. כדי למצוא את הפרמטרים האלה, לוחצים על Mediation ב-Chartboost בממשק המשתמש של Chartboost.
נכנסים לכרטיסייה Resources > API Explorer ורושמים את הפרטים של User ID ושל User Signature בקטע Authentication.
הפעלת מצב בדיקה
אפשר להפעיל את מצב הבדיקה באפליקציה על ידי מעבר לכרטיסייה ניהול אפליקציות מממשק המשתמש של Chartboost, בחירת האפליקציה מהרשימה ולחיצה על Edit app settings.
Android
iOS
דרך הגדרות האפליקציה, אפשר להפעיל או להשבית את מצב הבדיקה באפליקציה.
לאחר הפעלת מצב הבדיקה, ניתן לך לשלוח בקשה להצגת מודעות באמצעות מזהה יחידת המודעות שנוצר מוקדם יותר, ולקבל מודעת בדיקה של Chartboost.
אחרי שתוכלו לקבל מודעות בדיקה של Chartboost, האפליקציה תמוקם בדף Publisher App Review של Chartboost. כדי שהמונטיזציה ב-Chartboost תפעל, הבדיקה של אפליקציית בעל התוכן הדיגיטלי צריכה לקבל אישור מ-Chartboost.
שלב 2: הגדרת ביקוש ב-Chartboost AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספת Chartboost לרשימת שותפי הפרסום בנושא GDPR ותקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Chartboost לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK והמתאם של Chartboost
מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת (Mediation) של Google Mobile Ads ל-Chartboost מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsChartboostMediation.unitypackage מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package >
Custom Package (חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsChartboostMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על Import.
לאחר מכן, בוחרים באפשרות Assets > Play Services Resolutionr > Android resolver >
אילוץ סגירה. ספריית Unity Play Services resolver תבצע רזולוציית תלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android באפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-Chartboost SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם חייבים לוודא שהודעות גילוי נאות מסוימות נשלחות למשתמשים באזור הכלכלי האירופי (EEA) ושהסכמתם לקבל מהם הסכמה בנוגע לשימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שיכולה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב הזה, Google לא יכולה להעביר לרשתות כאלה באופן אוטומטי את הבחירות של המשתמשים בנושא פרטיות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Chartboost בגרסה 3.1.0 כולל את השיטה Chartboost.AddDataUseConsent(). הקוד לדוגמה הבא מגדיר את השימוש בנתונים ב-NonBehavioral. אם בוחרים לקרוא לשיטה הזו, מומלץ לעשות זאת לפני ששולחים בקשה להצגת מודעות באמצעות Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
חוקי פרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב מחייבים לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה). אפשרות ביטול ההסכמה מוצעת בקישור בולט בדף הבית של הצד המוכר. המדריך לציות לחוקי הפרטיות במדינות בארה"ב מאפשר להפעיל עיבוד נתונים מוגבל לצורך הצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Chartboost בגרסה 3.1.0 כולל את השיטה Chartboost.AddDataUseConsent(). הקוד לדוגמה הבא מגדיר את השימוש בנתונים ב-OptInSale. אם בוחרים לקרוא לשיטה הזו, מומלץ לעשות זאת לפני ששולחים בקשה להצגת מודעות באמצעות Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
שלב 5: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב עם Chartboost.
iOS
שילוב של SKAdNetwork
פועלים לפי מסמכי התיעוד של Chartboost כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב Chartboost ממשק המשתמש.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-Chartboost, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Chartboost (Waterfall) מקורות המודעות.
שלבים אופציונליים
Android
הרשאות
כדי ליהנות מביצועים אופטימליים, Chartboost ממליץ להוסיף את ההרשאות האופציונליות הבאות לקובץ AndroidManifest.xml של האפליקציה:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
אין צורך לבצע פעולות נוספות לשילוב עם iOS.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-Chartboost, בעלי האתרים יכולים לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות ResponseInfo בקטגוריות הבאות:
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
אלו הקודים וההודעות הנלוות שמתאם Chartboost מחזיר כשטעינת מודעה נכשלת:
Android
| קוד שגיאה | הסיבה |
|---|---|
| 0-99 | אירעה שגיאה ב-Chartboost SDK. |
| 101 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-Chartboost. |
| 102 | ב-Chartboost אפשר לטעון רק מודעה אחת לכל מיקום בכל פעם. |
| 103 | הפרמטרים של שרת Chartboost שהוגדרו ב- AdMob UI חסרים/לא חוקיים. |
| 104 | מודעת המעברון או מודעת המעברון ב-Chartboost לא מוכנה להצגה. |
iOS
| קוד שגיאה | הסיבה |
|---|---|
| 101 | הפרמטרים של שרת Chartboost שהוגדרו ב- AdMob UI חסרים/לא חוקיים. |
| 102 | אירעה שגיאת אתחול מ-Chartboost SDK. |
| 103 | מודעת Chartboost לא נשמרת במטמון בזמן ההצגה. |
| 104 | גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-Chartboost. |
| 105 | הגרסה של מערכת ההפעלה במכשיר נמוכה יותר מגרסת מערכת ההפעלה המינימלית שנתמכת ב-Chartboost SDK. |
| 200-299 | שגיאות במטמון של Chartboost SDK. לפרטים נוספים, אפשר לעיין בקוד. |
| 300-399 | שגיאות בהצגת SDK ב-Chartboost. לפרטים נוספים, אפשר לעיין בקוד. |
| 400-499 | שגיאות קליקים ב-Chartboost SDK. לפרטים נוספים, אפשר לעיין בקוד. |
יומן שינויים בפלאגין של Chartboost Unity
גרסה 4.6.0
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 9.7.0.0.
- יש תמיכה בגרסה 9.7.0.0 של מתאם iOS ב-Chartboost.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 4.5.0
- יש תמיכה במתאם ל-Android שלChartboost בגרסה 9.6.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 9.6.0.0.
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.4.0
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 9.5.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost בגרסה 9.5.1.0.
- נוצר ונבדק באמצעות פלאגין Unity של המודעות לנייד של Google בגרסה 8.5.3.
גרסה 4.3.0
- יש תמיכה במתאם ל-Android של Chartboost בגרסה 9.4.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 9.4.0.0.
- נוצר ונבדק באמצעות גרסה 8.5.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.2.0
- יש תמיכה במתאם ל-Android של Chartboost בגרסה 9.3.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 9.3.0.0.
- נוצר ונבדק באמצעות גרסה 8.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.1.1
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Chartboost/. - מרחב השמות של המתאם עבר ארגון מחדש לשימוש ב-
GoogleMobileAds.Mediation.Chartboost. - יש תמיכה במתאם ל-Android שלChartboost בגרסה 9.2.1.1.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 9.2.0.0.
- נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.1.0
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 9.2.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 9.2.0.0.
- נוצר ונבדק באמצעות גרסה 7.4.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 4.0.0
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 9.1.1.0.
- יש תמיכה בגרסה 9.1.0.0 של מתאם iOS ב-Chartboost.
- נוצר ונבדק באמצעות גרסה 7.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.5.1
- יש תמיכה במתאם ל-Android שלChartboost בגרסה 8.4.3.1.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 8.5.0.2.
- נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Google Mobile Ads Unity.
גרסה 3.5.0
- יש תמיכה במתאם ל-Android שלChartboost בגרסה 8.4.2.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 8.5.0.2.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.4.1
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 8.3.1.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 8.5.0.2.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.4.0
- יש תמיכה במתאם ל-Android שלChartboost גרסה 8.3.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 8.5.0.1.0.
גרסה 3.3.1
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 8.2.1.0.
- תומכת בגרסה 8.4.1.1 של מתאם iOS ב-Chartboost.
גרסה 3.3.0
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 8.2.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 8.4.0.0.
גרסה 3.2.0
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 8.1.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 8.3.1.0.
גרסה 3.1.0
- השיטה
RestrictDataCollection()הוסרה מהכיתהChartboost. - נוספו
AddDataUseConsent()שיטות עזר להעברת מידע לגבי GDPR ו-CCPA ל-Chartboost. - יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 8.1.0.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 8.2.0.0.
גרסה 3.0.1
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 8.0.3.1.
- יש תמיכה בגרסה 8.1.0.1 של מתאם iOS ב-Chartboost.
גרסה 3.0.0
- יש תמיכה במתאם ל-Android של תרשים Chartboost גרסה 8.0.2.0.
- יש תמיכה במתאם ל-iOS שלChartboost גרסה 8.1.0.0.
גרסה 2.0.1
- יש תמיכה במתאם ל-Android שלChartboost גרסה 7.5.0.1.
- תומכת בגרסה 8.0.4.0 של מתאם iOS ב-Chartboost.
גרסה 2.0.0
- יש תמיכה במתאם ל-Android של Chartboost בגרסה 7.5.0.0.
- יש תמיכה בגרסה 8.0.1.1 של מתאם iOS של Chartboost.
גרסה 1.3.0
- הפלאגין עודכן כך שיתמוך ב-Rewarded API החדש.
- יש תמיכה במתאם ל-Android של Chartboost בגרסה 7.3.1.1.
- יש תמיכה בגרסה 7.5.0.0 של מתאם iOS של Chartboost.
גרסה 1.2.0
- יש תמיכה במתאם ל-Android של Chartboost בגרסה 7.3.0.0.
- יש תמיכה בגרסה 7.3.0.0 של מתאם iOS של Chartboost.
גרסה 1.1.1
- יש תמיכה במתאם ל-Android של Chartboost בגרסה 7.2.0.1.
- יש תמיכה בגרסה 7.2.0.1 של מתאם iOS של Chartboost.
גרסה 1.1.0
- תומכת ב-Chartboost Android SDK בגרסה 7.2.0.
- תומכת ב-Chartboost iOS SDK בגרסה 7.2.0.
- נוספה השיטה
Chartboost.RestrictDataCollection()כדי להפעיל הגבלות על איסוף נתונים בהתאם ל-GDPR ב-Chartboost SDK.
גרסה 1.0.0
- גרסה ראשונה!
- תומכת ב-Chartboost Android SDK בגרסה 7.0.1.
- תומכת ב-Chartboost iOS SDK בגרסה 7.1.2.