iOS user invite

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 iOS

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. Thực hiện điều này bằng cách sử dụng AppsFlyerLinkGenerator.
Để thiết lập tạo liên kết lời mời:

Đảm bảo bạn nhập AppsFlyerLib:
```
import com.appsflyer.AppsFlyerLib;
```
In AppDelegate, đặt mẫu OneLink bằng cách sử dụng appInviteOneLinkID (ID mẫu do nhà tiếp thị cung cấp):
```
AppsFlyerLib.shared().appInviteOneLinkID = "H5hv" // Set the OneLink template ID for userinvitation links
```
📘
Lưu ý
- Đảm bảo đặt appInviteOneLinkID trước khi gọi ra start
- Mẫu OneLink phải có liên quan đến ứng dụng.

Gọi ra AppsFlyerShareInviteHelper.generateInviteUrl và chuyển cho nó một AppsFlyerLinkGenerator và một completionHandler:

AppsFlyerShareInviteHelper.generateInviteUrl(
    linkGenerator: {
        (_ generator: AppsFlyerLinkGenerator) -> AppsFlyerLinkGenerator in
            generator.addParameterValue(<TARGET_VIEW>, forKey: "deep_link_value")
            generator.addParameterValue(<PROMO_CODE>, forKey: "deep_link_sub1")
            generator.addParameterValue(<REFERRER_ID>, forKey: "deep_link_sub2")
            // Optional; makes the referrer ID available in the installs raw-data report
            generator.addParameterValue(<REFERRER_ID>, forKey: "af_sub1")
            generator.setCampaign("summer_sale")
            generator.setChannel("mobile_share")
      		// Optional; Set a branded domain name:
      		generator.brandDomain = "brand.domain.com"
            return generator
    },
    completionHandler: {
        (_ url: URL?) -> Void in
            if url != nil {
                NSLog("[AFSDK] AppsFlyer share-invite link: \(url!.absoluteString)")
            }        
            else {
                print("url is nil")
            }
        }
)

Tùy thuộc vào luồng người dùng mà bạn và nhà tiếp thị muốn đạt được, hãy định cấu hình generator như sau:

Đặt thông số phân bổ bằng cách sử dụng bộ thiết lập.
Đặt các thông số liên kết sâu, bằng cách sử dụng AppsFlyerLinkGenerator.addParameterValue:
- 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: Thông số có thể tùy chỉnh. Trong ví dụ này, được sử dụng để chuyển 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.

Trong mục completionHandler, hãy kiểm tra đảm bảo URL đã được tạo thành công (url không phải là nil) và truy xuất liên kết lời mời người dùng đã tạo.
Cho phép người dùng chia sẻ các liên kết đã tạo. Ví dụ, sao chép liên kết đó vào khay nhớ tạm của người dùng.

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.

generator.addParameterValue(<value>, forKey:"af_custom_shortlink")

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:
Gửi sự kiện cho biết rằng người dùng đã tạo liên kết lời mời bằng cách sử dụng logInvite:

AppsFlyerShareInviteHelper.logInvite(<CHANNEL>, parameters: [
    "campaign" : "summer_sale",
    "referrerId" : <REFERRER_ID>,
]);

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).
In DeepLinkDelegate.didResolveDeepLink, 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.deeplinkValue
- deep_link_sub1, bằng cách sử dụng DeepLink.clickEvent["deep_link_sub1"]
- deep_link_sub2, bằng cách sử dụng DeepLink.clickEvent["deep_link_sub2"]
Xem mã: Swift.
Khi bạn truy xuất ID người giới thiệu, cách thức lưu trữ và sử dụng ID đó là tùy bạn chọn.

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 người giới thiệu của Người dùng A có trong UDL didResolveDeepLink (trong ví dụ này, ở DeepLink.clickEvent["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 on in-app events

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):
```
AppsFlyerLib.shared().logEvent(AFEventPurchase, 
  withValues: [
		AFEventParamRevenue: 200,
		AFEventParamCurrency:"USD",
        AFEventParam1: <REFERRER_ID>
  ]);
```
Ở phía chương trình phụ trợ 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 ý

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 on in-app events

📘Lưu ý

📘
Lưu ý

📘
Lưu ý

📘
Lưu ý