شروع کنید، شروع کنید

ادغام Google Mobile Ads SDK در یک برنامه اولین قدم برای نمایش تبلیغات و کسب درآمد است. هنگامی که SDK را ادغام کردید، می‌توانید یک قالب تبلیغاتی (مانند ویدیوی بومی یا جایزه دار) را انتخاب کنید و مراحل اجرای آن را دنبال کنید.

قبل از اینکه شروع کنی

برای آماده سازی اپلیکیشن خود، مراحل زیر را انجام دهید.

پیش نیازهای اپلیکیشن

  • مطمئن شوید که فایل ساخت برنامه شما از مقادیر زیر استفاده می کند:

    • minSdkVersion 19 یا بالاتر
    • compileSdkVersion 33 یا بالاتر

برنامه خود را در حساب AdMob خود تنظیم کنید

با انجام مراحل زیر، برنامه خود را به عنوان یک برنامه AdMob ثبت کنید:

  1. به یک حساب AdMob وارد شوید یا برای آن ثبت نام کنید .

  2. برنامه خود را با AdMob ثبت کنید . این مرحله یک برنامه AdMob با شناسه برنامه AdMob منحصر به فرد ایجاد می کند که در ادامه این راهنما مورد نیاز است.

برنامه خود را پیکربندی کنید

  1. در فایل build.gradle در سطح پروژه خود، مخزن Maven Google و مخزن مرکزی Maven را در هر دو بخش buildscript و allprojects قرار دهید:

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. وابستگی‌های Google Mobile Ads SDK را به فایل Gradle سطح برنامه ماژول خود اضافه کنید، معمولا app/build.gradle :

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:22.5.0'
    }
    
  3. شناسه برنامه AdMob خود را، همانطور که در رابط وبAdMobمشخص شده است ، به فایل 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 در یک برنامه 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 مراجعه کنید.

Google Mobile Ads SDK را راه‌اندازی کنید

قبل از بارگیری تبلیغات، از برنامه خود بخواهید با فراخوانی MobileAds.initialize() که SDK را مقداردهی اولیه می کند و پس از تکمیل اولیه یا پس از 30 ثانیه وقفه، شنونده تکمیل را فراخوانی کند. این کار باید فقط یک بار انجام شود، ایده آل در هنگام راه اندازی برنامه.

تبلیغات ممکن است با تماس با MobileAds.initialize() توسط Google Mobile Ads SDK یا SDK های شریک واسطه بارگذاری شوند. اگر نیاز به دریافت رضایت از کاربران در منطقه اقتصادی اروپا (EEA) دارید، هر گونه پرچم‌های خاص درخواست را تنظیم کنید، مانند tagForChildDirectedTreatment یا tag_for_under_age_of_consent ، یا در غیر این صورت قبل از بارگیری تبلیغات اقدامی انجام دهید، مطمئن شوید که این کار را قبل از راه‌اندازی SDK تبلیغات تلفن همراه Google انجام دهید.

در اینجا مثالی از نحوه فراخوانی متد initialize() در یک Activity آورده شده است:

مثال MainActivity (گزیده)

جاوا

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) {
            }
        });
    }
}

کاتلین

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) {}
    }
}

اگر از میانجی‌گری استفاده می‌کنید، منتظر بمانید تا کنترل‌کننده تکمیل قبل از بارگیری تبلیغات فراخوانی شود، زیرا این کار باعث می‌شود که همه آداپتورهای میانجی اولیه اولیه شوند.

یک قالب تبلیغاتی را انتخاب کنید

Google Mobile Ads SDK اکنون وارد شده است و شما آماده اجرای یک تبلیغ هستید.AdMob تعدادی قالب تبلیغاتی مختلف ارائه می‌دهد، بنابراین می‌توانید یکی را انتخاب کنید که با تجربه کاربری برنامه‌تان مطابقت دارد.

تبلیغات مستطیلی که در بالا یا پایین صفحه نمایش دستگاه ظاهر می شوند. تبلیغات بنری در حالی که کاربران در حال تعامل با برنامه هستند روی صفحه می مانند و می توانند پس از مدت زمان معینی به طور خودکار بازخوانی شوند. اگر در زمینه تبلیغات موبایلی تازه کار هستید، آنها مکان خوبی برای شروع هستند.

پیاده سازی تبلیغات بنری

بینابینی

تبلیغات تمام صفحه که رابط یک برنامه را تا زمانی که توسط کاربر بسته شود پوشش می دهند. آنها به بهترین وجه در توقف های طبیعی در جریان اجرای برنامه، مانند بین سطوح یک بازی یا درست پس از اتمام یک کار، استفاده می شوند.

اجرای تبلیغات بینابینی

بومی

تبلیغات قابل تنظیم که با ظاهر و احساس برنامه شما مطابقت دارند. شما تصمیم می گیرید که چگونه و در کجا قرار گیرند، بنابراین طرح بندی با طراحی برنامه شما سازگارتر است.

تبلیغات بومی را پیاده سازی کنید

پاداش داده شد

تبلیغاتی که به کاربران برای تماشای ویدیوهای کوتاه و تعامل با تبلیغات و نظرسنجی‌های قابل پخش پاداش می‌دهد. برای کسب درآمد از برنامه های بازی رایگان استفاده می شود.

اجرای تبلیغات با پاداش

منابع اضافی

مخزن Google Mobile Ads در GitHub نحوه استفاده از قالب‌های تبلیغاتی مختلف را که این API ارائه می‌دهد، نشان می‌دهد.