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 phần Giới thiệu về tính năng dàn xếp.

Khởi chạy SDK Quảng cáo của Google 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 của Google 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 để xác minh rằng 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 các API Android của trình bổ trợ:

def flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

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

Bạn cần thêm các bộ điều hợp dàn xếp và các phần phụ thuộc của chúng 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 Android và iOS của 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 của họ vào ứng dụng.

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

Đoạn 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 nguồn quảng cáo bên thứ ba cho đơn vị quảng cáo biểu ngữ được 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 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 chế độ cài đặt theo quy định của tiểu bang ở Hoa Kỳ hoặc chế độ cài đặt theo 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 theo quy định của cá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 chế độ 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