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

הפלטפורמה: Android iOS Unity Flutter

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

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

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

דרישות

  • הגרסה האחרונה של הפלאגין למודעות לנייד של Google ל-Unity
  • Unity 2019.4 ואילך
  • כדי לפרוס ב-Android
    • רמת API ‏23 ומעלה ב-Android
  • כדי לפרוס ב-iOS
    • יעד פריסה 12.0 ומעלה ב-iOS
  • פרויקט פעיל ב-Unity שהוגדר עם Google Mobile Ads Unity Plugin. פרטים נוספים מופיעים במאמר בנושא תחילת העבודה.
  • ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה

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

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

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

Android

לאחר מכן, מציינים את כתובת ה-URL של האפליקציה ב-Google Play.

iOS

לאחר מכן, מציינים את כתובת ה-URL של האפליקציה ב-iTunes**.

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

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

מעברון

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

ההטבה הופעלה

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

מותאם

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

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

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

עדכון של הקובץ app-ads.txt

‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

כדי להטמיע את app-ads.txt ב-myTarget, אפשר לעיין במאמר איך יוצרים ומפרסמים קובץ.

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

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

שלב 2: הגדרת הביקוש של myTarget בממשק המשתמש של AdMob

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

Android

הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.

iOS

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

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין את Google Mobile Ads myTarget Mediation Plugin for Unity בפרויקט שלכם על ידי הפעלת הפקודה הבאה מספריית הבסיס של הפרויקט:

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 (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המאגרים שלי) בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads MyTarget Mediation ולוחצים על Install (התקנה).

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה האחרונה של הפלאגין לגישור בין רשתות של מודעות לנייד של Google ל-myTarget מקישור ההורדה ביומן השינויים, ומחלצים את GoogleMobileAdsMyTargetMediation.unitypackage מקובץ ה-ZIP.

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

ייבוא מ-Unity

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

אילוץ פתרון

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

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

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

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

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

יומן השינויים של הפלאגין myTarget Unity Mediation

גרסה 3.32.0 (בפיתוח)

גרסה 3.31.0

גרסה 3.30.1

גרסה 3.30.0

גרסה 3.29.0

גרסה 3.28.0

גרסה 3.27.1

גרסה 3.27.0

גרסה 3.26.0

גרסה 3.25.0

גרסה 3.24.0

גרסה 3.23.0

גרסה 3.22.0

גרסה 3.21.1

גרסה 3.21.0

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

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

גרסה 2.3.2

  • תמיכה בגרסה 5.2.5.0 של מתאם myTarget ל-Android.
  • תמיכה בגרסה 4.8.9.0 של מתאם myTarget ל-iOS.

גרסה 2.3.1

  • תמיכה בגרסה 5.2.5.0 של מתאם myTarget ל-Android.
  • תמיכה בגרסה 4.8.5.0 של מתאם myTarget ל-iOS.

גרסה 2.3.0

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

גרסה 2.2.0

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

גרסה 2.1.2

  • תמיכה בגרסה 5.1.3.0 של מתאם myTarget ל-Android.
  • תמיכה בגרסה 4.7.11.0 של מתאם myTarget ל-iOS.

גרסה 2.1.1

  • תמיכה בגרסה 5.1.1.0 של מתאם myTarget ל-Android.
  • תמיכה בגרסה 4.7.10.0 של מתאם myTarget ל-iOS.

גרסה 2.1.0

  • תמיכה בגרסה 5.1.0 של myTarget Android SDK.
  • תמיכה בגרסה 4.7.9 של myTarget iOS SDK.
  • הוספנו את השיטות הבאות:
    • ‫MyTarget.SetUserConsent() method כדי להעביר את סטטוס ההסכמה של המשתמש ל-SDK של MyTarget.
    • ‫MyTarget.SetUserAgeRestricted שיטה שמגדירה דגל כדי לציין אם המשתמש משתייך לקטגוריה עם הגבלת גיל (כלומר, מתחת לגיל 16).
    • שיטה MyTarget.IsUserConsent() לקבלת סטטוס ההסכמה הנוכחי של המשתמש.
    • ‫MyTarget.IsUserAgeRestricted() method לקבלת הדגל שמציין שהמשתמש משתייך לקטגוריה עם הגבלת גיל (כלומר, מתחת לגיל 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.
  • תמיכה ב-myTarget iOS SDK בגרסה 4.7.6.

גרסה 1.0.0

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