Bắt đầu

Hướng dẫn này dành cho những nhà xuất bản muốn kiếm tiền từ ứng dụng iOS thông qua AdMob và không sử dụng Firebase. Nếu bạn định đưa Firebase vào ứng dụng của mình (hoặc bạn đang cân nhắc), hãy xem AdMob với Firebase của hướng dẫn này.

Bước đầu tiên để tích hợp SDK Quảng cáo của Google trên thiết bị di động là vào một ứng dụng hiển thị quảng cáo và tạo ra doanh thu. Sau khi tích hợp SDK, bạn có thể hãy tiến hành triển khai một hoặc nhiều định dạng quảng cáo được hỗ trợ.

Điều kiện tiên quyết

• Sử dụng Xcode 15.3 trở lên
• Nhắm đến iOS 12.0 trở lên

• Bạn nên: Tạo tài khoản AdMob và đăng ký ứng dụng.

Nhập SDK quảng cáo trên thiết bị di động

Sử dụng một trong các phương pháp sau để nhập SDK Quảng cáo của Google trên thiết bị di động.

CocoaPods (ưu tiên)

Cách đơn giản nhất để nhập SDK vào một dự án iOS là sử dụng CocoaPods Đang mở cửa Podfile của dự án và thêm dòng này vào mục tiêu của ứng dụng:

pod 'Google-Mobile-Ads-SDK'

Sau đó, từ dòng lệnh, hãy chạy:

pod install --repo-update

Nếu bạn mới sử dụng CocoaPods, hãy xem tài liệu chính thức để biết thông tin về cách tạo và sử dụng Podfile.

Trình quản lý gói Swift

Lưu ý quan trọng: Thư viện bộ chuyển đổi dàn xếp chưa có trong Gói Swift Người quản lý. Nếu bạn sử dụng tính năng dàn xếp, chúng tôi bạn nên tích hợp với CocoaPods.

SDK Quảng cáo của Google trên thiết bị di động hỗ trợ Gói Swift Manager kể từ phiên bản 9.0.0. Làm theo các bước sau các bước để nhập gói Swift:

Lưu ý: Nếu di chuyển từ dự án dựa trên CocoaPods, hãy chạy pod deintegrate sang hãy xoá CocoaPods khỏi dự án Xcode của bạn. .xcworkspace do CocoaPods tạo có thể được xoá an toàn sau đó. Nếu bạn đang thêm SDK quảng cáo trên thiết bị di động của Google đối với một dự án lần đầu tiên, thì bạn có thể bỏ qua bước này.

1. Trong Xcode, hãy cài đặt Gói Swift quảng cáo trên thiết bị di động của Google bằng cách chuyển đến Tệp > Thêm gói....

2. Khi thông báo xuất hiện, hãy tìm gói Swift cho quảng cáo trên thiết bị di động của Google Kho lưu trữ GitHub:

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

3. Chọn phiên bản của Gói Swift quảng cáo trên thiết bị di động của Google mà bạn muốn sử dụng. Đối với các dự án mới, bạn nên sử dụng phiên bản Up to Next Major Version (Lên phiên bản lớn tiếp theo).

Sau khi bạn hoàn tất, Xcode sẽ bắt đầu phân giải các phần phụ thuộc của gói và tải chúng xuống trong nền. Để biết thêm chi tiết về cách thêm gói phần phụ thuộc, hãy xem bài viết của Apple.

Tải xuống theo cách thủ công

1. Tải SDK Quảng cáo của Google trên thiết bị di động xuống và Embed & Sign các khung sau vào dự án Xcode của bạn:

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. Thêm cờ trình liên kết -ObjC vào Cờ trình liên kết khác trong cài đặt bản dựng:

   

Cập nhật tệp Info.plist

Cập nhật tệp Info.plist của ứng dụng để thêm hai khoá:

1. Khoá GADApplicationIdentifier có giá trị chuỗi là AdMob app ID found in the AdMob UI

2. Khoá SKAdNetworkItems có SKAdNetworkIdentifier giá trị cho Google (cstr6suwn9.skadnetwork) và một số người mua bên thứ ba đã cung cấp các giá trị này cho Google.

Đoạn mã hoàn chỉnh

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</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>4pfyvq9l8r.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>5a6flpkh64.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>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>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.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>n6fk4nfna4.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>eh6m2bh4zr.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>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>ecpz2srf59.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>pwa73g5rt2.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.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>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>zq492l623r.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Nếu bạn chưa tạo AdMob tài khoản và đã đăng ký một tài khoản , bây giờ là thời điểm thích hợp để làm điều đó.

Trong ứng dụng thực tế, hãy thay thế mã ứng dụng mẫu bằng mã ứng dụng thực tế AdMob mã ứng dụng. Bạn có thể sử dụng mã mẫu nếu bạn chỉ đang thử nghiệm với SDK trong ứng dụng Hello World.

Chạy SDK quảng cáo trên thiết bị di động

Trước khi tải quảng cáo, hãy gọi phương thức startWithCompletionHandler: trên GADMobileAds.sharedInstance, Thao tác này sẽ khởi chạy SDK và gọi lại trình xử lý hoàn thành một lần khởi chạy hoàn tất (hoặc sau thời gian chờ 30 giây). Bạn chỉ cần thực hiện một lần, tốt nhất là khi khởi chạy ứng dụng. Bạn nên gọi startWithCompletionHandler: càng sớm càng tốt.

