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

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

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

Ad Manager מתאם התיווך של DT Exchange כולל את היכולות הבאות:

שילוב
בידינג
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה

דרישות

  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • Unity 4 ואילך
  • לפריסה ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
  • מדריך לתחילת העבודה בנושא בחירת הרשת

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

הוספת אפליקציה ומיקום מודעה חדשים

נרשמים או מתחברים ל-DT Exchange Console.

לוחצים על הלחצן Add App (הוספת אפליקציה) כדי להוסיף את האפליקציה.

ניהול אפליקציות

בוחרים את הפלטפורמה, ממלאים את שאר הפרטים בטופס ולוחצים על Add Placements (הוספת מיקומי מודעות).

Android

iOS

מזינים שם למיקום המודעה החדש בשדה Name your Placement (שם מיקום המודעה) ובוחרים את Placement Type (סוג מיקום המודעה) הרצוי מהתפריט הנפתח. בסיום, לוחצים על Save Placement.

הגדרה

מזהה אפליקציה ומזהה מיקום מודעה

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

תפריט

בדף App Management, שימו לב למזהה האפליקציה לצד האפליקציה.

מזהה אפליקציה

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

המזהה של מיקום המודעה

מזהה בעל האתר, מפתח צרכן וסוד צרכן

בתפריט הימני, לוחצים על שם המשתמש ובוחרים באפשרות פרופיל משתמש.

תפריט פרופיל המשתמש

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

פרופיל משתמש

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

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

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

פועלים לפי השלבים המפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את DT Exchange‏ (מונטיזציה של Fyber) לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob.

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Google Mobile Ads DT Exchange Mediation ל-Unity בפרויקט שלכם על ידי הפעלת הפקודה הבאה מהספרייה ברמה הבסיסית של הפרויקט:

openupm add com.google.ads.mobile.mediation.dtexchange

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את Unity Package Manager Settings.

בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר ברמת ההיקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפים: com.google

פרטי OpenUPM

לאחר מכן, עוברים אל Window‏ > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.

Unity Registries

בוחרים את החבילה Google Mobile Ads DT Exchange Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-DT Exchange מהקישור להורדה שמופיע בChangelog, ומחלצים את הקובץ GoogleMobileAdsDTExchangeMediation.unitypackage מקובץ ה-zip.

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets‏ > Import Package‏ > Custom Package ומאתרים את הקובץ GoogleMobileAdsDTExchangeMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות Assets‏ > External Dependency Manager‏ > Android Resolver‏ > Force Resolve. הספרייה של External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות המוצגים לתיקייה Assets/Plugins/Android באפליקציה שלכם ב-Unity.

אילוץ פתרון

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

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

בקטע הזה מוסבר איך מפעילים או משביתים מודעות בהתאמה אישית ב-DT Exchange.

בפלאגין של Google Mobile Ads לתהליך בחירת הרשת בגרסה 1.1.0 של DT Exchange נוסף המחלקה Fyber עם השיטות SetGDPRRequired() ו-SetGDPRConsentString(), שמאפשר לך להעביר את פרטי ההסכמה ל-DT Exchange באופן ידני. דוגמת הקוד הבאה מראה איך מעבירים את הפרמטרים האלה למתאם DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

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

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

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

בפלאגין של Google Mobile Ads לתהליך בחירת הרשת בגרסה 3.1.1 של DT Exchange נוסף המחלקה Fyber עם השיטה SetCCPAString(), וכך מאפשרת להעביר את פרטי ההסכמה ל-DT Exchange באופן ידני. הקוד לדוגמה הבא מדגים איך להעביר את הפרמטרים האלה למתאם DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

למידע נוסף על הערכים שאפשר לספק בשיטה, אפשר לעיין במאמר CCPA Open Source של DT Exchange.

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

Android

אין צורך בקוד נוסף לשילוב עם DT Exchange.

iOS

שילוב עם SKAdNetwork

פועלים לפי המסמכים של DT Exchange כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.

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

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

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

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

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

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-DT Exchange, בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo בכיתה הבאה:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

אלו הקודים וההודעות הנלוות שמתאם DT Exchange שולח כשמודעה לא נטענת:

Android

קוד שגיאה סיבה
101 הפרמטרים של שרת ה-DT Exchange שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא חוקיים.
103 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-DT Exchange.
105 ה-SDK של DT Exchange טוען מודעה אבל מחזיר בקר לא צפוי.
106 המודעה לא מוכנה להצגה.
200-399 ה-SDK של DT Exchange החזיר שגיאה. אפשר לקרוא פרטים נוספים בקוד.

iOS

קוד שגיאה סיבה
0-10 ה-SDK של DT Exchange החזיר שגיאה. פרטים נוספים זמינים במסמכי התיעוד.
101 הפרמטרים של שרת DT Exchange שהוגדרו ב Ad Manager ממשק המשתמש חסרים/לא חוקיים.
102 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-DT Exchange.
103 הצגת המודעה נכשלה כי כבר נעשה שימוש באובייקט המודעה.
104 לא הצלחנו להציג מודעות DT Exchange כי המודעה לא מוכנה.
105 ‏DT Exchange SDK החזיר שגיאת הפעלה.

יומן השינויים של הפלאגין של DT Exchange לבחירת רשת ב-Unity

גרסה 3.3.3

גרסה 3.3.2

גרסה 3.3.1

גרסה 3.3.0

גרסה 3.2.1

גרסה 3.2.0

גרסה 3.1.12

גרסה 3.1.11

גרסה 3.1.10

גרסה 3.1.8

גרסה 3.1.7

גרסה 3.1.6

גרסה 3.1.5

גרסה 3.1.4

גרסה 3.1.3

גרסה 3.1.2

גרסה 3.1.1

גרסה 3.1.0

גרסה 3.0.2

גרסה 3.0.1

גרסה 3.0.0

גרסה 2.0.0

גרסה 1.6.1

גרסה 1.6.0

גרסה 1.5.2

גרסה 1.5.1

גרסה 1.5.0

גרסה 1.4.0

גרסה 1.3.0

גרסה 1.2.3

גרסה 1.2.2

גרסה 1.2.1

גרסה 1.2.0

גרסה 1.1.0

גרסה 1.0.0