בוא נתחיל

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

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

Google Mobile Ads SDK for Flutter תומכת בשלב זה בטעינה ובהצגה של מודעות באנר, מודעות מעברון (מסך מלא), מודעות מותאמות ומודעות מתגמלות.

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

  • Flutter מגרסה 1.22.0 ואילך
  • במכשירי Android
    • Android Studio 3.2 ואילך
    • רמת טירגוט של Android API ברמה 20 ומעלה
    • צריך להגדיר את compileSdkVersion ל-28 או יותר
  • iOS

ייבוא Mobile Ads SDK

הגדרה ספציפית לפלטפורמה

Android

עדכון AndroidManifest.xml

יש לכלול את מזהה האפליקציה של Ad Manager בAndroidManifest.xml. אם לא תעשו זאת, האפליקציה קורסת בזמן הפעלת האפליקציה.

מוסיפים את מזהה האפליקציה של Ad Manager (מזוהה בממשק המשתמש של Ad Manager) לקובץ android/app/src/main/AndroidManifest.xml של האפליקציה. לשם כך, מוסיפים תג <meta-data> בשם בשם com.google.android.gms.ads.APPLICATION_ID. אפשר למצוא את מזהה האפליקציה בממשק המשתמש של Ad Manager. עבור android:value, יש להזין את מזהה האפליקציה שלכם ב-Ad Manager במירכאות, כפי שמוצג כאן:

<manifest>
    <application>
        <!-- Sample 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>

צריך להשתמש באותו value כשמפעילים את הפלאגין בקוד של Dart.

מידע נוסף על הגדרת AndroidManifest.xml והגדרת מזהה האפליקציה זמין במדריך ל-Android.

iOS

עדכון המידע.plist

בקובץ ios/Runner/Info.plist של האפליקציה, מוסיפים מפתח GADApplicationIdentifier עם ערך מחרוזת של מזהה האפליקציה ב-Ad Manager (מזוהה בממשק המשתמש של Ad Manager):

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

עליכם להעביר את אותו ערך בזמן ההפעלה של הפלאגין בקוד של Dart.

מידע נוסף על ההגדרה של Info.plist ועל הגדרת מזהה האפליקציה זמין במדריך ל-iOS.

מפעילים את Mobile Ads SDK

לפני טעינת המודעות, צריך להפעיל את האפליקציה בעזרת Mobile Ads SDK באמצעות התקשרות אל MobileAds.instance.initialize(), שמפעילה את ה-SDK ומחזירה Future שמסתיימת אחרי שתהליך האתחול מסתיים (או אחרי 30 שניות). יש לעשות זאת פעם אחת בלבד, רצוי ממש לפני הפעלת האפליקציה.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  MobileAds.instance.initialize();

  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  MyAppState createState() => MyAppState();
}

class MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // Load ads.
  }
}

בחירה של פורמט מודעה

ה-Mobile Ads SDK מיובא ועכשיו אתם יכולים להטמיע מודעה. Ad Manager מציע מספר פורמטים שונים של מודעות, כך שתוכלו לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה שלכם.

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

הטמעה של מודעת באנר

פרסומת מרווח ביניים

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

הטמעה של מודעת מעברון

מותאם

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

הטמעה של מודעה מותאמת

ההטבה הופעלה

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

הטמעה של מודעה מתגמלת