התחל בעבודה

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

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

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

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

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

    • גרסת SDK מינימלית של 21 ואילך
    • גרסת SDK של 34 ואילך

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

  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.gms:play-services-ads:23.5.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.5.0'
}

  3. מוסיפים את מזהה האפליקציה ב-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="
/<network_code>~<application_id>"/>
  </application>
</manifest>

    באפליקציה אמיתית, מחליפים את מזהה האפליקציה לדוגמה במזהה האפליקציה בפועל ב-Ad Manager. אפשר להשתמש במזהה לדוגמה אם אתם רק מתנסים ב-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 של השותף לתהליך בחירת הרשת בזמן ההפעלה. אם אתם צריכים לקבל הסכמה ממשתמשים באזור הכלכלי האירופי (EEA), צריך להגדיר דגלים ספציפיים לבקשה, כמו setTagForChildDirectedTreatment() או setTagForUnderAgeOfConsent(), או לבצע פעולה אחרת לפני טעינת המודעות. חשוב לוודא שאתם עושים זאת לפני שאתם מפעילים את Google Mobile Ads SDK.

דוגמה לאופן שבו מפעילים את השיטה initialize() בשרשור רקע בתוך Activity:

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 יובא ועכשיו אתם מוכנים להטמיע מודעה. ב-Ad Manager יש כמה פורמטים שונים של מודעות, כך שתוכלו לבחור את הפורמט שמתאים ביותר לחוויית המשתמש באפליקציה.

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

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

מעברון

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

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

מותאם

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

ב-Google Ad Manager יש שתי דרכים להטמיע מודעות מותאמות: סגנונות מותאמים ומודעות מותאמות רגילות באמצעות עיבוד בהתאמה אישית.

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

הטמעת סגנונות מותאמים הטמעת מודעות מותאמות (רינדור בהתאמה אישית)

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

מקורות מידע נוספים

במאגר של Google Mobile Ads ב-GitHub מוסבר איך להשתמש בפורמטים השונים של המודעות שזמינים ב-API הזה.