Cài đặt Mixpanel

Mixpanel là đối tác phân tích (analytics partner) có tích hợp với Adjust. Tích hợp cho phép Mixpanel nhận được dữ liệu do Adjust đo lường thông qua callback tự động. Bạn có thể sử dụng dữ liệu này cùng công cụ của đối tác để phân tích dữ liệu.

Dưới đây là hướng dẫn cài đặt tính năng đo lường Mixpanel. Hướng dẫn gồm các bước kích hoạt tích hợp và xác định loại dữ liệu mà Adjust có thể chia sẻ cho Mixpanel.

Trước khi bắt đầu

Yêu cầu

Quyền truy cập Admin, Editor hoặc Custom Editor.
Adjust SDK phiên bản 4.0.0 trở lên, để liên kết tham số SDK với tham số của Mixpanel. Chọn hướng dẫn phù hợp với nền tảng đang sử dụng.

Thông tin tài khoản

TOKEN

Để được hỗ trợ tìm thông tin tài khoản, vui lòng liên hệ với đại diện Mixpanel.

Chọn Mixpanel và ứng dụng trên Campaign Lab

Tại mục Campaign Lab , chọn Đối tác.
Chọn Đối tác mới > Mixpanel. Chọn Tiếp theo để chuyển sang màn hình kế tiếp.
Trên màn hình Lựa chọn ứng dụng , chọn ứng dụng mà bạn muốn tạo liên kết, sau đó kích hoạt tích hợp để chia sẻ dữ liệu cho Mixpanel.
Chọn Tiếp theo.

Kích hoạt tính năng chia sẻ dữ liệu

Kích hoạt tính năng chia sẻ dữ liệu để kích hoạt tích hợp giữa Adjust và Mixpanel. Để kích hoạt tính năng chia sẻ dữ liệu:

Nhập TOKEN.

Sau khi bạn kích hoạt tính năng chia sẻ dữ liệu cho Mixpanel, Adjust sẽ mặc định gửi các dữ liệu sau cho Mixpanel:

lượt cài đặt
lượt gỡ cài đặt
lượt cài đặt lại
lượt cài đặt lại_tái phân bổ
tái phân bổ
sự kiện

Cài đặt tính năng chia sẻ dữ liệu

Nếu ứng dụng của bạn là đa nền tảng (multi-platform app), và tính năng chia sẻ dữ liệu đã được kích hoạt cho các nền tảng này, thì bạn có thể thực hiện các thao tác sau:

Chọn Sử dụng cài đặt riêng của nền tảng nếu bạn muốn cài đặt tính năng chia sẻ dữ liệu khác nhau cho mỗi nền tảng.
Chọn Sử dụng cài đặt chung nếu bạn muốn cài đặt tính năng giống nhau cho tất cả nền tảng.

Tại mục Dữ liệu nào sẽ được chia sẻ mặc định? , kiểm tra lại các dữ liệu mà Adjust mặc định chia sẻ cho Mixpanel:

lượt cài đặt
lượt gỡ cài đặt
lượt cài đặt lại
lượt cài đặt lại_tái phân bổ
tái phân bổ
sự kiện

Gửi dữ liệu bổ sung

Chọn số lượng và loại dữ liệu mà bạn muốn chia sẻ cho Mixpanel qua callback. Mixpanel có thể sử dụng dữ liệu bạn chia sẻ để cải thiện dịch vụ.

Để gửi thêm dữ liệu khác, bạn có thể kiểm tra lại các mục sau và thực hiện các thay đổi cần thiết:

Chi phí quảng cáo (Ad spend)

Sử dụng tính năng chia sẻ dữ liệu chi phí quảng cáo để chia sẻ loại dữ liệu này cho Mixpanel. Loại dữ liệu này có thể giúp Mixpanel tối ưu hóa chiến dịch.

Adjust chỉ gửi Mixpanel dữ liệu chi phí quảng cáo nhận được qua callback. Dữ liệu này được lấy từ các giải pháp mà bạn đã cài đặt, và khả dụng với Mixpanel:

Nếu Mixpanel muốn nhận dữ liệu hoàn chỉnh, bạn có thể cài đặt tính năng Ad spend third-party storage export cho Mixpanel.

Giải pháp tăng trưởng:

Để chia sẻ dữ liệu này, bạn cần mua gói SpendWorks của Adjust. Để mua gói dịch vụ, vui lòng liên hệ với đại diện bán hàng.

Doanh thu in-app (từ giao dịch in-app)

