במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-ironSource Ads תהליך בחירת הרשת (Mediation), שמכסה את ה-Waterfall בשילובים שונים. הוראות להוספת מודעות ironSource ההגדרה של תהליך בחירת הרשת (Mediation), ואיך לשלב את ironSource Ads SDK והמתאם לאפליקציה Unity .
השילובים והפורמטים של המודעות שנתמכים
למתאם תהליך בחירת הרשת של Ad Manager מודעות ironSource את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity 4 ומעלה
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פעיל שהוגדר ב-Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה
שלב 1: הגדרת ההגדרות בממשק המשתמש של ironSource Ads
נרשמים ונכנסים לחשבון ironSource Ads.
על מנת להוסיף את האפליקציה למרכז הבקרה של ironSource Ads, לוחצים על הלחצן New App.
הזנת פרטי האפליקציה
בוחרים באפשרות Live App, מזינים את כתובת ה-URL של האפליקציה ולוחצים על Import App Information (ייבוא פרטי אפליקציה).
אם האפליקציה לא זמינה, בוחרים באפשרות App Not Live in the Application Store ומציינים שם זמני לאפליקציה, ובוחרים את הפלטפורמה.
ממלאים את שאר הטופס ולוחצים על הוספת אפליקציה.
שימו לב למפתח האפליקציה החדש, שמוצג אחרי הוספת האפליקציה. הערך הזה נדרש כדי להגדיר אתAd Manager מזהה יחידת המודעות. בחרו את הפורמטים של המודעות שבאפליקציה שלכם תומכת בהם. לאחר מכן, לוחצים על המשך.
Android
iOS
יצירת מכונה
בשלב הבא, מגדירים מופע רשת לאפליקציה שהוספתם.
עוברים אל מודעות > הגדרה > מכונות. בוחרים את האפליקציה ולוחצים על Create Instance.
מזינים את הפרטים הנדרשים ולוחצים על שמירה וסגירה.
אחרי שיוצרים את המכונה, מזהה המכונה מופיע בשדה Instance ID.
איתור מפתח ה-Reporting API
בנוסף למפתח האפליקציה ולמזהה המכונה, תצטרכו גם את המפתח הסודי של מודעות ironSource ואסימון הרענון כדי להגדיר אתAd Manager מזהה יחידת המודעות.
מנווטים אל My Account בלוח הבקרה של ironSource Ads ולוחצים על הכרטיסייה API. רשמו לעצמכם את המפתח הסודי ואת אסימון הרענון.
הפעלת מצב בדיקה
בצעו את ההוראות שבמדריך בדיקות אינטגרציה של ironSource Ads כדי ללמוד איך להפעיל מודעות בדיקה של מודעות ironSource.
שלב 2: הגדרת הביקוש ב-ironSource Ads ב Ad Manager ממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה ironSource Mobile לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את ironSource Mobile לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש Ad Manager .
שלב 3: מייבאים את ironSource Ads SDK ואת המתאם
הורדת הגרסה העדכנית של הפלאגין של Google לבחירת רשת (Mediation) של Google Mobile Ads ל-ironSource
מודעות מהקישור להורדה
Changelog (יומן שינויים) ומחלצים את הקטע
GoogleMobileAdsIronSourceMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > (נכסים >) ייבוא חבילה > Custom (בהתאמה אישית)
חבילה ומוצאים את הקובץ GoogleMobileAdsIronSourceMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android > אילוץ
לפתרון הבעיה. ספריית Unity Play Services resolver תבצע תלות
מאפס ומעתיקים את יחסי התלות המוצהרים
הספרייה Assets/Plugins/Android
של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-ironSource Ads SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-ironSource Ads
גרסה 1.0.0
כוללת את
IronSource.SetConsent()
. הקוד לדוגמה הבא מראה איך להעביר
פרטי ההסכמה ל-ironSource Ads SDK. אם בוחרים לקרוא לזה
מומלץ לעשות זאת לפני שליחת הבקשה להצגת מודעות באמצעות
Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
ניתן לעיין במסמכים של ironSource Ads בכתובת הגדרות מתקדמות בנושא רגולציה אפשר לקבל פרטים נוספים.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות (States) צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ב-ironSource Ads
גרסה 2.2.4
כוללת את
IronSource.SetMetaData()
. הקוד לדוגמה הבא מראה איך להעביר
פרטי ההסכמה ל-ironSource Ads SDK. חובה להגדיר את האפשרויות האלה לפני
אתם מאתחלים את מודעות Google לנייד
SDK
כדי להבטיח שהן יועברו באופן תקין אל ironSource Ads SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
אפשר לעיין במסמכים של ironSource Ads בהגדרות המתקדמות של תקנות, ב-Android וגם iOS לקבלת פרטים נוספים ועל הערכים שניתן לספק בשיטה.
שלב 5: מוסיפים את הקוד הנדרש
Android
כללי ההגנה
אם אתם מבצעים כיווץ, ערפול קוד (obfuscation) של האפליקציה וביצוע אופטימיזציה, כדי להשתמש במודעות IronSource נדרשים כללים נוספים של ProGuard לפרויקט שלכם.
כשיוצרים את הפרויקט, בוחרים את Android בתור הפלטפורמה. לאחר מכן:
פותחים את הגדרות הנגן ומסמנים את התיבה User ProGuard File מתחת לכיתוב
הגדרות פרסום. Unity צריכה להראות היכן
נוצר קובץ proguard-user.txt
שניתן לשנות.
ייעוץ
מדריך לשילוב SDK ב-Android של IronSource Ads
לקבלת מידע נוסף על כללי ProGuard שנדרשים לפרויקט שלכם,
ומוסיפים את הכללים האלה לקובץ proguard-user.txt
.
iOS
שילוב של SKAdNetwork
פועלים לפי מסמכי התיעוד של ironSource Ads כדי להוסיף את המזהים של SKAdNetwork אל
של הפרויקט ב-Info.plist
.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- Ad Manager ולהפעיל את מצב הבדיקה ב ironSource ממשק המשתמש.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-ironSource, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות ironSource (Waterfall) מקורות המודעות.
קודי שגיאה
אם המתאם לא מקבל מודעה מ-ironSource Ads, בעלי התוכן הדיגיטלי יכולים לבדוק
לשגיאה הבסיסית מהתגובה באמצעות
ResponseInfo
מתחת לקטע
המחלקות הבאות:
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
אלו הקודים וההודעות הנלוות שמוצגות במודעות ironSource כשמודעה נכשלת להיטען:
Android
קוד שגיאה | סיבה |
---|---|
101 | הפרמטרים של השרת של ironSource Ads שהוגדרו ב Ad Manager ממשק המשתמש חסרים/לא חוקיים. |
102 | כדי להפעיל את ה-SDK של מודעות ironSource, צריך להוסיף הקשר לפעילות. |
103 | ב-ironSource Ads אפשר לטעון רק מודעה אחת לכל מזהה מופע של ironSource. |
105 | הגודל המבוקש של מודעת הבאנר לא נתמך על ידי ironSource Ads. |
106 | ironSource Ads SDK לא הופעל. |
501-1056 | שגיאות ב-SDK של ironSource Ads. לצפייה במסמכי התיעוד אפשר לקבל פרטים נוספים. |
iOS
קוד שגיאה | סיבה |
---|---|
101 | הפרמטרים של השרת של ironSource Ads שהוגדרו ב Ad Manager ממשק המשתמש חסרים/לא חוקיים. |
102 | מתאם המודעות ironSource לא תומך בפורמט המודעה המבוקש. |
103 | מודעת ironSource כבר נטענה עבור הגדרת הרשת הזו. |
104 | הגודל המבוקש של מודעת הבאנר לא נתמך על ידי ironSource Ads. |
508-1037 | שגיאות ב-SDK של ironSource Ads. לצפייה במסמכי התיעוד אפשר לקבל פרטים נוספים. |
יומן שינויים בפלאגין של IronSource Unity Mediation
גרסה 3.2.1
- השם של
DummyClient
השתנה. השם החדש הואPlaceholderClient
. - יש תמיכה במתאם ל-Android של IronSource בגרסה 8.2.1.0.
- יש תמיכה במתאם iOS של IronSource בגרסה 8.2.0.0.0.
- נוצר ונבדק באמצעות גרסה 9.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.2.0
- יש תמיכה במתאם ל-Android של IronSource בגרסה 8.2.0.0.
- יש תמיכה במתאם iOS של IronSource בגרסה 8.2.0.0.0.
- נוצר ונבדק באמצעות גרסה 9.1.1 של פלאגין Google Mobile Ads Unity.
גרסה 3.1.1
- יש תמיכה במתאם ל-Android של IronSource בגרסה 8.1.0.0.
- תומכת במתאם iOS של IronSource בגרסה 8.1.1.0.0.
- נוצר ונבדק באמצעות גרסה 9.1.1 של פלאגין Google Mobile Ads Unity.
גרסה 3.1.0
- יש תמיכה במתאם ל-Android של IronSource בגרסה 8.1.0.0.
- תומכת בגרסה 8.1.0.0.1 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.0.1
- יש תמיכה במתאם ל-Android של IronSource בגרסה 8.0.0.1.
- תומכת בגרסה 8.0.0.0.1 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.0.0
- יש תמיכה במתאם ל-Android של IronSource בגרסה 8.0.0.0.
- יש תמיכה במתאם iOS של IronSource בגרסה 8.0.0.0.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 2.6.1
- תומך במתאם ל-Android של IronSource בגרסה 7.9.0.0.
- תומכת בגרסה 7.9.1.0.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 2.6.0
- תומך במתאם ל-Android של IronSource בגרסה 7.9.0.0.
- תומכת בגרסה 7.9.0.0.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 2.5.0
- תומך במתאם ל-Android של IronSource בגרסה 7.6.0.0.
- תומכת בגרסה 7.6.0.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.4.0
- תומך במתאם ל-Android של IronSource בגרסה 7.5.2.0.
- תומכת בגרסה 7.5.1.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 8.6.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.3.1
- תומך במתאם ל-Android של IronSource בגרסה 7.3.1.0.
- תומכת בגרסה 7.3.1.0.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 8.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.3.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/IronSource/
. - מרחב השמות של המתאם עבר ארגון מחדש לשימוש ב-
GoogleMobileAds.Mediation.IronSource
. - תומך במתאם ל-Android של IronSource בגרסה 7.3.0.1.0.
- תומכת בגרסה 7.3.0.0.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.7
- תומך במתאם ל-Android של IronSource בגרסה 7.2.7.0.
- תומכת בגרסה 7.2.7.0.1 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 7.4.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.6
- תומך במתאם ל-Android של IronSource בגרסה 7.2.6.0.
- תומכת בגרסה 7.2.6.0.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 7.3.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.5
- תומך במתאם ל-Android של IronSource בגרסה 7.2.5.0.
- תומכת בגרסה 7.2.5.1.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 7.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.4
- השיטה
IronSource.SetMetaData(string, string)
נוספה. - תומך במתאם ל-Android של IronSource בגרסה 7.2.3.1.0.
- תומכת בגרסה 7.2.4.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 7.2.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.3
- תומך במתאם ל-Android של IronSource בגרסה 7.2.3.1.0.
- תומכת בגרסה 7.2.3.1.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 7.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.2
- תומך במתאם ל-Android של IronSource בגרסה 7.2.2.1.0.
- תומכת בגרסה 7.2.2.1.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.1
- תומך במתאם ל-Android של IronSource בגרסה 7.2.1.1.0.
- תומכת בגרסה 7.2.1.2.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.2.0
- תומך במתאם ל-Android של IronSource בגרסה 7.2.1.0.
- תומכת בגרסה 7.2.1.0 של מתאם iOS של IronSource.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 2.1.5
גרסה 2.1.4
גרסה 2.1.3
גרסה 2.1.2
- תומך במתאם ל-Android של IronSource בגרסה 7.1.11.1.0.
- תומכת בגרסה 7.1.11.1.0 של מתאם iOS של IronSource.
גרסה 2.1.1
גרסה 2.1.0
גרסה 2.0.3
גרסה 2.0.2
גרסה 2.0.1
גרסה 2.0.0
- יש תמיכה במתאם ל-Android של IronSource בגרסה 7.0.0.0.
- תומכת בגרסה 7.0.0.0 של מתאם iOS של IronSource.
גרסה 1.10.0
- יש תמיכה במתאם ל-Android של IronSource בגרסה 6.18.0.0.
- תומכת בגרסה 6.18.0.0 של מתאם iOS של IronSource.
גרסה 1.9.1
- יש תמיכה במתאם ל-Android של IronSource בגרסה 6.17.0.1.
- תומכת בגרסה 6.17.0.1.0 של מתאם iOS של IronSource.
גרסה 1.9.0
- יש תמיכה במתאם ל-Android של IronSource בגרסה 6.17.0.0.
- תומכת בגרסה 6.16.3.0 של מתאם iOS של IronSource.
גרסה 1.8.2
גרסה 1.8.1
גרסה 1.8.0
- יש תמיכה במתאם ל-Android של IronSource בגרסה 6.16.0.0.
- תומכת בגרסה 6.16.0.0 של מתאם iOS של IronSource.
גרסה 1.7.0
- תומך במתאם ל-Android של IronSource בגרסה 6.15.0.1.0.
- תומכת בגרסה 6.15.0.1.0 של מתאם iOS של IronSource.
גרסה 1.6.0
- תומך במתאם ל-Android של IronSource בגרסה 6.14.0.1.0.
- תומכת בגרסה 6.14.0.0 של מתאם iOS של IronSource.
גרסה 1.5.0
- תומך במתאם ל-Android של IronSource בגרסה 6.13.0.1.0.
- תומכת בגרסה 6.13.1.0.0 של מתאם iOS של IronSource.
גרסה 1.4.0
- יש תמיכה במתאם ל-Android של IronSource בגרסה 6.12.0.0.
- תומכת בגרסה 6.12.0.0 של מתאם iOS של IronSource.
גרסה 1.3.2
- יש תמיכה במתאם ל-Android של IronSource בגרסה 6.10.0.0.
- תומכת בגרסה 6.8.7.0 של מתאם iOS של IronSource.
גרסה 1.3.1
- תומך במתאם IronSource ל-Android בגרסה 6.10.0.0
- תומך במתאם iOS של IronSource בגרסה 6.8.6.0
גרסה 1.3.0
- תומך במתאם IronSource ל-Android בגרסה 6.10.0.0
- תמיכה במתאם iOS של IronSource בגרסה 6.8.4.1.0
גרסה 1.2.0
- תומך בגרסה 6.9.0.1 של מתאם IronSource ל-Android
- תמיכה במתאם iOS של IronSource בגרסה 6.8.4.1.0
גרסה 1.1.2
- תומך בגרסה 6.8.4.1 של מתאם IronSource ל-Android
- תמיכה במתאם iOS של IronSource בגרסה 6.8.4.1
גרסה 1.1.1
- תומך בגרסה 6.8.4.1 של מתאם IronSource ל-Android
- יש תמיכה במתאם iOS של IronSource בגרסה 6.8.3.0
גרסה 1.1.0
- הפלאגין עודכן כך שיתמוך בממשק ה-API החדש של גרסת הבטא הפתוחה.
- תומך בגרסה 6.8.1.2 של מתאם IronSource ל-Android
- תמיכה במתאם iOS של IronSource בגרסה 6.8.0.1
גרסה 1.0.4
- תומך במתאם IronSource ל-Android בגרסה 6.7.11.0
- תמיכה במתאם iOS של IronSource בגרסה 6.7.11.0
גרסה 1.0.3
- תומך במתאם IronSource ל-Android בגרסה 6.7.10.0
- תומך במתאם iOS של IronSource בגרסה 6.7.10.0
גרסה 1.0.2
- תומך בגרסה 6.7.9.1.1 של מתאם IronSource ל-Android
- תומך במתאם iOS של IronSource בגרסה 6.7.10.0
- תוקנה התנגשות עם הפלאגין לתהליך בחירת הרשת ב-Chartboost Unity.
גרסה 1.0.1
- תומך בגרסה 6.7.9.0 של מתאם IronSource ל-Android.
- יש תמיכה בגרסה 6.7.9.2.0 של מתאם iOS ל-IronSource.
גרסה 1.0.0
- גרסה ראשונה!
- תומך בגרסה 6.7.9.0 של מתאם IronSource ל-Android.
- יש תמיכה בגרסה 6.7.9.1.0 של מתאם iOS ל-IronSource.