דף זה תורגם על ידי Cloud Translation API.

מתחילים!

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

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

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

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

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

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

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

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

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

בקובץ build.gradle ברמת הפרויקט, כוללים את המאגר של Maven ב-Google ואת המאגר המרכזי של Maven בקטעים buildscript ו-allprojects:
```
buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}
```
מוסיפים את יחסי התלות של Google Mobile Ads SDK לקובץ Gradle ברמת האפליקציה, בדרך כלל app/build.gradle:
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:21.5.0'
}
```
מוסיפים את AdMob מזהה האפליקציה (שמזהה ב-AdMob ממשק המשתמש) לקובץ ה-AndroidManifest.xml של האפליקציה. לשם כך יש להוסיף תג <meta-data> באמצעות התג android:name="com.google.android.gms.ads.APPLICATION_ID". מזהה האפליקציה מופיע בממשק המשתמש AdMob . עבור android:value, צריך להזין מזהה אפליקציה AdMob משלך המוקף במירכאות.
```
<manifest>
    <application>
        
        <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> כפי שמוצג למעלה, מתרחשת קריסה עם ההודעה:
```
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

לפני טעינת המודעות, צריך להפעיל את האפליקציה כדי להפעיל את Google Mobile Ads SDK באמצעות קריאה ל-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) {}
    }
}

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

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

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

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

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

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

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

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

מותאמת

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

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

ההטבה הופעלה

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

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

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

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