Tích hợp Liftoff Monetize với tính năng dàn xếp

Chọn nền tảng: Android iOS Unity Flutter Android (Phiên bản cũ)

Hướng dẫn này cho bạn biết cách sử dụng Google Mobile Ads Flutter Plugin để tải và hiển thị quảng cáo từ Liftoff Monetize bằng tính năng dàn xếp, bao gồm cả hoạt động tích hợp đặt giá thầu và dàn xếp kiểu thác nước. Tài liệu này trình bày cách thêm Liftoff Monetize vào cấu hình dàn xếp của một đơn vị quảng cáo, cũng như cách tích hợp SDK và bộ chuyển đổi Liftoff Monetize vào một ứng dụng Flutter.

Các định dạng quảng cáo và công cụ tích hợp được hỗ trợ

Tích hợp
Đặt giá thầu
Thác nước
Định dạng
Mở ứng dụng
Biểu ngữ
Quảng cáo xen kẽ
Quảng cáo có tặng thưởng
Quảng cáo xen kẽ có tặng thưởng
Mã gốc

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

Trước khi tiếp tục, hãy xác minh những thông tin sau:

  • Phiên bản Google Mobile Ads Flutter Plugin mới nhất.
  • Flutter framework phiên bản 3.7.0 trở lên.
  • Cách triển khai trên Android
    • Android API cấp 24 trở lên.
  • Cách triển khai trên iOS
    • Mục tiêu triển khai iOS là 13.0 trở lên.
  • Một dự án Flutter đang hoạt động được định cấu hình bằng Google Mobile Ads Flutter Plugin. Hãy xem bài viết Thiết lập Google Mobile Ads Flutter Plugin để biết thông tin chi tiết.
  • Thiết lập tính năng dàn xếp.

    • Bước 1: Thiết lập cấu hình trong giao diện người dùng của Liftoff Monetize

    Đăng ký hoặc đăng nhập vào tài khoản Liftoff Monetize.

    Thêm ứng dụng của bạn vào trang tổng quan Liftoff Monetize bằng cách nhấp vào nút Add Application (Thêm ứng dụng).

    Điền tất cả thông tin cần thiết vào biểu mẫu.

    Android

    iOS

    Sau khi tạo ứng dụng, hãy chọn ứng dụng đó trong Trang tổng quan về ứng dụng Liftoff Monetize.

    Android

    iOS

    Ghi lại Mã ứng dụng.

    Android

    iOS

    Thêm vị trí mới

    Để tạo một vị trí mới dùng cho tính năng dàn xếp, hãy chuyển đến Trang tổng quan về vị trí của Liftoff Monetize, nhấp vào nút Add Placement (Thêm vị trí) rồi chọn ứng dụng của bạn trong danh sách thả xuống.

    Thông tin chi tiết về cách thêm vị trí mới được nêu dưới đây:

    Chọn Biểu ngữ, nhập Tên vị trí và điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy chuyển nút Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

    Biểu ngữ 300x250

    Chọn MREC, nhập Tên vị trí rồi điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy bật nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

    Quảng cáo xen kẽ

    Chọn Interstitial (Quảng cáo xen kẽ), nhập Placement Name (Tên vị trí đặt quảng cáo) và điền vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy chuyển nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

    Được thưởng

    Chọn Rewarded (Có tặng thưởng), nhập Placement Name (Tên vị trí đặt quảng cáo) rồi điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy bật nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

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

    Chọn Có tặng thưởng. Nhập Tên vị trí, bật Có thể bỏ qua và điền vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy chuyển nút Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

    Mã gốc

    Chọn Quảng cáo gốc, nhập Tên vị trí rồi điền thông tin vào phần còn lại của biểu mẫu. [Chỉ đặt giá thầu] Trong mục Kiếm tiền, hãy bật nút chuyển Đặt giá thầu trong ứng dụng sang trạng thái Đã bật. Nhấp vào nút Tiếp tục ở cuối trang để tạo vị trí.

    Ghi lại Mã tham chiếu rồi nhấp vào Đồng ý.

    Biểu ngữ 300x250

    Quảng cáo xen kẽ

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

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

    Mã gốc

    Xác định vị trí khoá API Báo cáo

    Đặt giá thầu

    Bạn không cần thực hiện bước này đối với các hoạt động tích hợp đặt giá thầu.

    Thác nước

    Ngoài Mã ứng dụng và Mã tham chiếu, bạn cũng cần có Khoá API báo cáo của Liftoff Monetize để thiết lập mã đơn vị quảng cáo Ad Manager. Chuyển đến Trang tổng quan về báo cáo của Liftoff Monetize rồi nhấp vào nút Khoá API báo cáo để xem Khoá API báo cáo.

    Cập nhật tệp app-ads.txt

    Tệp Authorized Sellers for Apps app-ads.txt là một sáng kiến của IAB Tech Lab giúp đảm bảo rằng khoảng không quảng cáo trong ứng dụng của bạn chỉ được bán thông qua những kênh mà bạn đã xác định là được uỷ quyền. Để tránh mất nhiều doanh thu từ quảng cáo, bạn cần phải triển khai tệp app-ads.txt. Nếu chưa làm, hãy tạo tệp app-ads.txt cho Ad Manager.

    Để triển khai app-ads.txt cho Liftoff Monetize, hãy tải xuống và thêm các mục app-ads.txt của Liftoff Monetize vào tệp app-ads.txt hiện có. Để biết thêm thông tin, hãy xem app-ads.txt.

    Bật chế độ thử nghiệm

    Để bật quảng cáo thử nghiệm, hãy chuyển đến trang tổng quan Liftoff Monetize rồi chuyển đến Applications (Ứng dụng).

    Chọn ứng dụng mà bạn muốn bật quảng cáo thử nghiệm trong phần Mã tham chiếu vị trí của ứng dụng. Bạn có thể bật quảng cáo thử nghiệm bằng cách chọn Chế độ thử nghiệm thành Chỉ hiển thị quảng cáo thử nghiệm trong phần Trạng thái.

    Android

    iOS

    Bước 2: Thiết lập nhu cầu về Liftoff Monetize trong giao diện người dùng Ad Manager

    Định cấu hình chế độ cài đặt dàn xếp cho đơn vị quảng cáo

    Android

    Để biết hướng dẫn, hãy xem bước 2 trong tài liệu về Android.

    iOS

    Để biết hướng dẫn, hãy xem bước 2 trong tài liệu về iOS.

    Thêm Liftoff vào danh sách đối tác quảng cáo theo GDPR và quy định của các bang tại Hoa Kỳ

    Hãy làm theo các bước trong phần Chế độ cài đặt theo quy định của Châu Âu và Chế độ cài đặt theo quy định của các bang tại Hoa Kỳ để thêm Liftoff vào danh sách đối tác quảng cáo theo quy định của Châu Âu và các bang tại Hoa Kỳ trong giao diện người dùng Ad Manager.

    Bước 3: Nhập SDK và bộ chuyển đổi Liftoff Monetize

    Tích hợp thông qua pub.dev

    Thêm phần phụ thuộc sau đây bằng phiên bản mới nhất của Liftoff Monetize SDK và bộ chuyển đổi trong tệp pubspec.yaml của gói:

    dependencies:
  gma_mediation_liftoffmonetize: ^1.5.5

    Tích hợp thủ công

    Tải phiên bản mới nhất của trình bổ trợ dàn xếp Quảng cáo của Google trên thiết bị di động cho Liftoff Monetize, trích xuất tệp đã tải xuống và thêm thư mục trình bổ trợ đã trích xuất (cùng nội dung của thư mục đó) vào dự án Flutter của bạn. Sau đó, tham chiếu trình bổ trợ trong tệp pubspec.yaml bằng cách thêm phần phụ thuộc sau:

    dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

    Bước 4: Triển khai chế độ cài đặt quyền riêng tư trên SDK Liftoff Monetize

    Để tuân thủ Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu của Google, bạn phải công bố một số thông tin nhất định cho người dùng ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh và Thuỵ Sĩ, đồng thời phải có được sự đồng ý của họ để sử dụng cookie hoặc phương pháp lưu trữ cục bộ khác khi pháp luật yêu cầu, cũng như để thu thập, chia sẻ và sử dụng dữ liệu cá nhân cho hoạt động cá nhân hoá quảng cáo. Chính sách này thể hiện các yêu cầu của Chỉ thị về quyền riêng tư và truyền thông điện tử của Liên minh Châu Âu và Quy định chung về việc bảo vệ dữ liệu (GDPR). Bạn chịu trách nhiệm xác minh rằng sự đồng ý được truyền đến từng nguồn quảng cáo trong chuỗi dàn xếp của bạn.

    Kể từ phiên bản 1.1.0 của trình bổ trợ Flutter Liftoff Monetize, Liftoff Monetize sẽ tự động đọc sự đồng ý theo GDPR do các nền tảng quản lý sự đồng ý đặt ra (các nền tảng này hỗ trợ Thông số về sự đồng ý bổ sung của Google), bao gồm cả UMP SDK. Để biết thêm thông tin, hãy xem Hướng dẫn triển khai theo GDPR được đề xuất cho Android và iOS.

    Luật về quyền riêng tư của các bang tại Hoa Kỳ

    Luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ yêu cầu bạn phải cho người dùng quyền từ chối việc "bán" "thông tin cá nhân" của họ (theo định nghĩa của các thuật ngữ này trong luật), trong đó quyền từ chối được cung cấp thông qua một đường liên kết nổi bật "Không bán thông tin cá nhân của tôi" trên trang chủ của bên "bán". Hướng dẫn tuân thủ luật về quyền riêng tư của các bang tại Hoa Kỳ cho phép bạn bật chế độ xử lý dữ liệu bị hạn chế cho hoạt động phân phát quảng cáo của Google, nhưng Google không thể áp dụng chế độ cài đặt này cho từng mạng quảng cáo trong chuỗi dàn xếp của bạn. Do đó, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp có thể tham gia vào việc bán thông tin cá nhân và làm theo hướng dẫn của từng mạng đó để đảm bảo tuân thủ quy định.

    Trình bổ trợ dàn xếp Quảng cáo của Google trên thiết bị di động cho Liftoff Monetize bao gồm phương thức GmaMediationLiftoffmonetize.setCCPAStatus(). Mã mẫu sau đây cho biết cách truyền thông tin về sự đồng ý đến Liftoff Monetize SDK. Nếu chọn gọi phương thức này, bạn nên gọi trước khi yêu cầu quảng cáo thông qua Google Mobile Ads Flutter Plugin.

    import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

    Hãy xem hướng dẫn triển khai được đề xuất theo CCPA cho Android và iOS để biết thêm thông tin chi tiết và các giá trị có thể được cung cấp trong phương thức này.

    Bước 5: Thêm mã bắt buộc

    Android

    Bạn không cần phải có thêm mã để tích hợp Liftoff Monetize.

    iOS

    Tích hợp SKAdNetwork

    Làm theo tài liệu của Liftoff Monetize để thêm giá trị nhận dạng SKAdNetwork vào tệp Info.plist của dự án.

    Bước 6: Kiểm thử việc triển khai

    Bật quảng cáo thử nghiệm

    Đảm bảo rằng bạn đăng ký thiết bị thử nghiệm cho Ad Manager và bật chế độ thử nghiệm trong giao diện người dùng Liftoff Monetize.

    Xác minh quảng cáo thử nghiệm

    Để xác minh rằng bạn đang nhận được quảng cáo thử nghiệm từ Liftoff Monetize, hãy bật thử nghiệm riêng một nguồn quảng cáo trong công cụ kiểm tra quảng cáo bằng (các) nguồn quảng cáo Liftoff Monetize (Đặt giá thầu) và Liftoff Monetize(Thác nước).

    Mã lỗi

    Nếu bộ chuyển đổi không nhận được quảng cáo từ Liftoff Monetize, nhà xuất bản có thể kiểm tra lỗi cơ bản trong phản hồi quảng cáo bằng ResponseInfo trong các lớp sau:

    Android

    Định dạng Tên lớp
    Quảng cáo khi mở ứng dụng (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
    Quảng cáo khi mở ứng dụng (Thác nước) com.google.ads.mediation.vungle.VungleMediationAdapter
    Quảng cáo biểu ngữ (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
    Biểu ngữ (Thác nước) com.vungle.mediation.VungleInterstitialAdapter
    Quảng cáo xen kẽ (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
    Quảng cáo xen kẽ (Thác nước) com.vungle.mediation.VungleInterstitialAdapter
    Quảng cáo có tặng thưởng (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
    Quảng cáo có tặng thưởng (Thác nước) com.vungle.mediation.VungleAdapter
    Quảng cáo xen kẽ có tặng thưởng (Đặt giá thầu) com.google.ads.mediation.vungle.VungleMediationAdapter
    Quảng cáo xen kẽ có tặng thưởng (Kiểu thác nước) com.google.ads.mediation.vungle.VungleMediationAdapter

    iOS

    Định dạng Tên lớp
    Quảng cáo khi mở ứng dụng (Đặt giá thầu) GADMediationAdapterVungle
    Quảng cáo khi mở ứng dụng (Thác nước) GADMediationAdapterVungle
    Quảng cáo biểu ngữ (Đặt giá thầu) GADMediationAdapterVungle
    Biểu ngữ (Thác nước) GADMAdapterVungleInterstitial
    Quảng cáo xen kẽ (Đặt giá thầu) GADMediationAdapterVungle
    Quảng cáo xen kẽ (Thác nước) GADMAdapterVungleInterstitial
    Quảng cáo có tặng thưởng (Đặt giá thầu) GADMediationAdapterVungle
    Quảng cáo có tặng thưởng (Thác nước) GADMAdapterVungleRewardBasedVideoAd
    Quảng cáo xen kẽ có tặng thưởng (Đặt giá thầu) GADMediationAdapterVungle
    Quảng cáo xen kẽ có tặng thưởng (Kiểu thác nước) GADMediationAdapterVungle

    Dưới đây là các mã và thông báo đi kèm do bộ chuyển đổi Liftoff Monetize gửi khi quảng cáo không tải được:

    Android

    Mã lỗi Lý do
    101 Thông số máy chủ không hợp lệ (ví dụ: mã ứng dụng hoặc mã vị trí đặt quảng cáo).
    102 Kích thước biểu ngữ được yêu cầu không liên kết với kích thước quảng cáo hợp lệ của Liftoff Monetize.
    103 Liftoff Monetize yêu cầu ngữ cảnh Activity để yêu cầu quảng cáo.
    104 SDK Vungle không thể tải nhiều quảng cáo cho cùng một mã vị trí.
    105 Không khởi động được Vungle SDK.
    106 SDK Vungle đã trả về một lệnh gọi lại tải thành công, nhưng Banners.getBanner() hoặc Vungle.getNativeAd() trả về giá trị rỗng.
    107 Vungle SDK chưa sẵn sàng phát quảng cáo.
    108 SDK Vungle đã trả về mã thông báo đặt giá thầu không hợp lệ.

    iOS

    Mã lỗi Lý do
    101 Thông số máy chủ không hợp lệ (ví dụ: mã ứng dụng hoặc mã vị trí đặt quảng cáo).
    102 Một quảng cáo đã được tải cho cấu hình mạng này. SDK Vungle không thể tải quảng cáo thứ hai cho cùng một mã vị trí.
    103 Kích thước quảng cáo được yêu cầu không khớp với kích thước biểu ngữ mà Liftoff Monetize hỗ trợ.
    104 Vungle SDK không thể hiển thị quảng cáo biểu ngữ.
    105 Vungle SDK chỉ hỗ trợ tải 1 quảng cáo biểu ngữ tại một thời điểm, bất kể mã vị trí.
    106 SDK Vungle đã gửi một lệnh gọi lại cho biết quảng cáo không thể phát được.
    107 SDK Vungle chưa sẵn sàng phát quảng cáo.

    Đối với các lỗi xuất phát từ SDK Vungle, hãy tham khảo Mã lỗi: SDK Vungle cho iOS và Android.

    Nhật ký thay đổi của bộ điều hợp dàn xếp Flutter của Liftoff Monetize

    Phiên bản 1.5.5

    Phiên bản 1.5.4

    Phiên bản 1.5.3

    Phiên bản 1.5.2

    Phiên bản 1.5.1

    Phiên bản 1.5.0

    Phiên bản 1.4.3

    Phiên bản 1.4.2

    • Cập nhật phiên bản Flutter tối thiểu lên 3.35.1
    • Cập nhật để hỗ trợ Google Mobile Ads Flutter Plugin phiên bản 7.0.0

    Phiên bản 1.4.1

    Phiên bản 1.4.0

    Phiên bản 1.3.0

    Phiên bản 1.2.3

    Phiên bản 1.2.2

    Phiên bản 1.2.1

    Phiên bản 1.2.0

    Phiên bản 1.1.1

    Phiên bản 1.1.0

    Phiên bản 1.0.0