מתחילים!

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

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

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

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

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

    • minSdkVersion מתוך 19 ומעלה
    • compileSdkVersion מתוך 28 ומעלה

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

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

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

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

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

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

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

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

    באפליקציה אמיתית, יש להשתמש במזהה app 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 בקובץ SDK של Google Mobile Ads כדי לגשת למזהה הפרסום:

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

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

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

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

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

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

מעברון

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

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

מקומי

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

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

ההטבה הופעלה

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

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

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

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