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

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

Android

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

iOS

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

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

בהתאם למדיניות 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

גרסה 3.14.0

גרסה 3.13.2

גרסה 3.13.1

גרסה 3.13.0

גרסה 3.12.0

גרסה 3.11.4

גרסה 3.11.3

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