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 phong phú trong ứng dụng, hãy nhớ đọc các bài viết sau:
- Sự kiện phong phú trong ứng dụng—Tổng quan (bài viết này)
- Sự kiện phong phú trong ứng dụng—Cấu trúc sự kiện
- Bảng điều khiển sự kiện
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.
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ước và thô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ên và Hạn chế.
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:
- 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.
- 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.
- 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 |
Các sự kiện được đề xuất theo ngành kinh doanh
Bảng sau cung cấp đường liên kết đến các bài viết gồm các ví dụ và luồng của các sự kiện trong ứng dụng tiêu biểu mà chúng tôi đề xuất bạn nên ghi nhận theo ngành dọc.
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 tổng quan của bảng điều khiển: Hiển thị hiệu suất thu hút người dùng (UA) LTV theo thời gian thực
- 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
-
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 điều sau khi thêm tên và thông số sự kiện:
- Để 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.
- Đ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.
Điểm hạn chế
Hãy lưu ý những điều sau khi thêm tên và thông số sự kiện:
- 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.
- Tên sự kiện không được bắt đầu bằng các ký tự sau: ", =, +, -.
- 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.
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:
- SDK gửi các sự kiện đến máy chủ AppsFlyer và chờ phản hồi thành công.
- 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.
- 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ủ.
- 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ô.