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

Hướng dẫn này cho bạn biết cách sử dụng Google Mobile Ads SDK for React Native để 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ả cá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 của Liftoff Monetize vào một ứng dụng React Native.

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:

Bước 1: Thiết lập cấu hình trong giao diện người dùng 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 của ứ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 với tính năng Dàn xếp AdMob, hãy chuyển đến Trang tổng quan về vị trí của Liftoff Monetize, nhấp vào nút 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:

Mở ứng dụng

Chọn Interstitial (Quảng cáo xen kẽ) rồi nhập Placement Name (Tên vị trí). Sau đó, chọn Có cho Có thể bỏ qua 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í.

Chọn Banner (Biểu ngữ), nhập Placement Name (Tên vị trí) rồi đ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 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í.

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) 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í.

Được thưởng

Chọn Rewarded (Có tặng thưởng), nhập Placement Name (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ẽ có tặng thưởng

Chọn Quảng cáo 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 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í.

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 Được rồi.

Mở ứng dụ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

Tìm 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 AdMob. 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 bạn chưa làm, hãy thiết lập tệp app-ads.txt cho ứng dụng của bạn.

Để triển khai app-ads.txt cho Liftoff Monetize, hãy tải xuống và thêm các mục nhập app-ads.txt của Liftoff Monetize vào tệp app-ads.txt hiện có của bạn. Để biết thêm thông tin, hãy xem bài viết về 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 mục Applications (Ứng dụng).

Chọn ứng dụng mà bạn muốn bật quảng cáo thử nghiệm trong mục 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 mục 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 AdMob

Đị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 AdMob.

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

Trong thư mục gốc của dự án, hãy cài đặt bộ chuyển đổi dàn xếp Google Mobile Ads SDK for React Native cho Liftoff Monetize. Hãy hoàn tất các bước sau:

  1. Sao chép tệp tar của bộ chuyển đổi Google Mobile Ads SDK for React Native từ thư mục gma-sdk-react-native/adapters/liftoff-monetize/ vào thư mục local_packages/ của dự án. Nếu bạn không có thư mục adapters, hãy xem phần Điều kiện tiên quyết.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/liftoff-monetize/gma-mediation-liftoffmonetize-0.1.0.tgz local_packages/

    Thay thế EXTRACT_DIR bằng đường dẫn đến thư mục mà bạn đã giải nén tệp lưu trữ.

  2. Cài đặt gói bộ chuyển đổi bằng trình quản lý gói mà bạn muốn:

    npm

    npm install ./local_packages/gma-mediation-liftoffmonetize-0.1.0.tgz

    chỉ len

    yarn add ./local_packages/gma-mediation-liftoffmonetize-0.1.0.tgz

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 nhằm mục đích 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.

Bộ chuyển đổi Liftoff Monetize React Native phiên bản N/A trở lên hỗ trợ việc chuyển tín hiệu đồng ý theo GDPR từ các nền tảng quản lý sự đồng ý (tích hợp với Khuôn khổ về tính minh bạch và sự đồng ý (TCF) của Cục Quảng cáo tương tác (IAB)) sang SDK Liftoff Monetize. Để biết thêm thông tin, hãy xem Hướng dẫn triển khai được đề xuất theo GDPR 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 tại Hoa Kỳ yêu cầu cung cấp cho người dùng quyền từ chối "bán" "thông tin cá nhân" (theo định nghĩa của các thuật ngữ này trong luật) của họ, 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.

Mã mẫu sau đây minh hoạ cách truyền thông tin về sự đồng ý đến bộ chuyển đổi Liftoff Monetize theo cách thủ công:

import { LiftoffMonetizeMediation } from '@google/gma-mediation-liftoffmonetize';
// ...

LiftoffMonetizeMediation.setCCPAStatus({ optedIn: 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ử kết quả 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 AdMob 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 (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 (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 chạy được SDK Vungle.
106 SDK Vungle đã trả về 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 SDK Vungle 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 SDK Vungle 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 bắt nguồn từ SDK Vungle, hãy tham khảo bài viết Mã lỗi: SDK Vungle cho iOS và Android.

Phiên bản 0.1.0

  • Bản phát hành đầu tiên.