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

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

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

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

דרישות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK והמתאם של Chartboost בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_chartboost: ^1.0.0

שילוב ידני

מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור Chartboost, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את הפלאגין לקובץ pubspec.yaml באמצעות יחסי התלות הבאים:

dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

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

הסכמה באיחוד האירופי ו-GDPR

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

הפלאגין של Google Mobile Ads לבחירת רשת ב-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: מוסיפים את הקוד הנדרש

שלב 6: בדיקה מעשית של ההטמעה

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

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

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

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

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

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

קודי שגיאה

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

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

GADMAdapterChartboost
GADMediationAdapterChartboost

אלה הקודים וההודעות שמופיעים במתאם Chartboost כשהטעינה של מודעה נכשלת:

יומן השינויים של מתאם Chartboost Flutter Mediation

1.0.0

• הגרסה הראשונית.
• תאימות מאומתת למתאם Chartboost ל-Android בגרסה 9.8.1.0
• תאימות מאומתת עם מתאם Chartboost ל-iOS בגרסה 9.8.0.0
• ה-plugin נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin בגרסה 5.2.0.