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

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

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

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

דרישות

• יעד הפריסה של iOS מגרסה 12.0 ואילך

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

• מדריך לתחילת העבודה בנושא בחירת הרשת

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

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

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

ממלאים את שאר הפרטים בטופס ולוחצים על הלחצן 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

שימוש ב-CocoaPods (מומלץ)

• מוסיפים את השורה הבאה ל-Podfile של הפרויקט:

  pod 'GoogleMobileAdsMediationChartboost'
  

• מריצים את הפקודה הבאה בשורת הפקודה:

  pod install --repo-update

שילוב ידני

• מורידים את הגרסה העדכנית ביותר של Chartboost SDK ומקשרים את Chartboost.framework ואת CHAMoatMobileAppKit.framework בפרויקט.

• מורידים את הגרסה האחרונה של מתאם Chartboost מהקישור להורדה בChangelog ומקשרים את ChartboostAdapter.framework בפרויקט.

• מוסיפים את המסגרות הבאות לפרויקט:

  • StoreKit
  • Foundation
  • CoreGraphics
  • WebKit
  • AVFoundation
  • UIKit

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

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

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

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

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

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

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

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

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

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

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

קודי שגיאה

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

GADMAdapterChartboost
GADMediationAdapterChartboost

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

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

גרסה 9.8.0.0

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

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

• Google Mobile Ads SDK בגרסה 11.11.0.
• גרסת Chartboost SDK‏ 9.8.0.

גרסה 9.7.0.1

• עדכנו את CFBundleShortVersionString כך שיכלול שלושה רכיבים במקום ארבעה.

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

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

גרסה 9.7.0.0

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

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

• Google Mobile Ads SDK בגרסה 11.2.0.
• Chartboost SDK גרסה 9.7.0.

גרסה 9.6.0.1

• נדרשת עכשיו גרסת iOS 12.0 מינימלית.
• מעכשיו נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
• Info.plist נכלל במסגרות שב-ChartboostAdapter.xcframework.

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

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

גרסה 9.6.0.0

• תאימות מאומתת עם Chartboost SDK בגרסה 9.6.0.
• השיטה GADMobileAds.sharedInstance.sdkVersion שהוצאה משימוש הוחלפה ב-GADMobileAds.sharedInstance.versionNumber.
• נוספה הטמעה של GADMediationInterstitialAd.

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

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

גרסה 9.5.1.0

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

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

• Google Mobile Ads SDK בגרסה 10.12.0.
• גרסת Chartboost SDK‏ 9.5.1.

גרסה 9.4.0.0

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

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

• גרסה 10.7.0 של Google Mobile Ads SDK.
• גרסת SDK של Chartboost‏ 9.4.0.

גרסה 9.3.1.0

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

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

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

גרסה 9.3.0.0

• תאימות מאומתת עם Chartboost SDK בגרסה 9.3.0.
• עכשיו נדרשת גרסת iOS מגרסה 11.0 ואילך.
• מעכשיו נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.

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

• גרסה 10.4.0 של Google Mobile Ads SDK.
• גרסת SDK של Chartboost‏ 9.3.0.

גרסה 9.2.0.0

• הוסרה ייבוא של GADMChartboostExtras בקובץ הכותרת ChartboostAdapter.
• תאימות מאומתת ל-Chartboost SDK בגרסה 9.2.0.
• מעכשיו נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.
• הוסרה התמיכה בארכיטקטורה armv7.
• עכשיו נדרשת גרסת iOS 11.0 מינימלית.

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

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

גרסה 9.1.0.0

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

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

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

גרסה 9.0.0.0

• תאימות מאומתת עם Chartboost SDK בגרסה 9.0.0.
• תאימות מאומתת לגרסה 9.10.0 של Google Mobile Ads SDK.
• עדכנו את המתאם לשימוש ב-API ‏didRewardUser.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 9.8.0 ואילך של Google Mobile Ads SDK.

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

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

גרסה 8.5.0.2

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

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

• Google Mobile Ads SDK בגרסה 9.0.0.
• גרסת Chartboost SDK‏ 8.5.0.

גרסה 8.5.0.1.0

• תאימות מאומתת ל-Chartboost SDK 8.5.0, שמתייחס לגרסה 8.5.0.1 ב-CocoaPods.

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

• Google Mobile Ads SDK בגרסה 8.13.0.
• Chartboost SDK גרסה 8.5.0

גרסה 8.5.0.0

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

פותח ונבדק עם

• Google Mobile Ads SDK גרסה 8.12.0.
• גרסת Chartboost SDK‏ 8.5.0.

גרסה 8.4.2.0

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

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

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

גרסה 8.4.1.1

• תלות מקלה ב-Google Mobile Ads SDK בגרסה 8.0.0 ואילך.

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

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

גרסה 8.4.1.0

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

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

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

גרסה 8.4.0.1

