מתחילים

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

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

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

מעברון

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

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

מותאם

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

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

ההטבה הופעלה

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

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