Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Thiết lập SDK quảng cáo trên thiết bị di động của Google

Chọn nền tảng: Android iOS Unity Flutter Android (Cũ)

Để phân phối quảng cáo và kiếm doanh thu, hãy tích hợp Google Mobile Ads SDK vào ứng dụng iOS của bạn. Để chuẩn bị cho dự án, bạn sẽ nhập và khởi chạy Google Mobile Ads SDK trước khi yêu cầu quảng cáo.

Hướng dẫn này trình bày cách nhập và khởi chạy Google Mobile Ads SDK, cũng như cách chọn một định dạng quảng cáo.

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

Trước khi tiếp tục, hãy đảm bảo bạn có những thông tin sau:

Sử dụng Xcode 16.0 trở lên.
Nhắm đến iOS 13.0 trở lên.

Nhập Google Mobile Ads SDK

Để nhập Google Mobile Ads SDK, hãy hoàn tất một trong các phần sau:

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

Để thêm một phần phụ thuộc gói vào dự án, hãy làm theo các bước sau:

Mở Xcode.
Chuyển đến File > Add Package Dependencies... (Tệp > Thêm phần phụ thuộc của gói...).
Cài đặt Gói Swift Google Mobile Ads SDK.
Khi thông báo nhắc xuất hiện, hãy tìm kiếm kho lưu trữ GitHub cho Gói Swift quảng cáo trên thiết bị di động của Google:
```
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
```
Chọn phiên bản của Gói Google Mobile Ads SDK Swift 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 lớn tiếp theo.

CocoaPods

Để sử dụng CocoaPods, hãy làm theo các bước sau:

Hãy mở Podfile của dự án rồi thêm dòng này vào cấu hình bản dựng target của ứng dụng:
```
pod 'Google-Mobile-Ads-SDK'
```
Trong một cửa sổ dòng lệnh, hãy chạy:
```
pod install --repo-update
```

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

Để tải Google Mobile Ads SDK xuống theo cách thủ công, hãy làm như sau:

Tải xuống Google Mobile Ads SDK.
Giải nén gói googlemobileadssdkios.zip.
Trong dự án Xcode, hãy thêm các khung sau:
- GoogleMobileAds.xcframework
- UserMessagingPlatform.xcframework
Trong phần cài đặt Chung của mục tiêu, hãy chuyển đến Frameworks, Libraries, and Embedded Content (Khung, thư viện và nội dung được nhúng).
Xác nhận rằng bạn đã đặt GoogleMobileAds.xcframework và UserMessagingPlatform.xcframework thành Nhúng và ký.
Trong phần cài đặt bản dựng của dự án, hãy làm như sau:
- Thêm đường dẫn /usr/lib/swift vào Runpath Search Paths (Đường dẫn tìm kiếm Runpath).
- Thêm cờ trình liên kết -ObjC vào Cờ trình liên kết khác.

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

Trong tệp Info.plist của ứng dụng, hãy thêm các khoá sau:

Một khoá GADApplicationIdentifier có giá trị chuỗi là mã ứng dụng Ad Manager của bạn trong giao diện người dùng Ad Manager và có dạng ca-app-pub-################~##########.
Khoá SKAdNetworkItems. Khoá này bao gồm các giá trị SKAdNetworkIdentifier cho Google cstr6suwn9.skadnetwork và một số người mua bên thứ ba.

Ví dụ đầy đủ

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager 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>

Thay thế SAMPLE_APP_ID bằng mã ứng dụng Ad Manager của bạn. Trong khi kiểm thử, hãy sử dụng mã ứng dụng mẫu xuất hiện trong ví dụ trước.

Để giúp ứng dụng khởi chạy nhanh hơn, hãy liên kết các nhóm lợi nhuận với những ứng dụng cụ thể. Nếu một nhóm lợi nhuận nhắm đến iOS nhưng không được liên kết với một ứng dụng, thì Google sẽ gửi nhóm đó đến tất cả ứng dụng iOS trong tài khoản của bạn. Phương pháp này có thể làm giảm hiệu suất.

Khởi chạy Google Mobile Ads SDK

Trước khi tải quảng cáo, hãy khởi chạy Google Mobile Ads SDK bằng cách gọi phương thức start() từ thuộc tính GADMobileAds.sharedInstance. Phương thức này gọi một trình xử lý hoàn thành sau khi Google Mobile Ads SDK và các bộ điều hợp dàn xếp hoàn tất quá trình xử lý hoặc sau 30 giây.

Ví dụ sau đây khởi động Google Mobile Ads SDK:

Swift

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

SwiftUI

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

Objective-C

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

Khi khởi chạy, Google Mobile Ads SDK có thể tải trước quảng cáo hoặc khởi chạy SDK của bên thứ ba khi gọi phương thức startWithCompletionHandler:. Nếu bạn cần có sự đồng ý của người dùng ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh (UK) hoặc Thuỵ Sĩ, hãy đặt các cờ riêng cho từng yêu cầu. Nếu cần đặt các cờ dành riêng cho yêu cầu, hãy nhớ đặt các cờ này trước khi khởi chạy Google Mobile Ads SDK. Để biết thông tin chi tiết, hãy xem phần Nhắm mục tiêu.

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

Sau khi nhập Google Mobile Ads SDK, bạn có thể chọn một định dạng quảng cáo để triển khai.

Ad Manager cung cấp các định dạng quảng cáo sau:

Định dạng quảng cáo	Mô tả	Tài liệu
Biểu ngữ	Hiển thị quảng cáo hình chữ nhật trong một phần bố cục của ứng dụng. Quảng cáo này tự động làm mới theo khoảng thời gian đã đặt. Người dùng sẽ thấy những quảng cáo này theo định kỳ khi ở trên cùng một màn hình.	Thiết lập quảng cáo biểu ngữ
Quảng cáo xen kẽ	Hiển thị quảng cáo toàn trang trong ứng dụng của bạn. Hãy đặt quảng cáo này tại các điểm ngắt và điểm chuyển tiếp tự nhiên trong giao diện ứng dụng của bạn, chẳng hạn như sau khi người dùng hoàn thành một cấp độ trong một ứng dụng trò chơi.	Quảng cáo xen kẽ
Mã gốc	Cho phép bạn tuỳ chỉnh các thành phần, chẳng hạn như dòng tiêu đề và lời kêu gọi hành động, trong ứng dụng của mình. Khi tuỳ chỉnh quảng cáo, bạn sẽ tạo ra những quảng cáo phù hợp với thiết kế hình ảnh của ứng dụng.	Tải quảng cáo gốc
Được thưởng	Người dùng nhận được phần thưởng trong ứng dụng (như tiền xu hoặc điểm) bằng cách chơi trò chơi, làm bài khảo sát hoặc xem video. Bạn có thể đặt phần thưởng cho các đơn vị quảng cáo, cũng như chỉ định giá trị phần thưởng và vật phẩm mà người dùng sẽ nhận được.	Quảng cáo có tặng thưởng
Quảng cáo xen kẽ có tặng thưởng	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 xuất hiện trong quá trình chuyển đổi ứng dụng.	Quảng cáo xen kẽ có tặng thưởng
Quảng cáo khi mở ứng dụng	Xuất hiện khi người dùng mở hoặc quay lại ứng dụng của bạn. Quảng cáo này phủ lên màn hình tải.	Quảng cáo khi mở ứng dụng

Thiết lập SDK quảng cáo trên thiết bị di động của Google Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.