Nếu bạn chọn chia sẻ dữ liệu doanh thu in-app, Mixpanel sẽ nhận được dữ liệu số tiền và sự kiện doanh thu. Bạn cần liên kết sự kiện để có thể chia sẻ dữ liệu này; lưu ý, sự kiện phải tạo doanh thu.

Liên kết event

Liên kết sự kiện mà bạn muốn chia sẻ, với giá trị mà Mixpanel có thể nhận được. Đối với sự kiện không được liên kết, dữ liệu liên quan đến sự kiện sẽ không được chia sẻ cho Mixpanel.

Liên kết các sự kiện riêng lẻ

Nếu bạn sở hữu ứng dụng đa nền tảng (multi-platform app), thì có thể chia sẻ cho Mixpanel các sự kiện khác nhau tùy theo từng nền tảng. Tức bạn có thể:

Cài đặt sự kiện riêng lẻ để quản lý chiến dịch theo từng nền tảng.
Điều chỉnh tính năng chia sẻ dữ liệu của từng nền tảng.

Để chọn sự kiện in-app mà muốn bạn muốn gửi trực tiếp cho Mixpanel, thực hiện các bước sau tại mục Liên kết sự kiện .

Chọn Liên kết sự kiện.
Mở danh sách Sự kiện của Adjust , chọn sự kiện mà bạn muốn chia sẻ cho Mixpanel.
Tại mục Sự kiện đối tác , chọn sự kiện của Mixpanel, đảm bảo sự kiện đó tương ứng với sự kiện của Adjust.
1. Đối với ứng dụng đơn nền tảng và ứng dụng đa nền tảng nhưng chỉ bật tính năng chia sẻ dữ liệu cho một nền tảng, thì bạn chỉ cần liên kết sự kiện cho nền tảng đó. Còn đối với ứng dụng đa nền tảng nhưng bật tính năng chia sẻ dữ liệu cho nhiều nền tảng, thì bạn có các lựa chọn sau:
  - Chọn Sử dụng biểu đồ liên kết riêng của nền tảng để liên kết sự kiện theo từng nền tảng một, hoặc để không liên kết sự kiện cho một số nền tảng nhất định.
  - Chọn Sử dụng biểu đồ liên kết chung để liên kết chung sự kiện cho tất cả nền tảng.
2. Trong danh sách Sự kiện của đối tác , chọn sự kiện có sẵn hoặc nhập sự kiện do bạn đặt tên - sự kiện này sẽ liên kết với sự kiện của Adjust.
Chọn Áp dụng .

Giờ đây, Mixpanel sẽ nhận được dữ liệu về sự kiện in-app của từng sự kiện được liên kết.

Liên kết tất cả sự kiện

Nếu Mixpanel cho phép liên kết tự động tất cả sự kiện, thì tại mục Liên kết sự kiện , chọn Liên kết tất cả sự kiện. Như vậy bạn đỡ mất thời gian liên kết từng sự kiện một.

Sau bước trên, Mixpanel sẽ nhận được dữ liệu sự kiện in-app của tất cả sự kiện được liên kết.

Liên kết tham số

Bạn cần liên kết tham số để gửi dữ liệu tùy chỉnh cho Mixpanel.

Với tham số đối tác (khả dụng trên Adjust SDK phiên bản 4.0 trở lên), Adjust có thể thu thập và trực tiếp gửi các điểm dữ liệu tùy chỉnh từ ứng dụng đến Mixpanel. Như vậy, Mixpanel có thể nhận được dữ liệu chi tiết cho từng sự kiện được liên kết.

Trước khi thêm tham số đối tác mới vào SDK, vui lòng đảm bảo rằng, các tham số đối tác hiện có không đáp ứng được yêu cầu.

Để chia sẻ tham số đối tác cho Mixpanel, thực hiện các bước sau.

Cài đặt tham số đối tác trong Adjust SDK.
- Xem mục Trước khi bắt đầu của tất cả liên kết nền tảng phát triển SDK.
Tại mục Cài đặt tính năng chia sẻ dữ liệu , chọn Tham số.
Đến mục Liên kết tham số , chọn tham số mà bạn muốn gửi đến mạng quảng cáo:
1. Chọn Liên kết tham số.
2. Tại trường Tham số SDK , nhập tên tham số SDK mà bạn muốn chia sẻ cho mạng quảng cáo.
3. Tại trường Tham số đối tác , nhập tham số mạng quảng cáo tương ứng với tham số SDK.

Lưu ý:

Nếu bạn cài đặt tham số đối tác trong Adjust SDK nhưng không cài đặt tính năng liên kết tham số đối tác, thì Adjust sẽ chuyển tiếp tham số theo tên được ghi trong Adjust SDK.

