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

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

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

למתאם בחירת הרשת של Ad Manager ל-Chartboost יש את היכולות הבאות:

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

דרישות

  • Unity 4 ואילך
  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • לפריסה ב-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

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

כדי להגדיר את מזהה יחידת המודעות ב-Ad Manager, צריך את מזהה המשתמש וחתימת המשתמש ב-Chartboost. כדי למצוא את הפרמטרים האלה, לוחצים על Chartboost mediation בממשק המשתמש של 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 בממשק המשתמש של Ad Manager

הגדרת הגדרות בחירת הרשת ליחידת המודעות

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.

iOS

להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.

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

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

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

OpenUPM-CLI

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

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

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

אילוץ פתרון

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

בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם צריכים לוודא שהמשתמשים באזור הכלכלי האירופי (EEA) מקבלים גילויים נאותים מסוימים לגבי השימוש במזהי מכשירים ובמידע אישי, ומאשרים את השימוש הזה. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, 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). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (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: בדיקה מעשית של ההטמעה

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

חשוב לרשום את מכשיר הבדיקה ב-Ad Manager ולהפעיל את מצב הבדיקה בממשק המשתמש של Chartboost.

אימות מודעות לבדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Chartboost, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות של Chartboost (Waterfall).

שלבים אופציונליים

Android

הרשאות

כדי לשפר את הביצועים, מומלץ להוסיף את ההרשאות האופציונליות הבאות לקובץ 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 שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
104 מודעת המעברון או המודעה המתגמלת של Chartboost לא מוכנה להצגה.

iOS

קוד שגיאה סיבה
101 פרמטרים של שרת Chartboost שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
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.7.0

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

גרסה 1.2.0

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