Cài đặt cơ chế giới thiệu người dùng

Khi người dùng mời một người bạn tải và đăng ký ứng dụng của bạn, thì bạn có thể sử dụng cơ chế giới thiệu để gửi lại họ một phần thưởng.

Để cài đặt cơ chế giới thiệu người dùng, thực hiện các bước sau:

1. Tạo liên kết tùy chỉnh cho chương trình giới thiệu. Cần đặt liên kết này phía sau thành tố invite của ứng dụng.
2. Thêm tham số label. Tham số label có chức năng truyền gửi referral ID. Bạn cần cài đặt sao cho ứng dụng có thể điền referral ID vào tham số label trước rồi mới gửi link URL cho người được giới thiệu.
3. Cài đặt referral ID vào hệ thống. Cài đặt attribution callback hoặc server callback để nhận referral ID sau khi người dùng mới tải và cài đặt ứng dụng thông qua liên kết giới thiệu. Hệ thống sau đó cần gửi thưởng cho người dùng dựa theo referral ID.

Trước khi bắt đầu

Trước khi cài đặt cơ chế giới thiệu người dùng, cần thực hiện các bước sau:

• Nếu ứng dụng chạy trên iOS, cần kích hoạt probabilistic modeling. Việc này nhằm đảm bảo cơ chế giới thiệu có thể hoạt động được trong môi trường mobile web.
• Đảm bảo hệ thống có thể tạo và áp dụng mã giới thiệu (referral code) để gửi thưởng cho người dùng. Vui lòng kiểm tra các thông tin sau:
  • Máy chủ của bạn có thể tạo referral ID khi người dùng nhấn vào nút "mời bạn bè" hoặc "chia sẻ".
  • Máy chủ của bạn có thể điền referral ID vào trường dữ liệu label.
  • Máy chủ của bạn có thể xử lý giá trị label nhận được từ Adjust callback, qua đó gửi thưởng đến người giới thiệu, người được giới thiệu hoặc cả hai.

1. Tạo liên kết tùy chỉnh cho chương trình giới thiệu

1. Xem hướng dẫn Cài đặt liên kết tùy chỉnh.
2. Có thể kích hoạt probabilistic modeling khi cài đặt tính năng phân bổ để đảm bảo độ chính xác của phân bổ.

2. Thêm tham số label vào liên kết

Adjust sử dụng tham số label để nhận dữ liệu tùy chỉnh – dữ liệu này không liên quan đến dữ liệu phân bổ. Trong cơ chế giới thiệu người dùng, bạn có thể sử dụng tham số này để gán ID cho người dùng.

Thêm tham số label vào liên kết tùy chỉnh cạnh các tham số khác. Bạn có thể sử dụng thêm branded link để cải thiện trải nghiệm người dùng.

https://example.go.link?adj_t=abc123&adj_label={user_id}

Nếu bạn sử dụng server callback để chia sẻ referral ID cho Adjust, thì bạn có thể sử dụng tham số callback động để thay thế.

3. Cài đặt referral ID vào hệ thống

Nếu người được giới thiệu tải và mở ứng dụng, thì một trong các kịch bản sau sẽ xảy ra:

• Attribution callback: Adjust SDK nhận được attribution callback, tham số label trong callback đã được điền referral ID (ứng dụng của bạn có thể thu thập ID này).
• Install callback: Máy chủ của bạn nhận được install callback Adjust, trong đó referral ID đã được điền vào tham số label hoặc tham số callback động.

Hệ thống sau đó cần gửi thưởng cho người dùng theo đúng referral ID.

Attribution callback (khuyên dùng)

Attribution callback cho phép bạn nhận tham số label có chứa referral ID, ngay sau khi người dùng cài đặt ứng dụng thông qua liên kết giới thiệu, và lượt cài đặt này sẽ được phân bổ cho liên kết giới thiệu. Dưới đây là hướng dẫn cài đặt attribution callback:

• iOS
• Android
• Unity
• React Native
• Flutter

Install callback

Server install callback cho phép bạn nhận callback có chứa mã giới thiệu về máy chủ BI. Xem hướng dẫn Cài đặt server callback để biết thêm thông tin.

Để cài đặt install callback, cần thực hiện các bước sau:

1. Sử dụng thẻ ứng dụng (app card) hoặc tab Quản lý dữ liệu để cài đặt server callback.

   • (Admin, Editor và Custom Editor) Để cài đặt server callback bằng thẻ ứng dụng, tại mục AppView , chọn Tất cả ứng dụng. Tìm ứng dụng của bạn và chọn Server callback.
   • Để cài đặt server callback bằng tab Quản lý dữ liệu , tại mục AppView , chọn Tất cả ứng dụng. Tìm ứng dụng của bạn, sau đó chọn tab Quản lý dữ liệu.

2. Tại mục Server callback , chọn Thêm callback > Guided setup.

3. Mở danh sách Callback trigger , chọn hoạt động “install”

4. Nhập endpoint URL — nơi bạn muốn nhận dữ liệu — vào trường Server endpoint.

5. (Tùy chọn) Chọn Thêm một điều kiện để thêm điều kiện (dưới dạng trường dữ liệu hoặc giá trị). Callback chỉ được kích hoạt khi điều kiện được đáp ứng.

6. Chọn Thêm một trường dữ liệu trong mục Trường dữ liệu , sau đó chọn {install}, để linh động thêm dữ liệu người dùng hoặc dữ liệu tương tác vào callback. Bạn có thể thêm nhiều trường dữ liệu cùng lúc.

7. Chọn Tạo callback URL để tạo và mã hóa callback URL.

Dưới đây là ví dụ callback URL đã thêm tham số label và trường dữ liệu cần thiết:

https://myendpoint.test/?label={label}&adid={adid}&tracker_name={tracker_name}&gps_adid={gps_adid}&idfa={idfa}&idfv={idfv}&app_name={app_name}&activity_kind={activity_kind}&created_at={created_at}

Báo cáo dữ liệu

Adjust Datascape cung cấp báo cáo tổng hợp cho liên kết giới thiệu. Tham số label không xuất hiện trên Datascape, chỉ có trong raw data report hoặc thông qua attribution callback.

Hướng dẫn kiểm thử

Để kiểm thử cơ chế giới thiệu người dùng, thực hiện các bước sau:

1. Đặt liên kết tùy chỉnh có chứa tham số label phía sau thành tố invite của ứng dụng.
2. Chọn thành tố invite và sao chép liên kết. Đảm bảo mã giới thiệu đã được điền vào tham số label.
3. Dán liên kết vào messenger hoặc môi trường mà người dùng sẽ sử dụng để chia sẻ liên kết.
4. Làm theo mục Trước khi bắt đầu trong hướng dẫn Testing Console để chuẩn bị thiết bị kiểm thử.
5. Chọn liên kết.
6. Kiểm tra dữ liệu thiết bị có trên Testing Console theo hướng dẫn tại đây.
7. Kiểm tra để đảm bảo bạn đã nhận được tham số label trong attribution callback hoặc thông qua server callback trong hệ thống BI.
8. Gửi thưởng cho người dùng theo đúng mã giới thiệu.