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:

• Google Play Install Referrer (GPIR)
• Meta Install Referrer (MIR)

Cả hai install referrer đều cung cấp thêm thông tin về lượt cài đặt ứng dụng Meta, có thể là ứng dụng Facebook hay Instagram. Tuy nhiên, chỉ MIR là có hỗ trợ 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).

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 Admin và Editor có thể cập nhật thông tin xác thực của Meta trên Adjust.

GPIR

Để kích hoạt GPIR, bạn cần cài đặt Google Play Install Referrer.

MIR

Để kích hoạt MIR plugin, bạn cần nâng cấp Adjust Android SDK v5 và cài đặt Meta install referrer.

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.

1. Khi người dùng cài ứng dụng, install referrer sẽ thu thập dữ liệu referrer từ nguồn cài đặt.
2. Meta sử dụng API của install referrer để chia sẻ dữ liệu ở dạng mã hóa.
3. 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.

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

Meta không gửi dữ liệu device ID.

Các điểm dữ liệu 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 những Android app store khác ngoài Google Play Store (ví dụ, Galaxy Store và Amazon Store).

Cài đặt install referrer

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

Chia sẻ thông tin tài khoản Meta cho Adjust

Để Adjust có thể giải mã dữ liệu referrer, bạn cần chia sẻ Install Referrer Decryption Key.

Tìm Decryption Key

Decryption key là mã gồm 64 ký tự, tương ứng với một Meta app ID.

Ví dụ: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

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

1. Mở App Dashboard.
2. Chọn ứng dụng.
3. Chọn Settings > Basic .
4. Cuộn đến phần Android.
5. Sao chép Install Referrer Decryption Key.

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. Chọn Campaign Lab > Đối tác.
2. Tìm rồi chọn Facebook để mở 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. Dán Decryption key mà bạn đã sao chép ở bước trước vào trường Decryption Key (Tùy chọn).
7. Chọn nút Lưu.

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

Adjust sử dụng trường dữ liệu để gửi dữ liệu sau giải mã của Meta. Để nhận dữ liệu qua raw data export, 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

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

Adjust sử dụng các biểu đồ sau để liên kết dữ liệu nhận được từ trường dữ liệu referrer của Meta với dữ liệu của Adjust.

Cách Adjust hiển thị network_name

Adjust sử dụng logic sau để báo cáo network_name:

Ví dụ về callback

https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&fb_referrer={fb_install_referrer}&PhFbInstallReferrerAdId={fb_install_referrer_ad_id}&PhFbInstallReferrerAdGroupId={fb_install_referrer_adgroup_id}&PhFbInstallReferrerAdGroupName={fb_install_referrer_adgroup_name}&PhFbInstallReferrerCampaignId={fb_install_referrer_campaign_id}&PhFbInstallReferrerCampaignName={fb_install_referrer_campaign_name}&PhFbInstallReferrerCampaignGroupId={fb_install_referrer_campaign_group_id}&PhFbInstallReferrerCampaignGroupName={fb_install_referrer_campaign_group_name}&PhFbInstallReferrerAccountId={fb_install_referrer_account_id}&PhFbInstallReferrerAdObjectiveName={fb_install_referrer_ad_objective_name}&PhFbInstallReferrerPublisherPlatform={fb_install_referrer_publisher_platform}

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

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&fb_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&PhFbInstallReferrerAdId=12345&PhFbInstallReferrerCampaignId=%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&PhFbInstallReferrerCampaignName=Adams+Test+Campaign&PhFbInstallReferrerCampaignGroupId=654321&PhFbInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhFbInstallReferrerAccountId=444444&PhFbInstallReferrerAdObjectiveName=APP_INSTALLS &PhFbInstallReferrerAdObjectiveName=APP_INSTALLS&FbInstallReferrerPublisherPlatform=facebook

Lượt cài đặt không được phân bổ cho Meta

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

https://myserver.com?tracker=def456&tracker_name=NetworkA&fb_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