במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות תהליך בחירת הרשת ב-AdMob, שכוללות שילובים של Waterfall. המאמר מסביר איך להוסיף DT Exchange למודעה את תצורת הגישור של היחידה ואת האופן שבו ניתן לשלב את DT Exchange SDK מתאם לאפליקציה Android .
השילובים והפורמטים של המודעות שנתמכים
למתאם תהליך בחירת הרשת עבור DT Exchange יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מותאם |
דרישות
- Android API ברמה 21 ואילך
ה-SDK העדכני של Google Mobile Ads
השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של DT Exchange
שלב 2: הגדרת ביקוש ב-DT Exchange AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
עליך להוסיף DT Exchange לתצורה של תהליך בחירת הרשת של יחידת המודעות.
קודם נכנסים לחשבון AdMob. לאחר מכן נכנסים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, צריך ללחוץ על השם של הקבוצה לבחירת רשת כדי לערוך אותה, ולדלג לקטע הוספה DT Exchange כמקור מודעות.
כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת (Mediation).
מזינים את פורמט המודעה ואת הפלטפורמה, ולוחצים על המשך.
נותנים שם לקבוצה לבחירת רשת (Mediation) ובוחרים מיקומים גיאוגרפיים לטירגוט. בשלב הבא, מגדירים את הסטטוס של הקבוצה לבחירת רשת למופעלת ולוחצים על הוספת יחידות של מודעות.
משייכים את הקבוצה הזו לבחירת רשת לאחת או יותר מיחידות המודעותAdMob הקיימות. לאחר מכן לוחצים על סיום.
עכשיו אתם אמורים לראות שהכרטיס של יחידות המודעות מאוכלס ביחידות של המודעות שבחרתם:
הוספה של DT Exchange כמקור מודעות
בכרטיס Waterfall בקטע מקורות מודעות, בוחרים באפשרות הוספת מקור מודעות. לאחר מכן בוחרים DT Exchange.
בוחרים באפשרות DT Exchange ומפעילים את המתג Optimize. עליכם להזין את Publisher ID, Consumer Secret and Consumer Keyשקיבלתם בסעיף הקודם כדי להגדיר אופטימיזציה של מקורות מודעות עבורDT Exchange. לאחר מכן מזינים ערך של עלות בפועל לאלף חשיפות עבורDT Exchange ולוחצים על המשך.אם כבר יש לכם מיפוי של DT Exchange, תוכלו לבחור אותו. אם לא, לוחצים על הוספת מיפוי.
לאחר מכן, מזינים את Application ID and Placement IDשקיבלתם בקטע הקודם. לאחר מכן לוחצים על סיום.
הוספה Fyber לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
שלב 3: מייבאים את ה-DT Exchange SDK והמתאם
שילוב עם Android Studio (מומלץ)
לקובץ build.gradle.kts
ברמת האפליקציה, מוסיפים את ההטמעה הבאה
של יחסי התלות ושל מערכי הגדרות אישיות. משתמשים בגרסאות העדכניות ביותר של ה-SDK והמתאם של DT Exchange:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:fyber:8.3.1.0")
}
שילוב ידני
- מורידים את הגרסה העדכנית של DT Exchange SDK ל-Android ומוסיפים את הקבצים הבאים לפרויקט:
ia-mraid-kit-release-x.y.z.aar
ia-sdk-core-release-x.y.z.aar
ia-video-kit-release-x.y.z.aar
- עוברים אל
פריטי מידע שנוצרו בתהליך פיתוח (Artifact) של מתאם DT
במאגר Maven של Google. בוחרים בגרסה העדכנית ביותר ומורידים את העברת השיחה
החלפת הקובץ
.aar
של המתאם, והוספתו לפרויקט.
שלב 4: מטמיעים את הגדרות הפרטיות ב-DT Exchange SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
DT Exchange מכיל API שמאפשר להעביר את הסכמת המשתמשים ל-SDK שלהם. הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה אל DT Exchange. SDK באופן ידני. אם בוחרים להעביר את פרטי ההסכמה ל-DT Exchange SDK באופן ידני, מומלץ להפעיל את הקוד הזה לפני שמבקשים מודעות דרך Google Mobile Ads SDK.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")
נכנסים לדף המשאבים בנושא GDPR של DT Exchange מדריך להטמעת GDPR כדי לקבל פרטים נוספים ואת הערכים שמצוינים בשיטה.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
DT Exchange מכיל ממשק API שמאפשר להעביר את הסכמת המשתמשים ל-SDK שלהם. הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה אל DT Exchange. SDK באופן ידני. אם תבחרו להעביר את פרטי ההסכמה ל-DT Exchange ל-SDK באופן ידני, מומלץ לקרוא לקוד הזה לפני ששולחים בקשה להצגת מודעות באמצעות Google Mobile Ads SDK.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")
נכנסים לדף המשאבים של CCPA ב-DT Exchange מדריך להטמעה של CCPA כדי לקבל פרטים נוספים ואת הערכים שמצוינים בשיטה.
שלב 5: מוסיפים את הקוד הנדרש
לא נדרש קוד נוסף לשילוב DT Exchange.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-DT Exchange, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות DT Exchange (Waterfall) מקורות המודעות.
שלבים אופציונליים
פרמטרים ספציפיים לרשת
מתאם DT Exchange תומך בפרמטרים נוספים של בקשות שאפשר להעביר למתאם כחבילת Android. המתאם מחפש את הדברים הבאים המפתחות בחבילה:
פרמטרים וערכים של בקשה | |
---|---|
InneractiveMediationDefs.KEY_AGE
|
מספר שלם. הגיל של המשתמש |
FyberMediationAdapter.KEY_MUTE_VIDEO
|
בוליאני. השתקה או ביטול ההשתקה של הסרטון |
הדוגמה הבאה ממחישה איך להגדיר את הפרמטרים האלה של בקשות להצגת מודעות:
Java
Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
.build();
Kotlin
var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)
val request = AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
.build()
קודי שגיאה
אם המתאם לא מקבל מודעה מ-DT Exchange, אפשר לבדוק
לשגיאה בסיסית מהתגובה באמצעות מודעה באמצעות
ResponseInfo.getAdapterResponses()
במחלקה הבאה:
com.google.ads.mediation.fyber.FyberMediationAdapter
אלו הקודים וההודעות הנלוות שמוצגות על ידי מתאם ה-DT Exchange כשמודעה נכשלת להיטען:
קוד שגיאה | סיבה |
---|---|
101 | הפרמטרים של שרת DT Exchange שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
103 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך על ידי DT Exchange. |
105 | DT Exchange SDK טען מודעה אבל החזיר בקר לא צפוי. |
106 | המודעה לא מוכנה להצגה. |
200-399 | אירעה שגיאה ב-DT Exchange SDK. להצגת הקוד אפשר לקבל פרטים נוספים. |
יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-DT Exchange
גרסה 8.3.1.0
- תאימות מאומתת ל-DT Exchange SDK 8.3.1.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 23.3.0.
- DT Exchange SDK גרסה 8.3.1.
גרסה 8.3.0.0
- נוספה תמיכה בהעברה של גרסת Google Mobile Ads SDK אל DT Exchange SDK.
- תאימות מאומתת ל-DT Exchange SDK 8.3.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 23.2.0.
- DT Exchange SDK גרסה 8.3.0.
גרסה 8.2.7.0
- תאימות מאומתת ל-DT Exchange SDK 8.2.7.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK בגרסה 23.0.0.
- DT Exchange SDK בגרסה 8.2.7.
גרסה 8.2.6.1
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 23.0.0.
- תאימות מאומתת ל-DT Exchange SDK 8.2.6.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK בגרסה 23.0.0.
- DT Exchange SDK גרסה 8.2.6.
גרסה 8.2.6.0
- תאימות מאומתת ל-DT Exchange SDK 8.2.6.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK בגרסה 22.6.0.
- DT Exchange SDK גרסה 8.2.6.
גרסה 8.2.5.0
- תאימות מאומתת ל-DT Exchange SDK 8.2.5.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 22.5.0.
- DT Exchange SDK גרסה 8.2.5.
גרסה 8.2.4.0
- תאימות מאומתת ל-DT Exchange SDK 8.2.4.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 22.3.0.
- DT Exchange SDK גרסה 8.2.4.
גרסה 8.2.3.0
- המתאם עודכן כדי להשתמש במחלקה החדשה
VersionInfo
. - הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 22.0.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK גרסה 22.0.0.
- DT Exchange SDK בגרסה 8.2.3.
גרסה 8.2.2.1
- נוספה תמיכה בהעברת מפתח
muteVideo
בסעיף נוסף של גישור להשתקת מודעות מעברון.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 21.5.0.
- DT Exchange SDK גרסה 8.2.2.
גרסה 8.2.2.0
- תאימות מאומתת ל-DT Exchange SDK 8.2.2.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 21.5.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 21.5.0.
- DT Exchange SDK גרסה 8.2.2.
גרסה 8.2.1.0
- השם של המתאם שונה ל-'DT Exchange'.
- תאימות מאומתת ל-DT Exchange SDK 8.2.1.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 21.3.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 21.3.0.
- DT Exchange SDK גרסה 8.2.1.
גרסה 8.2.0.0
- תאימות מאומתת ל-Fyber SDK 8.2.0.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.1.0.
הקוד נוצר ונבדק באמצעות:
- גרסה 21.1.0 של Google Mobile Ads SDK.
- Fyber SDK גרסה 8.2.0.
גרסה 8.1.5.0
- תאימות מאומתת ל-Fyber SDK 8.1.5.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK גרסה 21.0.0.
- Fyber SDK גרסה 8.1.5.
גרסה 8.1.4.0
- תאימות מאומתת ל-Fyber SDK בגרסה 8.1.4.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 21.0.0.
- Fyber SDK גרסה 8.1.4.
גרסה 8.1.3.1
- עודכנו
compileSdkVersion
ו-targetSdkVersion
ל-API 31. - עדכנת את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.0.0.
- רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-19.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK בגרסה 21.0.0.
- Fyber SDK גרסה 8.1.3.
גרסה 8.1.3.0
- תאימות מאומתת ל-Fyber SDK 8.1.3.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 20.6.0.
פותח ונבדק בעזרת:
- גרסה 20.6.0 של Google Mobile Ads SDK.
- Fyber SDK גרסה 8.1.3.
גרסה 8.1.2.0
- תאימות מאומתת ל-Fyber SDK 8.1.2.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 20.5.0.
פותח ונבדק בעזרת:
- גרסה 20.5.0 של Google Mobile Ads SDK.
- גרסת ה-SDK של Fyber היא 8.1.2.
גרסה 8.1.0.0
- תאימות מאומתת ל-Fyber SDK 8.1.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK בגרסה 20.4.0.
- Fyber SDK גרסה 8.1.0.
גרסה 7.8.4.1
- נפתרה בעיה שבה המתאם לא הופעל אם יש מזהה אפליקציה כפול או יותר ממזהה אפליקציה ייחודי אחד מההגדרות של תהליך בחירת הרשת.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.4.0.
פותח ונבדק בעזרת:
- גרסה 20.4.0 של Google Mobile Ads SDK.
- Fyber SDK גרסה 7.8.4.
גרסה 7.8.4.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.8.4.
- עדכנת את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.3.0.
- תוקנה בעיה במודעות מתגמלות לרשת המדיה, שדרכה לא התקשרו אל
onVideoComplete()
. - כדי להציג מודעות ב-Fyber, עכשיו נדרש הקשר פעילות.
פותח ונבדק בעזרת:
- גרסה 20.3.0 של Google Mobile Ads SDK.
- Fyber SDK גרסה 7.8.4.
גרסה 7.8.3.0
- תאימות מאומתת עם Fyber SDK 7.8.3.
- נוספו הודעות וקודי שגיאה של מתאם סטנדרטי.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 20.1.0.
פותח ונבדק בעזרת:
- גרסה 20.1.0 של Google Mobile Ads SDK.
- Fyber SDK גרסה 7.8.3.
גרסה 7.8.2.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.8.2.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-20.0.0.
הקוד נוצר ונבדק באמצעות:
- גרסה 20.0.0 של Google Mobile Ads SDK.
- Fyber SDK גרסה 7.8.2.
גרסה 7.8.1.0
- תאימות מאומתת ל-Fyber SDK 7.8.1.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.7.0.
- Fyber SDK גרסה 7.8.1.
גרסה 7.8.0.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.8.0.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 19.7.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.7.0.
- גרסת Fyber SDK 7.8.0.
גרסה 7.7.4.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.7.4.
- תוקנה בעיה שבה
onUserEarnedReward()
מועבר פעמיים עבור מודעות מתגמלות.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.5.0.
- Fyber SDK גרסה 7.7.4.
גרסה 7.7.3.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.7.3.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK גרסה 19.5.0.
- Fyber SDK גרסה 7.7.3.
גרסה 7.7.2.0
- תאימות מאומתת ל-Fyber SDK 7.7.2.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 19.5.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.5.0.
- Fyber SDK גרסה 7.7.2.
גרסה 7.7.1.0
- תאימות מאומתת ל-Fyber SDK 7.7.1.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.4.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.4.0.
- גרסת SDK של Fyber 7.7.1.
גרסה 7.7.0.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.7.0.
הקוד נוצר ונבדק באמצעות:
- Google Mobile Ads SDK גרסה 19.3.0.
- Fyber SDK גרסה 7.7.0.
גרסה 7.6.1.0
- תאימות מאומתת ל-Fyber SDK 7.6.1.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK בגרסה 19.3.0.
- Fyber SDK גרסה 7.6.1.
גרסה 7.6.0.0
- תאימות מאומתת ל-Fyber SDK 7.6.0.
- המתאם עודכן כך שיתמוך בבקשות למודעות באנר מותאמות שמוצגות בתוך הטקסט.
- עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 19.3.0.
- תוקן באג שגרם לכך שלא בוצעה קריאה לשיטות onAdOpened()/onAdClosed() עבור מודעות באנר.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.3.0.
- גרסת Fyber SDK 7.6.0.
גרסה 7.5.4.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.5.4.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.1.0.
פותח ונבדק בעזרת:
- גרסה 19.1.0 של Google Mobile Ads SDK
- גרסת Fyber SDK 7.5.4.
גרסה 7.5.3.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.5.3.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.0.1.
- Fyber SDK גרסה 7.5.3.
גרסה 7.5.2.0
- תאימות מאומתת ל-Fyber SDK בגרסה 7.5.2.
- הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.0.1.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 19.0.1.
- Fyber SDK גרסה 7.5.2.
גרסה 7.5.0.0
- תאימות מאומתת ל-Fyber SDK 7.5.0.
- תוקנה קריסה מסוג NullPointerException במהלך הטעינה של מודעות Fyber.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 18.3.0.
- Fyber SDK גרסה 7.5.0.
גרסה 7.4.1.0
- תאימות מאומתת ל-Fyber SDK 7.4.1.
- עדכנת את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-18.3.0.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK גרסה 18.3.0.
- Fyber SDK גרסה 7.4.1.
גרסה 7.3.4.0
- זו הגרסה הראשונה
- תמיכה במודעות באנר, במודעות מעברון ובמודעות מתגמלות.
פותח ונבדק בעזרת:
- Google Mobile Ads SDK בגרסה 18.2.0.
- גרסת Fyber SDK 7.3.4.