Bắt đầu với Adapty Attribution

Adapty Attribution giúp bạn kết nối chi phí quảng cáo với doanh thu gói đăng ký trong các chiến dịch web-to-app, cho bạn cái nhìn toàn diện về kinh tế ứng dụng của mình trong một nơi duy nhất.

Để xem dữ liệu doanh thu trong Adapty Attribution, trước tiên bạn cần bật tích hợp này trên Adapty Dashboard. Bạn không cần truyền bất kỳ API key, token hay định danh nào. Chỉ cần cập nhật và cấu hình Adapty SDK.

Trước khi bắt đầu

Để kết nối dữ liệu doanh thu với hiệu suất chiến dịch, hãy để Adapty theo dõi các giao dịch mua của bạn:

• Nếu bạn đã triển khai in-app purchase với Adapty, bạn không cần làm gì thêm ở bước này.
• Nếu bạn chưa triển khai in-app purchase và muốn dùng Adapty, hãy hoàn thành các bước trong hướng dẫn quickstart để ủy quyền xử lý giao dịch mua cho Adapty.
• Nếu bạn đã triển khai in-app purchase mà không dùng Adapty và không có kế hoạch migrate sang Adapty, hãy cài đặt SDK Adapty cho nền tảng của bạn ở chế độ observer. Ở bước này, bạn chỉ cần thêm SDK vào dự án, kích hoạt nó với chế độ observer được bật, và báo cáo các giao dịch: Thiết lập này cho phép attribution từ web sang app:
• Khi người dùng cài đặt app, SDK sẽ lấy thông tin cài đặt từ các tham số link, giúp Adapty Attribution có thể lấy được thông tin chiến dịch
• SDK biết về tất cả các sự kiện liên quan đến doanh thu trong app và có thể gán attribution cho các chiến dịch web.

Bước 1. Bật Adapty Attribution trong SDK

Bắt đầu từ Adapty SDK phiên bản 4.1, Adapty Attribution mặc định bị tắt. Để SDK đăng ký lượt cài đặt và gửi thông tin cài đặt đến ứng dụng của bạn, hãy bật tính năng này khi kích hoạt SDK:

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
    .with(adaptyAttributionEnabled: true)

val config = AdaptyConfig.Builder("YOUR_PUBLIC_SDK_KEY")
    .withAdaptyAttributionEnabled(true)
    .build()

Adapty.activate(applicationContext, config)

AdaptyConfig config = new AdaptyConfig.Builder("YOUR_PUBLIC_SDK_KEY")
    .withAdaptyAttributionEnabled(true)
    .build();

Adapty.activate(getApplicationContext(), config);

await adapty.activate({
  apiKey: 'YOUR_PUBLIC_SDK_KEY',
  params: {
    adaptyAttributionEnabled: true,
  }
});

Trong các phiên bản SDK dưới 4.1, Adapty Attribution được bật tự động — không cần thay đổi code.

Bước 2. Mở Adapty Attribution

Nhấp vào logo Adapty ở phần header và chọn Attribution.

Các sự kiện gói đăng ký sẽ tự động bắt đầu đổ vào Adapty Attribution. Dữ liệu chiến dịch sẽ xuất hiện sau khi bạn kết nối nguồn dữ liệu ở Bước 3.

Để tạm dừng gửi sự kiện, mở Integrations > Adapty trong Adapty Dashboard và tắt toggle.

Các sự kiện được hỗ trợ

Theo mặc định, Adapty gửi ba nhóm sự kiện đến User Acquisition:

• Trials
• Gói đăng ký
• Sự cố

Bạn có thể xem danh sách đầy đủ các sự kiện được hỗ trợ tại đây.

Bước 3. Kết nối nền tảng quảng cáo và thêm tracking link

Adapty sử dụng tracking link để kết nối lượt cài đặt ứng dụng với dữ liệu chiến dịch. Bạn phải dùng tracking link làm URL đích trong mọi chiến dịch quảng cáo muốn đo lường trong Adapty Attribution.

Nếu chạy quảng cáo trên nhiều nền tảng, hãy thiết lập tracking link riêng cho từng nền tảng.

Có hai cách Adapty kết nối với nền tảng quảng cáo:

• Tích hợp trực tiếp (Meta Ads, TikTok Ads). Adapty kết nối trực tiếp với nền tảng quảng cáo. Các liên kết theo dõi được tạo tự động, và các thông số chiến dịch được điền động dựa trên vị trí sử dụng liên kết. Bạn có thể dùng chung một liên kết cho nhiều chiến dịch, nhóm quảng cáo hoặc mẫu quảng cáo khác nhau, và Adapty sẽ tự động nhận được dữ liệu chiến dịch cùng chi phí quảng cáo chính xác.

• Chỉ dùng tracking link (tất cả các nền tảng quảng cáo khác). Adapty không kết nối trực tiếp với nền tảng quảng cáo. Tracking link được tạo thủ công và tất cả các tham số chiến dịch phải được xác định rõ ràng khi tạo link. Dữ liệu chi phí quảng cáo không khả dụng với các nền tảng này.

Để tạo tracking link cho Meta Ads:

1. Vào Integrations > Meta trong Adapty Attribution Dashboard và nhấn Continue with Facebook.

2. Đăng nhập bằng tài khoản Facebook và nhấp Continue.

3. Xem lại các quyền được yêu cầu và nhấp Save.
4. Chuyển sang tab Web campaigns và nhấp Create campaign. Chọn ứng dụng và nhấp Save.

