הגדרת הפלאגין למודעות לנייד של 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 אפשר להשתמש בפורמטים הבאים של מודעות:

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