הגדרה של Google Mobile Ads SDK

בחירת פלטפורמה: ‫Android (בטא) חדש Android iOS Unity Flutter

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

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

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

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

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

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

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

  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:24.9.0")
}

    Groovy

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

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

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

    מחליפים את SAMPLE_APP_ID במזהה האפליקציה ב-Ad Manager. במהלך הבדיקה, משתמשים במזהה האפליקציה לדוגמה שמופיע בדוגמה הקודמת.

    בנוסף, חשוב לדעת שאם לא מוסיפים את התג <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 וקוראת ל-listener של השלמה אחרי ששני האתחולים של Google Mobile Ads SDK ושל המתאם מסתיימים, או אחרי פסק זמן של 30 שניות. צריך לבצע את הפעולה הזו רק פעם אחת, ועדיף בזמן הפעלת האפליקציה.

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

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

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

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();
MyActivity.java

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MyActivity) {}
}
MyActivity.kt

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

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

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

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

מעברון

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

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

מותאם

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

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

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

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

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