Doanh thu từ quảng cáo ở cấp lượt hiển thị

Khi một lượt hiển thị xảy ra, Google Mobile Ads SDK for React Native sẽ cung cấp dữ liệu doanh thu từ quảng cáo liên quan đến lượt hiển thị đó. Sử dụng dữ liệu này để tính toán giá trị vòng đời (LTV) của người dùng hoặc chuyển dữ liệu đến các nền tảng phân tích hoặc đối tác phân bổ bên thứ ba.

Hướng dẫn này trình bày cách triển khai tính năng thu thập dữ liệu doanh thu từ quảng cáo ở cấp lượt hiển thị trong ứng dụng React Native.

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

Trước khi tiếp tục, hãy làm như sau:

Mỗi định dạng quảng cáo đều hỗ trợ một lệnh gọi lại sự kiện onAdPaid. Trong vòng đời của quảng cáo, Google Mobile Ads SDK for React Native sẽ theo dõi các sự kiện hiển thị và gọi trình xử lý bằng tải trọng AdValue nhận được.

Ví dụ sau đây đăng ký một trình nghe sự kiện có tính phí trên một quảng cáo có tặng thưởng, ghi lại dữ liệu doanh thu từ quảng cáo kiếm được và hiển thị quảng cáo:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Bạn nên làm như sau:

  • Đối với quảng cáo toàn màn hình, hãy đặt trình nghe trên đối tượng quảng cáo sau khi bạn tải quảng cáo và trước khi hiển thị quảng cáo. Đối với quảng cáo biểu ngữ và quảng cáo gốc, hãy truyền lệnh gọi lại onAdPaid dưới dạng thuộc tính cho thành phần <BannerAdView /> hoặc <NativeAdView />. Quy trình này đảm bảo rằng bạn không bỏ lỡ bất kỳ lệnh gọi lại sự kiện có tính phí nào.

  • Gửi thông tin về doanh thu từ quảng cáo ở cấp lượt hiển thị đến máy chủ phân tích ưu tiên khi Google Mobile Ads SDK for React Native gọi lệnh gọi lại onAdPaid. Quy trình này đảm bảo rằng bạn không bỏ lỡ lệnh gọi lại và giúp dữ liệu của bạn luôn nhất quán.

Tìm hiểu về việc tích hợp AAP

Để biết thông tin chi tiết về cách chuyển dữ liệu doanh thu từ quảng cáo đến các nền tảng phân tích, hãy xem hướng dẫn sau đây của Đối tác phân bổ ứng dụng (AAP):

Tìm hiểu đối tượng AdValue

Đối tượng AdValue đại diện cho giá trị bằng tiền mà bạn nhận được từ một quảng cáo, bao gồm mã tiền tệ và loại độ chính xác. Bảng sau đây liệt kê các thuộc tính của đối tượng AdValue:

Thuộc tính Mô tả
amountMicros Doanh thu từ quảng cáo tính theo đơn vị một phần triệu, trong đó 1000000 đơn vị một phần triệu tương đương với một đơn vị tiền tệ, chẳng hạn như 1 USD hoặc 1 EUR.
currencyCode Mã đơn vị tiền tệ theo ISO 4217 của giá trị quảng cáo, ví dụ: USD hoặc EUR.
precision Mức độ chính xác của giá trị quảng cáo. Danh sách sau đây trình bày chi tiết từng mức độ chính xác:
  • UNKNOWN: Giá trị quảng cáo không xác định. Giá trị này được trả về khi bạn bật tính năng pingback LTV nhưng không có đủ dữ liệu.
  • ESTIMATED: Giá trị quảng cáo được ước tính từ dữ liệu tổng hợp.
  • PUBLISHER_PROVIDED: Giá trị quảng cáo do nhà xuất bản cung cấp, chẳng hạn như CPM thủ công trong một nhóm dàn xếp.
  • PRECISE: Giá trị chính xác phải trả cho một quảng cáo.

Trong tính năng Dàn xếp AdMob, AdMob sẽ tìm cách cung cấp giá trị ESTIMATED cho những nguồn quảng cáo được tối ưu hoá. Để biết thông tin chi tiết, hãy xem bài viết Tối ưu hoá nguồn quảng cáo dạng thác nước trong tính năng dàn xếp. Nếu một nguồn quảng cáo không được tối ưu hoá hoặc không có đủ dữ liệu tổng hợp để ước tính, thì Google Mobile Ads SDK for React Native sẽ trả về loại độ chính xác PUBLISHER_PROVIDED.

Số lượt hiển thị thử nghiệm từ các nguồn quảng cáo đặt giá thầu

Sau khi một sự kiện doanh thu từ quảng cáo ở cấp lượt hiển thị xảy ra cho một nguồn quảng cáo đặt giá thầu thông qua một yêu cầu thử nghiệm, bạn chỉ nhận được các giá trị sau:

  • UNKNOWN: cho biết loại độ chính xác.
  • 0: cho biết giá trị quảng cáo.

Để biết thông tin chi tiết về cách gửi yêu cầu quảng cáo thử nghiệm, hãy xem bài viết Bật thiết bị thử nghiệm.