במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Chartboost באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. הוא עוסק בהוספת Chartboost ליחידת מודעות הגדרת תהליך בחירת הרשת (Mediation), ואיך לשלב את Chartboost SDK והמתאם לאפליקציה של Unity.
השילובים והפורמטים של המודעות שנתמכים
Ad Manager מתאם תהליך בחירת הרשת עבור Chartboost כולל היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה |
דרישות
- Unity 4 ומעלה
- ה-SDK העדכני של Google Mobile Ads
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של Chartboost
להירשם לחשבון Chartboost לאחר אימות החשבון, מתחברים אליו. לאחר מכן עוברים לכרטיסייה ניהול אפליקציות.
לוחצים על הלחצן הוספת אפליקציה חדשה כדי ליצור את האפליקציה.
ממלאים את שאר הטופס ולוחצים על הלחצן Add App (הוספת האפליקציה) כדי להשלים את אפליקציה.
לאחר יצירת האפליקציה, תופנו למרכז הבקרה שלה. שימו לב ל מזהה האפליקציה וחתימת האפליקציה של האפליקציה.
Android
iOS
כדי להשתמש ב-AdMob, נדרש User ID ב-Chartboost חתימת משתמש להגדרת מודעת AdMob מזהה יחידה. כדי למצוא את הפרמטרים האלה, לוחצים על Chartboost Mediation לממשק המשתמש של Chartboost.
עוברים אל מקורות מידע > API Explorer ושימו לב User ID וחתימת משתמש בקטע אימות.
הפעלת מצב בדיקה
אפשר להפעיל את מצב הבדיקה באפליקציה בקטע ניהול האפליקציות מממשק המשתמש של Chartboost, בוחרים את האפליקציה מהרשימה ולוחצים על עורכים את הגדרות האפליקציה.
Android
iOS
בהגדרות האפליקציה אפשר להפעיל או להשבית את מצב בדיקה.
לאחר הפעלת מצב הבדיקה, אפשר לבקש מודעות באמצעות המזהה של יחידת המודעות שנוצר מוקדם יותר ולקבל מודעת בדיקה של Chartboost.
אחרי שתהיה לך אפשרות לקבל מודעות בדיקה של Chartboost, האפליקציה שלך תוצב בביקורת על אפליקציות לבעלי תוכן דיגיטלי ב-Chartboost. כדי שהמונטיזציה ב-Chartboost תעבוד, צריך לבדוק את האפליקציה של בעלי התוכן הדיגיטלי צריכים לקבל אישור מ-Chartboost.
שלב 2: הגדרת ביקוש ב-Chartboost Ad Manager בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספת Chartboost לרשימת שותפי הפרסום בנושא GDPR ותקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Chartboost לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש Ad Manager .
שלב 3: מייבאים את ה-SDK והמתאם של Chartboost
OpenUPM-CLI
אם יש לכם את OpenUPM-CLI אפשר להתקין את Chartboost של Google Mobile Ads הפלאגין של תהליך בחירת הרשת (Mediation) ל-Unity לפרויקט שלך, על ידי הרצת הפקודה הבאה מספריית השורש של הפרויקט:
openupm add com.google.ads.mobile.mediation.chartboost
OpenUPM
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > הגדרות פרויקט > Package Manager כדי לפתוח את הגדרות של מנהל החבילות של Unity.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמרשם היקף עם את הפרטים הבאים:
- שם:
OpenUPM
- כתובת אתר:
https://package.openupm.com
- היקפים:
com.google
לאחר מכן עוברים אל חלון > Package Manager כדי לפתוח את Unity Package Manager וגם בוחרים באפשרות My Registries (הרישומים שלי) בתפריט הנפתח.
בוחרים את החבילה Google Mobile Ads Chartboost Mediation לוחצים על התקנה.
חבילת Unity
כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור
Chartboost מקישור ההורדה ב-
ה
יומן שינויים
ומחלצים את הקטע
GoogleMobileAdsChartboostMediation.unitypackage
מהמיקוד
חדש.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > ייבוא חבילה >
Custom Package (חבילה מותאמת אישית) ומוצאים את
GoogleMobileAdsChartboostMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על
ייבוא.
בשלב הבא בוחרים באפשרות נכסים > פותר הבעיות של Play Services >
Android resolve > סגירה ידנית. המקודד של Unity Play Services
תבצע רזולוציית תלות מאפס ותעתיק את
יחסי תלות מוצהרים בספרייה Assets/Plugins/Android
של
אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-Chartboost SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (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);
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות (States) צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-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: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- 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 UI חסרים/לא חוקיים. |
104 | מודעת המעברון או מודעת המעברון ב-Chartboost לא מוכנה להצגה. |
iOS
קוד שגיאה | סיבה |
---|---|
101 | הפרמטרים של שרת Chartboost שהוגדרו ב- Ad Manager 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
הגרסה הבאה
- השם של
DummyClient
השתנה. השם החדש הואPlaceholderClient
.
גרסה 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.