Sự kiện phong phú trong ứng dụng—Tổng quan

Khái quát: Ghi nhận các sự kiện phong phú trong ứng dụng hậu cài đặt (chẳng hạn như đăng nhập, đăng ký hoặc mua hàng trong ứng dụng) được phân bổ cho các nguồn truyền thông và chiến dịch.

 Bài đọc liên quan

Để có bức tranh toàn cảnh về cách làm việc với các sự kiện trong ứng dụng, hãy nhớ đọc các bài viết sau:

Tại sao phải ghi nhận các sự kiện trong ứng dụng?

Sự kiện trong ứng dụng cung cấp thông tin chi tiết về những gì đang diễn ra trong ứng dụng của bạn và là công cụ lý tưởng để xác định giá trị của người dùng ứng dụng và chất lượng của lưu lượng truy cập bắt nguồn từ các nguồn truyền thông khác nhau. Việc ghi nhận sự kiện trong ứng dụng cho phép bạn đo lường các KPI như ROI (Lợi tức Đầu tư) và LTV (Giá trị Vòng đời).

Khi người dùng thực hiện đăng ký, xem xong hướng dẫn, thêm các mặt hàng vào giỏ hàng hoặc thực hiện mua hàng, thì dữ liệu sự kiện trong ứng dụng có thể ghi nhận các sự kiện kèm theo thông tin chi tiết. Việc triển khai các sự kiện trong ứng dụng là bắt buộc đối với tất cả các mục đích phân tích hậu cài đặt.

Giới thiệu về các sự kiện trong ứng dụng

Sự kiện trong ứng dụng bao gồm tên sự kiện và có thể gồm cả các thông số sự kiện. Khi bạn thêm thông số sự kiện vào một sự kiện trong ứng dụng thì nó được gọi là sự kiện phong phú trong ứng dụng. Các thông số sự kiện cung cấp cho bạn thêm ngữ cảnh và thông tin về sự kiện đang xảy ra. Ví dụ: mặc dù giúp bạn biết rằng một người dùng đã đặt trước, nhưng các thông số sự kiện có thể cung cấp cho bạn những thông chi tiết như loại giao dịch mua, điểm đến và doanh thu.

travel.png

Các sự kiện tùy chỉnh và xác định trước

Các sự kiện trong ứng dụng mà bạn muốn gửi yêu cầu nhà phát triển của bạn phải triển khai mã, nếu có, trong ứng dụng của bạn. Tên sự kiện và thông số sự kiện được phân loại như sau:

  • Được xác định trước: Đây là các tên sự kiện và thông số sự kiện thường được sử dụng giữa các ứng dụng khác nhau. Bạn thực sự nên sử dụng tên sự kiện được xác định trướcthông số sự kiện nhiều nhất có thể vì những lý do sau:
    • Việc đặt tên được xác định trước cho phép ánh xạ tự động các sự kiện tới đối tác. 
    • Nếu AppsFlyer quyết định thay đổi tên của bất kỳ sự kiện hoặc thông số sự kiện nào thì việc triển khai của bạn sẽ tương thích ngược.
  • Tùy chỉnh: Đây là các tên sự kiện và thông số mà bạn xác định cho các tình huống người dùng cụ thể xảy ra trong ứng dụng của bạn. Bạn có thể sử dụng bất kỳ tên sự kiện tùy chỉnh hoặc chuỗi tên thông số nào, nhưng hãy nhớ rằng các sự kiện tùy chỉnh cần được duy trì bởi nhà phát triển của bạn. Xem Lời khuyênHạn chế.

Sự kiện doanh thu

Bất cứ khi nào bạn gửi các sự kiện trong ứng dụng, chẳng hạn như mua hàng hoặc đặt vé máy bay, bạn sẽ gửi sự kiện đó cùng với doanh thu liên quan. Thông số duy nhất có chứa doanh thu trong các sự kiện trong ứng dụng làaf_revenue

