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

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

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

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

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

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

דרישות

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

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

נרשמים ונכנסים לחשבון הפרסום ב-ironSource.

הוסף אפליקציה חדשה

כדי להוסיף אפליקציה חדשה, עוברים אל מודעות > אפליקציות ולוחצים על הוספת אפליקציה.

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

כותבים לעצמכם את מפתח האפליקציה, בוחרים את פורמטים של המודעות שהאפליקציה תומכת בהם ולוחצים על המשך.

Android

iOS

יצירת מכונה

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

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

בידינג

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

Android

iOS

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

Android

iOS

מפל

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

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

איתור מפתח Reporting API

בידינג

השלב הזה לא נדרש לשילובי בידינג.

מפל

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

עדכון קובץ app-ads.txt

Authorized Sellers for Apps app-ads.txt היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, יוצרים קובץ app-ads.txt ל-Ad Manager.

כדי להטמיע את app-ads.txt ב-ironSource, אפשר להיעזר במפיצים המורשים של ironSource.

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

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

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

הגדרת הגדרות בחירת הרשת ליחידת המודעות

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.

iOS

להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.

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

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

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

שילוב דרך pub.dev

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

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

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

dependencies:
  gma_mediation_ironsource: ^

שילוב ידני

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

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

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

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

הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-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: מוסיפים את הקוד הנדרש

Android

כללי Proguard

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

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

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

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

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 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 Ads כשהמודעה לא נטענת:

Android

קוד שגיאה סיבה
101 פרמטרים של שרת של ironSource Ads שהוגדרו בממשק המשתמש של AdMob חסרים או לא חוקיים.
102 כדי לאתחל את ה-SDK של ironSource Ads, נדרש הקשר של פעילות.
103 מערכת ironSource Ads יכולה לטעון רק מודעה אחת לכל מזהה מכונה של ironSource.
105 מערכת ironSource Ads לא תומכת בגודל מודעת הבאנר המבוקש.
106 ה-SDK של ironSource Ads לא הופעל.
501-1056 שגיאות ב-SDK של ironSource Ads. פרטים נוספים זמינים במסמכי התיעוד.

iOS

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

יומן השינויים של מתאם בחירת הרשת של ironSource ל-Flutter

1.3.0

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

1.2.0

  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.3.1.

1.1.0

  • הפלאגין ל-iOS הוא עכשיו מסגרת סטטית.
  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.3.1.

1.0.0

  • זו הגרסה הראשונה.
  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.