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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

לוח הבקרה של Chartboost Mediation

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

Chartboost API Explorer

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

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

Android

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

iOS

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

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

מצב בדיקה ב-Chartboost

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין בפרויקט את הפלאגין Chartboost Mediation של Google Mobile Ads ל-Unity על ידי הרצת הפקודה הבאה מספריית השורש של הפרויקט:

openupm add com.google.ads.mobile.mediation.chartboost

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.

בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר ברמת ההיקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפים: com.google

פרטי OpenUPM

לאחר מכן עוברים אל Window > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries מהתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads Chartboost Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

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

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets‏ > Import Package‏ > Custom Package ומאתרים את הקובץ GoogleMobileAdsChartboostMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות Assets‏ > External Dependency Manager‏ > Android Resolver‏ > Force Resolve. הספרייה של External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות המוצגים לתיקייה Assets/Plugins/Android באפליקציה שלכם ב-Unity.

אילוץ פתרון

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

בהתאם למדיניות 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 לא יכולה להחיל את ההגדרה הזו על כל רשת המודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.

הפלאגין של 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 ה-SDK של Chartboost החזיר שגיאה.
101 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-Chartboost.
102 מערכת Chartboost יכולה לטעון רק מודעה אחת בכל מיקום בכל פעם.
103 פרמטרים של שרת Chartboost שהוגדרו בממשק המשתמש של AdMob חסרים או לא חוקיים.
104 מודעת המעברון או המודעה המתגמלת של Chartboost לא מוכנה להצגה.

iOS

קוד שגיאה סיבה
101 פרמטרים של שרת Chartboost שהוגדרו בממשק המשתמש של AdMob חסרים או לא חוקיים.
102 אירעה שגיאת אתחול ב-Chartboost SDK.
103 מודעת Chartboost לא נשמרת במטמון בזמן ההצגה.
104 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-Chartboost.
105 גרסת מערכת ההפעלה של המכשיר נמוכה מגרסת מערכת ההפעלה המינימלית שנתמכת על ידי Chartboost SDK.
200-299 שגיאות במטמון של Chartboost SDK. פרטים נוספים זמינים במאמר קוד.
300-399 מוצגות שגיאות ב-Chartboost SDK. אפשר לקרוא פרטים נוספים בקוד.
400-499 שגיאות הקשה ב-Chartboost SDK. פרטים נוספים זמינים במאמר קוד.

יומן השינויים של הפלאגין של Chartboost לבחירת רשת (Mediation) ב-Unity

גרסה 4.6.1

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

  • התמיכה במתאם של Chartboost ל-Android היא בגרסה 7.5.0.0.
  • התמיכה מתבצעת במתאם Chartboost ל-iOS בגרסה 8.0.1.1.

גרסה 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.
  • התמיכה מתבצעת במתאם Chartboost ל-iOS בגרסה 7.3.0.0.

גרסה 1.1.1

  • תמיכה במתאם Chartboost ל-Android בגרסה 7.2.0.1.
  • התמיכה מתבצעת במתאם Chartboost ל-iOS בגרסה 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.