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

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

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

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

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

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

דרישות

• ה-SDK העדכני של Google Mobile Ads
• Flutter 3.7.0 ואילך
• כדי לפרוס ב-Android
  • Android API ברמה 21 ואילך
• לפריסה ב-iOS
  • יעד הפריסה של iOS מגרסה 12.0 ואילך
• פרויקט Flutter פעיל שהוגדרה בו Google Mobile Ads SDK. למידע נוסף, ראו תחילת העבודה.
• מדריך לתחילת העבודה בנושא בחירת הרשת

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

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

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

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

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

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

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

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

יצירת מכונה

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

איתור מפתח Reporting API

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

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

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

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

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

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

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

שילוב באמצעות pub.dev

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

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

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

dependencies:
  gma_mediation_ironsource: ^1.0.0

שילוב ידני

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

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

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

GmaMediationIronsource().setConsent(true);

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

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

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

הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור ironSource Ads כולל את GmaMediationIronsource().setDoNotSell . דוגמת הקוד הבאה מראה איך מעבירים את פרטי ההסכמה ל-ironSource Ads SDK. צריך להגדיר את האפשרויות האלה לפני שמפעילים את Google Mobile Ads 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 Ads.

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

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

קודי שגיאה

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

אלו הקודים וההודעות הנלוות שמתאם המודעות ironSource זורק כשטעינה של מודעה נכשלת:

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

הגרסה הבאה

• ה-plugin נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin בגרסה 5.2.0.

1.1.0

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

1.0.0

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