Bài viết liên tục được cập nhật, và những phần được cập nhật rất có thể chưa được dịch sang ngôn ngữ của bạn. Để xem thông tin mới nhất, vui lòng chọn ngôn ngữ Tiếng Anh.

Báo cáo dữ liệu thô Meta - Android

Meta cho phép nhà quảng cáo nhận dữ liệu thô Android qua install referrer. Siêu dữ liệu (metadata) của chiến dịch sẽ được thêm vào install referrer và được mã hóa. Để đọc được siêu dữ liệu, bạn cần sử dụng khóa giải mã (decryption key) mà Meta cung cấp cho ứng dụng.

Bạn có thể sử dụng hai install referrer sau để làm phong phú thêm dữ liệu:

  • Meta Install Referrer (MIR)
  • Google Play Install Referrer (GPIR)
Lưu ý:
Cả hai install referrer đều cung cấp thêm thông tin về lượt cài đặt ứng dụng Meta, ví dụ Facebook hay Instagram. Tuy nhiên, khác với GPIR, MIR có hỗ trợ thêm phân bổ view-through, và phân bổ click-through đối với non-same session (người dùng click vào quảng cáo và được chuyển hướng đến app store, nhưng không ấn tải xuống/cài đặt ngay). Bạn nên sử dụng MIR để khai thác tối đa thông tin từ chiến dịch Meta.

Trước khi bắt đầu

Trước khi bắt đầu, vui lòng tham khảo các thông tin sau.

Yêu cầu

  • Meta Decryption Key của ứng dụng.
  • Người dùng AdminEditor có thể cập nhật thông tin xác thực của Meta trên Adjust.

MIR

GPIR

Cơ chế hoạt động

Khi sử dụng giải pháp install referrer, bạn có thể liên kết hoạt động in-app của người dùng với nguồn chuyển đổi (acquisition source) cho các quảng cáo phát trên Android. Qua đó, bạn có thể tiếp tục đo lường hiệu quả quảng cáo của chiến dịch và nhận diện xu hướng chuyển đổi chính.

Khi người dùng cài ứng dụng, install referrer sẽ thu thập nội dung referrer từ nguồn cài đặt. Meta sử dụng API của install referrer để gửi dữ liệu (dữ liệu được mã hóa). Adjust sẽ trích xuất dữ liệu này, sau đó sử dụng Meta decryption key để giải mã dữ liệu.

Chuỗi dữ liệu sau giải mã có thể có cấu trúc như sau:

{
"ad_id":"12345",
"ad_objective_name":"APP_INSTALL",
"adgroup_id":"54321",
"adgroup_name":"Test Ad Group",
"campaign_id":"987654",
"campaign_name":"Test Campaign",
"campaign_group_id":"654321",
"campaign_group_name":"Test Campaign Group",
"account_id":"444444",
"publisher_platform":"Test Publisher Platform",
}

Bạn có thể sử dụng trường dữ liệu để gửi dữ liệu sau giải mã qua raw data export.

Cảnh báo:
Nếu kích hoạt cả MIR và GPIR, bạn sẽ nhận được thông tin của cả hai. Với các thông tin trùng lặp giữa MIR và GPIR, Adjust sẽ chỉ hiện một lần thông tin lên Datascape, nhưng bạn vẫn nhận được hai bộ dữ liệu của MIR và GPIR đầy đủ qua raw data export. Bạn nên ưu tiên xem dữ liệu MIR.

Dữ liệu nào không được chia sẻ?

Meta không gửi các siêu dữ liệu sau:

Các siêu dữ liệu (metadata) sau chỉ xuất hiện khi bạn sử dụng MIR:

  • Lượt chuyển đổi view-through.
  • Sự kiện ứng dụng (app event) xảy ra trên các Android app store khác ngoài Google Play Store (ví dụ, Galaxy Store và Amazon Store).

Cài đặt giải pháp Install Referrer

Vui lòng thực hiện các bước sau để cài đặt giải pháp install referrer và nhận dữ liệu chiến dịch từ Meta.

