הגדרה של Google Mobile Ads SDK (גרסה קודמת)

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

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

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

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

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

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

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

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

  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. מוסיפים את יחסי התלות של Google Mobile Ads SDK (Legacy) לקובץ ה-build ברמת האפליקציה:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.5.0")
}

    Groovy

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

  3. לוחצים על Sync Now (סנכרון עכשיו). לפרטים על סנכרון, ראו סנכרון פרויקטים עם קובצי 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 (Legacy) בגרסה 20.4.0 ומעלה, אפשר לדלג על השלב הזה כי ה-SDK מצהיר באופן אוטומטי על ההרשאה com.google.android.gms.permission.AD_ID ויכול לגשת למזהה הפרסום כשהוא זמין.

    באפליקציות שמשתמשות בגרסה 20.3.0 ומטה של Google Mobile Ads SDK (Legacy) ומטרגטות ל-Android 13, צריך להוסיף את ההרשאה com.google.android.gms.permission.AD_ID בקובץ AndroidManifest.xml כדי ש-Google Mobile Ads SDK (Legacy) יוכל לגשת למזהה הפרסום:

    <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 (Legacy)

לפני שטוענים מודעות, צריך להפעיל את Google Mobile Ads SDK (Legacy) באמצעות קריאה ל-MobileAds.initialize().

ה-method הזו מפעילה את ה-SDK וקוראת למאזין להשלמה אחרי שההפעלה של Google Mobile Ads SDK (Legacy) ושל המתאם הושלמה, או אחרי זמן קצוב לתפוגה של 30 שניות. צריך לעשות את זה רק פעם אחת, רצוי בזמן הפעלת האפליקציה.

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

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

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

Java

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

Kotlin

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

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

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

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

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

מעברון

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

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

מותאמת

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

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

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

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

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