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

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

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

Ad Manager מתאם בחירת הרשת של ironSource Ads כולל את היכולות הבאות:

שילוב
בידינג  1
מפל
פורמטים
מודעת באנר  2
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות  2

1 השילוב של הבידינג נמצא בגרסת בטא סגורה. כדי לבקש גישה, פנו למנהל החשבון שלכם.

2 הפורמט הזה נתמך רק בשילוב עם רשימת הרשתות.

דרישות

  • ה-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.

הזנת פרטי האפליקציה

בוחרים באפשרות אפליקציה פעילה, מזינים את שם האפליקציה ולוחצים על ייבוא פרטי האפליקציה.

אם האפליקציה לא זמינה, בוחרים באפשרות האפליקציה לא זמינה בחנות האפליקציות ומזינים שם זמני לאפליקציה. בוחרים את הפלטפורמה.

ממלאים את שאר הפרטים בטופס ולוחצים על Add App (הוספת אפליקציה).

שימו לב למפתח האפליקציה החדש, שמוצג אחרי הוספת האפליקציה. תצטרכו את הערך הזה כדי להגדיר את מזהה יחידת המודעות ב-AdMob. בוחרים את פורמט המודעות שהאפליקציה תומכת בהם. לאחר מכן, לוחצים על המשך.

Android

iOS

יצירת מכונה

בשלב הבא מגדירים מכונה של רשת לאפליקציה שהוספתם.

בידינג

עוברים אל LevelPlay > Setup > SDK networks ובוחרים את האפליקציה. בקטע Bidding, לוחצים על סמל העריכה כדי להציג את מזהה המכונה לבידינג.

Android

iOS

שימו לב למזהה המכונה.

Android

iOS

מפל

עוברים אל Ads‏ > Setup‏ > Instances. בוחרים את האפליקציה ולוחצים על Create Instance.

מזינים את הפרטים הנחוצים ולוחצים על שמירה וסגירה.

אחרי יצירת המכונה, מזהה המכונה מופיע בשדה Instance ID.

איתור מפתח Reporting API

בידינג

לא צריך לבצע את השלב הזה בשילוב של בידינג.

מפל

בנוסף למפתח האפליקציה ולמזהה המכונה, תצטרכו גם את מפתח הסוד ואת אסימון הרענון של ironSource Ads כדי להגדיר את מזהה יחידת המודעות ב-AdMob.

עוברים לקטע My Account במרכז הבקרה לבעלי תוכן דיגיטלי ב-ironSource Ads ולוחצים על הכרטיסייה API. חשוב לזכור את המפתח הסודי ואת אסימון הרענון.

הפעלת מצב בדיקה

כדי להפעיל מודעות בדיקה של ironSource Ads, פועלים לפי ההוראות במדריך בדיקת השילוב של ironSource Ads.

שלב 2: מגדירים את הביקוש למודעות של ironSource בממשק המשתמש Ad Manager

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

Android

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

iOS

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

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

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

שלב 3: מייבאים את ה-SDK והמתאם של ironSource Ads

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין בפרויקט את הפלאגין IronSource Mediation של Google Mobile Ads ל-Unity. לשם כך, מריצים את הפקודה הבאה מספריית השורש של הפרויקט:

openupm add com.google.ads.mobile.mediation.ironsource

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.

בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר ברמת ההיקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפים: com.google

פרטי OpenUPM

לאחר מכן עוברים אל Window > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries מהתפריט הנפתח.

מערכות רישום של Unity

בוחרים בחבילה Google Mobile Ads IronSource Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת (Mediation) של Google Mobile Ads ל-IronSource מהקישור להורדה ב-Changelog ומחלצים את GoogleMobileAdsIronSourceMediation.unitypackage מקובץ ה-ZIP.

בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > Import Package (ייבוא חבילה) > Custom Package (חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsIronSourceMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות Assets‏ > External Dependency Manager‏ > Android Resolver‏ > Force Resolve. הספרייה של External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות המוצגים לתיקייה Assets/Plugins/Android באפליקציה שלכם ב-Unity.

אילוץ פתרון

שלב 4: הטמעת הגדרות הפרטיות ב-ironSource Ads SDK

בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם צריכים לוודא שהמשתמשים באזור הכלכלי האירופי (EEA) מקבלים גילויים נאותים מסוימים לגבי השימוש במזהי מכשירים ובמידע אישי, ומאשרים את השימוש הזה. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.

הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור 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 לא יכולה להחיל את ההגדרה הזו על כל רשת המודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.

הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור 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

כללי ProGuard

אם אתם מקטינים, מטשטשים ומבצעים אופטימיזציה של האפליקציה, מערכת IronSource Ads דורשת כללי ProGuard נוספים לפרויקט.

כשמפתחים את הפרויקט, בוחרים באפשרות Android בתור פלטפורמה. לאחר מכן, פותחים את הגדרות הנגן ומסמנים את האפשרות קובץ Proguard של משתמש בכרטיסייה הגדרות פרסום. ב-Unity אמור להופיע המיקום שבו נוצר קובץ proguard-user.txt בהתאמה אישית שאפשר לשנות.

קובץ Proguard של משתמש ב-Unity

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

iOS

שילוב של SKAdNetwork

פועלים לפי המסמכים של ironSource Ads כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 6: בודקים את ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של ironSource Ads.

אימות מודעות לבדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה מ-ironSource Ads, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות ironSource Ads (Bidding) ו-ironSource Ads (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 Ads, נדרש הקשר של פעילות.
103 מערכת ironSource Ads יכולה לטעון רק מודעה אחת לכל מזהה מכונה של ironSource.
105 מערכת ironSource Ads לא תומכת בגודל מודעת הבאנר המבוקש.
106 ה-SDK של ironSource Ads לא הופעל.
501-1056 שגיאות ב-SDK של ironSource Ads. אפשר לקרוא פרטים נוספים במסמכי העזרה.

iOS

קוד שגיאה סיבה
101 פרמטרים של שרת ironSource Ads שהוגדרו בממשק המשתמש של Ad Manager חסרים או לא חוקיים.
102 מתאם המודעות ironSource לא תומך בפורמט המודעה המבוקש.
103 כבר נטענה מודעה של ironSource בהגדרת הרשת הזו.
104 הגודל המבוקש של מודעת הבאנר לא נתמך על ידי ironSource Ads.
508-1037 שגיאות ב-ironSource Ads SDK. פרטים נוספים זמינים במסמכי התיעוד.

יומן השינויים של פלאגין בחירת הרשת של Unity של ironSource

גרסה 3.4.0

גרסה 3.3.1

גרסה 3.3.0

גרסה 3.2.1

גרסה 3.2.0

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

  • תמיכה במתאם Android של IronSource בגרסה 6.10.0.0
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.8.6.0

גרסה 1.3.0

  • תמיכה במתאם Android של IronSource בגרסה 6.10.0.0
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.8.4.1.0

גרסה 1.2.0

  • תומך בגרסה 6.9.0.1 של מתאם IronSource ל-Android
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.8.4.1.0

גרסה 1.1.2

  • תמיכה במתאם Android של IronSource בגרסה 6.8.4.1
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.8.4.1

גרסה 1.1.1

  • תמיכה במתאם Android של IronSource בגרסה 6.8.4.1
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.8.3.0

גרסה 1.1.0

  • עדכנו את הפלאגין כך שיתמוך ב-Rewarded API החדש בגרסת בטא פתוחה.
  • תמיכה במתאם Android של IronSource בגרסה 6.8.1.2
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.8.0.1

גרסה 1.0.4

  • תמיכה במתאם Android של IronSource בגרסה 6.7.11.0
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.7.11.0

גרסה 1.0.3

  • תמיכה במתאם Android של IronSource בגרסה 6.7.10.0
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.7.10.0

גרסה 1.0.2

  • תמיכה במתאם Android של IronSource בגרסה 6.7.9.1.1
  • תומך במתאם iOS של IronSource בגרסה 6.7.10.0
  • תוקן קונפליקט עם הפלאגין של Chartboost לבחירת רשת (Mediation) ב-Unity.

גרסה 1.0.1

  • תמיכה במתאם Android של IronSource בגרסה 6.7.9.0.
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.7.9.2.0.

גרסה 1.0.0

  • גרסה ראשונה!
  • תומך בגרסה 6.7.9.0 של מתאם IronSource ל-Android.
  • תמיכה במתאם IronSource ל-iOS בגרסה 6.7.9.1.0.