במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-myTarget באמצעות תהליך בחירת הרשת (Mediation), שכוללות שילובים של Waterfall. במאמר הזה מוסבר איך להוסיף את היעד myTarget להגדרת תהליך בחירת הרשת, ואיך לשלב את myTarget SDK והמתאם אפליקציית Unity.
השילובים והפורמטים של המודעות שנתמכים
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
דרישות
- Unity 4 ומעלה
- ה-SDK העדכני של Google Mobile Ads
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: קביעת ההגדרות בממשק המשתמש myTarget
תחילה, נרשמים או מתחברים לחשבון myTarget. מנווטים לדף Apps על ידי לחיצה על APPS בכותרת. כדי להוסיף את האפליקציה, לוחצים על הוספת אפליקציה.
אם האפליקציה תומכת גם בפלטפורמות Android וגם בפלטפורמות iOS, עליך להגדיר כל אחת מהן בנפרד.
Android
לאחר מכן, ספק את כתובת האתר של Google Play עבור האפליקציה שלך.
iOS
לאחר מכן, עליך לספק את כתובת ה-URL של iTunes** של האפליקציה.
כשמוסיפים אפליקציה, האפשרות myTarget מחייבת אתכם ליצור יחידת מודעות לפני שתוכלו להשלים את התהליך.
כדי לפתוח את דף הפרטים של האפליקציה.כרזה
בוחרים באפשרות BANNER מתוך הפורמטים הזמינים של המודעות, ואז לוחצים על הלחצן ADD UNIT.
פרסומת מרווח ביניים
בוחרים באפשרות INTERSTIAL מתוך הפורמטים הזמינים של המודעות, ולוחצים על הלחצן ADD UNIT.
ההטבה הופעלה
בוחרים באפשרות סרטון מתגמל מתוך הפורמטים הזמינים של המודעות ולוחצים על הלחצן הוספה של יחידת מודעות.
מותאם
בוחרים באפשרות NATIVE מתוך הפורמטים הזמינים של המודעות, ולוחצים על ADD UNIT.
בדף הפרטים של יחידת המודעות, רושמים או זוכרים את מזהה המיקום. המזהה מופיע מתחת להגדרות של יחידת המודעות בתור slot_id. מזהה המיקום ישמש להגדרת יחידת המודעות AdMob בקטע הבא.
בנוסף ל-slot_id, תצטרכו גם את אסימון הגישה הקבוע ל-myTarget כדי להגדיר את המזהה של יחידת המודעות ב-AdMob. עוברים לכרטיסייה Profile (פרופיל) ובוחרים באפשרות Access Tokens. לוחצים על Create Token או על Show Token על מנת להציג את Permanent Access Token מ-myTarget.
הפעלת מצב בדיקה
פועלים לפי ההוראות במסמכי התיעוד של myTarget כדי להוסיף ולהגדיר מכשיר בדיקה בממשק המשתמש myTarget.
שלב 2: הגדרת הביקוש ליעד שלי AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Mail.ru לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Mail.ru לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK והמתאם של myTarget
הורדת הגרסה האחרונה של הפלאגין לתהליך בחירת הרשת (Mediation) של Google Ads לנייד עבור myTarget
מקישור ההורדה
Changelog (יומן שינויים) ומחלצים את הקטע
GoogleMobileAdsMyTargetMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה > Custom (בהתאמה אישית)
Package ומוצאים את קובץ GoogleMobileAdsMyTargetMediation.unitypackage
שאתם
ההורדה הושלמה. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android > אילוץ
לפתרון הבעיה. ספריית Unity Play Services resolver תבצע תלות
מאפס ומעתיקים את יחסי התלות המוצהרים
הספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: הטמעה של הגדרות הפרטיות ב-myTarget SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) בגרסה 2.1.0 כולל את myTarget
SetUserConsent()
ו-SetUserAgeRestricted()
. הדוגמה הבאה
קוד שמראה איך להעביר את פרטי ההסכמה של המשתמשים ל-myTarget SDK. אם
לקרוא לשיטה הזו, מומלץ לעשות זאת לפני
מודעות באמצעות Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
אם ידוע שהמשתמש נמצא בקטגוריה של הגבלת גיל, אפשר גם לקרוא
אמצעי תשלום אחד (SetUserAgeRestricted()
).
MyTarget.SetUserAgeRestricted(true);
הצגת מדריך בנושא פרטיות ו-GDPR אפשר לקבל מידע נוסף.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) בגרסה 3.13.3 כולל myTarget
אמצעי תשלום אחד (SetCCPAUserConsent(bool)
). הקוד לדוגמה הבא מראה איך להעביר
הסכמת המשתמשים ל-myTarget SDK. אם בוחרים לקרוא לשיטה הזו,
מומלץ לעשות זאת לפני שאתם מבקשים מודעות דרך
Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetCCPAUserConsent(true);
יש לפנות לתמיכה של myTarget כדי מידע נוסף.
שלב 5: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב myTarget.
iOS
שילוב של SKAdNetwork
צריך לפעול לפי המסמכים של myTarget
כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב myTarget ממשק המשתמש.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-myTarget, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות myTarget (Waterfall) מקורות המודעות.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-myTarget, בעלי התוכן הדיגיטלי יכולים לבדוק את
לשגיאה בסיסית מהתגובה באמצעות מודעה באמצעות
ResponseInfo
מתחת לקטע
המחלקות הבאות:
Android
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
אלו הקודים וההודעות שנלוות למתאם myTarget כשמודעה נכשלת להיטען:
Android
קוד שגיאה | סיבה |
---|---|
100 | myTarget SDK החזירה שגיאה. |
101 | הפרמטרים של שרת myTarget שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים. |
102 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-myTarget. |
103 | הבקשה להצגת מודעה היא לא בקשה מאוחדת להצגת מודעה מותאמת. |
104 | המודעה המותאמת שנטענה מ-myTarget שונה מהמודעה המותאמת המבוקשת. |
105 | במודעה המותאמת שנטענה מ-myTarget חסרים נכסים נדרשים (כמו תמונה או סמל). |
iOS
קוד שגיאה | סיבה |
---|---|
100 | ל-myTarget SDK עדיין אין מודעה זמינה. |
101 | הפרמטרים של שרת myTarget שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים. |
102 | מתאם myTarget אינו תומך בפורמט המודעה המבוקש. |
103 | ניסיתי להציג מודעת myTarget שלא נטענה. |
104 | גודל המודעה המבוקש אינו תואם לגודל באנר הנתמך ב-myTarget. |
105 | חסרים נכסים נדרשים של מודעות מותאמות. |
יומן שינויים בפלאגין myTarget Unity Mediation
גרסה 3.18.0
- השם של
DummyClient
השתנה. השם החדש הואPlaceholderClient
. - יש תמיכה במתאם myTarget ל-Android גרסה 5.22.1.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.21.6.0.
- נוצר ונבדק באמצעות גרסה 9.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.17.1
- יש תמיכה במתאם myTarget ל-Android גרסה 5.21.1.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.21.5.0.
- נוצר ונבדק באמצעות גרסה 9.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.17.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.21.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.21.4.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.16.2
- יש תמיכה במתאם myTarget ל-Android גרסה 5.20.1.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.21.2.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.16.1
- יש תמיכה במתאם myTarget ל-Android גרסה 5.20.1.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.21.1.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 3.16.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.20.0.0.
- יש תמיכה בגרסה 5.21.0.1 של מתאם iOS myTarget.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 3.15.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.20.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.20.1.0.
- נוצר ונבדק באמצעות גרסה 8.7.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.14.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.18.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.19.0.0.
- נוצר ונבדק באמצעות גרסה 8.5.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.13.2
- יש תמיכה במתאם myTarget ל-Android גרסה 5.16.5.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.17.5.0.
- נוצר ונבדק באמצעות גרסה 8.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.13.1
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/MyTarget/
. - מרחב השמות של המתאם עבר ארגון מחדש לשימוש ב-
GoogleMobileAds.Mediation.MyTarget
. - יש תמיכה במתאם myTarget ל-Android גרסה 5.16.4.1.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.17.4.0.
- נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.13.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.16.4.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.17.4.0.
- נוצר ונבדק באמצעות גרסה 8.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.12.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.15.5.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.16.0.0.
- נוצר ונבדק באמצעות גרסה 7.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.11.4
- יש תמיכה במתאם myTarget ל-Android גרסה 5.15.4.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.15.2.0.
- נוצר ונבדק באמצעות גרסה 7.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.11.3
- שם השיטה
IsConsent()
שונה מהמחלקהMyTarget
ל-GetUserConsent()
. - נוספו למחלקה
MyTarget
את השיטות הבאות:SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- יש תמיכה במתאם myTarget ל-Android גרסה 5.15.3.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.15.2.0.
- נוצר ונבדק באמצעות גרסה 7.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.11.2
- יש תמיכה בגרסה 5.15.2.1 של מתאם Android ל-myTarget.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.15.2.0.
- נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.11.1
- יש תמיכה במתאם myTarget ל-Android גרסה 5.15.1.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.15.1.0.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.11.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.15.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.15.0.1.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.10.2
- יש תמיכה במתאם myTarget ל-Android גרסה 5.14.4.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.14.4.0.
גרסה 3.10.1
- יש תמיכה במתאם myTarget ל-Android גרסה 5.14.3.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.14.2.0.
גרסה 3.10.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.14.2.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.14.1.0.
גרסה 3.9.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.13.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.11.2.0.
גרסה 3.8.2
- יש תמיכה במתאם myTarget ל-Android גרסה 5.11.7.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.9.10.0.
גרסה 3.8.1
- יש תמיכה במתאם myTarget ל-Android גרסה 5.11.5.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.9.6.0.
גרסה 3.8.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.11.4.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.9.5.0.
גרסה 3.7.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.10.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.7.5.0.
גרסה 3.6.1
- השם של השיטה
MyTarget.IsUserConsent()
שונה ל-MyTarget.IsConsent()
. - יש תמיכה במתאם myTarget ל-Android גרסה 5.9.1.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.7.2.0.
גרסה 3.6.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.9.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.7.0.0.
גרסה 3.5.2
- יש תמיכה במתאם myTarget ל-Android גרסה 5.8.3.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.6.3.0.
גרסה 3.5.1
- יש תמיכה במתאם myTarget ל-Android גרסה 5.8.2.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.6.1.0.
גרסה 3.5.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.8.1.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.6.0.0.
גרסה 3.4.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.8.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.5.2.0.
גרסה 3.3.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.7.0.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.5.1.0.
גרסה 3.2.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.6.3.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.4.9.0.
גרסה 3.1.0
- יש תמיכה במתאם myTarget ל-Android גרסה 5.4.6.0.
- יש תמיכה ב-myTarget iOS מתאם גרסה 5.3.3.0.
גרסה 3.0.0
- הפלאגין עודכן כך שיתמוך בממשק ה-API החדש של גרסת הבטא הפתוחה.
- תומך בגרסה 5.3.9.0 של מתאם myTarget ל-Android.
- יש תמיכה בגרסה 5.0.4.0 של מתאם iOS מסוג myTarget ל-iOS.
גרסה 2.3.2
- יש תמיכה בגרסה 5.2.5.0 של מתאם myTarget ל-Android.
- יש תמיכה בגרסה 4.8.9.0 של מתאם iOS מסוג myTarget ל-iOS.
גרסה 2.3.1
- יש תמיכה בגרסה 5.2.5.0 של מתאם myTarget ל-Android.
- יש תמיכה בגרסה 4.8.5.0 של מתאם iOS מסוג myTarget ל-iOS.
גרסה 2.3.0
- יש תמיכה בגרסה 5.2.2.0 של מתאם myTarget ל-Android.
- יש תמיכה בגרסה 4.8.0.0 של מתאם iOS מסוג myTarget ל-iOS.
גרסה 2.2.0
- יש תמיכה בגרסה 5.1.4.0 של מתאם myTarget ל-Android.
- יש תמיכה בגרסה 4.8.0.0 של מתאם iOS מסוג myTarget ל-iOS.
גרסה 2.1.2
- יש תמיכה בגרסה 5.1.3.0 של מתאם myTarget ל-Android.
- יש תמיכה בגרסה 4.7.11.0 של מתאם iOS מסוג myTarget ל-iOS.
גרסה 2.1.1
- יש תמיכה בגרסה 5.1.1.0 של מתאם myTarget ל-Android.
- יש תמיכה בגרסה 4.7.10.0 של מתאם iOS מסוג myTarget ל-iOS.
גרסה 2.1.0
- יש תמיכה בגרסה 5.1.0 של myTarget Android SDK.
- יש תמיכה בגרסה 4.7.9 של myTarget iOS SDK.
- הוספנו את השיטות הבאות:
- שיטה
MyTarget.SetUserConsent()
להעברת סטטוס ההסכמה של המשתמש ל-MyTarget SDK. - שיטה
MyTarget.SetUserAgeRestricted
שמגדירה דגל כדי לציין אם ידוע שהמשתמש נמצא בקטגוריה הגבלת גיל (כלומר, מתחת לגיל 16). - שיטה אחת (
MyTarget.IsUserConsent()
) לקבלת סטטוס ההסכמה הנוכחי של המשתמש. MyTarget.IsUserAgeRestricted()
כדי לקבל את הדגל שמציין שהמשתמש ידוע בקטגוריה שחלה עליו הגבלת גיל (כלומר, מתחת לגיל 16).
- שיטה
גרסה 2.0.1
- יש תמיכה בגרסה 5.0.2 של myTarget Android SDK.
- יש תמיכה בגרסה 4.7.8 של myTarget iOS SDK.
גרסה 2.0.0
- יש תמיכה בגרסה 5.0.0 של myTarget Android SDK.
- יש תמיכה בגרסה 4.7.7 של myTarget iOS SDK.
גרסה 1.1.0
- יש תמיכה בגרסה 4.7.2 של myTarget Android SDK.
- יש תמיכה בגרסה 4.7.6 של myTarget iOS SDK.
גרסה 1.0.0
- גרסה ראשונה!
- יש תמיכה בגרסה 4.6.27 של myTarget Android SDK.
- יש תמיכה בגרסה 4.6.24 של myTarget iOS SDK.