גישור

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

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

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

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

לא התנסיתם בתהליך בחירת הרשת (Mediation) בעבר? מידע נוסף זמין במאמר מבוא לתהליך בחירת הרשת (Mediation).

הפעלה של Google Mobile Ads SDK

במדריך לתחילת העבודה מוסבר איך להפעיל את Google 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 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. כדי להוסיף אותם, צריך לעדכן את קובץ build.gradle ברמת האפליקציה ב-Android ואת קובץ Podfile ב-iOS. ל-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

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

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