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

במדריך הזה מוסבר איך משתמשים ב-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) ביחידת המודעות

Android

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

iOS

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

הוספה 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

בכפוף להסכמת משתמשים של 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

הגרסה הבאה

  • השם של DummyClient השתנה. השם החדש הוא PlaceholderClient.

גרסה 3.17.0

גרסה 3.16.2

גרסה 3.16.1

גרסה 3.16.0

גרסה 3.15.0

גרסה 3.14.0

גרסה 3.13.2

גרסה 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

גרסה 3.12.0

גרסה 3.11.4

גרסה 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

גרסה 3.11.1

גרסה 3.11.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

גרסה 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 החדש של גרסת הבטא הפתוחה.
  • תומך בגרסה 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.