שילוב של 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. פרטים נוספים זמינים במאמר תחילת העבודה.
  • השלמת התהליך של תהליך בחירת הרשת המדריך לתחילת העבודה

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

Chartboost API Explorer

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

כדי להפעיל את מצב הבדיקה באפליקציה, עוברים לכרטיסייה Apps management בממשק המשתמש של Chartboost, בוחרים את האפליקציה מהרשימה ולוחצים על Edit app settings (עריכת ההגדרות של האפליקציה).

Android

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

iOS

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

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

מצב בדיקה של Chartboost

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

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

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

קביעת הגדרות של תהליך בחירת הרשת (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 Package Manager Settings.

בכרטיסייה 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 שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על Import.

ייבוא מ-Unity

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

הפלאגין של 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 שהוגדרו בממשק המשתמש של 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.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.
  • יש תמיכה בגרסה 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.