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

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

Android

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

iOS

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

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

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

קובץ Unity User ProGuard

כדי להבין אילו כללי 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

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