Cảnh báo: SDK quảng cáo trên thiết bị di động hoặc SDK của đối tác dàn xếp có thể tải trước quảng cáo sau khi gọi startWithCompletionHandler:. Nếu bạn cần có được sự đồng ý của người dùng ở Khu vực kinh tế Châu Âu (EEA), hãy đặt mọi cờ theo yêu cầu cụ thể (chẳng hạn như dưới dạng tagForChildDirectedTreatment hoặc tag_for_under_age_of_consent) hoặc nếu không, hãy thực hiện hành động trước khi tải quảng cáo, hãy nhớ thực hiện trước khi khởi chạy SDK quảng cáo trên thiết bị di động.

Dưới đây là ví dụ về cách gọi phương thức startWithCompletionHandler: trong AppDelegate của bạn:

AppDelegate mẫu (phần trích dẫn)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }
}

SwiftUI

import GoogleMobileAds

class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }
}

@main
struct YourApp: App {
  // To handle app delegate callbacks in an app that uses the SwiftUI lifecycle,
  // you must create an application delegate and attach it to your `App` struct
  // using `UIApplicationDelegateAdaptor`.
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds.sharedInstance startWithCompletionHandler:nil];
  return YES;
}

@end

Lưu ý: Nếu bạn đang sử dụng tính năng dàn xếp, hãy đợi cho đến khi trình xử lý hoàn thành được gọi trước khi tải quảng cáo để đảm bảo rằng tất cả các bộ chuyển đổi dàn xếp đều được khởi chạy.

Chọn định dạng quảng cáo

SDK quảng cáo trên thiết bị di động hiện đã được nhập và khởi chạy, và bạn đã sẵn sàng hãy triển khai quảng cáo. AdMob cung cấp một số nhiều định dạng quảng cáo khác nhau, vì vậy, bạn có thể chọn định dạng phù hợp nhất với người dùng ứng dụng của bạn của bạn.

Đối với nhà phát triển SwiftUI, hãy làm theo SwiftUI của chúng tôi hướng dẫn.

Biểu ngữ

Đơn vị quảng cáo biểu ngữ hiển thị quảng cáo hình chữ nhật chiếm một phần của bạn. Những quảng cáo này có thể tự động làm mới sau một khoảng thời gian nhất định. Điều này có nghĩa là người dùng xem một quảng cáo mới đều đặn, ngay cả khi họ không thay đổi trong ứng dụng của bạn. Đây cũng là định dạng quảng cáo triển khai đơn giản nhất.

Triển khai quảng cáo biểu ngữ

Quảng cáo xen kẽ

Đơn vị quảng cáo xen kẽ hiển thị quảng cáo toàn trang trong ứng dụng của bạn. Đặt chúng ở vị trí tự nhiên điểm ngắt và chuyển tiếp trong giao diện của ứng dụng, chẳng hạn như sau khi hoàn thành cấp độ trong một ứng dụng trò chơi.

Triển khai quảng cáo xen kẽ

Mã gốc

Quảng cáo gốc là quảng cáo mà bạn có thể tuỳ chỉnh cách thức các thành phần như dòng tiêu đề và lời kêu gọi hành động hiển thị trong ứng dụng của bạn. Bằng cách tự tạo kiểu cho quảng cáo, bạn có thể tạo bản trình bày quảng cáo tự nhiên, không phô trương có thể thêm vào người dùng phong phú của bạn.

Triển khai quảng cáo gốc

Được thưởng

Đơn vị quảng cáo có tặng thưởng cho phép người dùng chơi trò chơi, thực hiện các cuộc khảo sát hoặc xem video để nhận phần thưởng trong ứng dụng, chẳng hạn như xu, thêm mạng hoặc điểm. Bạn có thể đặt các phần thưởng khác nhau cho các đơn vị quảng cáo khác nhau, đồng thời chỉ định giá trị phần thưởng và các mục mà người dùng đã nhận được.

Triển khai quảng cáo có tặng thưởng

Quảng cáo xen kẽ có tặng thưởng

Quảng cáo xen kẽ có tặng thưởng là một loại định dạng quảng cáo có trả thưởng mới cho phép bạn tặng thưởng, chẳng hạn như tiền xu hoặc thêm mạng, cho những quảng cáo tự động xuất hiện trong quá trình chuyển đổi ứng dụng tự nhiên.

Không giống như quảng cáo có tặng thưởng, người dùng không bắt buộc phải chọn xem quảng cáo có tặng thưởng quảng cáo xen kẽ.

Thay vì đưa ra lời nhắc chọn xem trong quảng cáo có tặng thưởng, quảng cáo xen kẽ có tặng thưởng cần có màn hình giới thiệu công bố phần thưởng và cho phép người dùng chọn không tham gia họ muốn làm như vậy.

Triển khai quảng cáo xen kẽ có tặng thưởng

Quảng cáo khi mở ứng dụng

Quảng cáo khi mở ứng dụng là định dạng quảng cáo xuất hiện khi người dùng mở hoặc quay lại . Quảng cáo phủ lên màn hình tải.

Triển khai quảng cáo khi mở ứng dụng