שנתחיל?

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

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

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

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

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

    • גרסת SDK מינימלית של 21 ומעלה
    • הידור גרסת ה-SDK של 33 ומעלה

הגדרת האפליקציה בחשבון 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")

    מגניב

    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 ברמת האפליקציה file:

    Kotlin

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

    מגניב

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

  3. יש להוסיף את AdMob מזהה האפליקציה, כפי שמזוהה ב AdMob לממשק האינטרנט של האפליקציה קובץ AndroidManifest.xml. כדי לעשות זאת, צריך להוסיף תג <meta-data> עם android:name="com.google.android.gms.ads.APPLICATION_ID". טיפים נוספים לאופטימיזציה מפורטים מזהה האפליקציה ב AdMob ממשק האינטרנט. עבור android:value, עליך להזין את AdMob מזהה האפליקציה שלך, שמוקף במירכאות.

    <manifest>
  <application>
    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>

    באפליקציה אמיתית, יש להחליף את מזהה האפליקציה לדוגמה באמת AdMob מזהה האפליקציה. תוכלו להשתמש במזהה לדוגמה אם בחרת להתנסות ב-SDK באפליקציה Hello World.

    בנוסף, חשוב לשים לב שאי אפשר להוסיף את התג <meta-data> בדיוק כמו בתוצאות שמוצגות קריסה עם ההודעה:

    Missing application ID.

    (אופציונלי) הצהרה הרשאה AD_ID לגרסאות קודמות שיעבדו עם Android 13.

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

הפעלה של Google Mobile Ads SDK

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

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

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

הנה דוגמה לקריאה ל-method initialize() ברקע שרשור בתוך פעילות:

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

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

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

מעברון

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

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

מותאם

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

משאבים נוספים

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