הגדרת תהליך בחירת הרשת

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

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

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

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

אתחול Google Mobile Ads Flutter Plugin

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

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

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 flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

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

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

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

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

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

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

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

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

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

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

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

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

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