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 OneSignal

OneSignal 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 OneSignal 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 OneSignal. 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 OneSignal.

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

OneSignal App ID

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

Chọn OneSignal 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 > OneSignal. 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 OneSignal.
  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à OneSignal. Để kích hoạt tính năng chia sẻ dữ liệu:

  1. Nhập OneSignal App ID.

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

  • lượt cài đặt
  • phiên truy cập

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

  • lượt cài đặt
  • phiên truy cập

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

Phiên truy cập

Adjust không tự động gửi callback phiên truy cập, vì số lượng dữ liệu là rất lớn. Nếu bạn chọn chia sẻ dữ liệu phiên truy cập, OneSignal sẽ nhận được dữ liệu liên quan đến hoạt động truy cập ứng dụ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, OneSignal 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à OneSignal 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 OneSignal.

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 OneSignal 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 OneSignal, thực hiện các bước sau tại mục Liên kết sự kiện .

  1. Chọn Liên kết sự kiện.

  2. Mở danh sách Sự kiện của Adjust , chọn sự kiện mà bạn muốn chia sẻ cho OneSignal.

  3. Tại mục Sự kiện đối tác , chọn sự kiện của OneSignal, đả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.

  4. Chọn Áp dụng .

Giờ đây, OneSignal 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 OneSignal 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, OneSignal 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.

Kích hoạt OneSignal 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 OneSignal 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

Bạn cần triển khai push token trong Adjust SDK để yêu cầu (request) được đo lường thành công trên OneSignal dashboard.

Để biết thêm thông tin, vui lòng tham khảo hướng dẫn Adjust SDK: Android, iOS

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

OneSignal 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
{adid}Adjust device ID (tất cả nền tảng)
{country}Mã quốc gia gồm hai ký tự
{currency}Mã tiền tệ gốc theo ISO 4217, do Adjust SDK gửi đến
{event_name}Tên sự kiện, như được hiển thị trên Adjust dashboard
{idfa||gps_adid}IDFA, hoặc GPS ADID nếu giá trị IDFA rỗng
{ip_address}Địa chỉ IP của thiết bị
{language}Mã ngôn ngữ gồm hai ký tự
{last_time_spent}Thời lượng phiên truy cập cuối cùng của người dùng, tính bằng giây
{os_version}Số phiên bản của hệ điều hành
{push_token}Push notification token: tức là, registration token (Android), device token (iOS)
{revenue_float}Doanh thu được gửi từ Adjust SDK, đã được làm tròn theo quy ước của đơn vị tiền tệ
{session_count}Số phiên truy cập do Adjust SDK ghi nhận
{app_version}Số phiên bản ứng dụng (Android), số phiên bản của bản dựng trong gói (iOS)
{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
{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)
{last_session_time}Dấu thời gian của phiên truy cập cuối cùng
{network_name}Tên network, được lấy từ trình theo dõi