Lời mời Người dùng trên Android

Tổng quan

Triển khai và phân bổ liên kết lời mời người dùng khi người dùng hiện có giới thiệu những người khác đến với ứng dụng của bạn.
Để biết thông tin giới thiệu, hãy xem lời mời người dùng.

Bạn muốn xem ví dụ đầy đủ? kiểm tra công thức:

🦉

Lời mời người dùng OneLink trong Android

Mở Công thức

Triển khai lời mời người dùng

Trước khi bạn bắt đầu: Đồng bộ với nhà tiếp thị để tìm ra các trường hợp sử dụng chính xác mà họ muốn cho các liên kết và để nhận danh sách các thông số họ muốn được triển khai.

Để triển khai phân bổ lời mời người dùng, hãy thực hiện các bước sau:

Thiết lập phương thức tạo liên kết lời mời để tạo liên kết lời mời.
Tùy chọn Ghi nhật ký tạo liên kết lời mời.
Thiết lập Liên kết Sâu Hợp nhất (UDL)
Tùy chọn Truy xuất dữ liệu người giới thiệu từ các liên kết lời mời người dùng.
Tùy chọn Thiết lập phần thưởng cho người giới thiệu.

Đoạn mã sau đây dựa trên ví dụ về nhà tiếp thị.

Set up invite link generation

Để cho phép người dùng mời bạn bè của họ dùng ứng dụng của bạn, bạn cần có phương thức tạo liên kết lời mời người dùng. Thực hiện điều này bằng cách sử dụng LinkGenerator.
Để thiết lập phương thức tạo liên kết lời mời người dùng:

Đảm bảo nhập các phần phụ thuộc sau:

import com.appsflyer.AppsFlyerLib;
import com.appsflyer.CreateOneLinkHttpTask;
import com.appsflyer.share.LinkGenerator;
import com.appsflyer.share.ShareInviteHelper;

Đặt mẫu OneLink bằng cách sử dụng setAppInviteOneLink() (ID mẫu do nhà tiếp thị cung cấp):
```
AppsFlyerLib.getInstance().setAppInviteOneLink("H5hv"); // set the OneLink template ID the user invite links will be based on
```
📘
Lưu ý
- Đảm bảo gọi setAppInviteOneLink() trước khi gọi ra start.
- Mẫu OneLink phải có liên quan đến ứng dụng.

Tạo một thẻ LinkGenerator using ShareInviteHelper.generateInviteUrl().

LinkGenerator linkGenerator = ShareInviteHelper.generateInviteUrl(getApplicationContext());

Tùy thuộc vào luồng người dùng bạn muốn đạt được, hãy thêm các thông số sau bằng cách sử dụng linkGenerator.addParameter():
```
linkGenerator.addParameter("deep_link_value", <TARGET_VIEW>);
linkGenerator.addParameter("deep_link_sub1", <PROMO_CODE>);
linkGenerator.addParameter("deep_link_sub2", <REFERRER_ID>);
// Optional; makes the referrer ID available in the installs raw-data report
linkGenerator.addParameter("af_sub1", <REFERRER_ID>);
```
- deep_link_value: Trải nghiệm ứng dụng mà người dùng được giới thiệu cần được liên kết sâu vào.
- deep_link_sub1: Mã khuyến mãi mà người được mời nhận được.
- deep_link_sub2: Mã định danh người giới thiệu. Có thể dùng để thưởng cho người giới thiệu.
- Lưu ý: Nếu bạn có SDK từ V6.5.2 trở xuống, bạn cần mã hóa bất kỳ giá trị thông số nào bằng các ký tự đặc biệt.
Đặt thông số phân bổ. (Những thông số này sẽ hiển thị trong bảng điều khiển AppsFlyer và báo cáo dữ liệu thô).
```
linkGenerator.setCampaign("summer_sale");
linkGenerator.setChannel("mobile_share");
```
Tùy chọn Đặt miền được gắn thương hiệu cho liên kết được tạo:
```
linkGenerator.setBrandDomain("brand.domain.com");
```

Tạo một thẻ LinkGenerator.ResponseListener để truy xuất liên kết lời mời người dùng khi liên kết có sẵn:

LinkGenerator.ResponseListener listener = new LinkGenerator.ResponseListener() {
            @Override
            public void onResponse(String s) {
                Log.d(LOG_TAG, "Share invite link: " + s);
                // ...
            }

            @Override
            public void onResponseError(String s) {
                Log.d(LOG_TAG, "onResponseError called");
            }
         
};

📘
Lưu ý
Since SDK v6.9.0 LinkGenerator.ResponseListener replaced CreateOneLinkHttpTask.ResponseListener

