המדריך הזה מיועד לבעלי אפליקציות שרוצים לייצר הכנסות מאפליקציית 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
- הגרסה האחרונה של Xcode עם כלי שורת פקודה מופעלים
ייבוא Mobile Ads SDK
- כוללים את Google Mobile Ads SDK for Flutter בפרויקט Flutter.
הגדרה ספציפית לפלטפורמה
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 מציע מספר פורמטים שונים של מודעות, כך שתוכלו לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה שלכם.
כרזה
מודעות מלבניות שמופיעות בחלק העליון או התחתון של מסך המכשיר. מודעות באנר נשארות על המסך בזמן שהמשתמשים מקיימים אינטראקציה עם האפליקציה, וניתן לרענן אותן באופן אוטומטי לאחר פרק זמן מסוים. אם אתם רק מתחילים לפרסם, זה מקום מצוין להתחיל.
פרסומת מרווח ביניים
מודעות במסך מלא שמסתירות את הממשק של האפליקציה עד שהמשתמש סוגר אותן. הן מתאימות במיוחד להפסקות טבעיות בתהליך ההפעלה של האפליקציה, למשל בין שלבים של משחק או מיד לאחר השלמת משימה.
מותאם
מודעות בהתאמה אישית שמתאימות לעיצוב ולסגנון של האפליקציה. אתם מחליטים איך ואיפה הן יוצגו, כך שהפריסה תהיה תואמת יותר לעיצוב של האפליקציה.
ההטבה הופעלה
מודעות שמתגמלות משתמשים על צפייה בסרטונים קצרים ועל אינטראקציות עם מודעות התנסות באפליקציה ומודעות סקר. השיטה הזו מתאימה למונטיזציה של משתמשים בחינם.