במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-DT Exchange באמצעות תהליך בחירת הרשת (Mediation), שכולל מידע על שילובים ב-Waterfall. נסביר איך להוסיף את DT Exchange להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של DT Exchange באפליקציה של Unity.
שילובים נתמכים ופורמטים נתמכים של מודעות
מתאם הגישור של DT Exchange AdMob כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה |
דרישות
- Unity 4 ואילך
- ה-SDK העדכני של מודעות Google לנייד
- כדי לפרוס ב-Android
- Android API ברמת 19 ואילך
- כדי לפרוס ב-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) ביחידת המודעות
הוספה של Fyber לרשימת שותפי הפרסום של תקנות GDPR ותקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Fyber לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK והמתאם של DT Exchange
הורד את הגרסה האחרונה של הפלאגין של Google Mobile Ads לגישור עבור DT Exchange דרך קישור ההורדה ב-Changelog וחלץ את GoogleMobileAdsFyberMediation.unitypackage
מקובץ ה-zip.
בעורך הפרויקטים ב-Unity, לוחצים על Assets > Import Package > Custom
Package (נכסים > ייבוא חבילה > חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsFyberMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.
לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force
resolve. ספריית Unity Play Services Solutionr תבצע פתרון בעיות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-DT Exchange SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.
בקטע הזה נסביר איך להפעיל או להשבית מודעות בהתאמה אישית ב-DT Exchange.
בפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads בגרסה 1.1.0, נוספו המחלקה Fyber
עם השיטות SetGDPRRequired()
ו-SetGDPRConsentString()
,
כך אפשר להעביר את פרטי ההסכמה ל-DT Exchange באופן ידני. הקוד לדוגמה הבא מדגים איך להעביר את הפרמטרים האלה למתאם DT Exchange:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
למידע נוסף ולערכים שאפשר לספק בשיטה, תוכלו לעיין במאמר בנושא GDPR של DT Exchange.
חוקי הפרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-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 של 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 | 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
גרסה 3.1.8
- יש תמיכה במתאם DT Exchange ל-Android בגרסה 8.2.5.0.
- יש תמיכה במתאם DT Exchange ל-iOS בגרסה 8.2.6.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.6.0.
גרסה 3.1.7
- יש תמיכה במתאם DT Exchange ל-Android בגרסה 8.2.4.0.
- יש תמיכה במתאם DT Exchange ל-iOS בגרסה 8.2.4.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.5.2 נוצרה ונבדקה.
גרסה 3.1.6
- יש תמיכה במתאם DT Exchange ל-Android בגרסה 8.2.3.0.
- יש תמיכה במתאם DT Exchange ל-iOS בגרסה 8.2.3.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.4.1 נוצרה ונבדקה.
גרסה 3.1.5
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/DTExchange/
. - מרחב השמות של המתאם שהוגדר מחדש לצורך שימוש ב-
GoogleMobileAds.Mediation.DTExchange
. - יש תמיכה במתאם DT Exchange ל-Android בגרסה 8.2.3.0.
- יש תמיכה במתאם DT Exchange ל-iOS בגרסה 8.2.1.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.1.0 נוצרה ונבדקה.
גרסה 3.1.4
- יש תמיכה במתאם DT Exchange ל-Android בגרסה 8.2.2.0.
- יש תמיכה במתאם DT Exchange ל-iOS בגרסה 8.1.9.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.1.
גרסה 3.1.3
- יש תמיכה במתאם DT Exchange ל-Android בגרסה 8.2.1.0.
- יש תמיכה במתאם DT Exchange ל-iOS בגרסה 8.1.9.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.0.
גרסה 3.1.2
- שם הפלאגין של תהליך בחירת הרשת (Mediation) ב-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.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.1.
גרסה 3.1.1
- נוספו למחלקה
Fyber
את השיטות הבאות:SetCCPAString(string)
ClearCCPAString()
- יש תמיכה במתאם Android של Fyber בגרסה 8.2.0.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 8.1.6.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.0.
גרסה 3.1.0
- יש תמיכה במתאם Android של Fyber בגרסה 8.2.0.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 8.1.5.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.2.0.
גרסה 3.0.2
- יש תמיכה במתאם Android של Fyber בגרסה 8.1.3.1.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 8.1.5.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.2.
גרסה 3.0.1
- יש תמיכה במתאם Android של Fyber בגרסה 8.1.3.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 8.1.4.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 3.0.0
- יש תמיכה במתאם Android של Fyber בגרסה 8.1.2.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 8.1.2.0.
גרסה 2.0.0
- יש תמיכה במתאם Android של Fyber בגרסה 7.8.4.1.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 8.0.0.0.
גרסה 1.6.1
- יש תמיכה במתאם Android של Fyber בגרסה 7.8.3.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.8.6.0.
גרסה 1.6.0
- יש תמיכה במתאם Android של Fyber בגרסה 7.8.2.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.8.5.0.
גרסה 1.5.2
- יש תמיכה במתאם Fyber Android בגרסה 7.7.4.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.7.3.0.
גרסה 1.5.1
- יש תמיכה במתאם Android של Fyber בגרסה 7.7.2.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.7.2.0.
גרסה 1.5.0
- יש תמיכה במתאם Android של Fyber בגרסה 7.7.1.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.7.1.0.
גרסה 1.4.0
- יש תמיכה במתאם Android של Fyber בגרסה 7.7.0.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.6.4.0.
גרסה 1.3.0
- יש תמיכה במתאם Android של Fyber בגרסה 7.6.0.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.6.0.0.
גרסה 1.2.3
- יש תמיכה במתאם Android של Fyber בגרסה 7.5.4.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.5.6.0.
גרסה 1.2.2
- יש תמיכה במתאם Android של Fyber בגרסה 7.5.3.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.5.4.0.
גרסה 1.2.1
- יש תמיכה במתאם Android של Fyber בגרסה 7.5.2.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.5.3.0.
גרסה 1.2.0
- יש תמיכה במתאם Android של Fyber בגרסה 7.5.0.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.5.1.0.
גרסה 1.1.0
- הוספנו את השיטות הבאות למחלקה
Fyber
כדי לתמוך בדרישות GDPR:SetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- יש תמיכה במתאם Android של Fyber בגרסה 7.3.4.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.5.0.0.
גרסה 1.0.0
- השקה ראשונה!
- יש תמיכה במתאם Android של Fyber בגרסה 7.3.4.0.
- יש תמיכה במתאם Fyber ל-iOS בגרסה 7.4.0.0.