Cài đặt ACTIN
ACTIN 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 ACTIN 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 ACTIN. 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 ACTIN.
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 ACTIN. Chọn hướng dẫn phù hợp với nền tảng đang sử dụng.
iOS / Android / Windows / Unity / React Native / Flutter / Adobe Air / Cordova / Marmalade / Xamarin / Cocos2d-x / Titanium / Corona
Thông tin tài khoản
ACTIN TOKEN
- Để được hỗ trợ tìm thông tin tài khoản, vui lòng liên hệ với đại diện ACTIN.
Chọn ACTIN 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 > ACTIN. 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 ACTIN.
- 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à ACTIN. Để kích hoạt tính năng chia sẻ dữ liệu:
- Nhập ACTIN TOKEN.
Sau khi bạn kích hoạt tính năng chia sẻ dữ liệu cho ACTIN, Adjust sẽ mặc định gửi các dữ liệu sau cho ACTIN:
- lượt cài đặt
- phiên truy cập
- lượt gỡ cài đặt
- lượt cài đặt lại_tái phân bổ
- tái phân bổ
- sự kiện
- lượt cài đặt bị từ chối
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 ACTIN:
- lượt cài đặt
- phiên truy cập
- lượt gỡ cài đặt
- lượt cài đặt lại_tái phân bổ
- tái phân bổ
- sự kiện
- lượt cài đặt bị từ chối
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 ACTIN qua callback. ACTIN 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:
Doanh thu in-app (từ giao dịch in-app)
Nếu bạn chọn chia sẻ dữ liệu doanh thu, ACTIN 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.
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), ACTIN 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.
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.
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, ACTIN sẽ nhận được dữ liệu liên quan đến hoạt động truy cập ứng dụng.
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 ACTIN.
Liên kết event
Liên kết sự kiện mà bạn muốn chia sẻ, với giá trị mà ACTIN 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 ACTIN.
Để chọn sự kiện in-app mà muốn bạn muốn gửi trực tiếp cho ACTIN, 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 ACTIN.
- Mở 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. Bạn cần liên kết sự kiện với một số giá trị.
- Chọn Áp dụng .
Giờ đây, ACTIN 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 tham số
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 ACTIN. Như vậy, ACTIN 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 ACTIN, thực hiện các bước sau.
- Cài đặt tham số đối tác trong Adjust SDK: iOS , Android)
- Đánh dấu tích vào hộp kiểm nằm cạnh Chia sẻ dữ liệu tham số.
- Liên kết sự kiện
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 ACTIN 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 ACTIN 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.
Danh sách tất cả tham số được chuyển tiếp đến ACTIN
ACTIN 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 |
{adid} | Adjust device ID (tất cả nền tảng) |
{android_id} | Android ID (chỉ áp dụng với Android) |
{api_level} | Cấp độ API (chỉ áp dụng với Android) |
{city} | Thành phố |
{click_attribution_window} | Khung thời gian phân bổ được cài đặt cho device matching (tính theo giờ) |
{country_subdivision} | Đơn vị hành chính, ví dụ: bang |
{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 |
{deeplink} | Deep link URL được thêm vào click URL |
{device_name} | Số hiệu của thiết bị |
{device_type} | Loại thiết bị |
{environment} | Môi trường hiện tại của Adjust SDK |
{fire_adid} | Fire OS advertising identifier |
{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 |
{impression_attribution_window} | Khung thời gian phân bổ được cài đặt cho impression matching (tính theo giờ) |
{ip_address} | Địa chỉ IP của thiết bị |
{isp} | Nhà cung cấp dịch vụ internet |
{language} | Mã ngôn ngữ gồm hai ký tự |
{mac_md5} | MAC MD5 hash, viết hoa |
{match_type} | Phương pháp phân bổ |
{nonce} | Chuỗi bao gồm chữ và số ngẫu nhiên, viết thường (duy nhất cho từng callback) |
{os_name} | Hệ điều hành của thiết bị |
{os_version} | Số phiên bản của hệ điều hành |
{partner_parameters} | Tham số đối tác tùy chỉnh do Adjust SDK hoặc yêu cầu S2S thu thập được, sau đó gửi đến nhà cung cấp dịch vụ bên thứ ba qua postback |
{postal_code} | Mã bưu chính của địa chỉ IP |
{random_user_id} | User ID ngẫu nhiên (của từng thiết bị) |
{random} | Số ngẫu nhiên (duy nhất cho từng callback) |
{reattribution_attribution_window} | Khung thời gian phân bổ được cài đặt cho tái phân bổ (tính theo giờ) |
{reftag} | Thẻ tham chiếu thiết bị ngẫu nhiên |
{reporting_currency} | Mã tiền tệ ISO 4217 được dùng trong báo cáo trên dashboard |
{reporting_revenue} | Dữ liệu doanh thu được ghi nhận trên Adjust dashboard (dữ liệu đã được làm tròn, tùy quy ước của từng đơn vị tiền tệ) |
{revenue} | Doanh thu được gửi từ Adjust SDK, tính theo cent |
{sdk_version} | Phiên bản Adjust SDK (của từng ứng dụng) |
{session_count} | Số phiên truy cập do Adjust SDK ghi nhận |
{time_spent} | Thời lượng phiên truy cập hiện tại của người dùng, tính bằng giây |
{timezone} | Múi giờ |
{tracking_enabled} | 1 nếu tính năng theo dõi được bật, 0 nếu tính năng không được bật |
{tracking_limited} | 1 nếu tính năng theo dõi bị hạn chế, 0 nếu tính năng không bị hạn chế |
{user_agent} | User agent đến, dạng thô |
{win_adid} | Windows advertising identifier |
{win_hwid} | Windows Store hardware ID |
{win_naid} | Windows Store network adapter ID |
{win_udid} | Windows Phone unique device ID |
{activity_kind} | Loại hoạt động của người dùng |
{adgroup_name} | Tên adgroup, được lấy từ trình theo dõi |
{app_id} | Store App ID hoặc Google Play Store |
{app_name} | Tên của ứng dụng |
{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 |
{click_time} | Dấu thời gian của lượt click được phân bổ |
{connection_type} | Loại kết nối internet |
{conversion_duration} | Khoảng thời gian giữa lượt click và lượt cài đặt hoặc tái phân bổ, tính bằng giây |
{created_at_milli} | Dấu thời gian của hoạt động, tính theo mili giây |
{creative_name} | Tên creative, được lấy từ trình theo dõi |
{engagement_time} | Dấu thời gian của lượt tương tác |
{impression_based} | 1 nếu là tương tác đến từ việc xem quảng cáo, 0 nếu không phải |
{impression_time} | Dấu thời gian của lượt hiển thị được phân bổ |
{install_begin_time} | Thời điểm ứng dụng bắt đầu được tải xuống (chỉ áp dụng với Android và Google Play Store) |
{install_finish_time} | Thời điểm ứng dụng được tải xuống hoàn tất |
{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) |
{is_organic} | 1 nếu là lượt truy cập tự nhiên (organic), 0 nếu không phải |
{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 |
{reattributed_at} | Dấu thời gian tái phân bổ |
{referral_time} | Thời điểm người dùng vào trang Play Store (chỉ áp dụng với Android và Google Play Store) |
{reinstalled_at} | Dấu thời gian của lượt cài đặt lại |
{rejection_reason} | Lý do từ chối phân bổ |
{store} | Store đích của lượt click |
{time_to_reinstall} | Khoảng thời gian giữa lượt gỡ cài đặt gần nhất và lượt cài đặt lại theo sau, tính bằng giây |
{time_to_uninstall} | Khoảng thời gian giữa lượt cài đặt (hoặc lượt cài đặt lại gần nhất) và lượt gỡ cài đặt theo sau, tính bằng giây |
{tracker_name} | Tên hiện tại của trình theo dõi |
{uninstalled_at} | Dấu thời gian của lượt gỡ cài đặt (ước tính dựa trên thời gian của phiên truy cập cuối cùng) |