במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-ironSource Ads באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של Waterfall. במאמר מוסבר איך מוסיפים מודעות ironSource Ads להגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של ironSource Ads באפליקציה Unity .
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם תהליך בחירת הרשת עבור ironSource Ads כולל את היכולות הבאות:
שילוב | ||
---|---|---|
בידינג | 1 | |
מפל | ||
פורמטים | ||
כרזה | 2 | |
פרסומת מרווח ביניים | ||
ההטבה הופעלה | ||
מודעות מעברון מתגמלות | 2 |
1 השילוב של הבידינג נמצא בגרסת בטא סגורה, צריך לפנות למנהל החשבון ולבקש גישה.
2 הפורמט הזה נתמך רק בשילוב עם Waterfall.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity מגרסה 4 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 12.0 ואילך
- פרויקט Unity פועל שהוגדר באמצעות Google Mobile Ads SDK. למידע נוסף, ראו תחילת העבודה.
- מבצעים את ההוראות שבמדריך לתחילת העבודה.
שלב 1: הגדרת ההגדרות בממשק המשתמש של ironSource Ads
נרשמים ונכנסים לחשבון ironSource Ads.
על מנת להוסיף את האפליקציה למרכז הבקרה של ironSource Ads, לוחצים על הלחצן New App.
הזנת פרטי האפליקציה
בוחרים באפשרות Live App, מזינים את כתובת ה-URL של האפליקציה ולוחצים על Import App Information (ייבוא פרטי אפליקציה).
אם האפליקציה לא זמינה, בוחרים באפשרות App Not Live in the Application Store ומציינים שם זמני לאפליקציה, ובוחרים את הפלטפורמה.
ממלאים את שאר הטופס ולוחצים על הוספת אפליקציה.
שימו לב למפתח האפליקציה החדש, שמוצג אחרי הוספת האפליקציה. הערך הזה נדרש כדי להגדיר אתAdMob מזהה יחידת המודעות. בחרו את הפורמטים של המודעות שבאפליקציה שלכם תומכת בהם. לאחר מכן, לוחצים על המשך.
Android
iOS
יצירת מכונה
בשלב הבא, מגדירים מופע רשת לאפליקציה שהוספתם.
בידינג
עוברים אל LevelPlay > Setup > SDK Networks ובוחרים את האפליקציה. בקטע Bidding לוחצים על סמל העריכה כדי להציג את מזהה המופע של הבידינג.
Android
iOS
חשוב לשים לב למזהה המכונה.
Android
iOS
מפל
עוברים אל מודעות > הגדרה > מכונות. בוחרים את האפליקציה ולוחצים על Create Instance.
מזינים את הפרטים הנדרשים ולוחצים על שמירה וסגירה.
אחרי שיוצרים את המכונה, מזהה המכונה מופיע בשדה Instance ID.
איתור מפתח ה-Reporting API
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
בנוסף למפתח האפליקציה ולמזהה המכונה, תצטרכו גם את המפתח הסודי של מודעות ironSource ואסימון הרענון כדי להגדיר אתAdMob מזהה יחידת המודעות.
מנווטים אל My Account בלוח הבקרה של ironSource Ads ולוחצים על הכרטיסייה API. רשמו לעצמכם את המפתח הסודי ואת אסימון הרענון.
הפעלת מצב בדיקה
בצעו את ההוראות שבמדריך בדיקות אינטגרציה של ironSource Ads כדי ללמוד איך להפעיל מודעות בדיקה של מודעות ironSource.
שלב 2: הגדרת הביקוש ב-ironSource Ads ב AdMob ממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה ironSource Mobile לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את ironSource Mobile לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ironSource Ads SDK ואת המתאם
מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור ironSource
Ads מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsIronSourceMediation.unitypackage
מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package > Custom
Package (חבילה בהתאמה אישית) ומוצאים את הקובץ GoogleMobileAdsIronSourceMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.
לאחר מכן, בוחרים נכסים > Play Services Resolutionr > Android resolver > אילוץ פתרון. ספריית Unity Play Services Resolutionr תפתור את יחסי התלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android
באפליקציה ל-Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-ironSource Ads SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם חייבים לוודא שהודעות גילוי נאות מסוימות נשלחות למשתמשים באזור הכלכלי האירופי (EEA) ושהסכמתם לקבל מהם הסכמה בנוגע לשימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שיכולה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב הזה, Google לא יכולה להעביר לרשתות כאלה באופן אוטומטי את הבחירות של המשתמשים בנושא פרטיות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור ironSource Ads
גרסה 1.0.0
כולל את
IronSource.SetConsent()
. הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה ל-ironSource Ads SDK. אם תבחרו לקרוא ל-method הזה, מומלץ לעשות זאת לפני שמבקשים מודעות דרך Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
פרטים נוספים זמינים במאמרי העזרה של ironSource Ads בקטע Regulation Advanced Settings.
חוקי פרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב מחייבים לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה). אפשרות ביטול ההסכמה מוצעת בקישור בולט בדף הבית של הצד המוכר. המדריך לציות לחוקי הפרטיות במדינות בארה"ב מאפשר להפעיל עיבוד נתונים מוגבל לצורך הצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.
הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור ironSource Ads
גרסה 2.2.4
כולל את
IronSource.SetMetaData()
. הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה ל-ironSource Ads SDK. צריך להגדיר את האפשרויות האלה לפני שמאתחלים את ה-SDK של Google Mobile Ads כדי להבטיח שהן יועברו כראוי ל-ironSource Ads SDK.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
בחומרי העזר של ironSource Ads בנושא ההגדרות המתקדמות של תקנה ל-Android וגם ל-iOS, אפשר לקבל פרטים נוספים על הערכים שניתן לספק בשיטה.
שלב 5: מוסיפים את הקוד הנדרש
Android
כללי ההגנה
אם מבצעים כיווץ, ערפול קוד (obfuscation) של האפליקציה ומבצעים אופטימיזציה, כדי להשתמש ב-IronSource Ads נדרשים כללים נוספים של ProGuard בפרויקט.
כשיוצרים את הפרויקט, בוחרים באפשרות Android בתור הפלטפורמה. לאחר מכן, פותחים את Player Settings (הגדרות הנגן) ובודקים את האפשרות User ProGuard File בכרטיסייה Publishing Settings (הגדרות פרסום). קוד ה-Unity אמור להראות את המקום שבו נוצר קובץ proguard-user.txt
בהתאמה אישית, שאותו תוכלו לשנות.
כדי להבין אילו כללי ProGuard נדרשים בפרויקט שלכם, ולהוסיף את הכללים האלה לקובץ proguard-user.txt
תוכלו לעיין במדריך לשילוב SDK של Android ב-IronSource Ads.
iOS
שילוב של SKAdNetwork
פועלים לפי מסמכי התיעוד של ironSource Ads כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist
של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב 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 שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
102 | כדי להפעיל את ה-SDK של מודעות ironSource, צריך להוסיף הקשר לפעילות. |
103 | ב-ironSource Ads אפשר לטעון רק מודעה אחת לכל מזהה מופע של ironSource. |
105 | הגודל המבוקש של מודעת הבאנר לא נתמך על ידי ironSource Ads. |
106 | ironSource Ads SDK לא הופעל. |
501-1056 | שגיאות ב-SDK של ironSource Ads. אפשר לקרוא פרטים נוספים במסמכי העזרה. |
iOS
קוד שגיאה | הסיבה |
---|---|
101 | הפרמטרים של שרת ironSource Ads שהוגדרו ב AdMob ממשק המשתמש חסרים/לא חוקיים. |
102 | מתאם המודעות ironSource לא תומך בפורמט המודעה המבוקש. |
103 | מודעת ironSource כבר נטענה עבור הגדרת הרשת הזו. |
104 | הגודל המבוקש של מודעת הבאנר לא נתמך על ידי ironSource Ads. |
508-1037 | שגיאות ב-SDK של ironSource Ads. אפשר לקרוא פרטים נוספים במסמכי העזרה. |
יומן שינויים בפלאגין של IronSource Unity Mediation
גרסה 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 של פלאגין Google Mobile Ads Unity.
גרסה 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.