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

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

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

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

שילוב
בידינג
מפל
פורמטים
כרזה
פרסומת מרווח ביניים
ההטבה הופעלה
מודעת מעברון מתגמלת

דרישות

  • ה-SDK העדכני של מודעות Google לנייד
  • Flutter 3.7.0 ואילך
  • כדי לפרוס ב-Android
    • Android API ברמת 21 ואילך
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Flutter עבודה שהוגדר באמצעות 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 החדש, שמוצג אחרי הוספת האפליקציה. הערך הזה נדרש כדי להגדיר אתAdMob מזהה יחידת המודעות. בחרו את הפורמטים של המודעות שבאפליקציה שלכם תומכת בהם. לאחר מכן, לוחצים על המשך.

Android

iOS

יצירת מכונה

בשלב הבא, מגדירים מופע רשת לאפליקציה שהוספתם. ironSource תומך במספר מופעים ברשת של מודעות מתגמלות ומודעות מעברון.

עוברים אל מודעות > הגדרה > מכונות. בוחרים את האפליקציה ולוחצים על Create Instance.

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

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

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

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

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

בצעו את ההוראות המפורטות במדריך בדיקות אינטגרציה של ironSource כדי ללמוד איך להפעיל מודעות לבדיקה של ironSource.

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

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

Android

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

iOS

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

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

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

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

שילוב דרך pub.dev

(ב-Android בלבד) מוסיפים את המאגרים הבאים לקובץ build.gradle שבתוך ספריית android של הפרויקט:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

מוסיפים את יחסי התלות הבאים עם הגרסאות העדכניות שלironSource ה-SDK והמתאם בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_ironsource: ^1.0.0

שילוב ידני

הורד את הגרסה האחרונה של פלאגין הגישור של Google Mobile Ads עבור ironSource, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter שלכם. לאחר מכן, מוסיפים את התלות הבאה לפלאגין בקובץ pubspec.yaml:

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

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

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

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

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setConsent(true);

למידע נוסף, ראו Regulation Advanced Settings (הגדרות מתקדמות) במסמכי התיעוד של ironSource.

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

חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.

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

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

למידע נוסף על הערכים שאפשר לספק בשיטה, כדאי לעיין במסמכי התיעוד של ironSource בנושא הגדרות מתקדמות של התקנה עבור Android ו-iOS.

שלב 5: מוסיפים את קוד החובה

Android

כללי ההגנה

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

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

מחזור החיים של אפליקציה

לשנות את השיטות onPause() ו-onResume() בכל אחת מהפעילויות כדי לקרוא לשיטות ironSource המתאימות באופן הבא:

Java

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

Kotlin

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

iOS

שילוב של SKAdNetwork

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

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

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

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

iOS

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

יומן שינויים של מתאם גישור של ironSource

1.0.0

  • גרסה ראשונית.
  • תאימות מאומתת עם מתאם Android של ironSource גרסה 8.0.0.0
  • תאימות מאומתת עם מתאם iOS של ironSource גרסה 8.0.0.0.0
  • התוסף נוצר ונבדק עם Google Mobile Ads Flutter גרסה 5.1.0.