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

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

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

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

דרישות

• Android API ברמה 21 ואילך

• הגרסה העדכנית ביותר של Google Mobile Ads SDK

• מבצעים את ההוראות שבמדריך לתחילת העבודה.

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

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

לוחצים על הלחצן הוספת אפליקציה חדשה כדי ליצור את האפליקציה.

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

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

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

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

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

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

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

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

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

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

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

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

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

שילוב עם Android Studio (מומלץ)

מוסיפים את המאגרים הבאים לקובץ settings.gradle.kts ברמת הפרויקט:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

לאחר מכן, מוסיפים את יחסי התלות וההגדרות הבאים להטמעה בקובץ build.gradle.kts ברמת האפליקציה. משתמשים בגרסאות העדכניות של ה-SDK והמתאם שלChartboost:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:chartboost:9.8.0.0")
}

שילוב ידני

1. מורידים את הקובץ .aar של הגרסה העדכנית ביותר של Chartboost SDK מ-Maven Central ומוסיפים אותו לפרויקט.

2. עוברים אל ארטיפקטים של מתאם Chartboost במאגר Maven של Google. בוחרים את הגרסה האחרונה, מורידים את הקובץ .aar של מתאם Chartboost ומוסיפים אותו לפרויקט.

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

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

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

בגרסת ה-SDK 8.1.0, Chartboost הוסיפה את השיטה addDataUseConsent(). בקוד לדוגמה הבא מוגדר הערך NON_BEHAVIORAL להסכמה לשימוש בנתונים. אם בוחרים להפעיל את השיטה הזו, מומלץ לעשות זאת לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

במאמר בנושא GDPR של Chartboost שיטות הפרטיות ב-Android אפשר לקבל פרטים נוספים על הערכים שאפשר לספק בכל שיטה.

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

חוקי הפרטיות במדינות ארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה למכירת המידע האישי שלהם (בהתאם להגדרה המעוגנת בחוק). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת המודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.

בגרסת ה-SDK 8.1.0, Chartboost הוסיפה את השיטה addDataUseConsent(). הקוד לדוגמה הבא מגדיר את הנתונים באמצעות הסכמה ל-OPT_IN_SALE. אם בוחרים להפעיל את השיטה הזו, מומלץ לעשות זאת לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

במאמר בנושא CCPA של Chartboost שיטות הפרטיות ב-Android אפשר לקבל פרטים נוספים על הערכים שאפשר לספק בכל שיטה.

שלב 5: מוסיפים את הקוד הנדרש

שינוי של AndroidManifest

רכיבים אחרים

מוסיפים את המאפיין הבא לכל פעילות בקובץ AndroidManifest.xml שתציג מודעות Chartboost ותתמוך בכיוונים שונים:

android:configChanges="keyboardHidden|orientation|screenSize"

אירועים במחזור החיים

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

import com.chartboost.sdk.Chartboost;
// ...

@Override
public void onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed()) {
        return;
    } else {
        super.onBackPressed();
    }
}

import com.chartboost.sdk.Chartboost
// ...

@Override
fun onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed())
        return
    else
        super.onBackPressed()
}

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

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

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

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

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

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

הרשאות

כדי לשפר את הביצועים, מומלץ להוסיף את ההרשאות האופציונליות הבאות לקובץ AndroidManifest.xml של האפליקציה:

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

קודי שגיאה

אם המתאם לא מקבל מודעה מ-Chartboost, אפשר לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות ResponseInfo.getAdapterResponses() בסיווגים הבאים:

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

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

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

גרסה 9.8.0.0

• תאימות מאומתת ל-Chartboost SDK בגרסה 9.8.0.

פותח ונבדק בעזרת:

• גרסה 23.4.0 של Google Mobile Ads SDK.
• גרסת Chartboost SDK‏ 9.8.0.

גרסה 9.7.0.0

• תאימות מאומתת ל-Chartboost SDK גרסה 9.7.0.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-23.0.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK גרסה 23.0.0.
• גרסת ה-SDK של Chartboost היא 9.7.0.

גרסה 9.6.1.0

• תאימות מאומתת עם Chartboost SDK בגרסה 9.6.1.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.6.0.
• Chartboost SDK גרסה 9.6.1.

גרסה 9.6.0.0