• נוספו קודים והודעות סטנדרטיים של שגיאות במתאם.
• עדכנו את המתאם כך שישתמש בפורמט .xcframework.
• מעכשיו נדרשת גרסה 8.0.0 ואילך של Google Mobile Ads SDK.

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

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

גרסה 8.4.0.0

• תאימות מאומתת ל-Chartboost SDK 8.4.0.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.68.0 ואילך של Google Mobile Ads SDK.

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

• Google Mobile Ads SDK בגרסה 7.68.0.
• Chartboost SDK גרסה 8.4.0

גרסה 8.3.1.0

• תאימות מאומתת עם Chartboost SDK 8.3.1.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.66.0 ואילך של Google Mobile Ads SDK.
• עכשיו נדרשת גרסת iOS מגרסה 10.0 לפחות.
• עדכנו את המתאם כך שיתמוך בבקשות להצגת מודעות באנר מותאמות.

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

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

גרסה 8.2.1.0

• תאימות מאומתת ל-Chartboost SDK 8.2.1.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.64.0 ואילך של Google Mobile Ads SDK.
• עכשיו נדרשת גרסת iOS מגרסה 9.0 ואילך.

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

• Google Mobile Ads SDK גרסה 7.64.0.
• Chartboost SDK גרסה 8.2.1.

גרסה 8.2.0.0

• תאימות מאומתת עם Chartboost SDK 8.2.0.
• כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.61.0 ואילך של Google Mobile Ads SDK.

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

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

גרסה 8.1.0.1

• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 7.60.0.
• המתאם עודכן לשימוש ב-API החדש של Chartboost וממשקי API שהוצאו משימוש הוסרו.
• המתאם תומך עכשיו בחיבור של כמה מודעות באותו פורמט לאותו מיקום ב-Chartboost.
• אם לא משנים את התגמול בממשק המשתמש של AdMob או של Ad Manager, ערך התגמול במודעות המתגמלות הוא עכשיו הערך שצוין בממשק המשתמש של Chartboost במקום 0.

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

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

גרסה 8.1.0.0

• תאימות מאומתת ל-Chartboost SDK 8.1.0.
• הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 7.59.0.
• הוסר התמיכה בארכיטקטורה i386.

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

• Google Mobile Ads SDK בגרסה 7.59.0.
• Chartboost SDK גרסה 8.1.0

גרסה 8.0.4.0

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

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

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

גרסה 8.0.1.1

• תוקנה בעיה שבה בקשות למודעות באנר לא מחזירות תוצאות.

גרסה 8.0.1.0

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

גרסה 7.5.0.1

• הוסף קוד כדי לאתחל בצורה נכונה את Chartboost SDK.

גרסה 7.5.0.0

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

גרסה 7.3.0.0

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

גרסה 7.2.0.1

• הקריאה החוזרת של adapterDidCompletePlayingRewardBasedVideoAd: נוספה למתאם.

גרסה 7.2.0.0

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

גרסה 7.1.2.0

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

גרסה 7.1.1.0

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

גרסה 7.1.0.0

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

גרסה 7.0.4.0

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

גרסה 7.0.3.0

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

גרסה 7.0.2.0

• תאימות מאומתת עם Chartboost SDK 7.0.2.
• נוספה תמיכה בשני קודי שגיאה חדשים של Chartboost.

גרסה 7.0.1.0

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

גרסה 7.0.0.0

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

גרסה 6.6.3.0

• תאימות מאומתת ל-Chartboost SDK 6.6.3.
• הוסר התמיכה בארכיטקטורה 'armv7s'.
• תוקן באג שגרם לבעיות הידור (compilation) של בעלי תוכן דיגיטלי ב-Swift במהלך הייבוא של ChartboostAdapter.framework כמודול שייבא SDK לא מודולרי ב-Chartboost.

גרסה 6.6.2.0

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

גרסה 6.6.1.0

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

גרסה 6.6.0.0

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

גרסה 6.5.2.1

• הפעלת תמיכה בקוד בייט.
• עכשיו אנחנו מפיצים את מתאם Chartboost כמסגרת.
• כדי לייבא את ChartboostAdapter.framework לפרויקט, צריך להגדיר את Allow Non-modular Includes in Framework Modules כ-YES בקטע Build Settings של היעד.

גרסה 6.5.2.0

• שינינו את מערכת השמות של הגרסאות ל-[גרסת ה-SDK של Chartboost].[גרסת התיקון של המתאם].
• עדכנו את גרסת ה-SDK המינימלית הנדרשת של Chartboost לגרסה 6.5.1.
• עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 7.10.1.
• תוקן באג כדי לתמוך במספר מיקומי מודעות ב-Chartboost.
• האפליקציות מקבלות עכשיו את הקריאה החוזרת (callback) של interstitialWillDismissScreen: כשמודעת המעברון עומדת להיסגר.
• עכשיו אפליקציות מקבלות את הקריאה החוזרת rewardBasedVideoAdDidOpen: כשמודעת וידאו מתגמלת נפתחת.

גרסה 1.1.0

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

גרסה 1.0.0

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