התחל בעבודה

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

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

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

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

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

    • גרסת ה-SDK המינימלית של 24 ואילך
    • צריך לקמפל גרסת SDK של 35 ואילך
  • באפליקציות Kotlin, צריך להשתמש בגרסה 1.9 של Kotlin לפחות.

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

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

  1. נכנסים לחשבון 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")

    Groovy

    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.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
}

    Groovy

    dependencies {
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
}

  3. לוחצים על סנכרון עכשיו. פרטים על סנכרון זמינים במאמר בנושא סנכרון פרויקטים עם קובצי Gradle.

הפעלה של Google Mobile Ads SDK (בטא)

מתקשרים אל MobileAds.initialize() כדי להפעיל את Google Mobile Ads SDK (בטא). צריך להפעיל את הפונקציה הזו בשרשור ברקע. אם לא עושים את זה, יכול להיות שתתרחש שגיאה מסוג ANR (האפליקציה לא מגיבה).

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
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 Google Mobile Ads SDK (beta) on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize Google Mobile Ads SDK (beta) on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

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

יכול להיות שמודעות ייטענו מראש על ידי Google Mobile Ads SDK (בטא) או על ידי ערכות SDK של שותפי גישור בזמן האתחול. אם אתם צריכים לקבל הסכמה ממשתמשים באזור הכלכלי האירופי (EEA), להגדיר פלאגים ספציפיים לבקשה, כמו ‫RequestConfiguration.TagForChildDirectedTreatment או ‫RequestConfiguration.TagForUnderAgeOfConsent, או לבצע פעולה אחרת לפני טעינת המודעות, הקפידו לעשות זאת לפני ההפעלה של Google Mobile Ads SDK (בטא).

בחירת פורמט מודעה

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

יחידות של מודעות באנר מוצגות כמלבן שתופס חלק מהפריסה של האפליקציה. יכול להיות שיתבצע רענון אוטומטי של המודעות אחרי פרק זמן מסוים. הרענון האוטומטי יגרום לכך שתוצג למשתמשים מודעה חדשה במרווחי זמן קבועים, גם אם הם יישארו באותו מסך באפליקציה. כמו כן, מודעות באנר הן פורמט המודעה הפשוט ביותר להטמעה.

הטמעת מודעות באנר

מעברון

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

הטמעה של מודעות מעברון

ההטבה הופעלה

יחידות של מודעות מתגמלות מאפשרות למשתמשים לשחק במשחקים, להשתתף בסקרים או לצפות בסרטונים כדי לזכות בתגמולים בתוך האפליקציה, כמו מטבעות, עוד חיים או נקודות. אפשר להגדיר תגמולים שונים ליחידות מודעות שונות ולציין את ערכי התגמולים ואת הפריטים שהמשתמש קיבל.

הטמעה של מודעות מתגמלות

מודעת מעברון מתגמלת

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

בשונה ממודעות מתגמלות רגילות, המשתמשים לא צריכים להביע הסכמה לצפייה במודעת מעברון מתגמלת.

במקום זאת, צריך להציג למשתמשים מסך פתיחה שמתאר את התגמול וכולל אפשרות לסרב לצפות במודעה.

הטמעה של מודעות מעברון מתגמלות

מודעה בפתיחת אפליקציה

מודעה בפתיחת אפליקציה היא פורמט מודעה שמופיע כשמשתמשים פותחים את האפליקציה או חוזרים אליה. המודעה מוצגת כשכבת-על במסך הטעינה של האפליקציה.

הטמעה של מודעות בפתיחת אפליקציה