• Thông số tải trọng bao gồm một hoặc nhiều mã định danh thiết bị (tùy thuộc vào hệ điều hành).
• Điều gì sẽ xảy ra nếu tôi không thể gửi mã định danh thiết bị?
  • Bạn có thể không gửi được mã định danh vì một lý do ngoài tầm kiểm soát của mình, chẳng hạn như do người dùng đã giới hạn theo dõi quảng cáo (LAT) hoặc sử dụng iOS 14 và không đồng ý ATT. Nếu có sẵn IDFV, hãy gửi đi. 
  • Nếu không gửi ID quảng cáo/mã định danh của thiết bị, có thể xảy ra những vấn đề sau: 
    • Vấn đề đăng lại: Nguồn truyền thông sẽ nhận được đăng lại nhưng không có mã định danh của thiết bị; do đó, nguồn truyền thông không thể liên kết đăng lại với người dùng. 
    • Phân chia đối tượng và quy tắc không thành công. Bộ quy tắc đối tượng yêu cầu mã định danh. Cách tốt nhất luôn là gửi ID thiết bị hoặc customer user ID theo loại ID mà bộ quy tắc của bạn sử dụng cho mọi sự kiện S2S. Tuy nhiên, nếu mã định danh AppsFlyer đã được gửi qua các phương tiện khác (SDK hoặc sự kiện S2S trước đây), các sự kiện trong ứng dụng mới sẽ được khớp với đúng người dùng ngay cả khi không có mã định danh nào được gửi cùng với sự kiện.       

Mã định danh của thiết bị

"custom_data" : {"key_group" : { 
"key_a1" : "value a1", 
"key_a2" : "value a2" 
},
"key_b" : "value b"
}

curl --location --request POST 'https://api2.appsflyer.com/inappevent/<app_id_placeholder>' \
--header 'authentication: <dev_key_placeholder>
' \
--header 'Content-Type: application/json' \
--data-raw '{
  "appsflyer_id": "9999999999999-9999999999999999999",
	"advertising_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
	"customer_user_id" : "example_customer_id_123",
	"ip": "199.0.2.1",
	"app_version_name" : "example_version_name",
	"eventTime" : "2020-02-25 12:00.000",
	"eventName": "af_purchase",
	"eventCurrency": "ZAR",
        "os" : "14.6",
        "att" : 3,
	"eventValue": 
	"{
		\"af_revenue\": \"1006\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }"
}
'

Cân nhắc: 

• Nếu muốn thử nghiệm, hãy sử dụng ID AppsFlyer của lượt cài đặt không tự nhiên để sự kiện thử nghiệm tiến hành phân bổ trong thời gian thực. Các sự kiện tự nhiên trễ một vài giờ khi phân bổ.
• Hệ thống sử dụng sự kiện phân bổ lượt cài đặt của người dùng để điền dữ liệu vào một số trường sự kiện. Ví dụ, thời gian cài đặt và nguồn truyền thông. 

Để phân bổ thiết bị thử nghiệm là lượt cài đặt không tự nhiên:

1. Tạo đường dẫn phân bổ tùy chỉnh để thử nghiệm các thông báo S2S. Đặt thông số nguồn truyền thông trên liên kết thành s2s_test và cài đặt id quảng cáo (GAID, IDFA, v.v.) trên đường dẫn như được minh họa trong các đoạn mã của đường dẫn phân bổ ví dụ. 
2. Đăng ký thiết bị thử nghiệm
3. Gỡ cài đặt ứng dụng khỏi thiết bị thử nghiệm.
4. Gửi liên kết tới thiết bị thử nghiệm.
5. Nhấp vào liên kết.
6. Cài đặt, sau đó khởi chạy ứng dụng.
7. Trong bảng điều khiển, hãy kiểm tra xem lượt cài đặt đã được phân bổ chưa.
8. Tìm nạp ID AppsFlyer để sử dụng trong thông báo S2S của bạn.

Để gửi thông báo thử nghiệm S2S:

