Bài viết liên tục được cập nhật, và những phần được cập nhật rất có thể chưa được dịch sang ngôn ngữ của bạn. Để xem thông tin mới nhất, vui lòng chọn ngôn ngữ Tiếng Anh.

Cài đặt Piano Analytics

Piano Analytics 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 Piano Analytics 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 Piano Analytics. 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 Piano Analytics.

Trước khi bắt đầu

Yêu cầu

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Thông tin tài khoản

Collection Domain và Site ID

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

Trên Piano Analytics dashboard:

Trước khi kích hoạt tích hợp Piano Analytics, bạn cần truy cập giao diện Piano Analytics và tạo các sự kiện sau, lưu ý đặt tên cho sự kiện đúng theo tên có trong danh sách dưới đây:

  • adjust.installs
  • adjust.uninstalls
  • adjust.reinstalls
  • adjust.reattributions

Xem hướng dẫn tạo sự kiện trên giao diện Piano Analytics tại đây.

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

  1. Tại mục Campaign Lab , chọn Đối tác.
  2. Chọn Đối tác mới > Piano Analytics. Chọn Tiếp theo để chuyển sang màn hình kế tiếp.
  3. 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 Piano Analytics.
  4. 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à Piano Analytics. Để kích hoạt tính năng chia sẻ dữ liệu:

  1. Nhập Collection Domain và Site ID.

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

  • iượt cài đặt
  • lượt gỡ cài đặt
  • lượt cài đặt lại
  • tái phân bổ

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:

  1. 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.
  2. 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 Piano Analytics:

  • iượt cài đặt
  • lượt gỡ cài đặt
  • lượt cài đặt lại
  • tái phân bổ

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 Piano Analytics qua callback. Piano Analytics 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:

Lượt gỡ cài đặt và cài đặt lại

Nếu bạn chọn chia sẻ dữ liệu lượt gỡ cài đặt (uninstall) hoặc cài đặt lại (reinstall), Piano Analytics sẽ nhận được tất cả dữ liệu liên quan đến lượt gỡ cài đặt và/hoặc lượt cài đặt lại do Adjust đo lường.

Lưu ý:

Dữ liệu lượt gỡ cài đặt và/hoặc lượt cài đặt lại của ứng dụng iOS có thể không nhiều. Để biết thêm thông tin, tham khảo bài viết Đo lường lượt gỡ cài đặt và cài đặt lại.

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 Piano Analytics.

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 Piano Analytics. Như vậy, Piano Analytics 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 Piano Analytics, thực hiện các bước sau.

  1. Cài đặt tham số đối tác trong Adjust SDK.

  2. Tại mục Cài đặt tính năng chia sẻ dữ liệu , chọn Tham số.

  3. Đế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 Piano Analytics 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 Piano Analytics 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

Piano Analytics yêu cầu Visitor ID để liên kết lượt cài đặt ban đầu (initial install) với sự kiện in-app theo sau. Để thực hiện việc này, bạn sẽ cần gửi Visitor ID của Piano Analytics dưới dạng tham số đối tác chung của SDK, và đặt đúng tên của tham số là PAVisitorId . Để biết thêm chi tiết về tham số đối tác chung, vui lòng tham khảo tài liệu của chúng tôi:

Sau đây là ví dụ đoạn code cho Android:

const PAVisitorId = pa.getVisitorId();

Adjust.addGlobalPartnerParameter("PAVisitorId", PAVisitorId);

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

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

Trường dữ liệuThông tin
{session_count}Số phiên truy cập do Adjust SDK ghi nhận
{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
{device_manufacturer}Tên nhà sản xuất thiết bị
{installed_at}Dấu thời gian của lượt cài đặt (tức là, lần mở ứng dụng đầu tiên)
{network_name}Tên network, được lấy từ trình theo dõi