Cài đặt giải pháp đo lường cho Steam game
Hướng dẫn này bao gồm: các bước cài đặt ứng dụng game Steam, 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ả. Người dùng có thể tải game thông qua Steam store hoặc store nội bộ của nhà phát hành, trên máy Mac và Windows.
Để đo lường Steam game, bạn cần thực hiện các bước sau:
- Cài đặt ứng dụng mới tại AppView.
- Cài đặt S2S API để ghi lại dữ liệu phiên truy cập.
- Cài đặt liên kết tại Campaign Lab.
Cài đặt ứng dụng game Steam
Để 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:
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.
- Chọn PC > Steam . Áp dụng cho Steam store trên máy Windows và Mac.
- Nhập App ID , nếu bạn chưa có App ID, chọn Tôi chưa có App ID.
- (Tùy chọn) Chọn Chuyển hướng tất cả lượt click đến custom URL rồi nhập Custom URL, nếu bạn muốn đưa người dùng đến một trang web khác không phải Steam store. Bạn có thể cân nhắc phương án này nếu ứng dụng không có App ID.
- Chọn Lưu.
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/sessionPOST 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:
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:
|
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 |
Bạn có thể gửi steam_id của người dùng cho Adjust thông qua tham số external_device_id.
Ví dụ về yêu cầu (request)
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).