1. Sử dụng ID AppsFlyer được phân bổ để tạo thông báo S2S. Xem nội dung dưới đây để biết các ví dụ về mã.
2. Gửi thông báo.
3. Thực hiện một trong những thao tác sau để xem cách hệ thống ghi nhận thông báo trong AppsFlyer:
   • Tải về báo cáo dữ liệu thô của các sự kiện trong ứng dụng. Chờ tối đa 15 phút sau khi gửi sự kiện để sự kiện xuất hiện trong báo cáo dữ liệu thô. 
   • API Push (Hãy cân nhắc đến việc sử dụng các công cụ như trang Postman và Webhook).
4. Kiểm tra và xác nhận:
   • Các giá trị được gửi trong thông báo S2S đã được điền chính xác trong báo cáo. Đặc biệt lưu ý đến các trường Ngày sự kiện, Tiền tệ sự kiện, Doanh thu sự kiện và Giá trị sự kiện.
   • Nguồn phân bổ và thời gian cài đặt sẽ do AppsFlyer điền.
   • Hệ thống sẽ không điền những giá trị được chính SDK cung cấp, chẳng hạn như phiên bản SDK.

Android

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&advertising_id=<GAID>

iOS

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&idfa=<IDFA>

• ID quảng cáo/mã định danh thiết bị là bắt buộc để đảm bảo đăng lại đến các SRN như Facebook và Google Ads. Nếu bạn không thể gửi ID, thì lưu ý rằng bạn cũng không thể gửi đăng lại.
• Nếu bạn chỉ gửi ID AppsFlyer, các sự kiện trong ứng dụng sẽ được ghi nhận và phân bổ một cách chính xác.

Khi AppsFlyer xử lý các sự kiện trong ứng dụng S2S, hệ thống sẽ sử dụng ID AppsFlyer để điền vào các trường phân bổ nhằm xác định sự kiện cài đặt được liên kết đứng trước các sự kiện trong ứng dụng.

Điều này có nghĩa rằng một số dữ liệu mà AppsFlyer liên kết với các sự kiện trong ứng dụng S2S không tự nhiên thì không được liên kết với các sự kiện trong ứng dụng S2S tự nhiên.

Phải có Backend logic để hệ thống lấy giá trị và điền thông số. Phần dưới đây mô tả cách thức bạn có thể lấy ID AppsFlyer:

• ID AppsFlyer là thông tin bắt buộc và được dùng để phân bổ sự kiện.
• Hệ thống tạo ra ID này khi người dùng cài đặt ứng dụng di động lần đầu.
• Để có thể ánh xạ CUID tới ID AppsFlyer, bạn cần đặt CUID trong ứng dụng. 

Để giúp bạn dễ dàng biết được người dùng nào đã thực hiện sự kiện nào, hãy triển khai luồng bên dưới:

• Thiết lập customer user ID khi người dùng cài đặt ứng dụng.
• Báo cáo dữ liệu thô của AppsFlyer bao gồm CUID và ID AppsFlyer. Sử dụng một trong các công cụ phân phối dữ liệu để lấy dữ liệu này hoặc API Push AppsFlyer. 
• Sử dụng báo cáo dữ liệu thô để so khớp CUID với ID AppsFlyer. 
• ID AppsFlyer có trong SDK được tích hợp sẵn trong ứng dụng của bạn (Android/iOS).
• Ánh xạ ID AppsFlyer với customer user ID trong hệ thống nội bộ của bạn (một thao tác quan trọng phục vụ mục đích sử dụng sau này).

Sau khi bạn ánh xạ ID AppsFlyer với CUID, bạn có thể so khớp người dùng với những sự kiện được thực hiện. Sau đó, bạn có thể lấy các giá trị khác (giá trị sự kiện, tiền tệ sự kiện, thời gian sự kiện, v.v.) và gửi sự kiện trong ứng dụng máy chủ đến máy chủ. 

{
  "appsflyer_id": "1415211453000-6513894",
	"advertising_id": "38412345-8cf0-aa78-b23e-10b96e40000d",
	"eventName": "af_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"6\",
                \"af_currency\" \"USD"\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	"ip": "1.2.3.4",
	"eventTime": "2014-05-15 12:17:00.000"
}

