גישור

במדריך הזה מוסבר איך לשלב מתאם לתהליך בחירת הרשת (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 כדי להשתמש ב ממשקי 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(),
    );

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

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

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

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

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

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

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

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

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