Bạn cũng có thể ghi nhận doanh thu âm trong trường hợp người dùng hủy giao dịch mua hàng hoặc nếu bạn hoàn lại tiền. Để ghi nhận doanh thu âm, bạn chỉ cần thêm dấu trừ (-) vào giá trị doanh thu mà bạn chuyển đếnaf_revenue

af_revenue là giá trị duy nhất tích lũy doanh thu của những người dùng của bạn. Luôn sử dụng giá trị này với các sự kiện trong ứng dụng đại diện cho việc tạo doanh thu thực tế trong logic kinh doanh của bạn.

Phạm vi của giá trị này phải là -10.000 USD đến +10.000 USD hoặc số đơn vị tiền tệ gốc tương đương. Các giá trị nằm ngoài phạm vi này sẽ được đưa vào báo cáo dữ liệu thô nhưng không có trong báo cáo hợp nhất. 

af_revenue cũng có thể chứa các giá trị doanh thu âm nếu bạn cần ghi nhận các sự kiện như giao dịch bị hủy hoặc hoàn lại tiền.

Lưu ý:

  • Không định dạng giá trị doanh thu theo bất kỳ cách nào. Giá trị doanh thu không được chứa dấu phẩy phân tách, đơn vị tiền tệ, ký tự đặc biệt hoặc văn bản. Ví dụ, giá trị doanh thu phải có dạng 1234.56. AppsFlyer cung cấp giá trị doanh thu với độ chính xác lên đến năm chữ số sau dấu thập phân.
  • AppsFlyer hiển thị các nguồn thu chính xác như được gửi từ SDK. Doanh thu không bao gồm tính toán thuế VAT hoặc hoa hồng của cửa hàng ứng dụng, v.v. trừ khi chúng được nhà phát triển phía bên SDK thêm vào trước khi được gửi đến AppsFlyer.

af_currency đại diện cho đơn vị tiền tệ được thể hiện bằng af_revenue (hoặc af_price). Nếu thiếu af_currency trong các thông số của sự kiện, thì AppsFlyer sẽ gửi bằng giá trị mặc định "USD".

Bạn có thể dùng af_price như một thông số tiền tệ mà không tính là doanh thu (ví dụ như trong sự kiện “Thêm vào Giỏ hàng”). Thông số này đề cập đến giá của từng mặt hàng. Tổng số tiền của tất cả các giao dịch mua sẽ xuất hiện trong thông số af_revenue.

Tiền tệ doanh thu

Điều quan trọng là phải hiểu cách AppsFlyer xử lý cài đặt và quy đổi đơn vị tiền tệ.

AppsFlyer xử lý chênh lệch giữa đơn vị tiền tệ trong cài đặt ứng dụng và đơn vị tiền tệ của sự kiện trong ứng dụng bằng cách quy đổi đơn vị tiền tệ.

revenue_normalization_flow.png

Sơ đồ trên thể hiện quá trình sau đây:

  1. Các sự kiện trong ứng dụng được gửi - đơn vị tiền tệ khác nhau đối với mỗi sự kiện
  2. AppsFlyer tiêu chuẩn hóa tất cả các đơn vị tiền tệ thành USD
  3. AppsFlyer xử lý dữ liệu doanh thu
  4. Dữ liệu doanh thu trong bảng điều khiển được hiển thị bằng đơn vị tiền tệ trong cài đặt ứng dụng
  5. AppsFlyer điền dữ liệu doanh thu vào báo cáo dữ liệu thô bằng cả đơn vị tiền tệ trong cài đặt ứng dụng và của sự kiện

AppsFlyer sử dụng Tỷ giá Hối đoái Mở để quy đổi đơn vị tiền tệ. Tỷ giá hối đoái được cập nhật theo giờ. Bất cứ khi nào AppsFlyer thực hiện quy đổi đơn vị tiền tệ, nền tảng sẽ sử dụng tỷ giá hối đoái theo lần cập nhật theo giờ gần nhất.

Quy đổi đơn vị tiền tệ

 Ví dụ

