Dàn xếp

Hướng dẫn này cho bạn biết cách tích hợp bộ chuyển đổi dàn xếp với ứng dụng Flutter.

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

Trước khi có thể tích hợp tính năng dàn xếp cho một định dạng quảng cáo, bạn cần tích hợp định dạng quảng cáo đó vào ứng dụng của mình:

Bạn mới sử dụng tính năng dàn xếp? Hãy đọc Giới thiệu về tính năng Dàn xếp.

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

Hướng dẫn bắt đầu nhanh cho bạn biết cách khởi chạy SDK quảng cáo trên thiết bị di động. Trong lệnh gọi khởi chạy đó, các bộ chuyển đổi dàn xếp và đặt giá thầu cũng được khởi chạy. Bạn cần phải đợi quá trình khởi chạy hoàn tất trước khi tải quảng cáo để đảm bảo mọi mạng quảng cáo đều có sự tham gia đầy đủ trong yêu cầu quảng cáo đầu tiên.

Mã mẫu sau đây cho bạn biết cách kiểm tra trạng thái khởi chạy của từng bộ chuyển đổi trước khi thực hiện yêu cầu quảng cáo.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Cập nhật chế độ cài đặt gradle (chỉ dành cho Android)

Thêm các dòng sau vào tệp settings.gradle để bạn có thể sử dụng API Android của trình bổ trợ:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

Thêm phần phụ thuộc cho các mạng đối tác

Bạn cần thêm bộ chuyển đổi dàn xếp và các phần phụ thuộc của bộ chuyển đổi đó vào dự án Android và iOS. Bạn có thể thêm các thành phần này bằng cách cập nhật tệp build.gradle cấp ứng dụng trên Android và Podfile trên iOS. Google có các bộ chuyển đổi nguồn mở trong GitHub cho cả Android và iOS.

Hãy xem tài liệu về Android và iOS cho từng mạng đối tác để biết hướng dẫn chi tiết về cách thêm bộ chuyển đổi vào ứng dụng của bạn.

Kiểm tra xem lớp bộ chuyển đổi nào của mạng quảng cáo đã tải quảng cáo

Mã mẫu sau đây minh hoạ cách ghi lại tên lớp mạng quảng cáo cho một quảng cáo biểu ngữ:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

Hãy nhớ tắt tính năng làm mới trong tất cả giao diện người dùng của mạng quảng cáo bên thứ ba cho đơn vị quảng cáo biểu ngữ dùng trong tính năng dàn xếp Ad Manager. Điều này giúp tránh xảy ra hiện tượng làm mới hai lần vì Ad Manager cũng kích hoạt một lần làm mới dựa trên tốc độ làm mới của đơn vị quảng cáo biểu ngữ.

Dàn xếp quảng cáo gốc

Sau đây là một số phương pháp hay nhất cần xem xét khi triển khai tính năng dàn xếp gốc.

Chính sách về bản trình bày quảng cáo gốc
Mỗi mạng quảng cáo đều có chính sách riêng. Khi sử dụng tính năng dàn xếp, bạn nên lưu ý rằng ứng dụng của bạn vẫn phải tuân thủ các chính sách của mạng được dàn xếp đã cung cấp quảng cáo.

Luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ và GDPR

Nếu bạn cần tuân thủ luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ hoặc Quy định chung về việc bảo vệ dữ liệu (GDPR), hãy làm theo các bước trong phần cài đặt quy định của các tiểu bang ở Hoa Kỳ hoặc Cài đặt GDPR để thêm các đối tác dàn xếp vào danh sách các tiểu bang ở Hoa Kỳ hoặc đối tác quảng cáo theo GDPR (Quy định chung về việc bảo vệ dữ liệu) của Ad Manager. Nếu bạn không làm như vậy, các đối tác có thể không phân phát quảng cáo trên ứng dụng của bạn.

Tìm hiểu thêm về cách bật chế độ xử lý dữ liệu bị hạn chế (RDP) và có được sự đồng ý theo GDPR thông qua SDK Nền tảng thông báo cho người dùng (UMP) của Google.
Tiếp
Chọn mạng