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

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

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

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

דרישות

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

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

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

אם האפליקציה שלכם תומכת בפלטפורמות 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. עוברים לכרטיסייה פרופיל ובוחרים באפשרות 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 Mobile Ads mediation ל-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) מקבלים גילוי נאות בנושאים מסוימים ומביעים הסכמה לשימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשור הגישור שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש שנעשה בכל רשת. בשלב הזה, Google לא יכולה להעביר באופן אוטומטי לרשתות כאלה את בחירת ההסכמה של המשתמש.

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

חוקי הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (בהתאם להגדרה המעוגנת בחוק זה). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אל תמכרו את המידע האישי שלי". במדריך בנושא עמידה בדרישות של חוקי הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל להצגת מודעות של 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: בדיקת ההטמעה

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

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

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

גרסה 1.0.0

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