גישור

במדריך הזה מוסבר איך לשלב מתאם בחירת רשת (Mediation) באפליקציה שלכם ב-Flutter.

דרישות מוקדמות

כדי לשלב גישור לפורמט מודעה, צריך לשלב את פורמט המודעה באפליקציה:

• מודעות באנר
• מודעות מעברון
• מודעות מותאמות
• מודעות מתגמלות
• מודעות מעברון מתגמלות

זו הפעם הראשונה שאתם משתמשים בתהליך בחירת הרשת (Mediation)? מבוא לתהליך בחירת הרשת

איך מפעילים את Mobile Ads SDK

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

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

עדכון הגדרות Gradle (ב-Android בלבד)

מוסיפים את השורות הבאות לקובץ settings.gradle כדי שתוכלו להשתמש בממשקי ה-API של Android של הפלאגין:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

הוספת יחסי תלות לרשתות של שותפים

צריך להוסיף את מתאמי התהליך של בחירת הרשת ואת יחסי התלות שלהם לפרויקטים של Android ו-iOS. כדי להוסיף אותם, מעדכנים את הקובץ build.gradle ברמת האפליקציה ב-Android ואת הקובץ Podfile ב-iOS. ל-Google יש מתאמים בקוד פתוח ב-GitHub גם ל-Android וגם ל-iOS.

במסמכי העזרה Android ו-iOS של כל רשת שותפה מפורטות הוראות מפורטות להוספת המתאם שלה לאפליקציה.

בדיקה של סוג המתאם של רשת המודעות שהטעין את המודעה

הקוד לדוגמה הבא מראה איך לתעד ביומן את שם הכיתה של רשת המודעות של מודעת הבאנר:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

שימוש במודעות באנר עם תהליך בחירת הרשת

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

שימוש במודעות מותאמות עם תהליך בחירת הרשת

ריכזנו כאן כמה שיטות מומלצות שכדאי להביא בחשבון כשמטמיעים תהליך בחירת רשת (Mediation) מקורי.

המדיניות בנושא הצגת מודעות מותאמות

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

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

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