5. Trong tab General, mở rộng phần iOS và/hoặc Android rồi dán URL ứng dụng trên App Store và/hoặc Google Play. Sau đó, nhấp Save.

6. Sao chép giá trị trường Click link cho một link hoặc cho link theo từng nền tảng. Sau đó, trong Meta Ads Manager, mở quảng cáo của bạn và dán link này làm URL đích.

Important

Trong trường Website URL, hãy dán https://api-ua.adapty.io/api/v1/attribution/click. Dán phần còn lại của link vào trường URL parameters trong phần Tracking. Điều này sẽ giúp quảng cáo Meta của bạn được phê duyệt. Xem thêm các khuyến nghị về cách thiết lập quảng cáo trong Meta Ads Manager.

7. Bây giờ, khi bạn chạy quảng cáo trên Meta Ads, dữ liệu của quảng cáo đó sẽ hiển thị để phân tích trong Adapty Attribution dashboard.

Để tạo tracking link cho TikTok for Business:

1. Vào Integrations > TikTok Ads trong Adapty Attribution Dashboard và nhấn Continue with TikTok.

   

2. Đăng nhập bằng tài khoản TikTok của bạn và nhấn Continue.

3. Xem lại các quyền được yêu cầu và nhấn Save.

4. Chuyển sang tab Web campaigns và nhấp vào Create campaign. Chọn ứng dụng và nhấp Save.

   

5. Trong tab General, mở rộng phần iOS và/hoặc Android và dán URL ứng dụng từ App Store và/hoặc Google Play. Sau đó, nhấp Save.

   

6. Sao chép giá trị trường Click link cho một liên kết hoặc cho liên kết theo nền tảng cụ thể. Sau đó, trong TikTok Ads Manager, khi tạo quảng cáo, dán giá trị này vào trường Tracking URL trong phần Advanced Settings. Điều này cho phép Adapty kết nối các lượt cài đặt và mua hàng với quảng cáo trên TikTok. Xem hướng dẫn thiết lập chiến dịch trong TikTok Ads.

   

7. Bây giờ, khi bạn chạy quảng cáo trên TikTok for Business, dữ liệu của quảng cáo đó sẽ hiển thị để phân tích trong dashboard Adapty Attribution.

Để tạo tracking link cho các nền tảng quảng cáo khác:

1. Trong Adapty Attribution dashboard, mở Integrations và chọn thẻ Custom trong nhóm Network. Tại đó, nhấp vào Create link.

   

2. Chọn ứng dụng của bạn từ danh sách và nhấp vào Next.

   

3. Điền các thông số liên kết để khớp với chiến dịch và quảng cáo bạn muốn theo dõi.

4. Theo mặc định, bạn đang tạo một One Link. Liên kết này tự động phát hiện nền tảng của người dùng và chuyển hướng họ đến App Store hoặc Google Play sau khi ghi nhận lượt nhấp.

   Nếu bạn muốn sử dụng URL chuyển hướng riêng cho từng nền tảng, hãy bỏ chọn hộp kiểm One Link và cung cấp thủ công các liên kết cửa hàng theo từng nền tảng.

   

5. Nhấp vào Create.

6. Mở trang tracking link của bạn và sao chép Click link từ một trong các mục:

   • One link – sử dụng liên kết này để theo dõi lượt nhấp và tự động chuyển hướng người dùng đến cửa hàng phù hợp.
   • iOS link hoặc Android link — phiên bản dành riêng cho từng nền tảng nếu bạn muốn có liên kết riêng cho mỗi cửa hàng.

7. Truy cập nền tảng quảng cáo của bạn và dán liên kết vào quảng cáo dưới dạng URL đích.

Bước 4. Khởi chạy chiến dịch web-to-app và xem kết quả

Khi chiến dịch của bạn đã chạy và người dùng bắt đầu cài đặt ứng dụng, Adapty sẽ tự động ghi nhận attribution cho các lượt cài đặt và doanh thu theo từng chiến dịch.

Trong dashboard phân tích Attribution của Adapty, bạn sẽ thấy các chỉ số ở cấp độ chiến dịch như:

• Lượt cài đặt và tỷ lệ chuyển đổi
• Doanh thu từ gói đăng ký và sản phẩm mua một lần
• Phân tích hiệu suất theo nền tảng quảng cáo, chiến dịch, nhóm quảng cáo và mẫu quảng cáo

Các chỉ số sẽ xuất hiện ngay khi nhận được sự kiện cài đặt và doanh thu từ ứng dụng của bạn. Dữ liệu chi tiêu quảng cáo chỉ khả dụng với các nền tảng có tích hợp native.

Tìm hiểu thêm

Tiếp tục với tài liệu chuyên sâu về Adapty Attribution analytics và các hướng dẫn thực tế cho việc chạy chiến dịch trên các nền tảng quảng cáo lớn:

• Analytics trong Adapty Attribution: Xem cách sử dụng dashboard analytics hiệu quả.
• Chỉ số trong Adapty Attribution: Khám phá các chỉ số có sẵn để phân tích user acquisition.
• Tích hợp: Xem các nền tảng quảng cáo và tích hợp được Adapty Attribution hỗ trợ.
• Chạy quảng cáo trong Meta Ads Manager: Tìm hiểu cách thiết lập và chạy chiến dịch trong Meta Ads Manager.
• Chạy quảng cáo trong TikTok for Business: Tìm hiểu cách thiết lập và chạy chiến dịch trong TikTok for Business.