כדי להציג מודעות ולהרוויח הכנסות, צריך לשלב את Google Mobile Ads Flutter Plugin באפליקציית Flutter. כדי להכין את הפרויקט, מייבאים ומפעילים את Google Mobile Ads Flutter Plugin לפני שמבקשים מודעות.
במדריך הזה מוסבר איך לייבא ולהפעיל את Google Mobile Ads Flutter Plugin ואיך לבחור פורמט של מודעה.
דרישות מוקדמות
לפני שממשיכים, צריך:
- גרסה 3.38.1 ואילך של Flutter.
- ב-Android, הגרסה האחרונה של Android Studio.
- ב-iOS, הגרסה האחרונה של Xcode עם כלי שורת הפקודה המופעלים. פרטים נוספים מופיעים במאמר בנושא התקנת Flutter.
- מזהה אפליקציה ב-Ad Manager. פרטים נוספים זמינים במאמר בנושא איך מוצאים מזהה אפליקציה או מזהה יחידת מודעות.
ייבוא Google Mobile Ads Flutter Plugin
כדי לייבא את Google Mobile Ads Flutter Plugin בפרויקט Flutter, אפשר לעיין במאמר בנושא google_mobile_ads.
הגדרת האפליקציה
אחרי שמייבאים את Google Mobile Ads Flutter Plugin, בוחרים אחת מהפלטפורמות הבאות כדי להגדיר את האפליקציה:
Android
ב-Android Studio, עוברים אל הקובץ
android/app/src/main/AndroidManifest.xml.בקובץ
AndroidManifest.xml, מוסיפים תג<meta-data>לתג<application>עם המאפיינים הבאים:<manifest> <application> <!-- Sample Ad Manager 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>המאפיינים האלה חייבים לקבל את הערכים הבאים:
-
android:name:com.google.android.gms.ads.APPLICATION_ID. -
android:value: מזהה האפליקציה ב-Ad Manager.
פרטים על הגדרת קובץ
AndroidManifest.xmlמופיעים במאמר בנושא הגדרת Google Mobile Ads SDK (Legacy).-
iOS
- ב-Xcode, עוברים לקובץ
ios/Runner/Info.plist. בקובץ
Info.plist, מוסיפים מפתחGADApplicationIdentifierעם מזהה האפליקציה שלכם ב-Ad Manager כמחרוזת.<key>GADApplicationIdentifier</key> <string>ca-app-pub-################~##########</string>פרטים על הגדרת קובץ
Info.plistזמינים במאמר בנושא עדכון קובץInfo.plist.
אתחול Google Mobile Ads Flutter Plugin
לפני טעינת המודעות, צריך להפעיל את Google Mobile Ads Flutter Plugin על ידי קריאה ל-MobileAds.instance.initialize().
השיטה הזו מחזירה Future שמסתיימת אחרי Google Mobile Ads Flutter Plugin, או אחרי 30 שניות.
בדוגמה הבאה מתבצע אתחול של Google Mobile Ads Flutter Plugin:
// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();
בחירת פורמט מודעה
אחרי שמייבאים את Google Mobile Ads Flutter Plugin, אפשר לבחור פורמט מודעה להטמעה. ב-Ad Manager אפשר להשתמש בפורמטים הבאים של מודעות:
| פורמט מודעה | תיאור | מאמרי עזרה |
|---|---|---|
| מודעת באנר | מודעות מלבניות שמוצגות באזור ייעודי. המודעות האלה מתרעננות באופן אוטומטי, כך שהמשתמשים יכולים לצפות במודעות בלי לצאת מהמסך. | הגדרה של מודעות באנר |
| מעברון | מודעות במסך מלא שמוצגות באפליקציה. כדאי למקם אותן בנקודות מעבר טבעיות, למשל בין שלבים במשחק. | מודעות מעברון |
| מותאמת | מאפשרת לכם להתאים אישית נכסים, כמו כותרות וקריאות לפעולה, באפליקציות שלכם. כשמתאימים אישית את המודעה, יוצרים מודעות שתואמות לעיצוב החזותי של האפליקציה. | טעינה של מודעה מותאמת |
| ההטבה הופעלה | המודעות המתגמלות מאפשרות למשתמשים לצפות בסרטונים או להשתתף בסקרים כדי לזכות בתגמולים בתוך האפליקציה, כמו מטבעות או תוספת חיים. אפשר לציין ערכי תגמול לכל יחידת מודעות. | מודעות מתגמלות |
| מודעת מעברון מתגמלת | הפורמט הזה מאפשר לכם להציע תגמולים, כמו מטבעות או תוספת חיים, בתמורה לצפייה במודעות שמופיעות במהלך מעברים בין מסכים באפליקציה. | מודעות מעברון מתגמלות |
| מודעה בפתיחת אפליקציה | המודעה מופיעה כשמשתמשים פותחים את האפליקציה או חוזרים אליה. המודעה מוצגת כשכבת-על במסך הטעינה של האפליקציה. | מודעות בפתיחת אפליקציה |