• תאימות מאומתת ל-Chartboost SDK גרסה 9.6.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 22.5.0.
• גרסת ה-SDK של Chartboost היא 9.6.0.

גרסה 9.5.0.0

• תאימות מאומתת ל-Chartboost SDK בגרסה 9.5.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK גרסה 22.3.0.
• גרסת SDK של Chartboost‏ 9.5.0.

גרסה 9.4.1.0

• תאימות מאומתת ל-Chartboost SDK בגרסה 9.4.1.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.2.0.
• גרסת SDK של Chartboost‏ 9.4.1.

גרסה 9.4.0.0

• תאימות מאומתת עם Chartboost SDK בגרסה 9.4.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 22.1.0.
• Chartboost SDK גרסה 9.4.0

גרסה 9.3.1.0

• תאימות מאומתת ל-Chartboost SDK בגרסה 9.3.1.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.1.0.
• גרסת SDK של Chartboost‏ 9.3.1.

גרסה 9.3.0.0

• תאימות מאומתת ל-Chartboost SDK גרסה 9.3.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 22.0.0.
• Chartboost SDK גרסה 9.3.0.

גרסה 9.2.1.1

• מתאם מעודכן שמשתמש במחלקה החדשה VersionInfo.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 22.0.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 22.0.0.
• Chartboost SDK גרסה 9.2.1.

גרסה 9.2.1.0

• תאימות מאומתת ל-Chartboost SDK 9.2.1.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK גרסה 21.5.0.
• גרסת SDK של Chartboost‏ 9.2.1.

גרסה 9.2.0.0

• תאימות מאומתת ל-Chartboost SDK 9.2.0.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 21.5.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 21.5.0.
• גרסת SDK של Chartboost‏ 9.2.0.

גרסה 9.1.1.0

• הוספנו את השיטה ChartboostMediationAdapter.setAppParams(String, String) כדרך אופציונלית להטמיע בקוד קשיח את מזהה האפליקציה ואת חתימה האפליקציה שבהם צריך להשתמש כדי לאתחל את Chartboost SDK.
• תאימות מאומתת ל-Chartboost SDK 9.1.1.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.3.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 21.3.0.
• גרסת SDK של Chartboost‏ 9.1.1.

גרסה 8.4.3.1

• עדכנת את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.0.0.
• רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-19.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK גרסה 21.0.0.
• Chartboost SDK גרסה 8.4.3

גרסה 8.4.3.0

• תאימות מאומתת ל-Chartboost SDK 8.4.3.

הקוד נוצר ונבדק באמצעות:

• גרסה 20.6.0 של Google Mobile Ads SDK.
• גרסת ה-SDK של Chartboost היא 8.4.3.

גרסה 8.4.2.0

• תאימות מאומתת ל-Chartboost SDK 8.4.2.
• עודכנו compileSdkVersion ו-targetSdkVersion ל-API 31.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 20.6.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 20.6.0.
• Chartboost SDK גרסה 8.4.2.

גרסה 8.4.1.0

• תאימות מאומתת ל-Chartboost SDK 8.4.1.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 20.6.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 20.6.0.
• גרסת ה-SDK של Chartboost היא 8.4.1.

גרסה 8.3.1.0

• תאימות מאומתת עם Chartboost SDK 8.3.1.
• המתאם עודכן כדי להשתמש ב-API החדש של AdError.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 20.5.0.
• Chartboost SDK גרסה 8.3.1.

גרסה 8.3.0.0

• תאימות מאומתת ל-Chartboost SDK 8.3.0.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.5.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 20.5.0.
• גרסת ה-SDK של Chartboost היא 8.3.0.

גרסה 8.2.1.0

• תאימות מאומתת ל-Chartboost SDK 8.2.1.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 20.1.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 20.1.0.
• גרסת SDK של Chartboost‏ 8.2.1.

גרסה 8.2.0.1

• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 20.0.0.

הקוד נוצר ונבדק באמצעות:

• גרסה 20.0.0 של Google Mobile Ads SDK.
• גרסת Chartboost SDK 8.2.0.

גרסה 8.2.0.0

• תאימות מאומתת ל-Chartboost SDK 8.2.0.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 19.5.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 19.5.0.
• גרסת Chartboost SDK 8.2.0.

גרסה 8.1.0.0

• תאימות מאומתת ל-Chartboost SDK 8.1.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 19.2.0.
• גרסת SDK של Chartboost‏ 8.1.0.

