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

הגדרה

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

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

תפריט

בדף ניהול אפליקציות, בודקים מהו מזהה האפליקציה שלצד האפליקציה.

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

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

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

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

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

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

שימו לב ל-Publisher ID, לאסימון צרכן ולסוד צרכן, כי כל אלה נחוצים בשלב הבא.

פרופיל משתמש

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

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

Android

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

iOS

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

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

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

שלב 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 עבור DT Exchange מהקישור להורדה ביומן שינויים ומחלצים את GoogleMobileAdsDTExchangeMediation.unitypackage מקובץ ה-ZIP.

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי תלות חיצוני > Android היעדים > אילוץ פתרון. הספרייה של 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 אירעה שגיאה ב-DT Exchange SDK. פרטים נוספים זמינים במאמר קוד.

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.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