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

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

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

המתאם של Unity לגישור ב-DT Exchange כולל את היכולות הבאות:

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

דרישות

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

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

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

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

לוחצים על הוספת אפליקציה.

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

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

Android

iOS

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

הגדרה

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

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

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

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

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

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

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

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

פרופיל משתמש

עדכון של קובץ app-ads.txt

Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

כדי להטמיע app-ads.txt ב-DT Exchange, מוסיפים את DT לקובץ app-ads.txt.

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

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

Android

הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין את Google Mobile Ads DT Exchange Mediation Plugin for 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 (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המאגרים שלי) בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads DTExchange Mediation ולוחצים על Install (התקנה).

התקנה מ-OpenUPM

חבילת Unity

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

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

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

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

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

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

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

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

בפלאגין של Google Mobile Ads לגישור ב-DT Exchange בגרסה 3.1.1 נוסף המחלקה 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

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

שלב 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 שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
103 גודל המודעה המבוקש לא תואם לגודל באנר שנתמך ב-DT Exchange.
105 ה-SDK של DT Exchange טען מודעה אבל החזיר בקר לא צפוי.
106 המודעה לא מוכנה להצגה.
107 ההקשר הוא לא מופע של פעילות.
200-399 ה-SDK של DT Exchange החזיר שגיאה. פרטים נוספים מופיעים בקוד.

iOS

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

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

גרסה 3.3.11

גרסה 3.3.10

גרסה 3.3.9

גרסה 3.3.8

גרסה 3.3.7

גרסה 3.3.6

גרסה 3.3.5

גרסה 3.3.4

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