Là nhà phát triển, bạn có thể sử dụng Trình quản lý thẻ của Google để triển khai và quản lý các thẻ và pixel đo lường trong ứng dụng dành cho thiết bị di động của bạn mà không phải tạo lại và gửi lại tệp nhị phân ứng dụng đến thị trường ứng dụng. Những nhà phát triển làm việc với SDK Google Analytics cho Firebase có thể dễ dàng thêm Trình quản lý thẻ vào giúp quản lý và điều chỉnh việc triển khai, ngay cả sau khi ứng dụng đã vận chuyển.
Nhà phát triển có thể ghi lại các sự kiện quan trọng và quyết định thẻ hoặc pixel nào sau này được kích hoạt.
Điều kiện tiên quyết
Trước khi bắt đầu:
- Trong bảng điều khiển của Firebase, hãy thêm ứng dụng của bạn vào dự án Firebase.
- Thiết lập Google Analytics cho ứng dụng của bạn, bao gồm cả việc bật Google Analytics trong dự án Firebase và thêm SDK Google Analytics cho Firebase vào ứng dụng của bạn.
- Tạo tài khoản Trình quản lý thẻ.
- Định cấu hình vùng chứa Trình quản lý thẻ của Google.
Các phần sau đây hướng dẫn các bước định cấu hình và sử dụng Google Trình quản lý thẻ trong ứng dụng Android của bạn.
1. Thêm Trình quản lý thẻ của Google vào dự án
Trong tệp Gradle của mô-đun (thường là
app/build.gradle
), hãy thêm đoạn mã sau phần phụ thuộc trên thư viện Trình quản lý thẻ:dependencies { // ... compile 'com.google.android.gms:play-services-tagmanager:18.1.0' }
Đăng nhập vào tài khoản Trình quản lý thẻ của bạn.
Chọn một vùng chứa thiết bị di động.
Nhấp vào Phiên bản ở thanh điều hướng trên cùng.
Nhấp vào phiên bản vùng chứa mà bạn muốn sử dụng.
Nhấp vào Download (Tải xuống).
Tạo thư mục
app/src/main/assets/containers
nếu chưa có. Sao chép vùng chứa đã tải xuống vào thư mục.
2. Ghi nhật ký các sự kiện và biến
Trình quản lý thẻ sử dụng những sự kiện, thông số và thuộc tính người dùng do SDK Analytics cho Firebase để kích hoạt và tạo những thẻ mà bạn đã thiết lập Trình quản lý thẻ của Google.
Hãy đọc tài liệu dành cho nhà phát triển Firebase để biết hướng dẫn về cách thực hiện ghi nhật ký sự kiện và đặt thuộc tính người dùng.
Định cấu hình các biến trong Trình quản lý thẻ
Thu thập giá trị của các thông số sự kiện và thuộc tính người dùng để sử dụng trong Google Trình quản lý thẻ, bạn có thể định cấu hình các biến trong giao diện Trình quản lý thẻ.
Ví dụ: bạn có thể ghi lại sự kiện tuỳ chỉnh sau đây trong ứng dụng của mình:
Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
Sau đó, bạn có thể thiết lập các biến Thông số sự kiện mới trong Trình quản lý thẻ dưới dạng
sau để thu thập các giá trị image_name
và full_text parameter
:
- Tên biến: Tên hình ảnh
- Loại biến: Thông số sự kiện
- Tên khoá của thông số sự kiện:
image_name
và:
- Tên biến: Văn bản đầy đủ
- Loại biến: Thông số sự kiện
- Tên khoá của thông số sự kiện:
full_text
Tương tự, bạn có thể đặt thuộc tính người dùng sau đây trong ứng dụng của mình:
mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);
Sau đó, bạn có thể thiết lập một biến Thuộc tính người dùng Firebase mới trong Thẻ Google
Trình quản lý để thu thập giá trị favorite_food
:
- Tên biến: Món ăn yêu thích
- Loại biến: Thuộc tính người dùng Firebase
- Tên khoá của thông số sự kiện:
favorite_food
Sửa đổi và chặn sự kiện
Trình quản lý thẻ cho phép bạn sửa đổi và chặn các sự kiện trước khi các sự kiện đó được ghi lại bằng SDK Google Analytics cho Firebase. Việc sửa đổi sự kiện có thể giúp bạn thêm, xoá hoặc thay đổi giá trị của các thông số sự kiện hoặc điều chỉnh tên sự kiện mà không cần cập nhật ứng dụng. Google Analytics cho Firebase sẽ ghi lại các sự kiện không bị chặn SDK.
SDK Google Analytics cho Firebase cũng tự động ghi lại một số sự kiện và thuộc tính người dùng. Bạn có thể sử dụng các sự kiện và tài sản được thu thập tự động trong Trình quản lý thẻ mà không cần phải thêm bất kỳ mã nào. Tuy nhiên, bạn không thể chặn các kênh đó.
3. Gửi sự kiện
Biến tên sự kiện Firebase, biến thông số sự kiện Firebase và các biến khác các biến được dùng để thiết lập điều kiện kích hoạt. Đã đánh giá các điều kiện của điều kiện kích hoạt bất cứ khi nào bạn ghi lại một sự kiện Firebase. Theo mặc định, Google Analytics cho Firebase các sự kiện tự động kích hoạt. Bạn có thể thêm một mục Google Analytics cho Firebase trong Trình quản lý thẻ để chặn gửi sự kiện đến Google Analytics.
4. Xem trước, gỡ lỗi và xuất bản vùng chứa
Trước khi xuất bản phiên bản vùng chứa, bạn sẽ muốn xem trước phiên bản đó để đảm bảo quảng cáo hoạt động như dự kiến. Trình quản lý thẻ của Google cho phép bạn xem trước phiên bản vùng chứa của bạn bằng cách tạo liên kết và mã QR trong giao diện web rồi sử dụng chúng để mở ứng dụng của bạn. Bạn cũng có thể bật tính năng ghi nhật ký chi tiết để gỡ lỗi mọi hành vi không mong muốn.
Xem trước vùng chứa
Trước khi xem trước một vùng chứa, hãy tạo URL xem trước trong Trình quản lý thẻ của Google giao diện web bằng cách chọn phiên bản vùng chứa bạn muốn xem trước, rồi chọn Xem trước. Lưu URL xem trước này cho các bước sau.
![Bạn có thể xem trước URL trong cửa sổ xem trước của Thẻ
Giao diện web của trình quản lý](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/images/preview_example.png?authuser=19&hl=vi)
Cách xem trước vùng chứa (nếu bạn sử dụng Android Studio, hãy chuyển sang bước 3):
Thêm hoạt động xem trước này vào tệp
AndroidManifest
của bạn:<!-- Add preview activity. --> <activity android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity" android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. --> <intent-filter> <data android:scheme="tagmanager.c.com.example.app" /> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE"/> </intent-filter> </activity>
Thay đổi dòng này để bao gồm tên gói của ứng dụng:
<data android:scheme="tagmanager.c.com.example.app"/>
Trong giao diện web của Trình quản lý thẻ của Google, hãy tạo một đường liên kết xem trước:
- Đăng nhập vào tài khoản Trình quản lý thẻ của bạn.
- Chọn một vùng chứa thiết bị di động.
- Nhấp vào Phiên bản ở thanh điều hướng trên cùng.
- Nhấp vào Thao tác > Xem trước phiên bản vùng chứa mà bạn muốn bản xem trước.
- Nhập tên gói của ứng dụng.
- Nhấp vào Tạo đường liên kết bắt đầu xem trước.
Dừng ứng dụng rồi dùng đường liên kết xem trước đã tạo hoặc mã QR để chạy ứng dụng của bạn.
Bạn có thể thoát khỏi chế độ xem trước bằng cách nhấp vào đường liên kết được tạo bằng Tuỳ chọn Tạo đường liên kết xem trước cuối trong giao diện web.
Vùng chứa gỡ lỗi
Để khắc phục sự cố khi triển khai vùng chứa, hãy bật tính năng ghi nhật ký chi tiết:
$ adb shell setprop log.tag.GoogleTagManager VERBOSE
Xuất bản vùng chứa
Sau khi xem trước và xác minh rằng vùng chứa đang hoạt động, bạn có thể xuất bản ứng dụng đó. Sau khi bạn xuất bản vùng chứa, các cấu hình thẻ của bạn sẽ có sẵn cho người dùng ứng dụng dành cho thiết bị di động.
Các bước tiếp theo
Đọc phần Cấu hình nâng cao.