תחילת העבודה

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

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

ערכת Google Mobile Ads SDK ל-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

עדכון Info.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 מציע כמה פורמטים שונים של מודעות, כך שאפשר לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה.

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

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

מעברון

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

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

מותאם

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

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

ההטבה הופעלה

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

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