---
title: "Tích hợp Attribution"
description: "Tích hợp Adapty với các công cụ attribution để theo dõi việc thu hút người dùng và LTV."
---

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 đồ](charts) 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](#integrated-attribution) 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](#manual-attribution) 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](user-acquisition) để 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](#prevent-data-issues)** để đả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 \{#integrated-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ý](events) 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:
1. **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.
2. **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.
3. **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](#avoid-event-duplication) và [xung đột dữ liệu](#select-a-single-attribution-source).

Đọ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](adjust)
- [Airbridge](airbridge)
- [Apple Search Ads](apple-search-ads)
- [AppsFlyer](appsflyer)
- [Asapty](asapty)
- [Branch](branch)
- [Facebook Ads](facebook-ads)
- [Singular](singular)
- [Tenjin](tenjin)

:::note
Nếu bạn muốn Adapty mở rộng danh sách này, hãy [tạo yêu cầu tính năng](https://adapty.featurebase.app/en?b=6979f233ebd3cffd4f425ba0) và cho biết bạn quan tâm đến dịch vụ nào.
:::
## Attribution thủ công \{#manual-attribution\}

Nếu Adapty không hỗ trợ [tích hợp attribution](#integrated-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.

1. **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.
2. **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ụ**:

```swift showLineNumbers title="Swift"
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"
]
```

3. **Thiết lập dữ liệu attribution**:
Truyền dictionary attribution vào phương thức `updateAttribution`. Sau khi đã đặt giá trị attribution, bạn không thể ghi đè lên nó:

    ```swift showLineNumbers title="Swift"
    Adapty.updateAttribution(attribution, source: "custom") { error in
        if error == nil {
            // successful attribution update
        }
    }
    ```

    **Tham số:**

    - `attribution` (bắt buộc): dictionary chứa dữ liệu attribution.
    - `source` (bắt buộc): nguồn attribution. Đặt thành `.custom` nếu nhà cung cấp attribution của bạn không hỗ trợ [attribution tích hợp](#integrated-attribution).
4. **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](#avoid-event-duplication) và [xung đột dữ liệu](#select-a-single-attribution-source).
## Ngăn ngừa sự cố dữ liệu \{#prevent-data-issues\}

### Chọn một nguồn attribution duy nhất \{#select-a-single-attribution-source\}

Không nên 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ể nhận một nguồn attribution tại một thời điểm, và sau khi đã lưu giá trị attribution, hệ thống không thể ghi đè lên nó.

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 có dữ liệu tốt nhất.
Ví dụ, attribution từ [Apple Search Ads không phải organic](apple-search-ads) luôn được ưu tiên trên iOS. Để tắt attribution Apple Search Ads, mở [**App Settings** -> tab **Apple Search Ads**](https://app.adapty.io/settings/apple-search-ads) và tắt công tắc **Receive Apple Search Ads attribution**.
### Tránh trùng lặp sự kiện \{#avoid-event-duplication\}

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.