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ào ứng dụng Flutter.

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

Trước khi 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? Đọc bài viết Giới thiệu về tính năng dàn xếp.

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

Hướng dẫn bắt đầu nhanh giúp 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 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ó trong yêu cầu quảng cáo đầu tiên.

Mã mẫu sau đây cho thấy 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 mạng đối tác

Bạn cần thêm các trình chuyển đổi dàn xếp và phần phụ thuộc của trình chuyển đổi đó vào dự án Android và iOS. Bạn có thể thêm các tệp 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 trình chuyển đổi của họ vào ứng dụng.

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

Mã mẫu sau đây minh hoạ cách ghi nhật ký tên lớp mạng quảng cáo cho 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(),
    );

Sử dụng quảng cáo biểu ngữ có tính năng dàn xếp

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 nguồn quảng cáo bên thứ ba cho đơn vị quảng cáo biểu ngữ dùng trong hoạt động dàn xếp. Điều này sẽ giúp tránh xảy ra hiện tượng làm mới hai lần do 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ữ.

Sử dụng quảng cáo gốc có tính năng dàn xếp

Dưới đây là một số phương pháp hay nhất bạn cần cân nhắc áp dụng khi triển khai tính năng dàn xếp quảng cáo gốc.

Chính sách về việc hiển thị 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 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 tiểu bang ở Hoa Kỳ hoặc cài đặt GDPR để thêm đối tác dàn xếp vào danh sách đối tác quảng cáo theo GDPR hoặc tiểu bang ở Hoa Kỳ trong mục Quyền riêng tư và thông báo của Ad Manager. Nếu bạn không làm việc này, các đối tác sẽ không thể 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 tính năng xử lý dữ liệu bị hạn chế (RDP) và thu thập sự đồng ý theo GDPR bằng SDK Nền tảng thông báo cho người dùng (UMP) của Google.
Tiếp
Chọn mạng