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