השילוב של Google Mobile Ads SDK באפליקציה הוא השלב הראשון בהצגת מודעות וייצור הכנסות. אחרי שתשלבו את ה-SDK, תוכלו לבחור פורמט מודעה (למשל, מודעת וידאו מותאמת או מודעת וידאו מתגמלת) ולפעול לפי ההוראות להטמעתו.
לפני שמתחילים
כדי להכין את האפליקציה, יש להשלים את השלבים בקטעים הבאים.
דרישות מוקדמות של אפליקציה
- Android Studio 3.2 ואילך
יש לוודא שקובץ ה-build של האפליקציה משתמש בערכים הבאים:
minSdkVersion
מתוך19
או יותרcompileSdkVersion
מתוך28
או יותר
מגדירים את האפליקציה בחשבון AdMob
כדי לרשום את האפליקציה כאפליקציית AdMob, צריך לבצע את השלבים הבאים:
נכנסים לחשבון או נרשמים לחשבון AdMob.
רושמים את האפליקציה ב-AdMob. השלב הזה יוצר אפליקציית AdMob עם מזהה אפליקציה ייחודי ב-AdMob שנדרש בהמשך המדריך.
מגדירים את האפליקציה
בקובץ
build.gradle
ברמת הפרויקט, כוללים את המאגר של Maven ב-Google ואת המאגר המרכזי של Maven בקטעיםbuildscript
ו-allprojects
:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
מוסיפים את יחסי התלות של Google Mobile Ads SDK לקובץ Gradle ברמת האפליקציה, בדרך כלל
app/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-ads:21.5.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>
כפי שמוצג למעלה, מתרחשת קריסה עם ההודעה:The Google Mobile Ads SDK was initialized incorrectly.
(אופציונלי) יש להצהיר על הרשאת
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 ומפעילה מאזין להשלמה לאחר שהאתחול הושלם (או לאחר זמן קצוב של 30 שניות). חשוב לעשות זאת רק פעם אחת, ורצוי בעת השקת האפליקציה.
ניתן לטעון מראש את המודעות באמצעות Google Mobile Ads SDK או SDK של תהליך בחירת הרשת (Mediation) עם התקשרות למספר MobileAds.initialize()
. אם צריך לקבל הסכמה ממשתמשים באזור הכלכלי האירופי (EEA), מגדירים סימונים ספציפיים לבקשה (כמו tagForChildDirectedTreatment
או tag_for_under_age_of_consent
), או אם צריך לנקוט פעולה אחרת לפני טעינת המודעות, חשוב לעשות זאת לפני ההפעלה של Google Mobile Ads SDK.
הנה דוגמה לאופן שבו ניתן לקרוא לשיטה 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); MobileAds.initialize(this, new OnInitializationCompleteListener() { @Override public void onInitializationComplete(InitializationStatus initializationStatus) { } }); } }
Kotlin
import com.google.android.gms.ads.MobileAds class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) MobileAds.initialize(this) {} } }
אם אתם משתמשים בתהליך בחירת הרשת, יש להמתין עד שהגורם המטפל בהשלמה יבצע קריאה לפני טעינת מודעות. כך תוכלו לוודא שכל המתאמים בתהליך בחירת הרשת יאופסו.
בחירת פורמט מודעה
ה-SDK של מודעות Google לנייד מיובא, והכול מוכן להטמעה של מודעה. AdMob אפשר לבחור מבין כמה פורמטים של מודעות, כדי לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה שלך.
באנר
מודעות מלבניות שמופיעות בחלק העליון או התחתון של מסך המכשיר. מודעות באנר נשארות על המסך במהלך האינטראקציה של משתמשים עם האפליקציה, וניתן לרענן אותן אוטומטית לאחר פרק זמן מסוים. אם זו הפעם הראשונה שאתם מתנסים בפרסום בנייד, כדאי להתחיל כאן.
פרסומת מרווח ביניים
מודעות במסך מלא שמכסות את הממשק של האפליקציה, עד שהמשתמש סוגר אותן. מומלץ להשתמש בהן בהפסקות רגילות בתהליך ההפעלה של האפליקציה, כמו בין שלבים במשחק או מיד אחרי שמשלימים אותה.
מותאמת
מודעות בהתאמה אישית שמתאימות לעיצוב ולסגנון של האפליקציה, ואתם מחליטים איך ואיפה הן יוצגו, כך שהפריסה תואמת יותר לעיצוב של האפליקציה.
ההטבה הופעלה
מודעות שמתגמלות משתמשים על צפייה בסרטונים קצרים ועל אינטראקציות עם מודעות התנסות באפליקציה ומודעות סקר. השירות משמש למונטיזציה של אפליקציות בחינם.
מקורות מידע נוספים
במאגר של Google Mobile Ads ב-GitHub תוכלו לראות איך להשתמש בפורמטים שונים של מודעות ב-API הזה.