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

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות בחירת רשת, כולל שילובים של רשתות מודעות לפי סדר עדיפות. במאמר מוסבר איך להוסיף את 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.

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

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

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

Android

iOS

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

הגדרה

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

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

תפריט

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

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

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

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

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

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

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

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

פרופיל משתמש

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

הגדרת הגדרות בחירת הרשת ליחידת המודעות

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.

בכרטיסייה 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

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

  • שינינו את השם של הפלאגין של Unity לבחירת רשת להמרה (Mediation) ל-'DT Exchange'.
  • השם של המחלקה GoogleMobileAds.Api.Mediation.Fyber.Fyber השתנה ל-GoogleMobileAds.Api.Mediation.DTExchange.DTExchange.
  • תמיכה במתאם DT Exchange ל-Android בגרסה 8.2.1.0.
  • תמיכה במתאם DT Exchange ל-iOS בגרסה 8.1.7.0.
  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Unity בגרסה 7.3.1.

גרסה 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