Tích hợp Attribution

Adapty có thể trao đổi thông tin với các dịch vụ bên thứ ba để attribution các sự kiện gói đăng ký cho các chiến dịch marketing cụ thể. Việc trao đổi này cho phép bạn:

Khám phá chiến lược marketing nào mang lại doanh thu nhiều nhất
Lọc biểu đồ gói đăng ký trong Adapty theo attribution
Sử dụng khả năng của dịch vụ bên thứ ba để phân tích dữ liệu gói đăng ký từ Adapty

Bạn có thể thiết lập theo một trong hai cách:

Attribution tích hợp yêu cầu thiết lập tối thiểu và cho phép Adapty trao đổi dữ liệu với 9 nền tảng phổ biến.
Attribution thủ công yêu cầu bạn tự lấy dữ liệu attribution từ các API của dịch vụ bên thứ ba trước khi có thể gửi về Adapty.

Tip

Bật Adapty Attribution để có cái nhìn toàn diện về nền kinh tế của ứng dụng.

Adapty Attribution là một web dashboard dễ cấu hình, tổng hợp dữ liệu từ nhiều nguồn khác nhau để xác định các chiến lược thu hút người dùng hiệu quả.

Warning

Giữ dữ liệu của bạn sạch sẽ: tránh trùng lặp sự kiện và xung đột attribution. Hãy làm theo hướng dẫn trong phần Ngăn chặn sự cố dữ liệu để đảm bảo nguồn dữ liệu mới không làm ảnh hưởng đến analytics của bạn.

Tích hợp attribution

Adapty cung cấp tích hợp attribution sẵn có với 9 dịch vụ phổ biến. Các nền tảng này có thể tự động nhận dữ liệu gói đăng ký từ Adapty, xử lý từng giao dịch mua và phản hồi với attribution phù hợp.

Mỗi nền tảng có quy trình riêng, nhưng các bước đều đơn giản như nhau:

Thiết lập chia sẻ dữ liệu tự động. Cấp quyền cho Adapty kết nối với nền tảng bạn chọn.
Tích hợp SDK. Một số nền tảng yêu cầu thêm code để thiết lập dữ liệu attribution.
Tắt các dịch vụ chia sẻ sự kiện và nguồn attribution khác để tránh trùng lặp sự kiện và xung đột dữ liệu.

Đọc hướng dẫn theo từng nền tảng để có cái nhìn tổng quan chi tiết về cách tích hợp:

Adjust, AppsFlyer, Branch và Singular cũng có thể nhận synthetic events — tín hiệu cho biết một bản dùng thử hoặc gói đăng ký đã tồn tại qua những ngày đầu tiên. Đối với các chiến dịch Meta và TikTok, Adapty Attribution cung cấp Qualified trials thay thế.

Note

Nếu bạn muốn Adapty mở rộng danh sách, hãy tạo yêu cầu tính năng và bày tỏ sự quan tâm của bạn đối với một dịch vụ cụ thể.

Attribution thủ công

Nếu Adapty không hỗ trợ tích hợp attribution với dịch vụ bạn đang dùng, bạn cần tự viết code để trao đổi dữ liệu với nguồn attribution.

Lấy dữ liệu từ dịch vụ attribution. Dùng API của dịch vụ để yêu cầu dữ liệu attribution.
Tạo một dictionary chứa dữ liệu attribution vừa nhận được.

Dictionary có thể chứa các key sau:
- status (organic, non-organic, hoặc unknown)
- channel
- campaign
- ad_group
- ad_set
- creative
Important
- Tất cả các key đều là tùy chọn.
- Adapty bỏ qua các key không có trong danh sách.
- Giá trị của mỗi key có thể dài tối đa 50 ký tự.
Ví dụ:
let attribution = [ "status": "non_organic", "channel": "Google Ads", "campaign": "Christmas Sale", "ad_group": "ad group 1", "ad_set": "ad set 1", "creative": "creative id 1" ]
val attribution = mapOf( "status" to "non_organic", "channel" to "Google Ads", "campaign" to "Christmas Sale", "ad_group" to "ad group 1", "ad_set" to "ad set 1", "creative" to "creative id 1" )
const attribution = { status: 'non_organic', channel: 'Google Ads', campaign: 'Christmas Sale', ad_group: 'ad group 1', ad_set: 'ad set 1', creative: 'creative id 1', };
final attribution = <String, String>{ 'status': 'non_organic', 'channel': 'Google Ads', 'campaign': 'Christmas Sale', 'ad_group': 'ad group 1', 'ad_set': 'ad set 1', 'creative': 'creative id 1', };
Unity nhận dữ liệu attribution dưới dạng chuỗi JSON đã được serialize, vì vậy hãy xây dựng dictionary và serialize nó:
using System.Collections.Generic; using Newtonsoft.Json; var attribution = new Dictionary<string, object> { ["status"] = "non_organic", ["channel"] = "Google Ads", ["campaign"] = "Christmas Sale", ["ad_group"] = "ad group 1", ["ad_set"] = "ad set 1", ["creative"] = "creative id 1" }; var attributionJson = JsonConvert.SerializeObject(attribution);
val attribution = mapOf( "status" to "non_organic", "channel" to "Google Ads", "campaign" to "Christmas Sale", "ad_group" to "ad group 1", "ad_set" to "ad set 1", "creative" to "creative id 1" )
const attribution = { status: 'non_organic', channel: 'Google Ads', campaign: 'Christmas Sale', ad_group: 'ad group 1', ad_set: 'ad set 1', creative: 'creative id 1', };
Thiết lập dữ liệu attribution:

