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.

Marketer

Cài đặt giải pháp đo lường cho Microsoft Store và Native PC game

Giải pháp đo lường PC & Console của Adjust giúp bạn nhận thông tin phân bổ quan trọng liên quan đến ứng dụng game phát hành trên Mac và Windows. Sau khi bạn cài đặt giải pháp, Adjust sẽ tiến hành phân tích tác động của quảng cáo trong việc thúc đẩy số lượt cài đặt, phiên truy cập và sự kiện in-app của native game trên Mac và Windows. Giải pháp còn cung cấp cohort, giúp bạn phân tích dữ liệu phân bổ cụ thể, ví dụ: xem xét quá trình người dùng lên cấp trong một khoảng thời gian xác định.

Hướng dẫn này bao gồm: các bước cài đặt ứng dụng game, cách thiết lập kết nối Server-to-Server (S2S) API an toàn, và cách quản lý liên kết hiệu quả.

Để đo lường PC native game, bạn cần thực hiện các bước sau:

Cài đặt ứng dụng PC

Để thêm và cài đặt ứng dụng PC, thực hiện các bước sau:

Tại mục AppView , chọn Tất cả ứng dụng.
Chọn Ứng dụng mới .
Tại mục Nhập thông tin ứng dụng , nhập tên ứng dụng, chọn đơn vị tiền tệ sử dụng trong báo cáo, và kiểm tra liệu ứng dụng game có cần tuân thủ các quy định sau hay không:
- Quy định COPPA. Yêu cầu tuân thủ COPPA chỉ áp dụng với các công ty tại Mỹ. Tìm hiểu thêm về COPPA tại đây.
- Google DMA . Yêu cầu tuân thủ Google DMA chỉ áp dụng cho ứng dụng có tệp người dùng nằm ngoài lãnh thổ Khu vực kinh tế châu Âu (EEA). Tìm hiểu thêm về Google DMA tại đây.
Chọn Thêm ứng dụng .
Chọn Thêm nền tảng để kết nối nền tảng với ứng dụng game.
1. Chọn PC > Windows .
2. Kết nối nền tảng theo một trong hai cách sau:
  - Nếu bạn phát hành game trên Microsoft Store, chọn Microsoft Store rồi nhập App ID , nếu bạn chưa có App ID, chọn Tôi chưa có App ID.
  - Nếu bạn phát hành game trên store nội bộ, chọn Native PC , sau đó chọn Chuyển hướng tất cả lượt click đến custom URL , rồi nhập URL.
3. Chọn Lưu.

Tại mục Thông tin ứng dụng , bạn có thể chỉnh sửa cách thức hiển thị của tất cả liên kết khi liên kết được chia sẻ trên ứng dụng mạng xã hội.
Trên tab Sự kiện , thêm tên sự kiện in-app để đo lường hoạt động của người chơi game.
Trên tab Cài đặt phân bổ , cài đặt giải pháp phân bổ (device matching, probabilistic modeling và phân bổ tạm thời) và giải pháp tái phân bổ.
- Kích hoạt probabilistic modeling cho cả lượt click và lượt hiển thị. Bạn nên đặt khung thời gian phân bổ (attribution window) là 24 giờ. Nếu bạn muốn đặt khung thời gian dài hơn, vui lòng liên hệ với bộ phận tích hợp theo địa chỉ wizards@adjust.com.
Trên tab Quản lý dữ liệu , cài đặt server callback hoặc cloud storage upload để nhận dữ liệu thô, hoặc sử dụng Testing console để xem dữ liệu của thiết bị thử nghiệm.
Tại tab Bảo vệ , cài đặt giải pháp Bảo mật S2S để lấy token cho bước cài đặt S2S API.

Cài đặt Adjust S2S API

Sử dụng Adjust S2S API để kết nối ứng dụng với Adjust, sau đó tiến hành đo lường phiên truy cập và sự kiện của người dùng mà không cần phải điều chỉnh code của ứng dụng.

Tiếp tục sử dụng endpoint session cho quá trình cài đặt.

Trước khi bắt đầu

Máy chủ của Adjust sử dụng các biện pháp kiểm tra tính nhất quán nghiêm ngặt, ngăn tình trạng lạm dụng hoặc quá tải hệ thống. Phân bổ S2S là một tích hợp chuyên biệt, nên không thể sử dụng cùng với Adjust SDK.

Đọc bài viết Danh sách kiểm tra: Phân bổ S2S để xem tất cả hạn chế nếu sử dụng S2S thay cho tích hợp SDK.
Bạn phải gửi request đến máy chủ Adjust theo đúng trình tự diễn biến xảy ra trên thiết bị.

Xác thực

Khi cài đặt bảo mật S2S, bạn có thể bảo mật phiên truy cập S2S và giảm thiểu yêu cầu giả mạo (spoofed request). Sau khi bạn hoàn tất phần cài đặt, mỗi yêu cầu đến đều phải chứa token xác thực được tạo trên Adjust dashboard. Nếu yêu cầu không chứa token hoặc chứa token không hợp lệ, thì máy chủ sẽ từ chối yêu cầu.

Endpoint

