שילוב של Google Mobile Ads SDK באפליקציה הוא הצעד הראשון לקראת הצגת מודעות וייצור הכנסות. אחרי השילוב של ה-SDK, אפשר בוחרים פורמט מודעה (למשל, מודעת וידאו מותאמת או וידאו מתגמלת) ופועלים לפי השלבים כדי: להטמיע אותו.
לפני שמתחילים
כדי להכין את האפליקציה, צריך לבצע את השלבים בקטעים הבאים.
דרישות מוקדמות לאפליקציה
יש לוודא שקובץ ה-build של האפליקציה משתמש בערכים הבאים:
- גרסת SDK מינימלית של
21
ומעלה - הידור גרסת ה-SDK של
33
ומעלה
- גרסת 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 ברמת האפליקציה file:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.3.0") }
מגניב
dependencies { implementation 'com.google.android.gms:play-services-ads:23.3.0' }
יש להוסיף את 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.אם באפליקציה נעשה שימוש בגרסה 20.4.0 של Google Mobile Ads SDK או תוכלו לדלג על השלב הזה כי ה-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
), כולל איך להשבית אותו, קראו את מאמר במסוף.
הפעלה של Google Mobile Ads SDK
לפני שטוענים את המודעות, צריך להפעיל את Google Mobile Ads SDKMobileAds.initialize()
השיטה הזו מפעילה את ה-SDK וקוראת ל-השלמת האזנה כשגם הפעלות המתאמים וה-SDK של מודעות Google לנייד הושלמו, או אחרי זמן קצוב לתפוגה של 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 מציע.