Kích hoạt Mixpanel cho ứng dụng

Trên màn hình Kiểm tra lại cài đặt , kiểm tra lại các thao tác đã thực hiện. Bạn có thể quay lại để thực hiện thay đổi nếu cần:

Ứng dụng đã chọn
Cách chia sẻ dữ liệu

Chọn Kích hoạt đối tác để kích hoạt Mixpanel cho ứng dụng. Đối tác phân tích không dùng link cho chiến dịch. Sau khi kích hoạt tích hợp, chúng tôi sẽ gửi dữ liệu phân bổ và dữ liệu in-app event cho đối tác qua callback tự động, để bạn có thể sử dụng dữ liệu trong công cụ của đối tác.

Hướng dẫn cài đặt đối tác

Nếu bạn đang không sử dụng Mixpanel SDK trong ứng dụng, thì nên sử dụng Mixpanel server-to-server. Nếu bạn đang sử dụng Mixpanel SDK, thì có thể sử dụng quyền truy cập dữ liệu phân bổ in-app của Adjust để thêm dữ liệu phân bổ vào Mixpanel SDK, như được mô tả trong tài liệu iOS và Android.

Tham số có sẵn

Mixpanel cho phép bạn gửi một tập hợp tham số có sẵn (predefined parameter). Nếu bạn gán một tham số bất kỳ trong tập hợp này vào một sự kiện trong Adjust SDK, thì tham số sẽ được chuyển tiếp đến Mixpanel. Bạn có thể tìm thêm thông tin về cách gán tham số đối tác trong SDK Readme. Bên dưới là danh sách các tham số có sẵn và được Mixpanel chấp nhận:

Parameter key> Value

product_id> product ID của một giao dịch
product_spec> thông số kỹ thuật của sản phẩm

Nếu bạn muốn tìm hiểu thêm chức năng của tích hợp, vui lòng xem bài viết về Mixpanel. Nếu bạn có bất kỳ câu hỏi nào liên quan đến thông tin trong bài viết, vui lòng liên hệ với partners@adjust.com.

Mixpanel chỉ chấp nhận callback có chứa distinct ID của họ. Để callback gửi đi có chứa distinct ID của Mixpanel ("mixpanel_uuid"), cài đặt ID này dưới dạng tham số đối tác trong Adjust SDK.

Quy trình hiện tại diễn ra theo các bước sau:

Bên phía Mixpanel

Người dùng tải ứng dụng (nhưng chưa đăng ký)
Mixpanel được khởi chạy, distinct ID được tạo ngẫu nhiên (ví dụ random12345)
SDK theo dấu một vài sự kiện có gán distinct_id random12345
Người dùng đăng ký bằng email(USER-A), bạn gọi lệnh identify(USER-A)
SDK theo dấu các sự kiện tiếp theo dưới dạng email(USER-A)
Máy chủ hợp nhất sự kiện được theo dấu dưới dạng email (USER-A) với sự kiện được theo dấu dưới dạng random12345

Giải pháp bên phía Adjust

Máy khách đọc Mixpanel distinct_id (ví dụ random12345)
Máy khách gửi random12345 cho Adjust dưới dạng tham số đối tác trước khi khởi chạy Adjust SDK
Adjust sử dụng random12345 để gửi dữ liệu lượt cài đặt/sự kiện, đảm bảo tất cả dữ liệu được đặt chung trong một hồ sơ.

Để biết thêm thông tin về tham số và các yêu cầu cài đặt khác, vui lòng liên hệ với đại diện của Mixpanel.

Danh sách tất cả tham số được chuyển tiếp đến Mixpanel

Mixpanel yêu cầu Adjust gửi các tham số (điểm dữ liệu) sau trong callback:

Trường dữ liệu	Thông tin
`{android_id}`	Android ID (chỉ áp dụng với Android)
`{gps_adid}`	Google Play Store advertising ID
`{idfa}`	ID dành cho nhà quảng cáo (advertiser) (chỉ áp dụng với iOS)
`{idfv}`	iOS ID dành cho nhà cung cấp (vendor), viết hoa
`{ip_address}`	Địa chỉ IP của thiết bị
`{os_name}`	Hệ điều hành của thiết bị
`{revenue_usd}`	Doanh thu, tính theo đô-la Mỹ
`{adgroup_name}`	Tên adgroup, được lấy từ trình theo dõi
`{campaign_name}`	Tên campaign, được lấy từ trình theo dõi
`{created_at}`	Dấu thời gian của hoạt động
`{creative_name}`	Tên creative, được lấy từ trình theo dõi
`{network_name}`	Tên network, được lấy từ trình theo dõi