גרסה 8.0.3.2

• נוספו קודי שגיאה תיאוריים וסיבות לכשלים בחיבור או בהצגה של מתאמים.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-19.2.0.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK גרסה 19.2.0.
• גרסת SDK של Chartboost‏ 8.0.3.

גרסה 8.0.3.1

• הוספנו תמיכה במודעות באנר של Chartboost.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 19.1.0.
• גרסת SDK של Chartboost‏ 8.0.3.

גרסה 8.0.3.0

• תאימות מאומתת ל-Chartboost SDK 8.0.3.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 19.1.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK בגרסה 19.1.0.
• גרסת SDK של Chartboost‏ 8.0.3.

גרסה 8.0.2.0

• תאימות מאומתת עם Chartboost SDK 8.0.2.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-19.0.1.

פותח ונבדק בעזרת:

• Google Mobile Ads SDK בגרסה 19.0.1.
• גרסת SDK של Chartboost‏ 8.0.2.

גרסה 8.0.1.0

• תאימות מאומתת ל-Chartboost SDK 8.0.1.
• נדרשת גרסת Chartboost SDK 8.0.1 ואילך.
• לא נדרשת יותר הקשר פעילות כדי לטעון מודעות.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK גרסה 18.3.0.
• Chartboost SDK גרסה 8.0.1

גרסה 7.5.0.1

• תוקן באג שבו מתאם Chartboost לא הצליח להפעיל אירועי מודעות.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.3.0.

הקוד נוצר ונבדק באמצעות:

• Google Mobile Ads SDK גרסה 18.3.0.
• גרסת SDK של Chartboost‏ 7.5.0.

גרסה 7.5.0.0

• תאימות מאומתת ל-Chartboost SDK 7.5.0.
• העברת המתאם לשימוש ביחסי תלות של AndroidX.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 18.1.1.

גרסה 7.3.1.1

• עדכנו את המתאם כך שיתמוך ב-Rewarded API החדש בגרסת בטא פתוחה.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 17.2.0.

גרסה 7.3.1.0

• תאימות מאומתת ל-Chartboost SDK 7.3.1.

גרסה 7.3.0.0

• תאימות מאומתת עם Chartboost SDK 7.3.0.

גרסה 7.2.1.0

• תאימות מאומתת ל-Chartboost SDK 7.2.1.

גרסה 7.2.0.1

• עדכנו את המתאם כדי להפעיל את אירוע המודעה onRewardedVideoComplete().

גרסה 7.2.0.0

• תאימות מאומתת ל-Chartboost SDK 7.2.0.

גרסה 7.1.0.0

• תאימות מאומתת ל-Chartboost SDK 7.1.0.

גרסה 7.0.1.0

• תאימות מאומתת עם Chartboost SDK 7.0.1.
• נוספה תמיכה בקודי שגיאה חדשים של Chartboost.
• עדכנו את פרויקט המתאם ל-Android Studio 3.0

גרסה 7.0.0.0

• עדכנו את המתאם כך שיהיה תואם ל-Chartboost SDK 7.0.0.

גרסה 6.6.3.0

• תאימות מאומתת ל-Chartboost SDK 6.6.3.

גרסה 6.6.2.0

• תאימות מאומתת ל-Chartboost SDK 6.6.2.

גרסה 6.6.1.0

• תאימות מאומתת עם Chartboost SDK 6.6.1.

גרסה 6.6.0.0

• שינינו את המערכת למתן שמות לגרסאות ל-[Chartboost SDK version] גרסת תיקון של מתאם.
• עכשיו אפשר להוסיף את המתאמים כיחסי תלות בזמן הידור. לשם כך, מוסיפים את הטקסט הבא לתג ה-dependencies בקובץ build.gradle: compile 'com.google.ads.mediation:chartboost:6.6.0.0'
• הועבר להפצת המתאם כקובץ Aar במקום קובץ צנצנות (הוראות נוספות זמינות ב-README).

גרסה 1.1.0

• הוסר המיקום של מודעות Chartboost מהתוספים של Chartboost. מעכשיו, מיקום המודעה מצוין במסוף AdMob כשמגדירים את Chartboost לתהליך בחירת הרשת.

גרסה 1.0.0

• הגרסה הראשונית. תמיכה במודעות וידאו מתגמלות ובמודעות מעברון.