שנתחיל?

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

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

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

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

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

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

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

  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.3.0")
    }

    מגניב

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      </application>
    </manifest>
    

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

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

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

מעברון

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

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

מותאם

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

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

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

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

ההטבה הופעלה

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

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

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

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

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

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

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

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

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

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

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

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