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

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-myTarget באמצעות תהליך בחירת הרשת (Mediation), כולל שילובים של 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 דורשת ליצור יחידת מודעות כדי שתוכלו להשלים את התהליך.

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

מעברון

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

ההטבה הופעלה

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

מותאם

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

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

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

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

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

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

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

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

iOS

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

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Google Mobile Ads myTarget לתהליך בחירת הרשת (Mediation) ב-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

בוחרים בחבילה 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 שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על Import.

ייבוא מ-Unity

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

אילוץ פתרון

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

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

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

הפלאגין של 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: בדיקה מעשית של ההטמעה

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

חשוב לרשום את מכשיר הבדיקה ב-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 שהוגדרו 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 Unity Mediation

גרסה 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.
  • יש תמיכה בגרסה 5.0.4.0 של מתאם iOS מסוג myTarget ל-iOS.

גרסה 2.3.2

  • תמיכה במתאם myTarget ל-Android בגרסה 5.2.5.0.
  • יש תמיכה בגרסה 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

  • התמיכה במתאם myTarget ל-Android היא בגרסה 5.2.2.0.
  • יש תמיכה בגרסה 4.8.0.0 של מתאם iOS מסוג myTarget ל-iOS.

גרסה

  • התמיכה במתאם myTarget ל-Android היא בגרסה 5.1.4.0.
  • יש תמיכה בגרסה 4.8.0.0 של מתאם iOS מסוג myTarget ל-iOS.

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

  • הגרסה הראשונה!
  • יש תמיכה בגרסה 4.6.27 של myTarget Android SDK.
  • תמיכה ב-myTarget iOS SDK בגרסה 4.6.24.