במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Chartboost באמצעות תהליך בחירת הרשת (Mediation), שמכסה שילובים של Waterfall. נסביר איך להוסיף את Chartboost להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Chartboost באפליקציית Unity.
שילובים נתמכים ופורמטים נתמכים של מודעות
מתאם תהליך בחירת הרשת (Mediation) ב- Ad Manager Chartboost כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה |
דרישות
- Unity 4 ואילך
- ה-SDK העדכני של מודעות Google לנייד
- כדי לפרוס ב-Android
- Android API ברמת 21 ואילך
- כדי לפרוס ב-iOS
- יעד הפריסה של iOS הוא 12.0 ומעלה
- פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- משלימים את ההוראות של תהליך בחירת הרשת (Mediation) המדריך לתחילת העבודה
שלב 1: הגדרת הגדרות אישיות בממשק המשתמש של Chartboost
נרשמים לחשבון Chartboost ומתחברים אחרי אימות החשבון. לאחר מכן עוברים לכרטיסייה ניהול אפליקציות.
לוחצים על הלחצן Add new app (הוספת אפליקציה חדשה) כדי ליצור את האפליקציה.
מלאו את שאר הטופס ולחצו על הלחצן Add App כדי לסיים את תהליך היצירה של האפליקציה.
לאחר יצירת האפליקציה תועברו למרכז הבקרה שלה. חשוב לשים לב למזהה האפליקציה ולחתימת האפליקציה של האפליקציה.
Android
iOS
Ad Manager כדי להגדיר את Ad Manager מזהה יחידת המודעות, יש צורך ב-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 Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספת Chartboost לרשימת שותפי הפרסום של תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Chartboost לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש Ad Manager .
שלב 3: מייבאים את ה-SDK והמתאם של Chartboost
מורידים את הגרסה האחרונה של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור Chartboost דרך קישור ההורדה ב-Changelog ומחלצים את GoogleMobileAdsChartboostMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקטים ב-Unity, בוחרים באפשרות Assets > Import Package > Custom Package ומוצאים את הקובץ GoogleMobileAdsChartboostMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על Import.
לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force Solution. ספריית Unity Play Services Solutionr תבצע פתרון תלויי מההתחלה ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-Chartboost SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.
פלאגין תהליך בחירת הרשת של Google Mobile Ads בגרסה 3.1.0 כולל את השיטה Chartboost.AddDataUseConsent()
. הקוד לדוגמה הבא מגדיר את ההסכמה לשימוש בנתונים ל-NonBehavioral
. אם תבחרו לקרוא לשיטה הזו, מומלץ לעשות זאת לפני שתבקשו מודעות באמצעות Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
חוקי הפרטיות במדינות בארה"ב
חוקי הפרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.
פלאגין תהליך בחירת הרשת של Google Mobile Ads בגרסה 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: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager ולהפעיל את מצב הבדיקה ב 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 שהוגדרו Ad Manager בממשק המשתמש חסרים/לא חוקיים. |
104 | מודעת המעברון או המודעה המתגמלת של Chartboost לא מוכנה להצגה. |
iOS
קוד שגיאה | סיבה |
---|---|
101 | הפרמטרים של שרת Chartboost שהוגדרו Ad Manager בממשק המשתמש חסרים/לא חוקיים. |
102 | ערכת ה-SDK של Chartboost החזירה שגיאת אתחול. |
103 | מודעת Chartboost לא נשמרת במטמון בזמן ההצגה. |
104 | גודל המודעה המבוקש אינו תואם לגודל מודעת באנר נתמך של Chartboost. |
105 | גרסת מערכת ההפעלה של המכשיר נמוכה יותר מהגרסה המינימלית הנתמכת של Chartboost SDK. |
200-299 | שגיאות במטמון של Chartboost SDK. לפרטים נוספים, ראו קוד. |
300-399 | ב-Chartboost SDK מוצגות שגיאות. לפרטים נוספים, ראו קוד. |
400-499 | שגיאות קליקים ב-Chartboost SDK. לפרטים נוספים, ראו קוד. |
יומן שינויים של פלאגין Unity לגישור של Chartboost
גרסה 4.5.0
- יש תמיכה במתאם ל-Android בגרסה 9.6.0.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 9.6.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.6.0.
גרסה 4.4.0
- יש תמיכה במתאם ל-Android בגרסה 9.5.0.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 9.5.1.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.5.3.
גרסה 4.3.0
- יש תמיכה במתאם ל-Android בגרסה 9.4.0.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 9.4.0.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.5.0 נוצרה ונבדקה.
גרסה 4.2.0
- יש תמיכה במתאם ל-Android בגרסה 9.3.0.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 9.3.0.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.2.0 נוצרה ונבדקה.
גרסה 4.1.1
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/Chartboost/
. - מרחב השמות של המתאם שהוגדר מחדש לצורך שימוש ב-
GoogleMobileAds.Mediation.Chartboost
. - יש תמיכה במתאם ל-Android בגרסה 9.2.1.1 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 9.2.0.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.1.0 נוצרה ונבדקה.
גרסה 4.1.0
- יש תמיכה במתאם ל-Android בגרסה 9.2.0.0.
- יש תמיכה במתאם ל-iOS בגרסה 9.2.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.1.
גרסה 4.0.0
- יש תמיכה במתאם ל-Android בגרסה 9.1.1.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 9.1.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.0.
גרסה 3.5.1
- יש תמיכה במתאם ל-Android בגרסה 8.4.3.1 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.5.0.2.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.2.
גרסה 3.5.0
- יש תמיכה במתאם ל-Android בגרסה 8.4.2.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.5.0.2.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 3.4.1
- יש תמיכה במתאם ל-Android בגרסה 8.3.1.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.5.0.2.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 3.4.0
- יש תמיכה במתאם ל-Android בגרסה 8.3.0.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.5.0.1.0.
גרסה 3.3.1
- יש תמיכה במתאם ל-Android בגרסה 8.2.1.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.4.1.1 שלChartboost.
גרסה 3.3.0
- יש תמיכה במתאם ל-Android בגרסה 8.2.0.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.4.0.0.
גרסה 3.2.0
- יש תמיכה במתאם ל-Android בגרסה 8.1.0.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.3.1.0.
גרסה 3.1.0
- השיטה
RestrictDataCollection()
הוסרה מהמחלקהChartboost
. - נוספו
AddDataUseConsent()
שיטות מסייעות להעברת מידע על GDPR ו-CCPA ל-Chartboost. - יש תמיכה במתאם ל-Android בגרסה 8.1.0.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.2.0.0.
גרסה 3.0.1
- יש תמיכה במתאם ל-Android בגרסה 8.0.3.1 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.1.0.1 שלChartboost.
גרסה 3.0.0
- יש תמיכה במתאם ל-Android בגרסה 8.0.2.0 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.1.0.0.
גרסה 2.0.1
- יש תמיכה במתאם ל-Android בגרסה 7.5.0.1 שלChartboost.
- יש תמיכה במתאם ל-iOS בגרסה 8.0.4.0 שלChartboost.
גרסה
- יש תמיכה במתאם Android של Chartboost בגרסה 7.5.0.0.
- יש תמיכה במתאם iOS של Chartboost בגרסה 8.0.1.1.
גרסה 1.3.0
- הפלאגין עודכן כך שיתמוך בממשק ה-API החדש של מתגמלות.
- יש תמיכה במתאם Android של Chartboost בגרסה 7.3.1.1.
- יש תמיכה במתאם iOS של Chartboost בגרסה 7.5.0.0.
גרסה 1.2.0
- יש תמיכה במתאם Android של Chartboost בגרסה 7.3.0.0.
- יש תמיכה במתאם iOS של Chartboost בגרסה 7.3.0.0.
גרסה 1.1.1
- יש תמיכה במתאם Android של Chartboost בגרסה 7.2.0.1.
- יש תמיכה במתאם iOS של Chartboost בגרסה 7.2.0.1.
גרסה 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.