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