השילוב של Google Mobile Ads SDK באפליקציה הוא השלב הראשון לקראת הצגת מודעות וייצור הכנסות. אחרי שמשלבים את ה-SDK, אפשר לבחור פורמט מודעה (למשל: מודעות מותאמות או מודעות וידאו מתגמלות) ולפעול לפי השלבים להטמעה.
לפני שמתחילים
כדי להכין את האפליקציה, מבצעים את השלבים שמפורטים בקטעים הבאים.
דרישות מוקדמות לאפליקציה
יש לוודא שקובץ ה-build של האפליקציה משתמש בערכים הבאים:
- גרסת SDK מינימלית של
23
ואילך - הידור גרסת ה-SDK של
34
ואילך
- גרסת SDK מינימלית של
הגדרת האפליקציה בחשבון AdMob
כדי לרשום את האפליקציה כאפליקציית AdMob, מבצעים את השלבים הבאים:
רושמים את האפליקציה ב-AdMob. בשלב הזה יוצרים אפליקציה ב-AdMob עם מזהה אפליקציה ייחודי ב-AdMob, שיהיה בשימוש בהמשך המדריך.
הגדרת האפליקציה
בקובץ ההגדרות של Gradle, כוללים את מאגר Maven של Google ואת המאגר המרכזי של Maven:
Kotlin
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include(":app")
מגניב
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include ':app'
מוסיפים את יחסי התלות של Google Mobile Ads SDK לקובץ ה-build ברמת האפליקציה:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:24.2.0") }
מגניב
dependencies { implementation 'com.google.android.gms:play-services-ads:24.2.0' }
לוחצים על סנכרון עכשיו. למידע נוסף על סנכרון, ראו סנכרון פרויקטים עם קובצי Gradle.
מוסיפים את מזהה האפליקציה ב-AdMob, כפי שזוהה בממשק האינטרנט של AdMob, לקובץ
AndroidManifest.xml
של האפליקציה. כדי לעשות זאת, מוסיפים תג<meta-data>
עםandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. מזהה האפליקציה מופיע בממשק האינטרנט של AdMob. בשדה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>
באפליקציה אמיתית, החליפו את מזהה האפליקציה לדוגמה במזהה האפליקציה בפועל ב-AdMob. תוכלו להשתמש במזהה לדוגמה אם אתם רק רוצים להתנסות ב-SDK באפליקציה Hello World.
כמו כן, שימו לב שאם לא מוסיפים את התג
<meta-data>
בדיוק כפי שמוצג, התוצאה הייתה קריסה עם ההודעה:Missing application ID.
(אופציונלי) אפשר להצהיר על ההרשאה
AD_ID
לגרסאות קודמות שיעבדו עם Android 13.אם באפליקציה נעשה שימוש ב-Google Mobile Ads SDK מגרסה 20.4.0 ואילך, אפשר לדלג על השלב הזה, כי ה-SDK מצהיר באופן אוטומטי על ההרשאה
com.google.android.gms.permission.AD_ID
ויכול לגשת למזהה הפרסום בכל פעם שהוא זמין.אם באפליקציות שמשתמשות ב-Google Mobile Ads SDK מגרסה 20.3.0 ומטה ומטרגטות את Android 13, צריך להוסיף את ההרשאה
com.google.android.gms.permission.AD_ID
לקובץAndroidManifest.xml
כדי של-Google Mobile Ads SDK תהיה גישה למזהה הפרסום:<manifest> <application> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower --> <uses-permission android:name="com.google.android.gms.permission.AD_ID"/> </application> </manifest>
מידע נוסף על הצהרת ההרשאות
com.google.android.gms.permission.AD_ID
, כולל הנחיות איך להשבית אותה, זמין במאמר הזה ב-Play Console.
הפעלה של Google Mobile Ads SDK
לפני שטוענים מודעות, צריך להפעיל את Google Mobile Ads SDK באמצעות קריאה ל-MobileAds.initialize()
.
השיטה הזו מפעילה את ה-SDK ומבצעת האזנה להשלמה לאחר שה-Google Mobile Ads SDK והפעלת המתאם הושלמו, או אחרי זמן קצוב של 30 שניות. צריך לעשות זאת רק פעם אחת, רצוי בזמן הפעלת האפליקציה.
ייתכן שהמודעות ייטענו מראש על ידי Google Mobile Ads SDK או ערכות ה-SDK של השותפים בתהליך בחירת הרשת (Mediation) לאחר האתחול. אם אתם צריכים לקבל הסכמה ממשתמשים באזור הכלכלי האירופי (EEA), עליכם להגדיר סימונים ספציפיים לבקשה, כמו
setTagForChildDirectedTreatment()
או
setTagForUnderAgeOfConsent()
,
או לבצע פעולה אחרת לפני טעינת המודעות, הקפידו לעשות זאת לפני ההפעלה של Google Mobile Ads SDK.
הדוגמה הבאה מראה איך לקרוא ל-method initialize()
בשרשור ברקע בתוך פעילות:
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
new Thread(
() -> {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
})
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) {}
}
}
}
בחירת פורמט מודעה
Google Mobile Ads SDK מיובא ואתם יכולים להטמיע מודעה. ב-AdMob יש כמה פורמטים שונים של מודעות, כך שאפשר לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה.
מודעת באנר
יחידות של מודעות באנר מוצגות כמלבן שתופס חלק מהפריסה של האפליקציה. יכול להיות שיתבצע רענון אוטומטי שלהם אחרי פרק זמן מסוים. הרענון האוטומטי יגרום לכך שתוצג למשתמשים מודעה חדשה במרווחי זמן קבועים, גם אם הם יישארו באותו מסך באפליקציה. כמו כן, מודעות באנר הן פורמט המודעה הפשוט ביותר להטמעה.
מעברון
יחידות של מודעות מעברון משמשות להצגה של מודעות במסך מלא באפליקציה. צריך למקם אותן בנקודות עצירה ומעבר טבעיות בממשק של האפליקציה, כמו אחרי השלמת שלב באפליקציית משחקים.
מותאם
מודעות מותאמות הן מודעות שבהן אפשר להתאים אישית את האופן שבו נכסים, כמו כותרות וקריאות לפעולה, מוצגים באפליקציות. עיצוב המודעה בעצמכם מאפשר לכם ליצור הצגות של מודעות טבעיות ולא פולשניות, שיכולות להוסיף לחוויית המשתמש.
ההטבה הופעלה
יחידות של מודעות מתגמלות מאפשרות למשתמשים לשחק במשחקים, להשתתף בסקרים או לצפות בסרטונים כדי לזכות בתגמולים בתוך האפליקציה, כמו מטבעות, עוד חיים או נקודות. אתם יכולים להגדיר תגמולים שונים ליחידות מודעות שונות ולציין את ערכי התגמולים והפריטים שהמשתמשים קיבלו.
מודעות מעברון מתגמלות
מודעת מעברון מתגמלת היא מודעה מסוג חדש שמופיעה באופן אוטומטי בנקודות מעבר טבעיות באפליקציה ומאפשרת לכם להציע תגמולים, כמו מטבעות או תוספת חיים.
בשונה ממודעות מתגמלות רגילות, המשתמשים לא צריכים להביע הסכמה לצפייה במודעת מעברון מתגמלת.
לפני מודעות מתגמלות רגילות, המשתמשים רואים הודעה שמבקשת הסכמה להציג מודעות. אבל לפני מודעות מעברון מתגמלות, צריך להציג למשתמשים מסך פתיחה שמופיעים בו התגמול המוצע ואפשרות לסרב לצפות במודעה.
הטמעה של מודעות מעברון מתגמלות
מודעה בפתיחת אפליקציה
מודעה בפתיחת אפליקציה היא פורמט מודעה שמופיע כשמשתמשים פותחים את האפליקציה או חוזרים אליה. המודעה מוצגת כשכבת-על במסך הטעינה.
מקורות מידע נוספים
במאגר המודעות של Google לנייד ב-GitHub תוכלו לראות איך להשתמש בפורמטים השונים של המודעות שה-API הזה מציע.