Truyền dictionary attribution vào phương thức updateExternalAttribution (được đặt tên là updateAttribution trước SDK phiên bản 4.1). Khi Adapty đã lưu giá trị attribution, bạn không thể ghi đè lên nó:
```
Adapty.updateExternalAttribution(attribution, provider: .custom) { error in
    if error == nil {
        // attribution data accepted for processing
    }
}
```

Wait, let me re-read. The input starts with Tabs and first TabItem for iOS, then opens a second TabItem for Android (Kotlin) but the fragment ends there. I must reproduce exactly.

Adapty.updateExternalAttribution(attribution, provider: .custom) { error in
    if error == nil {
        // attribution data accepted for processing
    }
}

Adapty.updateExternalAttribution(attribution, AdaptyExternalAttributionProvider.CUSTOM) { error ->
    if (error == null) {
        // attribution data accepted for processing
    }
}

await adapty.updateExternalAttribution(attribution, 'custom');

await Adapty().updateExternalAttribution(attribution, provider: AdaptyExternalAttributionProvider.custom);

Adapty.UpdateExternalAttribution(
    attributionJson,
    AdaptyExternalAttributionProvider.Custom,
    (error) => {
        // handle the error
    });

Adapty.updateExternalAttribution(
    attribution,
    AdaptyExternalAttributionProvider.CUSTOM
).onSuccess {
    // attribution data accepted for processing
}.onError { error ->
    // handle the error
}

await adapty.updateExternalAttribution({ attribution, provider: 'custom' });

Info

appliedExternalAttributionProviders chỉ báo cáo attribution từ Apple Ads. Attribution từ các nhà cung cấp khác vẫn hiển thị trên hồ sơ người dùng và có thể dùng trong bộ lọc phân khúc, nhưng chưa xuất hiện ở đây.

Tham số:

attribution (bắt buộc): dictionary chứa dữ liệu attribution.
provider (bắt buộc; được đặt tên là source trước SDK phiên bản 4.1): nhà cung cấp attribution. Sử dụng giá trị custom nếu nhà cung cấp attribution của bạn không hỗ trợ integrated attribution — .custom trên iOS, AdaptyExternalAttributionProvider.CUSTOM trên Android và Kotlin Multiplatform, AdaptyExternalAttributionProvider.Custom trên Unity, AdaptyExternalAttributionProvider.custom trên Flutter, và chuỗi 'custom' trên Capacitor và React Native. Trước SDK phiên bản 4.1, truyền chuỗi "custom".

Vô hiệu hóa các dịch vụ chia sẻ sự kiện và nguồn attribution khác để tránh trùng lặp sự kiện và xung đột dữ liệu.

Ngăn ngừa sự cố dữ liệu

Chọn một nguồn attribution duy nhất

Không bật tích hợp attribution với nhiều nền tảng cùng một lúc. Adapty chỉ có thể chấp nhận một nguồn attribution tại một thời điểm, và chỉ có thể thay đổi attribution đã lưu trong hồ sơ người dùng trong vòng 15 phút đầu tiên sau khi hồ sơ được tạo.

Nếu bạn bật nhiều nguồn attribution, Adapty sẽ chọn nguồn có nhiều dữ liệu nhất — không nhất thiết là nguồn tốt nhất.

Ví dụ, attribution từ Apple Search Ads không phải organic luôn được ưu tiên trên iOS. Để tắt attribution Apple Search Ads, mở App Settings -> tab Apple Search Ads và tắt công tắc Receive Apple Search Ads attribution.

Khi một hồ sơ người dùng đã có attribution, dữ liệu attribution đến Adapty sau hơn 15 phút kể từ khi hồ sơ được tạo sẽ không thay đổi attribution đó, kể cả khi nhà cung cấp attribution của bạn re-attribute lượt cài đặt về sau từ phía họ. Để đảm bảo attribution của hồ sơ luôn đầy đủ, hãy gửi toàn bộ dữ liệu attribution đến Adapty ngay khi SDK attribution của bạn trả về kết quả.

Tránh trùng lặp sự kiện

Nếu bạn sử dụng Adapty để chia sẻ dữ liệu gói đăng ký theo thời gian thực với các dịch vụ attribution, bạn cần tắt các dịch vụ khác phục vụ cùng mục đích. Nếu bạn đã kết nối tài khoản Facebook với AppsFlyer, Adjust hoặc Branch, nó sẽ tự động chuyển tiếp sự kiện của bạn đến các dịch vụ này, trừ khi bạn chọn không tham gia.

Các sự kiện trùng lặp có thể làm lệch analytics của bạn và khiến việc đọc dữ liệu trở nên khó khăn. Sau khi đã cấu hình chia sẻ sự kiện Adapty, hãy tắt off tính năng chuyển tiếp sự kiện của bên thứ ba.