התחל בעבודה

השילוב של Google Mobile Ads SDK באפליקציה הוא השלב הראשון לקראת הצגת מודעות וייצור הכנסות. אחרי שמשלבים את ה-SDK, אפשר לבחור פורמט מודעה (למשל: מודעות מותאמות או מודעות וידאו מתגמלות) ולפעול לפי השלבים להטמעה.

לפני שמתחילים

כדי להכין את האפליקציה, מבצעים את השלבים שמפורטים בקטעים הבאים.

דרישות מוקדמות לאפליקציה

  • יש לוודא שקובץ ה-build של האפליקציה משתמש בערכים הבאים:

    • גרסת SDK מינימלית של 23 ואילך
    • הידור גרסת ה-SDK של 34 ואילך

הגדרת האפליקציה בחשבון AdMob

כדי לרשום את האפליקציה כאפליקציית AdMob, מבצעים את השלבים הבאים:

  1. נכנסים לחשבון AdMob או נרשמים לחשבון AdMob.

  2. רושמים את האפליקציה ב-AdMob. בשלב הזה יוצרים אפליקציה ב-AdMob עם מזהה אפליקציה ייחודי ב-AdMob, שיהיה בשימוש בהמשך המדריך.

הגדרת האפליקציה

  1. בקובץ ההגדרות של 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'
  2. מוסיפים את יחסי התלות של 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'
    }
  3. לוחצים על סנכרון עכשיו. למידע נוסף על סנכרון, ראו סנכרון פרויקטים עם קובצי Gradle.

  4. מוסיפים את מזהה האפליקציה ב-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 הזה מציע.