הגדרת הפלאגין למודעות לנייד של Google ל-Flutter

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

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

במדריך הזה מוסבר איך לייבא את Google Mobile Ads Flutter Plugin ולהפעיל אותו, ואיך לבחור פורמט של מודעה.

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

לפני שממשיכים, צריך:

ייבוא של Google Mobile Ads Flutter Plugin

כדי לייבא Google Mobile Ads Flutter Plugin בפרויקט Flutter, אפשר לעיין במאמר בנושא google_mobile_ads.

הגדרת האפליקציה

אחרי שמייבאים את Google Mobile Ads Flutter Plugin, בוחרים אחת מהפלטפורמות הבאות כדי להגדיר את האפליקציה:

Android

  1. ב-Android Studio, עוברים אל הקובץ android/app/src/main/AndroidManifest.xml.

  2. בקובץ AndroidManifest.xml, מוסיפים תג <meta-data> לתג <application> עם המאפיינים הבאים:

    <manifest>
        <application>
            <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
            <meta-data
                android:name="com.google.android.gms.ads.APPLICATION_ID"
                android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
        <application>
    <manifest>
    

    המאפיינים האלה חייבים לקבל את הערכים הבאים:

    • android:name: com.google.android.gms.ads.APPLICATION_ID.
    • android:value: מזהה האפליקציה ב-Ad Manager.

    פרטים על הגדרת הקובץ AndroidManifest.xml זמינים במאמר בנושא הגדרת Google Mobile Ads SDK (Legacy).

iOS

  1. ב-Xcode, עוברים לקובץ ios/Runner/Info.plist.
  2. בקובץ Info.plist, מוסיפים מפתח GADApplicationIdentifier עם מזהה האפליקציה שלכם ב-Ad Manager כמחרוזת.

    <key>GADApplicationIdentifier</key>
    <string>ca-app-pub-################~##########</string>
    

    פרטים על הגדרת קובץ Info.plist זמינים במאמר בנושא עדכון קובץ Info.plist.

אתחול Google Mobile Ads Flutter Plugin

לפני טעינת המודעות, צריך להפעיל את Google Mobile Ads Flutter Plugin על ידי קריאה ל-MobileAds.instance.initialize().

השיטה הזו מחזירה Future שמסתיימת אחרי ש-Google Mobile Ads Flutter Plugin מאותחל או אחרי 30 שניות.

בדוגמה הבאה מתבצעת אתחול של Google Mobile Ads Flutter Plugin:

// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();

בחירת פורמט מודעה

אחרי שמייבאים את Google Mobile Ads Flutter Plugin, אפשר לבחור פורמט מודעה להטמעה. ב-Ad Manager אפשר להשתמש בפורמטים הבאים של מודעות:

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