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

הערה: Fyber Marketplace נקרא עכשיו DT Exchange.

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

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

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

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

דרישות

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

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

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

הרשמה או התחברות ל-DT Exchange Console

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

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

Android

iOS

נותנים שם למיקום החדש בשדה בחירת שם למיקום ובוחרים את סוג המיקום הרצוי מהרשימה הנפתחת. בסיום לוחצים על Save Placement.

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

חשוב: צריך לוודא שיש לכם הרשאה לניהול החשבון כדי להשלים את ההגדרה של הסכמה באיחוד האירופי ו-GDPR, CPRA ו-User Messaging Platform. למידע נוסף, ראו ניהול הגישה של משתמשים לחשבון.

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

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

הערה: אי-שילוב בין הגרסאות התואמות של DT Exchange ו-Google Mobile Ads SDK עלול לגרום לבעיות ב-build.

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

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

לאחר מכן, בוחרים נכסים > Play Services Resolutionr > Android resolver > אילוץ פתרון. ספריית Unity Play Services Resolutionr תפתור את יחסי התלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android באפליקציה ל-Unity.

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

הסכמה באיחוד האירופי ו-GDPR

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

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

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

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

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

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

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

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

בפלאגין של 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

חשוב: צריך להשבית את מצב הבדיקה עבור AdMob וגם DT Exchange לפני פרסום האפליקציה.

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

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

iOS

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

יומן שינויים בפלאגין של DT Exchange Unity Mediation

גרסה 3.2.0

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.7.0.
• תמיכה במתאם DT Exchange ל-iOS בגרסה 8.3.0.0.
• נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.12

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.7.0.
• תמיכה במתאם DT Exchange ל-iOS בגרסה 8.2.8.0.
• נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.11

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.7.0.
• תומך במתאם DT Exchange ל-iOS בגרסה 8.2.7.0.
• נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.10

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.6.1.
• תומך במתאם DT Exchange ל-iOS בגרסה 8.2.7.0.
• נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.

גרסה 3.1.8

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.5.0.
• תומך במתאם DT Exchange ל-iOS בגרסה 8.2.6.0.
• נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.7

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.4.0.
• תמיכה במתאם DT Exchange ל-iOS בגרסה 8.2.4.0.
• נוצר ונבדק באמצעות גרסה 8.5.2 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.6

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.3.0.
• תומך במתאם DT Exchange ל-iOS בגרסה 8.2.3.0.
• נוצר ונבדק באמצעות גרסה 8.4.1 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.5

• תוכן המתאם הועבר אל GoogleMobileAds/Mediation/DTExchange/.
• מרחב השמות של המתאם עבר ארגון מחדש לשימוש ב-GoogleMobileAds.Mediation.DTExchange.
• תומך במתאם DT Exchange ל-Android בגרסה 8.2.3.0.
• תמיכה במתאם DT Exchange ל-iOS בגרסה 8.2.1.0.
• נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.4

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.2.0.
• תמיכה במתאם DT Exchange ל-iOS בגרסה 8.1.9.1.
• נוצר ונבדק באמצעות גרסה 7.4.1 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.3

• תומך במתאם DT Exchange ל-Android בגרסה 8.2.1.0.
• תמיכה במתאם DT Exchange ל-iOS בגרסה 8.1.9.0.
• נוצר ונבדק באמצעות גרסה 7.4.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.2

• שם הפלאגין של תהליך בחירת הרשת ב-Unity ממותג מחדש ל-"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.
• נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.1

• נוספו למחלקה Fyber את השיטות הבאות:
  • SetCCPAString(string)
  • ClearCCPAString()
• תומך במתאם ל-Android של Fyber בגרסה 8.2.0.0.
• תומך במתאם iOS של Fyber בגרסה 8.1.6.0.
• נוצר ונבדק באמצעות גרסה 7.3.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.1.0

• תומך במתאם ל-Android של Fyber בגרסה 8.2.0.0.
• תמיכה במתאם iOS של Fyber בגרסה 8.1.5.0.
• נוצר ונבדק באמצעות גרסה 7.2.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.0.2

• תומך במתאם ל-Android של Fyber בגרסה 8.1.3.1.
• תמיכה במתאם iOS של Fyber בגרסה 8.1.5.0.
• נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Google Mobile Ads Unity.

גרסה 3.0.1

• תומך במתאם ל-Android של Fyber בגרסה 8.1.3.0.
• תומכת במתאם iOS של Fyber בגרסה 8.1.4.0.
• נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.

גרסה 3.0.0

• תומך במתאם ל-Android של Fyber בגרסה 8.1.2.0.
• תמיכה במתאם iOS של Fyber בגרסה 8.1.2.0.

גרסה 2.0.0

• תומך במתאם ל-Android של Fyber בגרסה 7.8.4.1.
• תומכת במתאם iOS של Fyber בגרסה 8.0.0.0.

גרסה 1.6.1

• תומך במתאם ל-Android של Fyber בגרסה 7.8.3.0.
• תומך בגרסה 7.8.6.0 של מתאם iOS של Fyber.

גרסה 1.6.0

• תומך במתאם ל-Android של Fyber בגרסה 7.8.2.0.
• תומך בגרסה 7.8.5.0 של מתאם iOS של Fyber.

גרסה 1.5.2

• תומך במתאם ל-Android של Fyber בגרסה 7.7.4.0.
• תומך בגרסה 7.7.3.0 של מתאם iOS של Fyber.

גרסה 1.5.1

• תומך במתאם ל-Android של Fyber בגרסה 7.7.2.0.
• תומך בגרסה 7.7.2.0 של מתאם iOS של Fyber.

גרסה 1.5.0

• תומך במתאם ל-Android של Fyber בגרסה 7.7.1.0.
• תומך בגרסה 7.7.1.0 של מתאם iOS של Fyber.

גרסה 1.4.0

• תומך במתאם ל-Android של Fyber בגרסה 7.7.0.0.
• תומך בגרסה 7.6.4.0 של מתאם iOS של Fyber.

גרסה 1.3.0

• תומך במתאם ל-Android של Fyber בגרסה 7.6.0.0.
• תומך בגרסה 7.6.0.0 של מתאם iOS של Fyber.

גרסה 1.2.3

• תומך במתאם ל-Android של Fyber בגרסה 7.5.4.0.
• תומך במתאם iOS של Fyber בגרסה 7.5.6.0.

גרסה 1.2.2

• תומך במתאם ל-Android של Fyber בגרסה 7.5.3.0.
• תומכת במתאם iOS של Fyber בגרסה 7.5.4.0.

גרסה 1.2.1

• תומך במתאם ל-Android של Fyber בגרסה 7.5.2.0.
• תמיכה במתאם iOS של Fyber בגרסה 7.5.3.0.

גרסה 1.2.0

• תומך במתאם ל-Android של Fyber בגרסה 7.5.0.0.
• תמיכה במתאם iOS של Fyber בגרסה 7.5.1.0.

גרסה 1.1.0

• הוספנו את השיטות הבאות למחלקה Fyber כדי לתמוך בדרישות GDPR:
  • SetGDPRConsent()
  • SetGDPRConsentString()
  • ClearGDPRConsentData()
• תומך במתאם ל-Android של Fyber בגרסה 7.3.4.0.
• תומכת במתאם iOS של Fyber בגרסה 7.5.0.0.

גרסה 1.0.0

• גרסה ראשונה!
• תומך במתאם ל-Android של Fyber בגרסה 7.3.4.0.
• תומך בגרסה 7.4.0.0 של מתאם iOS של Fyber.