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

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

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

למתאם תהליך בחירת הרשת עבור DT Exchange יש את היכולות הבאות:

דרישות

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

• ה-SDK העדכני של Google Mobile Ads

• השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

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

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

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

שלב 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.

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

נכנסים לדף המשאבים בנושא GDPR של DT Exchange מדריך להטמעת GDPR כדי לקבל פרטים נוספים ואת הערכים שמצוינים בשיטה.

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

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

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

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

נכנסים לדף המשאבים של CCPA ב-DT Exchange מדריך להטמעה של CCPA כדי לקבל פרטים נוספים ואת הערכים שמצוינים בשיטה.

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

לא נדרש קוד נוסף לשילוב DT Exchange.

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

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

חשוב לרשום את מכשיר הבדיקה ל- Ad Manager

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

כדי לוודא שמוצגות לך מודעות לבדיקה מ-DT Exchange, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות DT Exchange (Waterfall) מקורות המודעות.

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

פרמטרים ספציפיים לרשת

מתאם DT Exchange תומך בפרמטרים נוספים של בקשות שאפשר להעביר למתאם כחבילת Android. המתאם מחפש את הדברים הבאים המפתחות בחבילה:

הדוגמה הבאה ממחישה איך להגדיר את הפרמטרים האלה של בקשות להצגת מודעות:

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();

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 כשמודעה נכשלת להיטען:

יומן שינויים של מתאם תהליך בחירת הרשת (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.