מתחילים!

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

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

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

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

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

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

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

הגדרת האפליקציה בחשבון AdMob

כדי לרשום את האפליקציה כאפליקציה ב-AdMob, יש לבצע את השלבים הבאים:

  1. נכנסים לחשבון או נרשמים לחשבון AdMob.

  2. רושמים את האפליקציה ב-AdMob. השלב הזה יוצר אפליקציה ב-AdMob עם מזהה אפליקציה ייחודי ב-AdMob הנדרש בהמשך המדריך.

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

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

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. מוסיפים את יחסי התלות של ה-SDK של Google Mobile Ads לקובץ ה-Gredle ברמת האפליקציה, בדרך כלל app/build.gradle:

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:21.3.0'
    }
    
  3. מוסיפים את AdMob מזהה האפליקציה (המזוהה בממשק AdMob UI) לקובץ ה-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 באפליקציה שלום עולם, תוכלו להשתמש במזהה האפליקציה לדוגמה שמוצג למעלה.

    חשוב לשים לב שגם אם לא מוסיפים את התג <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, כולל הנחיות להשבתה שלה, אפשר לעיין במאמר זה ב-Play Console.

הפעלה של Google Mobile Ads SDK

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

ניתן לטעון מראש את המודעות באמצעות Google Mobile Ads SDK או SDK של תהליך בחירת הרשת (Mediation) כשמפעילים קריאה ל-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 ועכשיו אפשר להטמיע מודעה. AdMob יש לך כמה פורמטים שונים של מודעות, כך שאפשר לבחור את הפורמט שהכי מתאים לחוויית המשתמש באפליקציה שלך.

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

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

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

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

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

מותאמת

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

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

ההטבה הופעלה

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

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

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

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