---
title: "Asapty"
description: "Khám phá Asapty và vai trò của nó trong hệ sinh thái gói đăng ký của Adapty."
---

Sử dụng tích hợp [Asapty](https://asapty.com/), bạn có thể tối ưu hóa các chiến dịch Search Ads. Adapty gửi các sự kiện gói đăng ký tới Asapty, giúp bạn xây dựng các dashboard tùy chỉnh dựa trên attribution từ Apple Search Ads.

Tích hợp này không bổ sung dữ liệu attribution vào Adapty, vì chúng tôi đã có đầy đủ thông tin cần thiết trực tiếp từ [ASA](apple-search-ads).

## Thiết lập tích hợp \{#set-up-integration\}

### Kết nối Adapty với Asapty \{#connect-adapty-to-asapty\}

Để tích hợp Asapty, hãy vào [Integrations > Asapty](https://app.adapty.io/integrations/asapty) trong Adapty dashboard và điền giá trị cho trường Asapty ID.

  <img src="/assets/shared/img/895de2b-CleanShot_2023-08-14_at_18.57.462x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

Asapty ID có thể tìm thấy trong mục Settings > General trong tài khoản Asapty của bạn.

### Cấu hình sự kiện và thẻ \{#configure-events-and-tags\}

Bên dưới phần thông tin xác thực, có ba nhóm sự kiện bạn có thể gửi tới Asapty từ Adapty. Chỉ cần bật những sự kiện bạn cần. Xem danh sách đầy đủ các sự kiện mà Adapty cung cấp [tại đây](events).

  <img src="/assets/shared/img/58ddf41-CleanShot_2023-08-15_at_15.11.072x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

Chúng tôi khuyến nghị sử dụng tên sự kiện mặc định do Asapty cung cấp. Tuy nhiên, bạn có thể tùy chỉnh tên sự kiện theo nhu cầu của mình.

### Kết nối ứng dụng của bạn với Asapty \{#connect-your-app-to-asapty\}

Sau khi hoàn thành các bước trên, Adapty sẽ tự động nhận dữ liệu attribution từ Asapty. Bạn không cần phải yêu cầu dữ liệu attribution một cách tường minh trong code ứng dụng. Để đảm bảo độ chính xác của dữ liệu attribution, hãy cấu hình Asapty để chia sẻ `customerUserId` cùng với dữ liệu của mỗi sự kiện.

## Cấu trúc sự kiện Asapty \{#asapty-event-structure\}

Adapty gửi các sự kiện tới Asapty qua GET request sử dụng query parameter. Mỗi URL sự kiện có dạng như sau:

```
https://asapty.com/_api/mmpEvents/?source=adapty&asaptyid=a1b2c3d4&keywordid=12345&adgroupid=67890&campaignid=11223&conversiondate=1709294400000&event_name=subscription_renewed&install_time=1709100000&app_name=MyApp&json=%7B%22af_revenue%22%3A%229.99%22%2C%22af_currency%22%3A%22USD%22...%7D
```

Các query parameter:

| Parameter        | Type   | Description                                          |
|:-----------------|:-------|:-----------------------------------------------------|
| `source`         | String | Luôn là "adapty".                                    |
| `asaptyid`       | String | Asapty ID từ thông tin xác thực của bạn.             |
| `keywordid`      | String | Apple Search Ads Keyword ID (nếu có).                |
| `adgroupid`      | String | Apple Search Ads Ad Group ID (nếu có).               |
| `campaignid`     | String | Apple Search Ads Campaign ID (nếu có).               |
| `conversiondate` | Long   | Timestamp của sự kiện tính bằng **mili giây**.       |
| `event_name`     | String | Tên sự kiện (được ánh xạ từ sự kiện Adapty).         |
| `install_time`   | Long   | Timestamp của lần cài đặt tính bằng giây.            |
| `app_name`       | String | Tiêu đề ứng dụng từ Adapty (nếu có).                 |
| `json`           | String | Chuỗi JSON đã được URL-encode chứa chi tiết sự kiện (xem bên dưới). |

Tham số `json` là một chuỗi JSON đã được URL-encode chứa các trường sau:

| Parameter                 | Type   | Description                                  |
|:--------------------------|:-------|:---------------------------------------------|
| `af_revenue`              | String | Số tiền doanh thu dưới dạng chuỗi.           |
| `af_currency`             | String | Mã tiền tệ (ví dụ: "USD").                   |
| `transaction_id`          | String | Transaction ID từ cửa hàng.                  |
| `original_transaction_id` | String | Transaction ID gốc từ cửa hàng.              |
| `purchase_date`           | Long   | Timestamp mua hàng tính bằng mili giây.      |
| `original_purchase_date`  | Long   | Timestamp mua hàng gốc tính bằng mili giây.  |
| `environment`             | String | `Production` hoặc `Sandbox`.                 |
| `vendor_product_id`       | String | Product ID từ cửa hàng.                      |
| `profile_country`         | String | Mã quốc gia dựa theo IP của người dùng.      |
| `store_country`           | String | Mã quốc gia của cửa hàng người dùng.         |

## Xử lý sự cố \{#troubleshooting\}

- Đảm bảo bạn đã cấu hình [Apple Search Ads](apple-search-ads) trong Adapty và [tải lên thông tin xác thực](https://app.adapty.io/settings/apple-search-ads); nếu không có, Asapty sẽ không hoạt động.
- Chỉ những hồ sơ người dùng có dữ liệu attribution ASA chi tiết (không phải organic) mới gửi sự kiện tới Asapty. Bạn sẽ thấy thông báo "The user profile is missing the required integration data." nếu dữ liệu attribution không đầy đủ.
- Các hồ sơ người dùng được tạo trước khi cấu hình tích hợp sẽ không thể gửi sự kiện tới Asapty.
- Nếu tích hợp với Adapty không hoạt động dù đã thiết lập đúng, hãy kiểm tra xem toggle **Receive Apple Search Ads attribution in Adapty** đã được bật trong tab [**App Settings** -> **Apple Search Ads**](https://app.adapty.io/settings/apple-search-ads) chưa.