appsflyer_id là thông số bắt buộc trong các thông báo sự kiện máy chủ đến máy chủ. AppsFlyer sử dụng thông số này để phân bổ sự kiện tới thiết bị ban đầu và nguồn truyền thông được phân bổ. Bạn có thể lấy ID bằng một trong các phương thức sau:

• Thông qua thiết bị di động bằng cách thực hiện lệnh gọi API SDK AppsFlyer: Android, iOS.
• Thông qua nền tảng AppsFlyer, sử dụng một trong các cách thức sau: API Pull, API Push, Xuất thông tin cài đặt dữ liệu thô.

Hệ thống có thể gửi các sự kiện có giá trị doanh thu âm. Ví dụ: nếu hủy lệnh mua. Thông số af_revenue có thể mang các giá trị âm để ghi nhận sự kiện này. 

Nếu bạn điền af_quantity, bạn có thể muốn điền một giá trị âm vào trường đó, tùy thuộc vào logic hệ thống của bạn. AppsFlyer không sử dụng af_quantity.

Ví dụ về doanh thu âm

{
	"eventName": "cancel_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"-6\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	
}

• Điểm cuối: Xác minh rằng điểm cuối được sử dụng là điểm cuối chính xác.
• Xác minh rằng tải trọng chứa các thông số bắt buộc. Xem tại đây.
• Kiểm tra xem ID AppsFlyer mà bạn sử dụng để khởi chạy sự kiện có phải là một appsflyer_id thực sự hay không, có thực sự được cài đặt trên ứng dụng cụ thể không. Không phải một ID thử nghiệm được cung cấp trong tài liệu. Xem tại đây.
• Các sự kiện S2S không hỗ trợ nhiều sự kiện trong một yêu cầu S2S. Phải gửi riêng từng sự kiện.
  • Các sự kiện có thể được gửi bằng phương thức không đồng bộ để thời gian phản hồi tốt hơn.
• Trong bảng điều khiển tổng quan, phạm vi ngày liên quan đến ngày cài đặt ứng dụng (LTV), chứ không phải ngày sự kiện.
  • Đảm bảo rằng bạn chọn đúng phạm vi ngày.
  • Đảm bảo rằng phạm vi ngày trong bảng điều khiển tương ứng với ngày cài đặt trên thiết bị (appsflyer_id), chứ không phải ngày sự kiện.
• Báo cáo dữ liệu thô về sự kiện cho biết: phạm vi ngày liên quan đến ngày sự kiện, chứ không phải ngày cài đặt. 

Nếu bạn gửi sự kiện S2S nhưng hệ thống chưa ghi nhận doanh thu, hãy đảm bảo rằng hệ thống đã tạo chuỗi cho JSON mà bạn gửi. Phần quan trọng nhất là thông số giá trị sự kiện trong JSON. Phải tạo chuỗi như minh họa trong ví dụ bên dưới.

"{\"af_revenue\":\"6\" ,\"af_content_type\":\"wallets\"}"

Nếu không được tạo chuỗi, thì giá trị sự kiện sẽ không được xử lý theo đúng cách và doanh thu sẽ không được ghi nhận.

Tuyệt đối không được định dạng các giá trị doanh thu. Chúng có thể chứa dấu thập phân. Không bao gồm mã hoặc ký hiệu tiền tệ, cũng như dấu phân cách ,. Giá trị doanh thu có thể bắt đầu bằng tiền tố -

• Ví dụ về các giá trị hợp lệ: 123, -123.45, 123.456 
• Ví dụ về các giá trị không hợp lệ: 1,234.56, 1,234

Hệ thống điền vào các trường dữ liệu thô bằng cách sử dụng giá trị được gửi trong lệnh gọi S2S và điền vào các trường khác bằng thông tin từ sự kiện cài đặt. Hệ thống sử dụng SDK AppsFlyer để quan sát hành vi tương tự, chứ không giống hệt nhau cho các sự kiện trong ứng dụng. Có một vài điểm khác biệt, cụ thể đó là các trường sau không được hệ thống điền dữ liệu cho các sự kiện S2S:

• wifi
• người điều hành
• ngôn ngữ
• Loại thiết bị
• Danh mục thiết bị
• Phiên bản Ứng dụng: Bạn có thể sử dụng app_version_name
• Tên ứng dụng