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

במדריך הזה מוסבר איך להשתמש ב-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) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

הוספה של 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

בהתאם למדיניות 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 בהתאמה אישית שתוכלו לשנות.

קובץ ProGuard של Unity User

תוכלו לעיין במדריך השילוב של 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

גרסה 2.6.1

גרסה 2.6.0

גרסה 2.5.0

גרסה 2.4.0

גרסה 2.3.1

גרסה 2.3.0

גרסה 2.2.7

גרסה 2.2.6

גרסה 2.2.5

גרסה 2.2.4

גרסה 2.2.3

גרסה 2.2.2

גרסה 2.2.1

גרסה 2.2.0

גרסה 2.1.5

גרסה 2.1.4

גרסה 2.1.3

גרסה 2.1.2

גרסה 2.1.1

גרסה 2.1.0

גרסה 2.0.3

גרסה 2.0.2

גרסה 2.0.1

גרסה 2.0.0

גרסה 1.10.0

גרסה 1.9.1

גרסה 1.9.0

גרסה 1.8.2

גרסה 1.8.1

גרסה 1.8.0

גרסה 1.7.0

גרסה 1.6.0

גרסה 1.5.0

גרסה 1.4.0

גרסה 1.3.2

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