راه‌اندازی SDK تبلیغات موبایلی گوگل، راه‌اندازی SDK تبلیغات موبایلی گوگل

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر ، اندروید (قدیمی)

برای ارائه تبلیغات و کسب درآمد، Google Mobile Ads SDK را در برنامه iOS خود ادغام کنید. برای آماده‌سازی پروژه خود، قبل از درخواست تبلیغات Google Mobile Ads SDK را وارد و مقداردهی اولیه می‌کنید.

اگر Firebase را در برنامه iOS خود گنجانده‌اید، به بخش «شروع کار با AdMob در پروژه iOS» مراجعه کنید.

این راهنما، وارد کردن و مقداردهی اولیه Google Mobile Ads SDK و انتخاب فرمت تبلیغ را پوشش می‌دهد.

پیش‌نیازها

قبل از ادامه، مطمئن شوید که موارد زیر را دارید:

• از Xcode نسخه ۱۶.۰ یا بالاتر استفاده کنید.
• iOS 13.0 یا بالاتر را هدف قرار دهید.

• در AdMob ثبت نام کنید و یک برنامه در AdMob تنظیم کنید .

وارد کردن Google Mobile Ads SDK

برای وارد کردن Google Mobile Ads SDK ، یکی از بخش‌های زیر را تکمیل کنید:

مدیر بسته سوئیفت

برای اضافه کردن یک وابستگی پکیج به پروژه خود، مراحل زیر را دنبال کنید:

1. ایکس‌کد را باز کنید.
2. به مسیر File > Add Package Dependencies... بروید.

3. بسته‌ی سویفت Google Mobile Ads SDK را نصب کنید.

4. در پنجره‌ای که ظاهر می‌شود، مخزن گیت‌هاب بسته‌ی Swift Ads Mobile Ads گوگل را جستجو کنید:

   https://github.com/googleads/swift-package-manager-google-mobile-ads.git
   

5. نسخه‌ای از بسته نرم‌افزاری Swift Google Mobile Ads SDK را که می‌خواهید استفاده کنید، انتخاب کنید. برای پروژه‌های جدید، توصیه می‌کنیم از Up to Next Major Version استفاده کنید.

کوکوپادز

برای استفاده از CocoaPods ، مراحل زیر را دنبال کنید:

1. Podfile پروژه خود را باز کنید و این خط را به پیکربندی ساخت target برنامه خود اضافه کنید:

   pod 'Google-Mobile-Ads-SDK'

2. در ترمینال، اجرا کنید:

   pod install --repo-update

دانلود دستی

برای دانلود دستی Google Mobile Ads SDK ، مراحل زیر را انجام دهید:

1. دانلود Google Mobile Ads SDK .
2. بسته googlemobileadssdkios.zip را از حالت فشرده خارج کنید.

3. در پروژه Xcode خود، فریم‌ورک‌های زیر را اضافه کنید:

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

4. در تنظیمات عمومی (General settings) دستگاه هدف خود، به سراغ فریم‌ورک‌ها (Frameworks)، کتابخانه‌ها (Libraries) و محتوای جاسازی‌شده (Embedded Content) بروید.

5. تأیید کنید که GoogleMobileAds.xcframework و UserMessagingPlatform.xcframework را روی Embed & Sign تنظیم کرده‌اید.

6. در تنظیمات ساخت پروژه خود، موارد زیر را انجام دهید:

   • مسیر /usr/lib/swift را به Runpath Search Paths اضافه کنید.
   • پرچم پیونددهنده‌ی -ObjC را به پرچم‌های پیونددهنده‌ی دیگر اضافه کنید.

فایل Info.plist خود را به‌روزرسانی کنید

در فایل Info.plist برنامه خود، کلیدهای زیر را اضافه کنید:

• یک کلید GADApplicationIdentifier با مقدار رشته‌ای از شناسه برنامه AdMob شما. برای جزئیات بیشتر، به «یافتن و کپی کردن شناسه برنامه یا شناسه واحد تبلیغاتی» مراجعه کنید.

• یک کلید SKAdNetworkItems . این کلید شامل مقادیر SKAdNetworkIdentifier برای Google cstr6suwn9.skadnetwork و خریداران شخص ثالث منتخب است .

مثال کامل

<key>GADApplicationIdentifier</key>
<!-- Sample AdMob app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wg4vff78zm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>44jx6755aq.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>k674qkevps.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbmxgpxpgc.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c3frkrj4fj.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>97r2b46745.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

SAMPLE_APP_ID با شناسه برنامه AdMob خود جایگزین کنید. هنگام آزمایش، از شناسه برنامه نمونه نشان داده شده در مثال قبلی استفاده کنید.

اگر هنوز حساب کاربری AdMob ایجاد نکرده‌اید و اپلیکیشنی ثبت نکرده‌اید ، اکنون زمان بسیار خوبی برای انجام این کار است.

مقداردهی اولیه Google Mobile Ads SDK

قبل از بارگذاری تبلیغات، با فراخوانی متد start() از ویژگی GADMobileAds.sharedInstance ، Google Mobile Ads SDK را مقداردهی اولیه کنید. این متد پس از اتمام پردازش Google Mobile Ads SDK و آداپتورهای واسطه، یا پس از 30 ثانیه، یک completion handler را فراخوانی می‌کند.

مثال زیر Google Mobile Ads SDK را مقداردهی اولیه می‌کند:

سویفت

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()
ViewController.swift

سویفت‌یو‌آی

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()
GoogleMobileAdsConsentManager.swift

هدف-سی

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];
ViewController.m

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

انتخاب قالب تبلیغ

پس از وارد کردن Google Mobile Ads SDK ، می‌توانید یک قالب تبلیغاتی را برای پیاده‌سازی انتخاب کنید.

ادموب قالب‌های تبلیغاتی زیر را ارائه می‌دهد:

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