המדריך הזה מיועד לבעלי אפליקציות שרוצים לייצר הכנסות מאפליקציה שנוצרה באמצעות Flutter.
השילוב של Google Mobile Ads SDK באפליקציית Flutter הוא השלב הראשון להצגת מודעות AdMob ולייצור הכנסות. אחרי שההטמעה תושלם, תוכלו לבחור פורמט מודעה כדי לקבל שלבי הטמעה מפורטים.
ערכת Google Mobile Ads SDK ל-Flutter תומכת כרגע בחיוב ובתצוגה של מודעות באנר, מודעות מעברון (מסך מלא), מודעות מותאמות ומודעות מתגמלות.
דרישות מוקדמות
- Flutter מגרסה 1.22.0 ואילך
- Android
- Android Studio מגרסה 3.2 ואילך
- טירגוט ל-Android API ברמה 20 ואילך
- מגדירים את
compileSdkVersion
לערך 28 ומעלה
- iOS
- הגרסה האחרונה של Xcode עם כלים מופעלים של שורת הפקודה
- מומלץ: ליצור חשבון AdMob ולרשום אפליקציה ל-Android ו/או ל-iOS
ייבוא של Mobile Ads SDK
- כוללים את הפלאגין של Google Mobile Ads SDK ל-Flutter בפרויקט ב-Flutter.
הגדרה ספציפית לפלטפורמה
Android
עדכון הקובץ AndroidManifest.xml
מזהה האפליקציה ב-AdMob חייב להיכלל ב-AndroidManifest.xml
. אם לא תעשו זאת, תתרחש קריסה בהפעלת האפליקציה.
מוסיפים את מזהה האפליקציה ב-AdMob, כפי שהוא מזוהה בממשק האינטרנט של AdMob, לקובץ android/app/src/main/AndroidManifest.xml
של האפליקציה באמצעות תג <meta-data>
בשם com.google.android.gms.ads.APPLICATION_ID
. בשביל android:value
, צריך להזין במירכאות את מזהה האפליקציה שלכם ב-AdMob כפי שמוצג כאן:
<manifest>
<application>
<!-- Sample AdMob 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
עם ערך מחרוזת של מזהה האפליקציה ב-AdMob, כפי שהוא מזוהה בממשק האינטרנט של AdMob:
<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, אפשר להטמיע מודעה. ב-AdMob יש כמה פורמטים שונים של מודעות, כך שאפשר לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה.
מודעת באנר
מודעות מלבניות שמופיעות בחלק העליון או התחתון של מסך המכשיר. מודעות באנר נשארות במסך בזמן שהמשתמשים יוצרים אינטראקציה עם האפליקציה, ואפשר לרענן אותן באופן אוטומטי אחרי פרק זמן מסוים. אם זו הפעם הראשונה שאתם משתמשים בפרסום בנייד, כדאי להתחיל מהם.
מעברון
מודעות במסך מלא שמכסות את הממשק של האפליקציה עד שהמשתמש סוגר אותן. מומלץ להשתמש בהן בהשהיות טבעיות בזרימה של האפליקציה, למשל בין שלבים במשחק או מיד אחרי השלמת משימה.
מותאם
מודעות בהתאמה אישית שתואמות לסגנון ולעיצוב של האפליקציה. אתם מחליטים איך ואיפה הן יוצגו, כך שהפריסה תהיה עקבית יותר עם עיצוב האפליקציה.
ההטבה הופעלה
מודעות שמציעות למשתמשים תגמולים בתמורה לצפייה בסרטונים קצרים, לאינטראקציות עם מודעות התנסות באפליקציה ולמילוי סקרים. מודעות מתגמלות מתאימות במיוחד לייצור הכנסות ממשתמשים שמעדיפים אפליקציות או משחקים חינמיים.