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

במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-ironSource Ads תהליך בחירת הרשת (Mediation), שמכסה את ה-Waterfall בשילובים שונים. הוראות להוספת מודעות ironSource ההגדרה של תהליך בחירת הרשת (Mediation), ואיך לשלב את ironSource Ads SDK והמתאם לאפליקציה Unity .

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

למתאם תהליך בחירת הרשת של AdMob מודעות ironSource את היכולות הבאות:

שילוב
בידינג  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. צפייה פרטים נוספים זמינים כאן.
  • השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

שלב 1: הגדרת ההגדרות בממשק המשתמש של ironSource Ads

Sign up and sign in to your ironSource Ads account.

To add your application to the ironSource Ads dashboard, click the New App button.

Enter app details

Select Live App, enter the URL of your app, and click Import App Info.

If your app is not available, select App Not Live in the Application Store and provide a Temporary Name for your app. Select your platform.

Fill out the rest of the form and click Add App.

Take note of your new App Key, which is displayed after the app has been added. You will need this value for setting up your AdMob ad unit ID. Select the ad formats your app supports. Then click Continue.

Android

iOS

Create instance

Next, configure a network instance for the app you added.

Bidding

Navigate to LevelPlay > Setup > SDK networks, then select your app. Under Bidding, click the edit icon to view the bidding instance ID.

Android

iOS

Take note of the Instance ID.

Android

iOS

Waterfall

Navigate to Ads > Setup > Instances. Select the app and click Create Instance.

Enter the necessary details and click Save and close.

Once the instance is created, the Instance ID is listed in the Instance ID field.

Locate your Reporting API Key

Bidding

This step isn't required for bidding integrations.

Waterfall

In addition to the App Key and Instance ID, you'll also need your ironSource Ads Secret Key and Refresh Token to set up your AdMob ad unit ID.

Navigate to My Account in your ironSource Ads publisher dashboard then click the API tab. Take note of your Secret Key and Refresh Token.

Turn on test mode

Follow the instructions in ironSource Ads's Integration testing guide on how to enable ironSource Ads test ads.

שלב 2: הגדרת הביקוש ב-ironSource Ads ב AdMob ממשק המשתמש

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

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

iOS

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

הוספה ironSource Mobile לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב

פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את ironSource Mobile לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .

שלב 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

בכפוף להסכמת משתמשים של 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 בכתובת הגדרות מתקדמות בנושא רגולציה אפשר לקבל פרטים נוספים.

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

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

קובץ Unity User ProGuard

ייעוץ מדריך לשילוב SDK ב-Android של IronSource Ads לקבלת מידע נוסף על כללי ProGuard שנדרשים לפרויקט שלכם, ומוסיפים את הכללים האלה לקובץ proguard-user.txt.

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.1

גרסה 3.1.0

גרסה 3.0.1

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

  • תומך במתאם 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.