במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-myTarget באמצעות תהליך בחירת הרשת (Mediation), שמכסה שילובים של Waterfall. נסביר איך להוסיף את myTarget להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של myTarget באפליקציית Unity.
שילובים נתמכים ופורמטים נתמכים של מודעות
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה | |
מודעת מעברון מתגמלת |
דרישות
- Unity 4 ואילך
- ה-SDK העדכני של מודעות Google לנייד
- כדי לפרוס ב-Android
- Android API ברמת 19 ואילך
- כדי לפרוס ב-iOS
- יעד הפריסה של iOS הוא 12.0 ומעלה
- פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלם את הפרטים של תהליך בחירת הרשת. מדריך לתחילת העבודה
שלב 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: הגדרת myTargetDemand ב AdMob ממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של Mail.ru לרשימת שותפי הפרסום של תקנות GDPR ותקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Mail.ru לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK ואת המתאם myTarget
צריך להוריד את הגרסה האחרונה של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור myTarget מהקישור להורדה ב-Changelog ולחלץ את GoogleMobileAdsMyTargetMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקטים ב-Unity, לוחצים על Assets > Import Package > Custom
Package (נכסים > ייבוא חבילה > חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsMyTargetMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על ייבוא.
לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force
resolve. ספריית Unity Play Services Solutionr תבצע פתרון בעיות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-myTarget SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.
הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads לגרסה 2.1.0 כולל את השיטות SetUserConsent()
ו-SetUserAgeRestricted()
. הקוד לדוגמה הבא מראה איך להעביר מידע על הסכמת משתמשים ל-myTarget SDK. אם תבחרו לקרוא לשיטה הזו, מומלץ לעשות זאת לפני שתבקשו מודעות דרך Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
אם ידוע שהמשתמש נמצא בקטגוריית הגבלת גיל, אפשר גם לקרוא ל-method SetUserAgeRestricted()
.
MyTarget.SetUserAgeRestricted(true);
למידע נוסף, אפשר לעיין במדריך פרטיות ו-GDPR של myTarget.
חוקי הפרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.
הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads לגרסה 3.13.3 כולל את השיטה SetCCPAUserConsent(bool)
. הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה של המשתמשים ל-myTarget SDK. אם תבחרו לקרוא לשיטה הזו, מומלץ לעשות זאת לפני שתבקשו מודעות דרך Google 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 | ערכת ה-SDK של myTarget החזירה שגיאה. |
101 | הפרמטרים של שרת myTarget שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים. |
102 | גודל המודעה המבוקש אינו תואם לגודל מודעת באנר נתמך של myTarget. |
103 | בקשה להצגת מודעה אינה בקשה מאוחדת להצגת מודעה מותאמת. |
104 | המודעה המותאמת שנטענה מ-myTarget שונה מהמודעה המותאמת המבוקשת. |
105 | במודעה המותאמת שנטענה מ-myTarget חסרים כמה נכסים נדרשים (למשל, תמונה או סמל). |
iOS
קוד שגיאה | סיבה |
---|---|
100 | ב-myTarget SDK עדיין אין מודעה זמינה. |
101 | הפרמטרים של שרת myTarget שהוגדרו AdMob בממשק המשתמש חסרים/לא חוקיים. |
102 | מתאם myTarget Adapter לא תומך בפורמט המודעה המבוקש. |
103 | ניסית להציג מודעת myTarget שלא נטענה. |
104 | גודל המודעה המבוקש אינו תואם לגודל מודעת באנר נתמך של myTarget. |
105 | חסרים נכסים נדרשים של מודעות מותאמות. |
יומן שינויים של פלאגין תהליך בחירת הרשת של myTarget Unity
גרסה 3.15.0
- תומך במתאם Android מסוג myTarget בגרסה 5.20.0.0.
- תומך במתאם iOS myTarget בגרסה 5.20.1.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.7.0.
גרסה 3.14.0
- תומך במתאם Android מסוג myTarget בגרסה 5.18.0.0.
- תומך במתאם iOS מסוג myTarget iOS 5.19.0.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.5.0 נוצרה ונבדקה.
גרסה 3.13.2
- תומך במתאם Android מסוג myTarget בגרסה 5.16.5.0.
- תומך במתאם iOS מסוג myTarget iOS 5.17.5.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 8.3.0.
גרסה 3.13.1
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/MyTarget/
. - מרחב השמות של המתאם שהוגדר מחדש לצורך שימוש ב-
GoogleMobileAds.Mediation.MyTarget
. - תומך במתאם Android מסוג myTarget בגרסה 5.16.4.1.
- תומך במתאם iOS שלי יעד גרסה 5.17.4.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.1.0 נוצרה ונבדקה.
גרסה 3.13.0
- תומך במתאם Android מסוג myTarget בגרסה 5.16.4.0.
- תומך במתאם iOS שלי יעד גרסה 5.17.4.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.0.0 נוצרה ונבדקה.
גרסה 3.12.0
- תומך במתאם Android מסוג myTarget בגרסה 5.15.5.0.
- תומכת במתאם iOS מסוג myTarget iOS 5.16.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.0.
גרסה 3.11.4
- תומך במתאם Android מסוג myTarget בגרסה 5.15.4.0.
- תומך במתאם iOS מסוג myTarget iOS 5.15.2.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.2.0.
גרסה 3.11.3
- שינית את שם השיטה
IsConsent()
מהמחלקהMyTarget
ל-GetUserConsent()
. - נוספו למחלקה
MyTarget
את השיטות הבאות:SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- תומך במתאם Android מסוג myTarget בגרסה 5.15.3.0.
- תומך במתאם iOS מסוג myTarget iOS 5.15.2.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.2.0.
גרסה 3.11.2
- תומך במתאם Android מסוג myTarget בגרסה 5.15.2.1.
- תומך במתאם iOS מסוג myTarget iOS 5.15.2.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.2.
גרסה 3.11.1
- תומך במתאם Android מסוג myTarget בגרסה 5.15.1.0.
- תומך במתאם iOS מסוג myTarget iOS 5.15.1.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 3.11.0
- תומך במתאם Android מסוג myTarget בגרסה 5.15.0.0.
- תומך במתאם iOS מסוג myTarget iOS 5.15.0.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 3.10.2
גרסה 3.10.1
גרסה 3.10.0
גרסה 3.9.0
גרסה 3.8.2
גרסה 3.8.1
גרסה 3.8.0
גרסה 3.7.0
גרסה 3.6.1
- שינית את שם השיטה
MyTarget.IsUserConsent()
ל-MyTarget.IsConsent()
. - תומך במתאם Android מסוג myTarget בגרסה 5.9.1.0.
- תומכת במתאם iOS מסוג myTarget iOS 5.7.2.0.
גרסה 3.6.0
גרסה 3.5.2
גרסה 3.5.1
גרסה 3.5.0
גרסה 3.4.0
גרסה 3.3.0
גרסה 3.2.0
גרסה 3.1.0
גרסה 3.0.0
- הפלאגין עודכן ועכשיו הוא יתמוך ב-API החדש של תוכנית הבטא הפתוחה.
- תמיכה במתאם myTarget Android בגרסה 5.3.9.0.
- תומך במתאם myTarget iOS בגרסה 5.0.4.0.
גרסה 2.3.2
- תומך במתאם myTarget Android בגרסה 5.2.5.0.
- תמיכה במתאם myTarget iOS בגרסה 4.8.9.0.
גרסה 2.3.1
- תומך במתאם myTarget Android בגרסה 5.2.5.0.
- תומך במתאם myTarget iOS בגרסה 4.8.5.0.
גרסה
- תומך במתאם myTarget Android בגרסה 5.2.2.0.
- תומך במתאם myTarget iOS בגרסה 4.8.0.0.
גרסה
- תמיכה במתאם myTarget Android בגרסה 5.1.4.0.
- תומך במתאם myTarget iOS בגרסה 4.8.0.0.
גרסה 2.1.2
- תומך במתאם myTarget Android בגרסה 5.1.3.0.
- תומך במתאם myTarget iOS בגרסה 4.7.11.0.
גרסה 2.1.1
- תמיכה במתאם myTarget Android בגרסה 5.1.1.0.
- תומך במתאם myTarget iOS בגרסה 4.7.10.0.
גרסה
- תמיכה ב-myTarget Android SDK בגרסה 5.1.0.
- תומך ב-myTarget iOS SDK בגרסה 4.7.9.
- נוספו השיטות הבאות:
MyTarget.SetUserConsent()
להעברת סטטוס ההסכמה של המשתמש ל-MyTarget SDK.- שיטה
MyTarget.SetUserAgeRestricted
שמגדירה סימון כדי לציין אם ידוע שהמשתמש נמצא בקטגוריה שחלה עליו הגבלת גיל (כלומר, מתחת לגיל 16). MyTarget.IsUserConsent()
כדי לקבל את סטטוס ההסכמה הנוכחי של המשתמש.MyTarget.IsUserAgeRestricted()
כדי לקבל את הדגל שמציין שהמשתמש ידוע כמשתייך לקטגוריה מוגבלת גיל (כלומר, מתחת לגיל 16).
גרסה 2.0.1
- תומך ב-myTarget Android SDK בגרסה 5.0.2.
- תומך ב-myTarget iOS SDK בגרסה 4.7.8.
גרסה
- תומך ב-myTarget Android SDK בגרסה 5.0.0.
- תומך ב-myTarget iOS SDK בגרסה 4.7.7.
גרסה 1.1.0
- תומך ב-myTarget Android SDK בגרסה 4.7.2.
- תומך ב-myTarget iOS SDK בגרסה 4.7.6.
גרסה 1.0.0
- השקה ראשונה!
- תומך ב-myTarget Android SDK בגרסה 4.6.27.
- תומך ב-myTarget iOS SDK בגרסה 4.6.24.