Trong cài đặt ứng dụng, bạn đặt đơn vị tiền tệ là GBP. Một người dùng ở Pháp mua sản phẩm bằng ứng dụng của bạn. Giá được báo bằng đơn vị EUR (€). Sự kiện trong ứng dụng mà bạn gửi tới AppsFlyer sẽ có dạng như sau:

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"EUR");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

Trong trường hợp này, AppsFlyer quy đổi doanh thu từ EUR sang USD và sau đó sang GBP. Giả sử tỷ giá hối đoái là €1 = $1,13. Vậy €200 sẽ thành $226,85. Tiếp theo, AppsFlyer sẽ quy đổi từ USD sang GBP. Giả sử tỷ giá hối đoái là $1 = £0,78. Vậy $226,85 sẽ thành £176,92.

Hiển thị Tiền tệ

Đơn vị tiền tệ được đặt trong cài đặt ứng dụng. Đơn vị tiền tệ mà bạn đặt trong cài đặt ứng dụng là đơn vị tiền tệ xuất hiện trong bảng điều khiển. Bất kể bạn gửi sự kiện trong ứng dụng bằng đơn vị tiền tệ nào, doanh thu trong bảng điều khiển luôn xuất hiện bằng đơn vị tiền tệ mà bạn đã đặt trong cài đặt ứng dụng.

 Ví dụ

Giả sử bạn gửi các sự kiện trong ứng dụng bằng đơn vị tiền tệ khác với đơn vị tiền tệ được đặt trong cài đặt ứng dụng hoặc hoàn toàn không chỉ định bất kỳ đơn vị tiền tệ nào. Trong ví dụ này, đơn vị tiền tệ trong cài đặt ứng dụng được đặt là GBP.

Bạn gửi ba sự kiện trong ứng dụng tới AppsFlyer.

  1. Sự kiện A có doanh thu là 234GBP là đơn vị tiền tệ
  2. Sự kiện B có doanh thu là 171EUR là đơn vị tiền tệ
  3. Sự kiện C có doanh thu là 171 nhưng không chỉ định đơn vị tiền tệ

Dữ liệu doanh thu trong bảng điều khiển

Doanh thu xuất hiện trong bảng điều khiển là giá trị được quy đổi từ đơn vị tiền tệ của sự kiện trong ứng dụng sang USD, sau đó sang đơn vị tiền tệ trong cài đặt ứng dụng.

Nếu không có đơn vị tiền tệ nào được chỉ định trong sự kiện, AppsFlyer sẽ mặc định là USD. Bảng điều khiển hiển thị sự kiện và doanh thu như sau:

Sự kiện trong ứng dụng Người dùng duy nhất Số hành động Doanh thu
A 1 1 £234
B 1 1 £149,4 - quy đổi từ EUR sang USD và sau đó sang GBP.
C 1 1 £132,9 - mặc định là USD vì không có đơn vị tiền tệ nào được chỉ định. Quy đổi trực tiếp từ USD sang GBP.

Dữ liệu doanh thu trong báo cáo dữ liệu thô

Nếu bạn đặt đơn vị tiền tệ là GBP trong cài đặt ứng dụng nhưng lại gửi các sự kiện trong ứng dụng bằng các đơn vị tiền tệ khác, thì báo cáo dữ liệu thô sẽ hiển thị doanh thu bằng cả đơn vị tiền tệ của cài đặt ứng dụng và đơn vị tiền tệ của sự kiện trong ứng dụng.

Nếu bạn đặt đơn vị tiền tệ là GBP trong cài đặt ứng dụng nhưng gửi các sự kiện trong ứng dụng không chỉ định đơn vị tiền tệ nào, thì báo cáo dữ liệu thô sẽ hiển thị doanh thu bằng cả đơn vị tiền tệ của cài đặt ứng dụng và bằng USD.

Báo cáo dữ liệu thô về sự kiện trong ứng dụng hiển thị sự kiện và doanh thu như sau:

