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

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

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

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

דרישות

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

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

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

שלב 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 להגדרות בחירת הרשת של יחידת המודעות.

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

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

מזינים את פורמט המודעה ואת הפלטפורמה ולוחצים על המשך.

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

משייכים את הקבוצה לבחירת רשת (Mediation) הזו לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. לאחר מכן לוחצים על סיום.

כרטיס יחידות המודעות אמור להיות מאוכלס עכשיו ביחידות המודעות שבחרתם:

הוספת Chartboost כמקור מודעות

הוספת 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) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת פרסום בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, 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 בנושא CCPA ובמאמרים שיטות פרטיות ל-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.
• גרסת ה-SDK של Chartboost היא 9.7.0.

גרסה 9.6.0.1

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

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

• Google Mobile Ads SDK בגרסה 11.0.1.
• גרסת ה-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.

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

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

גרסה 9.3.1.0

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

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

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

גרסה 9.3.0.0

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

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

• Google Mobile Ads SDK בגרסה 10.4.0.
• גרסת 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.
• תאימות מאומתת עם Google Mobile Ads SDK בגרסה 9.10.0.
• עדכנו את המתאם לשימוש ב-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

• תאימות מאומתת לגרסה 9.0.0 של Google Mobile Ads SDK.
• מעכשיו נדרשת גרסה 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.

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

• Google Mobile Ads SDK בגרסה 8.1.0.
• גרסת 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.
• גרסת ה-SDK של Chartboost היא 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.
• גרסת SDK של Chartboost‏ 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.
• גרסת SDK של Chartboost‏ 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.

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

• Google Mobile Ads SDK בגרסה 7.60.0.
• גרסת ה-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.
• גרסת ה-SDK של Chartboost היא 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

• הוספנו קריאה חוזרת (callback) מסוג 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'.
• תוקן באג שבו בעלי אפליקציות נתקלו בבעיה של הידור ב-Swift כשמייבאים את ChartboostAdapter.framework כמודול שמייבא את Chartboost SDK ללא מודול.

גרסה 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.
• אפליקציות מקבלות עכשיו את הקריאה החוזרת interstitialWillDismissScreen: כשהמודעה המעברית עומדת להיסגר.
• עכשיו אפליקציות מקבלות את הקריאה החוזרת rewardBasedVideoAdDidOpen: כשמודעת וידאו מתגמלת נפתחת.

גרסה 1.1.0

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

גרסה 1.0.0

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