השילוב של Google Mobile Ads SDK באפליקציה הוא השלב הראשון בהצגת מודעות וייצור הכנסות. אחרי שתשלבו את ה-SDK, תוכלו לבחור פורמט מודעה (למשל, מודעת וידאו מותאמת או מודעת וידאו מתגמלת) ולפעול לפי ההוראות להטמעתו.
לפני שמתחילים
כדי להכין את האפליקציה, יש להשלים את השלבים בקטעים הבאים.
דרישות מוקדמות של אפליקציה
- Android Studio 3.2 ואילך
יש לוודא שקובץ ה-build של האפליקציה משתמש בערכים הבאים:
minSdkVersion
מתוך19
או יותרcompileSdkVersion
מתוך28
או יותר
מגדירים את האפליקציה
בקובץ
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' }
מוסיפים את Ad Manager מזהה האפליקציה (שמזהה ב-Ad Manager ממשק המשתמש) לקובץ ה-
AndroidManifest.xml
של האפליקציה. לשם כך יש להוסיף תג<meta-data>
באמצעות התגandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. מזהה האפליקציה מופיע בממשק המשתמש Ad Manager . עבורandroid:value
, צריך להזין מזהה אפליקציה Ad Manager משלך המוקף במירכאות.<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>
באפליקציה אמיתית, השתמשו במזהה Ad Manager האמיתי של האפליקציה ולא בתעודה המפורטת למעלה. אם אתם רק רוצים להתנסות ב-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 לנייד מיובא, והכול מוכן להטמעה של מודעה. Ad Manager אפשר לבחור מבין כמה פורמטים של מודעות, כדי לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה שלך.
באנר
מודעות מלבניות שמופיעות בחלק העליון או התחתון של מסך המכשיר. מודעות באנר נשארות על המסך במהלך האינטראקציה של משתמשים עם האפליקציה, וניתן לרענן אותן אוטומטית לאחר פרק זמן מסוים. אם זו הפעם הראשונה שאתם מתנסים בפרסום בנייד, כדאי להתחיל כאן.
פרסומת מרווח ביניים
מודעות במסך מלא שמכסות את הממשק של האפליקציה, עד שהמשתמש סוגר אותן. מומלץ להשתמש בהן בהפסקות רגילות בתהליך ההפעלה של האפליקציה, כמו בין שלבים במשחק או מיד אחרי שמשלימים אותה.
מותאמת
מודעות בהתאמה אישית שמתאימות לעיצוב ולסגנון של האפליקציה, ואתם מחליטים איך ואיפה הן יוצגו, כך שהפריסה תואמת יותר לעיצוב של האפליקציה.
ב-Google Ad Manager קיימות שתי דרכים להטמעת מודעות מותאמות: סגנונות מותאמים ורינדור מותאם אישית.
המטרה של הסגנונות המותאמים היא להקל ככל האפשר על היישום של מודעות מותאמות, ומומלץ לבחור בפורמט הזה. עיבוד מותאם אישית נועד למקסם את החופש שיש לכם ליצירת המצגות שלכם.
הטמעת מודעות מותאמות | הטמעת סגנונות מותאמים |
ההטבה הופעלה
מודעות שמתגמלות משתמשים על צפייה בסרטונים קצרים ועל אינטראקציות עם מודעות התנסות באפליקציה ומודעות סקר. השירות משמש למונטיזציה של אפליקציות בחינם.
מקורות מידע נוספים
במאגר של Google Mobile Ads ב-GitHub תוכלו לראות איך להשתמש בפורמטים שונים של מודעות ב-API הזה.