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

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

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

AdMob מתאם תהליך בחירת הרשת עבור Chartboost כולל היכולות הבאות:

שילוב
בידינג
מפל
פורמטים
כרזה
מעברון
ההטבה הופעלה

דרישות

  • Unity 4 ומעלה
  • ה-SDK העדכני של Google Mobile Ads
  • לפריסה ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
  • השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

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

מרכז השליטה של אפליקציות ב-Chartboost

לוחצים על הלחצן Add new app (הוספת אפליקציה חדשה) כדי ליצור את האפליקציה.

ניהול אפליקציות

מלאו את שאר הטופס ולחצו על הלחצן Add App כדי לסיים את תהליך היצירה של האפליקציה.

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

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

Android

הגדרות יישום

iOS

הגדרות יישום

AdMob כדי להגדיר את AdMob מזהה יחידת המודעות, יש צורך ב-User ID ובחתימת משתמש ב-Chartboost. כדי למצוא את הפרמטרים האלה, לוחצים על Mediation ב-Chartboost בממשק המשתמש של Chartboost.

מרכז הבקרה של תהליך בחירת הרשת ב-Chartboost

נכנסים לכרטיסייה Resources > API Explorer ורושמים את הפרטים של User ID ושל User Signature בקטע Authentication.

Chartboost api Explorer

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

אפשר להפעיל את מצב הבדיקה באפליקציה על ידי מעבר לכרטיסייה ניהול אפליקציות מממשק המשתמש של Chartboost, בחירת האפליקציה מהרשימה ולחיצה על Edit app settings.

Android

עריכה של הגדרות האפליקציה

iOS

עריכה של הגדרות האפליקציה

דרך הגדרות האפליקציה, אפשר להפעיל או להשבית את מצב הבדיקה באפליקציה.

מצב בדיקה של Chartboost

לאחר הפעלת מצב הבדיקה, ניתן לך לשלוח בקשה להצגת מודעות באמצעות מזהה יחידת המודעות שנוצר מוקדם יותר, ולקבל מודעת בדיקה של Chartboost.

אחרי שתוכלו לקבל מודעות בדיקה של Chartboost, האפליקציה תמוקם בדף Publisher App Review של Chartboost. כדי שהמונטיזציה ב-Chartboost תפעל, הבדיקה של אפליקציית בעל התוכן הדיגיטלי צריכה לקבל אישור מ-Chartboost.

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

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

הוספה של Chartboost לרשימת שותפי הפרסום בנושא GDPR ותקנות במדינות בארה"ב

פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Chartboost לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .

שלב 3: מייבאים את ה-SDK והמתאם של Chartboost

הורדת הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-Chartboost מקישור ההורדה יומן שינויים וחילוץ GoogleMobileAdsChartboostMediation.unitypackage מקובץ ה-ZIP.

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה > חבילה מותאמת אישית ומוצאים את GoogleMobileAdsChartboostMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android > סגירה ידנית. ספריית Unity Play Services מקודדת תפעל של יחסי התלות מההתחלה ומעתיקים את יחסי התלות המוצהרים הספרייה Assets/Plugins/Android של אפליקציית Unity.

שלב 4: מטמיעים את הגדרות הפרטיות ב-Chartboost SDK

בכפוף להסכמת משתמשים של 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);

חוקי פרטיות במדינות בארה"ב

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

גרסה 4.5.0

גרסה 4.4.0

גרסה 4.3.0

גרסה 4.2.0

גרסה 4.1.1

גרסה 4.1.0

גרסה 4.0.0

גרסה 3.5.1

גרסה 3.5.0

גרסה 3.4.1

גרסה 3.4.0

גרסה 3.3.1

גרסה 3.3.0

גרסה 3.2.0

גרסה 3.1.0

גרסה 3.0.1

גרסה 3.0.0

גרסה 2.0.1

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