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

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-myTarget באמצעות תהליך בחירת הרשת, כולל שילובים של רשתות מודעות ב-Waterfall. במאמר מוסבר איך להוסיף את myTarget להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK ואת המתאם של myTarget באפליקציה של Unity.

השילובים והפורמטים של המודעות הנתמכים

שילוב
בידינג
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות

דרישות

  • Unity 4 ואילך
  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • כדי לפרוס ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Unity פעיל שהוגדרה בו ה-Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
  • מדריך לתחילת העבודה בנושא בחירת הרשת

שלב 1: הגדרת ההגדרות בממשק המשתמש של myTarget

קודם כול, נרשמים או נכנסים לחשבון myTarget. עוברים לדף Apps (אפליקציות) בלחיצה על APPS (אפליקציות) בכותרת. לוחצים על הוספת אפליקציה כדי להוסיף את האפליקציה.

אם האפליקציה תומכת גם בפלטפורמת Android וגם בפלטפורמת iOS, צריך להגדיר כל אחת מהן בנפרד.

Android

בשלב הבא, עליכם לספק את כתובת ה-URL של האפליקציה ב-Google Play.

iOS

בשלב הבא, עליכם לספק את כתובת ה-URL של האפליקציה ב-iTunes**.

כשמוסיפים אפליקציה, מערכת myTarget דורשת ליצור יחידת מודעות כדי שתוכלו להשלים את התהליך.

.

בוחרים באפשרות BANNER (באנר) מבין פורמטים המודעות הזמינים, ואז לוחצים על הלחצן ADD AD UNIT (הוספת יחידת מודעות).

מעברון

בוחרים באפשרות מודעת מעברון מבין פורמטים המודעות הזמינים, ואז לוחצים על הלחצן הוספת יחידת מודעות.

ההטבה הופעלה

בוחרים באפשרות מודעת וידאו מתגמלת מבין פורמטים המודעות הזמינים, ואז לוחצים על הלחצן הוספת יחידת מודעות.

מותאם

בוחרים באפשרות מודעה מותאמת מבין פורמטים המודעות הזמינים, ואז לוחצים על הוספת יחידת מודעות.

בדף הפרטים של יחידת המודעות, מציינים את מזהה המיקום. המזהה מופיע כ-slot_id בהגדרות של יחידת המודעות. מזהה המיקום הזה ישמש להגדרת יחידת המודעות ב-Ad Manager בקטע הבא.

בנוסף ל-slot_id, תצטרכו גם את אסימון הגישה הקבוע ב-myTarget כדי להגדיר את מזהה יחידת המודעות ב-AdMob. עוברים לכרטיסייה Profile ובוחרים באפשרות Access Tokens. לוחצים על Create Token (יצירת אסימון) או על Show Token (הצגת אסימון) כדי להציג את אסימון הגישה הקבוע של myTarget.

הפעלת מצב בדיקה

פועלים לפי ההוראות המפורטות במסמכי התיעוד של myTarget כדי להוסיף מכשיר בדיקה ולהגדיר אותו בממשק המשתמש של myTarget.

שלב 2: הגדרת הביקוש מ-myTarget בממשק המשתמש Ad Manager

הגדרת הגדרות בחירת הרשת ליחידת המודעות

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.

iOS

להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.

הוספה של Mail.ru לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב

פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Mail.ru לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של Ad Manager.

שלב 3: מייבאים את ה-SDK ואת המתאם של myTarget

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של myTarget לתהליך בחירת הרשת (Mediation) של Google Mobile Ads ל-Unity בפרויקט שלכם. לשם כך, מריצים את הפקודה הבאה מהספרייה ברמה הבסיסית (root) של הפרויקט:

openupm add com.google.ads.mobile.mediation.mytarget

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.

בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר ברמת ההיקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפים: com.google

פרטי OpenUPM

לאחר מכן, עוברים אל Window‏ > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads myTarget Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-myTarget מהקישור להורדה בChangelog ומחלצים את הקובץ GoogleMobileAdsMyTargetMediation.unitypackage מקובץ ה-zip.

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets‏ > Import Package‏ > Custom Package ומאתרים את הקובץ GoogleMobileAdsMyTargetMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי התלות החיצוניים > Android Resolver > Force Resolve. הספרייה של External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות המוצגים לתיקייה Assets/Plugins/Android באפליקציה שלכם ב-Unity.

אילוץ פתרון

שלב 4: הטמעת הגדרות הפרטיות ב-SDK של myTarget

בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם צריכים לוודא שהמשתמשים באזור הכלכלי האירופי (EEA) מקבלים גילויים נאותים מסוימים לגבי השימוש במזהי מכשירים ובמידע אישי, ומאשרים את השימוש הזה. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת פרסום בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, Google לא יכולה להעביר את הבחירה של המשתמש בנושא הסכמה לרשתות כאלה באופן אוטומטי.

הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-myTarget בגרסה 2.1.0 כולל את השיטות SetUserConsent() ו-SetUserAgeRestricted(). בדוגמת הקוד הבאה מוסבר איך מעבירים את פרטי ההסכמה של המשתמשים ל-myTarget SDK. אם בוחרים להפעיל את השיטה הזו, מומלץ לעשות זאת לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

אם ידוע שהמשתמש נמצא בקטגוריה עם הגבלת גיל, אפשר גם להפעיל את השיטה SetUserAgeRestricted().

MyTarget.SetUserAgeRestricted(true);

מידע נוסף זמין במדריך של myTarget בנושא פרטיות ו-GDPR.

חוקי פרטיות במדינות בארה"ב

חוקי הפרטיות במדינות ארה"ב מחייבים לתת למשתמשים את הזכות לבטל את ההסכמה למכירת 'המידע האישי' שלהם (בהתאם להגדרה המעוגנת בחוק). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך להפעיל עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.

הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-myTarget בגרסה 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: בדיקה מעשית של ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-Ad Manager ולהפעיל את מצב הבדיקה בממשק המשתמש של 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 שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
102 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-myTarget.
103 הבקשה להצגת מודעה היא לא בקשה להצגת מודעה מותאמת מאוחדת.
104 המודעה המותאמת שנטענת מ-myTarget שונה מהמודעה המותאמת המבוקשת.
105 במודעה המותאמת שנטענה מ-myTarget חסרים נכסים נדרשים (למשל, תמונה או סמל).

iOS

קוד שגיאה סיבה
100 עדיין אין מודעה זמינה ב-myTarget SDK.
101 פרמטרי השרת של myTarget שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא תקינים.
102 מתאם myTarget לא תומך בפורמט המודעה המבוקש.
103 נעשתה ניסיון להציג מודעה של myTarget שלא נטענה.
104 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-myTarget.
105 חסרים נכסים נדרשים של מודעות מותאמות.

יומן השינויים של הפלאגין של myTarget לבחירת רשת (Mediation) ב-Unity

גרסה 3.20.0

גרסה 3.19.0

גרסה 3.18.2

גרסה 3.18.1

גרסה 3.18.0

גרסה 3.17.1

גרסה 3.17.0

גרסה 3.16.2

גרסה 3.16.1

גרסה 3.16.0

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

  • עדכנו את הפלאגין כך שיתמוך ב-Rewarded 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.

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

גרסה 2.0.0

  • תמיכה ב-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.