Tạo biến cho thiết bị di động do người dùng xác định tùy chỉnh trong Trình quản lý thẻ của Google để phù hợp với các yêu cầu cụ thể mà có thể các biến tích hợp chưa xử lý.
Để tạo biến mới do người dùng xác định:
- Trong điều hướng bên trái, nhấp vào Biến.
- Trong phần Biến do người dùng xác định, nhấp vào Mới.
- Nhấp vào Cấu hình biến và chọn loại biến mong muốn.
- Hoàn tất các tùy chọn cho loại biến đã chọn.
- Đặt tên cho biến. Sử dụng lược đồ đặt tên mô tả chức năng của biến, ví dụ: "Biến lớp dữ liệu - Tên sản phẩm".
- Nhấp vào Lưu.
Trình quản lý thẻ hỗ trợ các loại biến do người dùng xác định này cho thiết bị di động:
Firebase
Tên sự kiện
Giá trị được đặt thành "eventNameXYZ" khi mã sau đây trong ứng dụng của bạn được thực thi:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Thông số sự kiện:
Giá trị được đặt thành giá trị của thông số sự kiện Google Analytics (Firebase) cho khóa cụ thể.
Thuộc tính người dùng Firebase
Giá trị được đặt thành giá trị thuộc tính người dùng Google Analytics (Firebase) cho khóa cụ thể.
Tiện ích
Đã bật theo dõi nhà quảng cáo
Đối với Android, biến trả về sẽ là true nếu theo dõi quảng cáo được bật hoặc false nếu người dùng đã chọn không tham gia quảng cáo dựa trên sở thích. Tìm hiểu thêm trong Trung tâm dành cho nhà phát triển Android. Các phiên bản SDK trước phiên bản 4 sẽ luôn trả về false. Đối với iOS phiên bản 6 trở lên, giá trị được đặt thành thuộc tính advertisingTrackingEnabled. Nếu không, giá trị được đặt thành true. Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Cố định
Giá trị được đặt cho chuỗi mà bạn chỉ định.
Cài đặt Google Analytics
Biến Cài đặt Google Analytics được sử dụng trong thẻ Universal Analytics trong các vùng chứa web và thiết bị di động (Firebase) để định cấu hình tập trung và chia sẻ các cài đặt Google Analytics phổ biến được sử dụng trên nhiều thẻ. Khi bạn tạo thẻ Google Analytics bằng Universal Analytics, Trình quản lý thẻ sẽ nhắc bạn chọn hoặc tạo biến Cài đặt Google Analytics. Tìm hiểu thêm.
Bảng tìm kiếm
Giá trị được đặt tùy thuộc vào hướng dẫn trong bảng tìm kiếm. Bảng tra cứu bao gồm hai cột (Bảng trống để minh hoạ cách dữ liệu được sử dụng sau này):
| Khi [select variable] = | Đặt [biến này] thành |
|---|---|
Bảng tìm kiếm cho phép bạn tạo biến có giá trị thay đổi tùy thuộc vào giá trị ở biến khác. Điều này rất hữu ích nếu ứng dụng của bạn được thiết lập theo cách mà giá trị thích hợp (ví dụ: ID theo dõi chuyển đổi) có thể được ánh xạ đến Mã phiên bản ứng dụng hoặc một khía cạnh khác của ứng dụng. Trong ví dụ này, biến có tên ID chuyển đổi sẽ được tạo. Nếu Mã phiên bản ứng dụng là 1.0, thì giá trị được đặt thành “12345”; nếu Mã phiên bản ứng dụng là 1.1, thì giá trị được đặt thành “34567”. Không có giới hạn về số lượng hàng trong bảng tra cứu. Các trường có phân biệt chữ hoa chữ thường.
| Khi {{App Version Code}} bằng | Đặt {{Conversion ID}} thành |
|---|---|
| 1.0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
Số ngẫu nhiên
Giá trị được đặt thành số ngẫu nhiên từ 0 đến 2147483647. Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Dữ liệu vùng chứa
ID vùng chứa
Giá trị là ID công khai của vùng chứa (ví dụ: GTM-ABC42). Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Số phiên bản vùng chứa
Khi vùng chứa ở chế độ xem trước, giá trị của biến này là số phiên bản xem trước của vùng chứa. Nếu không, giá trị của biến này là số phiên bản trực tiếp của vùng chứa. Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Ứng dụng
ID ứng dụng
Giá trị được đặt thành tên gói (Android) hoặc ID ứng dụng (iOS). Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Tên ứng dụng
Giá trị được đặt thành tên ứng dụng. Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Mã phiên bản ứng dụng
Giá trị được đặt thành phiên bản của ứng dụng hiện đang chạy. Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
ID cho quảng cáo
Đối với Android, giá trị được đặt thành ID quảng cáo. Các phiên bản SDK trước phiên bản 4 sẽ luôn trả về một chuỗi trống. Đối với iOS phiên bản 6 trở lên, giá trị được đặt thành mã định danh cho quảng cáo (IDFA). Nếu không, giá trị được đặt thành một chuỗi trống.
Phiên bản SDK
Giá trị được đặt thành phiên bản SDK của hệ điều hành mà ứng dụng được cài đặt. Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Thiết bị
Tên thiết bị
Giá trị được đặt thành tên thiết bị của ứng dụng hiện đang chạy (ví dụ: "Samsung Android", "Pixel 2"). Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Ngôn ngữ
Giá trị được đặt thành mã ngôn ngữ gồm hai chữ cái biểu thị tùy chọn ngôn ngữ thiết bị do người dùng đặt. Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Phiên bản hệ điều hành
Giá trị được đặt thành phiên bản của hệ điều hành mà ứng dụng được cài đặt. Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Nền tảng
Giá trị được đặt thành nền tảng của ứng dụng hiện đang chạy (ví dụ: "Android", "iOS"). Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Độ phân giải màn hình
Giá trị được đặt thành độ phân giải màn hình của thiết bị có ứng dụng hiện đang chạy. Định dạng là "chiều rộng x chiều cao", ví dụ: "1920 x 1080". Trong hầu hết các trường hợp, bạn nên sử dụng biến tích hợp tương đương.
Khác
Lệnh gọi hàm
Giá trị được đặt thành giá trị trả về của cuộc gọi cho chức năng được đăng ký trước. Để tìm hiểu thêm, hãy tham khảo tài liệu SDK Android hoặc iOS.
Bộ sưu tập giá trị (chỉ bộ chứa cũ)
Biến này chứa các cặp khóa-giá trị được thể hiện dưới định dạng JSON. Bạn sử dụng Tập hợp giá trị để đặt giá trị cấu hình cho ứng dụng của mình. Ví dụ: đối với ứng dụng trò chơi đua xe, bạn có thể xác định biến "Cài đặt ứng dụng" thuộc loại Tập hợp giá trị với các giá trị như sau:
{
"max-fuel": 200,
"starting-fuel": 100,
"fuel-burn-rate": 20
}
Ứng dụng dành cho thiết bị di động của bạn có thể truy xuất giá trị trong biến bằng cách cung cấp khóa. Ví dụ:
public class MainActivity {
// Add your public container ID.
private static final String CONTAINER_ID = "XXX-YYY";
// Container configuration value keys, used later
// for retrieving values.
private static final String MAX_FUEL_KEY = "max-fuel";
private static final String INIT_FUEL_KEY = "init-fuel";
private static final String FUEL_BURN_KEY = "fuel-burn-rate";
// Rest of your onCreate code.
}
}
/*
* Phương pháp để cập nhật giá trị cấu hình trò chơi bằng cách sử dụng
* Vùng chứa Trình quản lý thẻ của Google.
*/
public void updateConfigurationFromContainer(Container container) {
// Get reference to the container.
Container container = mFutureContainer.get();
// Update game settings using Container
// configuration value keys.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
Biến Tập hợp giá trị có trình kích hoạt được liên kết với biến. Đối với các giá trị cấu hình áp dụng cho tất cả phiên bản ứng dụng của bạn, đặt trình kích hoạt được bật của bạn thành giá trị Always đã xác định trước. Tham khảo tài liệu dành cho nhà phát triển (Android hoặc iOS) để biết chi tiết về cách sử dụng biến Tập hợp giá trị.