גישור

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

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

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

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

משתמשים חדשים בתהליך בחירת הרשת (Mediation)? כדאי לקרוא את המאמר מבוא לתהליך בחירת הרשת (Mediation).

הפעלה של Mobile Ads SDK

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

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

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

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

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

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(),
    );

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

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

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

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

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

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

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

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

למידע נוסף על הפעלת עיבוד נתונים מוגבל (RDP) וקבלת הסכמה ל-GDPR באמצעות Google User Messaging Platform (UMP) SDK