שנתחיל?

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

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

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

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

  • Android מגרסה 3.2 ואילך

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

    • minSdkVersion מתוך 19 או יותר
    • compileSdkVersion מתוך 28 או יותר

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

  1. בקובץ build.gradle ברמת הפרויקט, צריך לכלול את מאגר Maven ב-Google ואת המאגר המרכזי של Maven בקטעים buildscript ו-allprojects:

    buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

  2. מוסיפים את יחסי התלות של ה-SDK של Google Mobile Ads לקובץ Gradle ברמת האפליקציה, בדרך כלל ב-app/build.gradle:

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:22.1.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> כפי שמוצג למעלה, תתבצע קריסה עם ההודעה:

    The Google Mobile Ads SDK was initialized incorrectly.

    (אופציונלי) מצהירים על הרשאה של 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 הצהרת ההרשאה, כולל הוראות להשבתת ההרשאה, אפשר לקרוא את המאמר של Playsole.

מפעילים את Google Mobile Ads SDK

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

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

הנה דוגמה לקריאה לשיטה 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);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}
    }
}

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

בחירה של פורמט מודעה

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

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

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

פרסומת מרווח ביניים

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

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

מותאמת

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

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

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

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

ההטבה הופעלה

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

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

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

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