במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של Waterfall. במאמר הזה מוסבר איך להוסיף DT Exchange הגדרת הגישור ואיך לשלב את 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. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: קביעת ההגדרות בממשק המשתמש של DT Exchange
Add new app and ad placement
Sign up or log in to DT Exchange Console.
Click on the Add App button to add your app.
Select your Platform, fill out the rest of the form, and click Add Placements.
Android
iOS
Enter a name for the new placement in the field labeled Name your Placement and select your desired Placement Type from the dropdown list. Finally, click Save Placement.
App ID and Placement ID
Open the left navigation bar by hovering your mouse over it. Then click Apps from the left menu.
On the App Management page, take note of the App ID next to your app.
Select your app, navigate to the Placements tab, and click on the copy icon next to Placement Name. Take note of the Placement ID.
Publisher ID, Consumer Key and Consumer Secret
Click on your username from the left menu and select User Profile.
Take note of the Publisher ID, Consumer Key, and Consumer Secret as these are needed in the next step.
שלב 2: הגדרת ביקוש ב-DT Exchange AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Fyber לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Fyber לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-DT Exchange SDK והמתאם
הורדת הגרסה האחרונה של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) עבור DT
החלפה דרך קישור ההורדה
יומן שינויים וחילוץ
GoogleMobileAdsFyberMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה > Custom (בהתאמה אישית)
Package ומוצאים את קובץ GoogleMobileAdsFyberMediation.unitypackage
שאתם
ההורדה הושלמה. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android > אילוץ
לפתרון הבעיה. ספריית Unity Play Services resolver תבצע תלות
ומעתיקים את יחסי התלות המוצהרים
הספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-DT Exchange SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
בקטע הזה מוסבר איך מפעילים או משביתים מודעות בהתאמה אישית ב-DT Exchange.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) עבור DT Exchange בגרסה 1.1.0 הוסיף את
כיתה Fyber
עם השיטות SetGDPRRequired()
ו-SetGDPRConsentString()
,
מאפשרת להעביר את פרטי ההסכמה ל-DT Exchange באופן ידני. הבאים
קוד לדוגמה שמדגים איך להעביר את הפרמטרים האלה אל DT Exchange.
מתאם:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
כניסה ל-DT Exchange GDPR כדי לקבל מידע נוסף על הערכים שניתן לספק בשיטה.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) עבור 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 של 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 שהוגדרו ב 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
הגרסה הבאה
- השם של
DummyClient
השתנה. השם החדש הואPlaceholderClient
.
גרסה 3.2.1
- תומך במתאם DT Exchange ל-Android בגרסה 8.2.7.0.
- תמיכה במתאם DT Exchange ל-iOS בגרסה 8.3.1.0.
- נוצר ונבדק באמצעות גרסה 9.1.1 של פלאגין Google Mobile Ads Unity.
גרסה 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 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.0.1
- תומך במתאם ל-Android של Fyber בגרסה 8.1.3.0.
- תומכת במתאם iOS של Fyber בגרסה 8.1.4.0.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 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
- הוספנו את השיטות הבאות למחלקה
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.