Endpoint session giúp bạn ghi lại dữ liệu phiên truy cập khi người dùng khởi chạy game. Một phiên truy cập được ghi nhận khi một trong hai trường hợp sau xảy ra: người dùng mở lại game, trước đó đã tắt hẳn game; hoặc người dùng quay lại chơi game, trước đó để game chạy nền và sử dụng ứng dụng khác. Để tránh tiêu tốn tài nguyên không cần thiết, máy chủ của Adjust chỉ ghi nhận phiên truy cập mới với điều kiện phiên truy cập mới phải cách phiên truy cập liền kề trước 30 phút.

https://s2s.adjust.com/session

POST header

Ủy quyền: Khi bạn gọi Adjust API, hãy gửi giá trị của token xác thực với loại xác thực Bearer.

Ví dụ: Bearer authentication_token.

POST Payload:

Lưu ý:

Tham số có đánh dấu ***** là tham số bắt buộc.

Tham số	Loại dữ liệu	Có trong	Mô tả
`s2s`*	Chuỗi	Truy vấn	Tham số server-to-server: cho phép máy chủ Adjust nhận diện các hoạt động bên phía máy chủ (server-side activity). Giá trị tham số luôn bằng 1.
`app_token`*	Chuỗi	Truy vấn	Token xác thực duy nhất
`os_name`*	Chuỗi	Truy vấn	Sử dụng tham số tương ứng với hệ điều hành của ứng dụng: `windows` `macos`
`ip_address`*	Chuỗi	Truy vấn	Địa chỉ IP của thiết bị
`created_at`*	Dấu thời gian	Truy vấn	Dấu thời gian của thiết bị, thời gian tạo, bao gồm múi giờ.
`external_device_id`*	Chuỗi	Truy vấn	User ID duy nhất, ví dụ Account ID hoặc địa chỉ email đã mã hóa

Ví dụ về yêu cầu (request)

cURL

curl -X 'POST' -d 's2s=1&app_token=a1234b2x3a4o&ip_address=0.0.0.0&created_at=2018-03-23T09:46:47.288Z-0400&sent_at=2018-03-23T09:46:47.288Z-0400&external_device_id=099aa0bc' -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' -H 'User-Agent: Adjust Streaming Job (akka-http)' 'https://s2s.adjust.com/session'

Nếu bạn muốn ghi lại sự kiện bằng S2S API, tham khảo bài viết Sự kiện server-to-server (S2S).

Cài đặt liên kết

Sau khi bạn hoàn tất cải đặt và kiểm thử tích hợp S2S API (tích hợp giữa máy chủ của bạn và Adjust), kết nối Adjust với mạng quảng cáo mà bạn đang hợp tác để chạy quảng cáo.

Sử dụng liên kết để ghi lại dữ liệu phân bổ khi người dùng tương tác với quảng cáo trên các thiết bị khác nhau (ví dụ, người dùng xem quảng cáo trên điện thoại hoặc thiết bị CTV, sau đó chuyển qua PC để tải game). Dưới đây là hai ví dụ mạng quảng cáo cho chiến dịch web:

Truy cập Campaign Lab rồi thực hiện các bước cài đặt sau.

Tại mục Campaign Lab , chọn Đối tác.
Chọn Đối tác mới.
Trên màn hình Chọn đối tác , chọn mạng quảng cáo mà bạn muốn cài đặt.
Trên màn hình Chọn ứng dụng , chọn ứng dụng mà bạn muốn tạo liên kết cho ứng dụng đó.
(Tùy chọn) Trên màn hình Chia sẻ dữ liệu , cài đặt tích hợp giữa mạng quảng cáo và Adjust, và chọn cách thức chia sẻ dữ liệu.
Trên màn hình Cấu trúc liên kết , xem tham số cấu trúc liên kết (link structure parameter) được mạng quảng cáo cung cấp mặc định, và nếu cần, cập nhật giá trị.
(Tùy chọn) Trên màn hình Trang đến , cài đặt deep link, hoặc thêm tham số redirect và fallback vào liên kết.
- Nếu bạn muốn chuyển hướng người dùng đến một game store, đừng quên thêm URL làm tham số redirect bổ sung.
(Tùy chọn) Trên màn hình Cài đặt phân bổ , chọn 'cài đặt phân bổ tùy chỉnh' để phân bổ người dùng mới và người dùng hiện hữu. Các cài đặt này áp dụng cho lượt click và lượt hiển thị. Nếu bạn bỏ qua bước này, thì cài đặt phân bổ của ứng dụng sẽ được sử dụng làm cài đặt phân bổ của liên kết.
- Kích hoạt probabilistic modeling cho cả lượt click và lượt hiển thị. Khung thời gian phân bổ (attribution window) của phương pháp probabilistic modeling nên được đặt thành 24 giờ, nhưng bạn vẫn có thể đặt khung thời gian dài hơn đến 90 ngày. Khung thời gian phân bổ 90 ngày chỉ áp dụng cho PC và Console.
Trên màn hình Kiểm tra lại cài đặt , kiểm tra lại các lựa chọn, và thực hiện các thay đổi cần thiết.
Chọn Tạo liên kết để tạo click URL, impression URL, mã QR và link token. Sau khi liên kết được tạo, tính năng chia sẻ dữ liệu sẽ được kích hoạt (trong trường hợp bạn có cài đặt tính năng này).