onResponse() được gọi ra khi lời mời người dùng được tạo thành công.
onResponseError() được gọi ra khi không tạo được liên kết.

chuyển listener to linkGenerator.generateLink():

linkGenerator.generateLink(getApplicationContext(), listener);

Set the shortlink ID

Tùy chọn
The shortlink ID can be determined by the developer, by adding the paramter af_custom_shortlink to the LinkGenerator instance.

linkGenerator.addParameter("af_custom_shortlink", <value>);

Log invite link creation events

Tùy chọn
Để ghi nhật ký sự kiện tạo liên kết lời mời:
Ghi nhật ký lời mời bằng cách sử dụng logInvite():

HashMap<String,String> logInviteMap = new HashMap<String,String>();
logInviteMap.put("referrerId", <REFERRER_ID>);
logInviteMap.put("campaign", "summer_sale");

ShareInviteHelper.logInvite(getApplicationContext(), "mobile_share", logInviteMap);

logInvite dẫn đến trong một sự kiện trong ứng dụng af_invite .

📘
Lưu ý
Nếu bạn không muốn sử dụng một kênh, bạn có thể sử dụng logEvent thay vào đó.

Set up UDL for user invite attribution

Tùy chọn
Để thiết lập UDL cho phân bổ lời mời người dùng:
Thiết lập Liên kết Sâu Hợp nhất (UDL). Trong DeepLinkListener.onDeepLinking(), truy xuất các thông số liên kết sâu được tạo trong bước tạo liên kết. Trong ví dụ này, các thuộc tính sau sẽ được truy xuất:

deep_link_value, bằng cách sử dụng DeepLink.getDeepLinkValue()
deep_link_sub1, bằng cách sử dụng DeepLink.getStringValue()
deep_link_sub2, bằng cách sử dụng DeepLink.getStringValue()

Xem mã: Java.

Phần thưởng cho người giới thiệu

Tùy chọn
Trong các tình huống sau, Người dùng A mời Người dùng B dùng ứng dụng của bạn.

Reward referrers on install

Tình huống: Người dùng B cài đặt ứng dụng của bạn thông qua liên kết lời mời của Người dùng A.

ID của Người dùng A sẽ có trong DeepLinkListener.onDeepLinking() và trong ví dụ này, được truy xuất bằng cách sử dụng DeepLink.getStringValue("deep_link_sub2"). Sau khi bạn truy xuất ID, hãy thêm ID đó vào danh sách ID người giới thiệu sẽ được thưởng. Cách thức lưu trữ và truy xuất danh sách đó là tùy bạn chọn.

Reward referrers for user actions

Tình huống: Người dùng B thực hiện giao dịch mua. Bạn muốn thưởng cho Người dùng A, người ban đầu đã giới thiệu Người dùng B dùng ứng dụng của bạn, cho hành động này.

Để thưởng cho người dùng A vì hành động của người dùng B:

Truy xuất ID người giới thiệu của Người dùng A và thêm ID đó vào một trong các thông số sự kiện trong ứng dụng có thể tùy chỉnh (ví dụ: af_param_1):

 Map<String, Object> purchaseEventParameters = new HashMap<String, Object>();
 purchaseEventParameters.put(AFInAppEventParameterName.PARAM_1, <REFERRER_ID>);
 purchaseEventParameters.put(AFInAppEventParameterName.CURRENCY, "USD");
 purchaseEventParameters.put(AFInAppEventParameterName.REVENUE, 200);
 
 AppsFlyerLib.getInstance().logEvent(getApplicationContext(), purchaseEventParameters);

Ở phía backend của bạn, hãy truy xuất dữ liệu sự kiện trong ứng dụng
Thêm ID người giới thiệu được tìm thấy vào danh sách người dùng sẽ được thưởng.
Khi người dùng A khởi chạy ứng dụng, hãy kiểm tra xem ID người giới thiệu của họ có nằm trong danh sách những người dùng sẽ được thưởng hay không và nếu có thì thưởng cho họ.

📘
Lưu ý

Các bước 2-3 không được nhà phát triển ứng dụng di động thực hiện. Bước 4 phụ thuộc vào cách triển khai bước 2-3.

Sự kiện mua chỉ là một ví dụ. Điều này áp dụng cho mọi loại sự kiện trong ứng dụng.

Tổng quan

Triển khai lời mời người dùng

Set up invite link generation

📘Lưu ý

📘Lưu ý

Set the shortlink ID

Log invite link creation events

📘Lưu ý

Set up UDL for user invite attribution

Phần thưởng cho người giới thiệu

Reward referrers on install

Reward referrers for user actions

📘Lưu ý

📘
Lưu ý

📘
Lưu ý

📘
Lưu ý

📘
Lưu ý