1. Cập nhật thông tin xác thực của Meta trên Adjust

Để Adjust có thể giải mã siêu dữ liệu referrer, bạn cần chia sẻ Install Referrer Decryption Key. Key có 64 ký tự, gồm chữ thường (a-f) và số (0-9). Mỗi decryption key tương ứng với một Meta app ID.

Ví dụ: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Tìm Decryption Key

Vui lòng thực hiện các bước sau để tìm Decryption Key

  1. Đăng nhập Meta developer portal.
  2. Chọn My Apps ở góc trên cùng bên phải.
  3. Chọn ứng dụng mà bạn muốn lấy decryption key.
  4. Chọn Settings > Basic .
  5. Cuộn đến phần Android.
  6. Tìm Install Referrer Decryption Key bên dưới mục Google Play.

Thêm Decryption Key vào Adjust dashboard

Vui lòng thực hiện các bước sau để thêm Decryption Key vào nền tảng Adjust.

  1. Tại mục Campaign Lab , chọn Đối tác.
  2. Tìm Facebook và chọn liên kết để đến trang tổng quan.
  3. Chọn tab Chia sẻ dữ liệu để xem danh sách ứng dụng.
  4. Chọn ứng dụng mà bạn muốn cài đặt, và chọn nút Chỉnh sửa ().
  5. Tại mục Kích hoạt tính năng chia sẻ dữ liệu cho Facebook , chọn Chỉnh sửa.
  6. Nhập Decryption key cho từng nền tảng.

2. Thêm trường dữ liệu Meta referrer vào callback

Adjust có thể sử dụng một số trường dữ liệu để gửi dữ liệu sau giải mã từ Meta qua raw data export. Để nhận thông tin, bạn cần thêm các trường dữ liệu phù hợp vào callback URL hoặc định nghĩa CSV (CSV definition).

Các trường dữ liệu khả dụng

MIR
GPIR
Trường dữ liệuMô tả
{meta_install_referrer}Toàn bộ nội dung (content) của Meta install referrer, đã được giải mã.
{meta_install_referrer_campaign_group_name}Giá trị "campaign_group_name" từ nội dung của Meta install referrer.
{meta_install_referrer_campaign_group_id}Giá trị "campaign_group_id" từ nội dung của Meta install referrer.
{meta_install_referrer_campaign_name}Giá trị "campaign_name" từ nội dung của Meta install referrer.
{meta_install_referrer_campaign_id}Giá trị "campaign_id" từ nội dung của Meta install referrer.
{meta_install_referrer_adgroup_id}Giá trị "adgroup_id" từ nội dung của Meta install referrer.
{meta_install_referrer_adgroup_name}Giá trị "adgroup_name" từ nội dung của Meta install referrer.
{meta_install_referrer_ad_id}Giá trị "ad_id" từ nội dung của Meta install referrer.
{meta_install_referrer_account_id}Giá trị "account_id" từ nội dung của Meta install referrer.
{meta_install_referrer_ad_objective_name}Giá trị "ad_objective_name" từ nội dung của Meta install referrer.
{meta_install_referrer_publisher_platform}Giá trị "publisher_platform" từ nội dung của Meta install referrer.
{meta_install_referrer_is_click}Cho biết loại tương tác có phải lượt click hay không. Giá trị bằng 1 nếu loại tương tác là lượt click, giá trị bằng 0 nếu loại tương tác không phải là lượt click.
{meta_install_referrer_actual_timestamp}Giá trị "actual_timestamp" lấy từ nội dung của Meta install referrer.

Liên kết báo cáo và trường dữ liệu

Adjust liên kết dữ liệu nhận được từ trường dữ liệu Meta referrer theo các cách sau.

MIR
GPIR
Trường phân bổ trên AdjustCách ghi nhận của MetaTrường dữ liệuVí dụ
network_namePublisher platform
  • {meta_install_referrer_publisher_platform}
