הגדרה של GMA Next-Gen SDK

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

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

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

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

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

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

  • גרסת SDK מינימלית של 24 ואילך
  • גרסת SDK של 35 או גרסה חדשה יותר

• באפליקציות Kotlin, צריך להשתמש בגרסה 1.9 ומעלה של Kotlin.

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

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

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

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

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

1. בקובץ ההגדרות של Gradle, צריך לכלול את מאגר ה-Maven של Google ואת מאגר מרכזי:

   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. מוסיפים את יחסי התלות של GMA Next-Gen SDK לקובץ ה-build ברמת האפליקציה:

   Kotlin

   dependencies {
     implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
   }

   Groovy

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

3. לוחצים על Sync Now (סנכרון עכשיו). לפרטים על סנכרון, ראו סנכרון פרויקטים עם קובצי Gradle.

מפעילים את GMA Next-Gen SDK

נקודה חשובה: צריך להפעיל את GMA Next-Gen SDK לפני שטוענים מודעות ומשתמשים בשיטות אחרות של MobileAds, אלא אם צוין אחרת במפורש במסמכי העזרה של ה-API (ראו getVersion()). אחרת, יכול להיות שתיזרק שגיאה מסוג UninitializedPropertyAccessException.

קוראים ל-MobileAds.initialize() כדי להפעיל את GMA Next-Gen 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 GMA Next-Gen SDK 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.
      }
      // SDK initialization is complete. If you don't want to wait for bidding adapters to finish
      // initializing, start loading ads now.
    }
  }
}

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 GMA Next-Gen SDK 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.
                  });
              // SDK initialization is complete. If you don't want to wait for bidding adapters to
              // finish initializing, start loading ads now.
            })
        .start();
  }
}

ה-method הזו מפעילה את ה-SDK וקוראת למאזין להשלמה אחרי שההפעלה של GMA Next-Gen SDK ושל המתאם הושלמה, או אחרי זמן קצוב לתפוגה של 30 שניות. צריך לעשות את זה רק פעם אחת, רצוי בזמן הפעלת האפליקציה.

אם אתם משתמשים בתהליך בחירת הרשת (Mediation) ב-AdMob, צריך להמתין עד שה-completion handler נקרא לפני שטוענים את המודעות. כך אפשר לוודא שכל המתאמים של בחירת הרשת מאותחלים.

הערה: כדי להשתמש ב-Google User Messaging Platform (UMP) SDK, צריך להוסיף את מזהה האפליקציה לקובץ AndroidManifest.xml של האפליקציה. פרטים נוספים זמינים במאמר בנושא הוספת מזהה האפליקציה.

יכול להיות שערכות SDK של GMA Next-Gen SDK או של שותפים בתהליך בחירת הרשת (Mediation) יטענו מראש מודעות בזמן ההפעלה. אם אתם צריכים לקבל הסכמה ממשתמשים באזור הכלכלי האירופי (EEA), בבריטניה או בשווייץ, הגדירו דגלים ספציפיים לבקשה, כמו RequestConfiguration.TagForChildDirectedTreatment או RequestConfiguration.TagForUnderAgeOfConsent, או בצעו פעולה אחרת לפני טעינת המודעות, ודאו שאתם עושים זאת לפני ההפעלה של GMA Next-Gen SDK.

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

GMA Next-Gen SDK מיובא עכשיו ואתם מוכנים להטמיע מודעה. ב-AdMob יש כמה פורמטים שונים של מודעות, כדי שתוכלו לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה שלכם.

מודעת באנר

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

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

מעברון

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

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

מותאמת

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

הטמעת מודעות מותאמות

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

תמונה בתוך תמונה (בטא)

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

הטמעת מודעות בתמונה בתוך תמונה