Sự kiện Doanh thu sự kiện Tiền tệ doanh thu sự kiện Doanh thu Sự kiện bằng GBP
A 234 GBP 234
B 171 EUR 149,4 - được quy đổi từ EUR sang USD và sau đó sang GBP.
C 171 USD 132,9 mặc định là USD vì không có đơn vị tiền tệ nào được chỉ định. Quy đổi trực tiếp từ USD sang GBP.

Gửi sự kiện

Có một số cách để gửi các sự kiện trong ứng dụng tới AppsFlyer:

  • AppsFlyer SDK: Đây là cách gửi sự kiện phổ biến nhất. Bạn có thể gửi các sự kiện phong phú trong ứng dụng ghi nhận hành động của người dùng trong ứng dụng bằng API sự kiện trong ứng dụng của AppsFlyer ở cấp SDK.
  • API máy chủ đến máy chủ: Sử dụng API máy chủ đến máy chủ để gửi trực tiếp các sự kiện xảy ra bên ngoài ứng dụng dành cho thiết bị di động đến AppsFlyer. Ví dụ: nếu bạn có một người dùng đang hoạt động trên cả giao diện web và thiết bị di động, bạn có thể ghi nhận các sự kiện từ cả hai nguồn và phân bổ chúng cho cùng một người dùng trong AppsFlyer. Đó có thể là sự kiện trong ứng dụng hoặc các sự kiện khác, chẳng hạn như các sự kiện trang web, sự kiện tổng đài hoặc mua hàng tại cửa hàng thực tế.
  • Xác thực biên nhận: Đây là một cơ chế bảo mật trong đó nền tảng thanh toán, chẳng hạn như Apple và Google, xác nhận rằng giao dịch mua trong ứng dụng đã diễn ra như được báo cáo. Xác thực mua là công cụ chính để ngăn chặn các sự kiện doanh thu gian lận. Đồng thời, việc này cũng giúp bạn xem doanh thu thực tế và lọc ra các hoạt động mua hàng trong ứng dụng chưa hoàn tất. 
  • Ứng dụng lai: Các ứng dụng này kết hợp các chế độ xem gốc và nội dung HTML và cũng có thể ghi nhận các sự kiện trong ứng dụng. Tuy nhiên, vì SDK chỉ có thể gửi các sự kiện từ phía gốc nên các nhà phát triển phải chuyển tiếp tất cả dữ liệu sự kiện sang mã gốc.

Thiết lập sự kiện trong ứng dụng

Quá trình thiết lập sự kiện trong ứng dụng yêu cầu nhà tiếp thị và nhà phát triển làm việc cùng nhau như sau:

Bước Vai trò Nhiệm vụ Chi tiết

1

Nhà tiếp thị

Xác định các sự kiện trong ứng dụng mà bạn muốn đo lường. Xác định và thông báo tên sự kiện cũng như thông số sự kiện cho nhà phát triển của bạn.  

Bạn nên bắt đầu với 3-5 sự kiện mà bạn có thể sử dụng làm KPI để đo lường chất lượng của người dùng (ví dụ: mua hàng, đăng ký và chia sẻ). Thông số sự kiện là không bắt buộc và bạn có thể sử dụng bất kỳ thông số sự kiện nào với tên sự kiện bất kỳ.

Xem Các sự kiện được đề xuất theo ngành kinh doanh để biết các sự kiện trong ứng dụng tiêu biểu.

2 Nhà phát triển

Triển khai mã trong ứng dụng của bạn nếu có. 

Tài liệu dành cho nhà phát triển tại đây.

3 [Tùy chọn] Nhà tiếp thị Làm việc với nhà phát triển của bạn để đặt trường Customer User ID (CUID)

Trường này giúp làm phong phú thêm dữ liệu sự kiện trong ứng dụng bằng cách tham chiếu chéo dữ liệu phân bổ AppsFlyer với dữ liệu khác của bạn bằng cách sử dụng CUID làm mã khóa.

