API sự kiện máy chủ đến máy chủ dành cho thiết bị di động (S2S trên thiết bị di động)

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 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:

• Từ thiết bị di động bằng cách gọi ra API SDK AppsFlyer:
  Gốc AndroidGốc iOSGốc UnityReact

  getAppsFlyerId

  getAppsFlyerId

  getAppsFlyerId

  getAppsFlyerUID

• 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ô.

Khi đến AppsFlyer với số lượng lớn, các sự kiện S2S được ghi nhãn thời gian theo giá trị thuộc tính eventTime và thời gian đến của sự kiện. Thuộc tính eventTime biểu thị thời gian xảy ra sự kiện trong ứng dụng.

Khi đến, các sự kiện được ghi nhãn thời gian như sau:

• Nếu thông số eventTime không có trong bản ghi sự kiện thì thời gian sự kiện được đặt thành thời gian đến của thông báo HTTP.
• Các sự kiện đến trước 02:00 UTC được ghi nhãn theo giá trị eventTime. Có nghĩa là, đối với các sự kiện được ghi nhãn theo eventTime, chúng phải được báo cáo vào ngày diễn ra sự kiện hoặc ngày hôm sau cho đến 02:00 UTC.
• Các sự kiện diễn ra vào ngày hôm trước hoặc sớm hơn, đến sau 02:00 UTC, sẽ được ghi nhãn theo thời gian đến (thời gian của lệnh gọi API).
• Các sự kiện đến với giá trị eventTime trong tương lai (eventTime > thời gian đến):
  • Nếu eventTime được báo cáo và thời gian đến đều vào cùng một ngày theo lịch, thì sự kiện sẽ được ghi nhãn thời gian theo giá trị eventTime.
  • Nếu eventTime được báo cáo là vào ngày tiếp theo theo lịch, sự kiện sẽ được ghi nhãn thời gian theo thời gian đến.
• Các sự kiện có Giá trị eventTime không hợp lệ được đóng dấu thời gian đến của thông báo HTTP.

Ví dụ:

• Sự kiện đã được gửi với thông tin eventTime = 21 giờ, thứ Hai.

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.

• Đ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. 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ữ
• Model 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
• Tác nhân người dùng