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

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

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

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

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

² רק בפורמט הזה נתמכת בשילוב של Waterfall.

דרישות

• ה-SDK העדכני של Google Mobile Ads
• Flutter 3.7.0 ואילך
• לפריסה ב-Android
  • Android API ברמה 21 ואילך
• לפריסה ב-iOS
  • יעד הפריסה של iOS מגרסה 12.0 ואילך
• פרויקט Flutter פעיל שהוגדר ב-Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
• השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

נרשמים ונכנסים לחשבון ironSource Ads.

על מנת להוסיף את האפליקציה למרכז הבקרה של ironSource Ads, לוחצים על הלחצן New App.

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

בוחרים באפשרות Live App, מזינים את כתובת ה-URL של האפליקציה ולוחצים על Import App Information (ייבוא פרטי אפליקציה).

אם האפליקציה לא זמינה, בוחרים באפשרות App Not Live in the Application Store ומציינים שם זמני לאפליקציה, ובוחרים את הפלטפורמה.

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

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

יצירת מכונה

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

איתור מפתח ה-Reporting API

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

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

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

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

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

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

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

שילוב באמצעות 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

שילוב ידני

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

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

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

הסכמה באיחוד האירופי ו-GDPR

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

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

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

GmaMediationIronsource().setConsent(true);

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

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

ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל מודעה בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שעשויים להשתתף במכירת לפעול לפי ההנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות למדיניות.

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

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

GmaMediationIronsource().setDoNotSell(true);

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

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

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

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

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

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

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

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

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

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

כדי לוודא שמוצגות לך מודעות לבדיקה מ- IronSource , צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות ironSource Ads (Waterfall) מקורות המודעות.

קודי שגיאה

אם המתאם לא מקבל מודעה מ-ironSource Ads, בעלי התוכן הדיגיטלי יכולים לבדוק לשגיאה הבסיסית מהתגובה באמצעות ResponseInfo מתחת לקטע המחלקות הבאות:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

אלו הקודים וההודעות הנלוות שמוצגות במודעות ironSource כשמודעה נכשלת להיטען:

יומן שינויים של מתאם Mediation Flutter של ironSource

1.0.0

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