4 [Tùy chọn] Nhà tiếp thị Ánh xạ sự kiện cho các đối tác liên quan trong bảng điều khiển.  Đây là một công việc liên tục, tùy thuộc vào các đối tác mà bạn tích hợp.

Xác định sự kiện trong ứng dụng

Sau khi bạn xác định các sự kiện trong ứng dụng mà bạn muốn đo lường, hãy sử dụng Trình tạo sự kiện trong ứng dụng của chúng tôi để xác định các sự kiện và thông số như sau:

  1. Chọn tên sự kiện phù hợp nhất với tình huống bạn muốn ghi nhận.
  2. Chọn các thông số sự kiện mà bạn muốn liên kết với sự kiện. Chọn các thông số sẽ cung cấp ngữ cảnh bổ sung cho sự kiện và làm phong phú dữ liệu.
  3. Tải xuống tệp tin đã hoàn thành từ trình tạo sự kiện trong ứng dụng, sau đó chia sẻ tệp tin đó với nhà phát triển của bạn.

 Ví dụ

Nhà tiếp thị cho ứng dụng Thương mại điện tử muốn ghi nhận loại nội dung mà người dùng xem để hiểu rõ hơn những danh mục nào phổ biến nhất và kết nối lượt xem sản phẩm với doanh số bán sản phẩm.

Bảng sau đây thể hiện một ví dụ về cấu trúc sự kiện mà nhà tiếp thị chuyển cho nhà phát triển:
Tên của sự kiện Thông số sự kiện Giá trị thông số Sự kiện được kích hoạt khi nào?
af_content_view af_price Giá sản phẩm

Thời điểm người dùng xem trang chi tiết của một sản phẩm cụ thể

af_content_type Tên của danh mục sản phẩm, ví dụ: giày
af_content_id

ID sản phẩm, ví dụ: SKU

Xem dữ liệu sự kiện trong ứng dụng

Các sự kiện trong ứng dụng được phân bổ cho nguồn truyền thông chịu trách nhiệm cài đặt trong suốt vòng đời của người dùng. Dữ liệu sự kiện được trình bày dưới dạng dữ liệu Hoạt động hoặc Giá trị Trọn đời

Bạn có thể xem dữ liệu sự kiện trong ứng dụng của mình ở các vị trí sau:

  • Trang bảng điều khiển tổng quan: Hiển thị hiệu suất thu hút người dùng LTV (UA) theo thời gian thực. Lưu ý: Điều này bao gồm cả doanh thu được phân chia giữa người dùng tự nhiên và người dùng không tự nhiên được báo cáo thông qua các sự kiện trong ứng dụng và doanh thu nhắm mục tiêu lại được phân bổ kép.
  • Trang sự kiện: Hiển thị hiệu suất LTV sự kiện trong ứng dụng trên các nguồn truyền thông
  • Trang hoạt động: Hiển thị các hoạt động trong ứng dụng đối với phạm vi ngày đã chọn.
  • Báo cáo sự kiện trong ứng dụng dữ liệu thôHiển thị dữ liệu hoạt động, nghĩa là, một danh sách theo thứ tự thời gian về các hoạt động được thực hiện bởi toàn bộ cơ sở người dùng của bạn. Báo cáo này bao gồm các giá trị thông số sự kiện, ví dụ:
    {
      "af_level":"10",
      "af_score":"3387",
      "arena":"7",
      "char_type":"paladin"
    }

    Lưu ý rằng báo cáo dữ liệu thô là một tính năng cao cấp.

Lời khuyên