Meta Installs
campaign_nameCampaign name
Campaign ID
  • {meta_install_referrer_campaign_group_name}({meta_install_referrer_campaign_group_id})
 Android Facebook campaign test (123456789)
adgroup_nameAd Set Name
Ad Set ID
  • {meta_install_referrer_campaign_name}({meta_install_referrer_campaign_id})
 Android - US - Basic Ad Set (234567890)
creative_nameAd Name
Ad ID
  • {meta_install_referrer_adgroup_name}({meta_install_referrer_adgroup_id})
 Summer banner (345678901)

Cách Adjust hiển thị network_name

Ví dụ về callback

Ví dụ về callback URL

MIR
GPIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&meta_referrer={meta_install_referrer}&PhMetaInstallReferrerAdId={meta_install_referrer_ad_id}&PhMetaInstallReferrerAdGroupId={meta_install_referrer_adgroup_id}&PhMetaInstallReferrerAdGroupName={meta_install_referrer_adgroup_name}&PhMetaInstallReferrerCampaignId={meta_install_referrer_campaign_id}&PhMetaInstallReferrerCampaignName={meta_install_referrer_campaign_name}&PhMetaInstallReferrerCampaignGroupId={meta_install_referrer_campaign_group_id}&PhMetaInstallReferrerCampaignGroupName={meta_install_referrer_campaign_group_name}&PhMetaInstallReferrerAccountId={meta_install_referrer_account_id}&PhMetaInstallReferrerAdObjectiveName={meta_install_referrer_ad_objective_name}&PhMetaInstallReferrerPublisherPlatform={meta_install_referrer_publisher_platform}&PhMetaInstallReferrerIsClick={meta_install_referrer_is_click}&PhMetaInstallReferrerActualTimestamp={meta_install_referrer_actual_timestamp}

Callback sau khi đã được điền giá trị

MIR
GPIR
https://app.my-random-server.com/?tracker=unattr&tracker_name=Unattributed&referrer=adjust_reftag%3DceJTzfSP7kyVV%26utm_source%3Dfacebook%26utm_content%3D%257B%2522source%2522%253A%257B%2522data%2522%253A%2522afe56cf6228c6ea8c79da49186e718e92a579824596ae1d0d4d20d7793dca797bd4034ccf467bfae5c79a3981e7a2968c41949237e2b2db678c1c3d39c9ae564c5cafd52f2b77a3dc77bf1bae063114d0283b97417487207735da31ddc1531d5645a9c3e602c195a0ebf69c272aa5fda3a2d781cb47e117310164715a54c7a5a032740584e2789a7b4e596034c16425139a77e507c492b629c848573c714a03a2e7d25b9459b95842332b460f3682d19c35dbc7d53e3a51e0497ff6a6cbb367e760debc4194ae097498108df7b95eac2fa9bac4320077b510be3b7b823248bfe02ae501d9fe4ba179c7de6733c92bf89d523df9e31238ef497b9db719484cbab7531dbf6c5ea5a8087f95d59f5e4f89050e0f1dc03e464168ad76a64cca64b79%2522%252C%2522nonce%2522%253A%2522b7203c6a6fb633d16e9cf5c1%2522%257D%257D&meta_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhMetaInstallReferrerAdId=12345&PhMetaInstallReferrerCampaignId=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhMetaInstallReferrerCampaignName=Adams+Test+Campaign&PhMetaInstallReferrerCampaignGroupId=654321&PhMetaInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhMetaInstallReferrerAccountId=444444&PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS &PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS&MetaInstallReferrerPublisherPlatform=facebook&PhMetaInstallReferrerIsClick=1&PhMetaInstallReferrerActualTimestamp=1234567890

Đối với lượt cài đặt không được phân bổ cho Meta

Nếu referrer đã được gán với một lượt cài đặt, nhưng phân bổ được ghi cho một đối tác khác mà không phải là Meta, thì bạn vẫn nhận được thông tin referrer trong dữ liệu.

MIR
GPIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&meta_install_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D