Hãy lưu ý những chi tiết sau khi xác định tên và thông số sự kiện trong ứng dụng:

  • Để có tính nhất quán về dữ liệu trong báo cáo dữ liệu thô thì bạn nên xác định và sử dụng cùng một cấu trúc và tên sự kiện trong ứng dụng trên tất cả các nền tảng.
  • Sử dụng số lượng sự kiện tối thiểu để dễ dàng so sánh chất lượng của người dùng đến từ nhiều nguồn khác nhau.
  • Điều quan trọng là bạn phải đảm bảo quyền riêng tư của người dùng. Không điền các giá trị sự kiện trong ứng dụng cùng dữ liệu bị hạn chế có thể bị nhận dạng trực tiếp. Ví dụ: địa chỉ email, tên, mã số nhận dạng và mã bưu chính ở một số địa điểm. Để biết thêm thông tin về dữ liệu bị hạn chế, hãy đọc chính sách quyền riêng tư của dịch vụ.
  • AppsFlyer thu thập địa chỉ IP của thiết bị trong quá trình tương tác. Trong một số khu vực pháp lý hoặc các trường hợp sử dụng, địa chỉ IP có thể được coi là PII. Chúng tôi sử dụng địa chỉ IP để lấy vị trí địa lý rộng (cấp thành phố, quận) của thiết bị nhưng không sử dụng địa chỉ cụ thể. Nếu cần, bạn có thể chọn ẩn địa chỉ IP để chúng không xuất hiện trong báo cáo dữ liệu thô. 
  • Sự kiện trong ứng dụng là nguồn dữ liệu doanh thu duy nhất trên AppsFlyer. Bạn có thể gắn một giá trị doanh thu cụ thể cho từng sự kiện và xem nó trên bảng điều khiển của ứng dụng. Tìm hiểu thêm về các thông số kiếm tiền.

    revenue_data.png

Điểm hạn chế

Hãy lưu ý những chi tiết sau khi xác định tên và thông số sự kiện trong ứng dụng:

  • Chúng tôi khuyến nghị bạn nên sử dụng các ký tự chữ và số viết thường (a-z và 0-9) cho tên sự kiện trong ứng dụng của mình. Tên sự kiện có phân biệt chữ hoa và chữ thường, nghĩa là af_purchase và af_PURCHASE là hai sự kiện khác nhau trong dữ liệu thô. Tuy nhiên, trong các báo cáo hợp nhất (ví dụ: Tổng quan hoặc Sự kiện), chúng có thể được hiển thị dưới dạng một sự kiện.
  • Giới hạn số lượng giá trị trong một tập hợp là 300 sự kiện duy nhất trong một ngày. Tìm hiểu thêm
  • Người dùng duy nhất chỉ được tính cho 100 sự kiện đầu tiên sau khi họ cài đặt ứng dụng.
  • Tên sự kiện không được bắt đầu bằng các ký tự sau: " = + - 
  • Tên sự kiện không được chứa dấu cách. Bạn có thể sử dụng dấu cách gạch dưới (dấu gạch ngang dưới) trước hoặc sau tên của sự kiện.
  • Giá trị sự kiện không được vượt quá 1000 ký tự. 
  • Nếu bạn thêm URL giới thiệu làm giá trị sự kiện, thì đó phải là URL được mã hóa.
  • Facebook có một số hạn chế về tên và thông số sự kiện. Đọc về những hạn chế đó tại đây.

Câu hỏi thường gặp

Phần sau bao gồm các Câu hỏi thường gặp về sự kiện trong ứng dụng.

Làm cách nào để sử dụng thông số doanh thu?

Bạn có thể gửi giá trị doanh thu với bất kỳ tên thông số và sự kiện nào. Tuy nhiên, để đăng ký doanh thu (bao gồm doanh thu âm) trong dữ liệu thô và hợp nhất của AppsFlyer, bạn PHẢI sử dụng thông số af_revenue. Luôn sử dụng giá trị này với các sự kiện trong ứng dụng đại diện cho việc tạo doanh thu thực tế trong logic kinh doanh của bạn.

af_currency đại diện cho đơn vị tiền tệ được trình bày trong af_revenue (hoặc af_price). Nếu thiếu af_currency trong các thông số của sự kiện, thì AppsFlyer sẽ gửi bằng giá trị mặc định "USD".


Để biết thêm thông tin về thông số af_revenue, hãy xem hướng dẫn Phân bổ Doanh thu.

AppsFlyer phân bổ sự kiện như thế nào?

Các sự kiện trong ứng dụng được phân bổ cho nguồn truyền thông ban đầu của lượt cài đặt ứng dụng.

Khi cài đặt một ứng dụng (khởi chạy ứng dụng lần đầu) AppsFlyer sử dụng nhiều phương thức phân bổ khác nhau để xác định lượt cài đặt được phân bổ như thế nào. Đồng thời, SDK AppsFlyer tạo một ID AppsFlyer mới duy nhất, được liên kết với các thông tin chi tiết về phân bổ.

Mọi sự kiện trong ứng dụng sau đó do cùng một thiết bị trong ứng dụng thực hiện đều có ID này. Điều này cho phép AppsFlyer phân bổ sự kiện cho nguồn truyền thông ban đầu. Các nhà quảng cáo có thể sử dụng điều này để theo dõi toàn bộ hành trình của người dùng trong ứng dụng của họ.

Sự kiện của những người dùng được nhắm mục tiêu lại gần đây có thể bị phân bổ hai lần.

AppsFlyer phân bổ các sự kiện lượt cài đặt được phân bổ là tự nhiên khi:

Các sự kiện có được ghi nhận nếu thiết bị đang ngoại tuyến không?

Nếu người dùng bắt đầu một sự kiện khi không có kết nối internet, Appsflyer vẫn có thể ghi nhận nó. Đây là cách thức hoạt động:

  1. SDK gửi các sự kiện đến máy chủ AppsFlyer và chờ phản hồi thành công.
  2. Nếu SDK không nhận được phản hồi thành công thì sự kiện sẽ được lưu trữ trong bộ nhớ đệm.
  3. Khi nhận được phản hồi thành công tiếp theo thì sự kiện đã lưu trữ sẽ được gửi lại đến máy chủ.
  4. Nếu có nhiều sự kiện trong bộ nhớ đệm thì chúng sẽ được gửi lần lượt đến máy chủ.

 Lưu ý

Bộ nhớ đệm của SDK có thể lưu trữ tối đa 40 sự kiện, có nghĩa là chỉ lưu được 40 sự kiện đầu tiên xảy ra ngoại tuyến. Tất cả mọi thứ xảy ra sau đó, cho đến phản hồi thành công tiếp theo, sẽ bị loại bỏ.

Thời gian sự kiện xuất hiện trong dữ liệu thô là thời gian mà sự kiện được gửi tới AppsFlyer sau khi thiết bị được kết nối internet trở lại. Đây không phải là thời gian thực tế mà sự kiện diễn ra.

Các sự kiện phức tạp trong ứng dụng là gì và làm cách nào để thiết lập chúng?

Sự kiện phức tạp trong ứng dụng cho phép gửi nhiều sự kiện trong một lệnh gọi API duy nhất.

Tính năng này rất hữu ích khi bạn muốn xem một số hoạt động của người dùng có liên quan chặt chẽ với nhau đã được nhóm cùng với nhau (ví dụ: thêm một vài sản phẩm vào giỏ trong một phiên duy nhất).
Ví dụ:

{
  "af_revenue":"50.87",
  "af_currency":"USD",
  "af_receipt_id":"57601333",
  "product":[ 
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1177_8185",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"0153_9077",
	 "af_price":"14.99",
	 "af_quantity":"1"
   }
  ]
}

 Chú ý

Các sự kiện phức tạp trong ứng dụng gây ra các vấn đề về đăng lại với Facebook và Criteo. Nếu cần sự kiện được ánh xạ đầy đủ với Facebook và Criteo, bạn hãy gửi các sự kiện riêng lẻ cho từng hoạt động của người dùng (ví dụ: gửi sự kiện Thêm vào giỏ hàng cho từng mặt hàng được thêm). Sử dụng dữ liệu thô của sự kiện trong ứng dụng để nhóm các sự kiện này lại với nhau.

Tôi có thể thêm nhiều mặt hàng vào một giao dịch không?

Bạn có thể thêm nhiều mục vào một giao dịch duy nhất. Thay vì các giá trị duy nhất cho mỗi thông số sự kiện, bạn có thể có nhiều mục mô tả giao dịch, được phân tách bởi dấu phẩy. Định dạng phải là một chuỗi JSON.

 Ví dụ

Trong cùng một giao dịch, ông Smith mua hai chiếc áo sơ mi giống hệt nhau, một đôi giày và một chiếc mũ từ một cửa hàng trực tuyến tại Hoa Kỳ. Trình tự liệt kê từng mặt hàng phải giống hệt từng thông số.


"{\"af_content_id\": [\"123\",\"988\",\"399\"], \"af_quantity\": [\"2\",\"1\",\"1\"], \"af_price\": [\"25\",\"50\",\"10\"], \"af_revenue\": \"110\", \"af_currency\": \"USD\"}"

Nhiều mục được gửi từ giờ về sau dưới dạng một mảng trong đăng lại. Hiện tại Facebook và Twitter không thể phân tích các thông số mảng chính xác. Để hỗ trợ vấn đề này, AppsFlyer tổng hợp số lượng các mặt hàng (af_quantity) thay vì gửi nó đến các SRN này dưới dạng một mảng. Trong ví dụ của chúng tôi, Facebook sẽ nhận thông số af_quantity=4.

 Lưu ý

Nhiều mặt hàng có thể được dùng với các sự kiện trong ứng dụng sau:

af_add_to_cart, af_add_to_wishlist, af_tutorial_completion, af_initiated_checkout, af_purchase, af_rate, af_spent_credits, af_content_view, af_travel_booking, af_update 

AppsFlyer xử lý sự kiện trùng lặp như thế nào?

Chúng tôi có cơ chế loại bỏ trùng lặp sự kiện trong ứng dụng. Nó sẽ kiểm tra tất cả các sự kiện trong ứng dụng để xem có sự kiện trong ứng dụng giống hệt xuất phát từ cùng một appsflyer_id ít hơn 10 giây trước hay không. Nếu tìm thấy sự kiện này, cơ chế đó sẽ loại bỏ trùng lặp.

Hai sự kiện được coi là giống hệt nhau nếu các trường sau đây trong cả hai sự kiện giống nhau:

  • Tên của sự kiện
  • Giá trị của sự kiện
  • ID ứng dụng
  • ID AppsFlyer

 Lưu ý

Hủy trùng lặp chỉ hoạt động với các sự kiện trong ứng dụng được gửi từ SDK.

Các sự kiện trong ứng dụng S2S không được hủy trùng lặp.

AppsFlyer lưu giữ dữ liệu cấp người dùng trong bao lâu và nghĩa vụ xóa dữ liệu như thế nào?

AppsFlyer lưu giữ (dữ liệu thô) cấp người dùng trong 24 tháng trừ trường hợp có chỉ dẫn, yêu cầu hoặc cho phép khác theo luật định. Một số SRN/đối tác yêu cầu nhà cung cấp phân bổ, bao gồm AppsFlyer, xóa SRN/dữ liệu cấp người dùng liên quan đến đối tác trước khi hết thời hạn 24 tháng.

Sau khi xóa, các sự kiện liên quan đến người dùng đã xóa hiển thị dưới dạng tự nhiên. Dữ liệu hợp nhất trong quá khứ không bị thay đổi. Để biết thêm thông tin, hãy xem phần Nghĩa vụ lưu giữ và xóa dữ liệu.

Tôi có cần thêm thông số OS (hệ điều hành) vào các sự kiện của mình không?

  • SDK Android và SDK iOS tự động thêm thông số OS (hệ điều hành).
  • Đối với API S2S, bắt đầu từ ngày 1 tháng 7 năm 2021, bạn phải gửi thông số OS (hệ điều hành) cho các ứng dụng iOS. Nếu bạn không gửi thông số này, dữ liệu được coi là đến từ người dùng iOS 14.5 và điều này ảnh hưởng đến phương thức cung cấp dữ liệu thô.
Bài viết này có hữu ích không?