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 mà không phải tạo lại và gửi lại tệp nhị phân của ứng dụng cho các chợ ứng dụng. Các 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ẻ để giúp quản lý và thực hiện các thay đổi đối với phương thức triển khai, ngay cả sau khi ứng dụng đã được 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 sẽ được kích hoạt sau.
Điều kiện tiên quyết
- 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.
- Tạo tài khoản Trình quản lý thẻ.
- Định cấu hình vùng chứa của Trình quản lý thẻ.
Các phần sau đây hướng dẫn bạn các bước để định cấu hình và sử dụng Trình quản lý thẻ của Google trong ứng dụng iOS.
1. Thêm Trình quản lý thẻ vào dự án
Thêm gói Trình quản lý thẻ:
CocoaPods
Cách thêm Trình quản lý thẻ thông qua CocoaPods:
Trong dòng lệnh, hãy chạy lệnh sau:
$ sudo gem install cocoapods
Thay đổi đối với thư mục dự án.
Chạy lệnh sau để tạo tệp có tên
Podfile
:$ pod init
Trong
Podfile
, hãy thêm đoạn mã sau:pod 'GoogleTagManager', '~> 6.0'
Chạy lệnh sau để tải và cài đặt các phần phụ thuộc của Trình quản lý thẻ vào dự án của bạn:
$ pod install
Trình quản lý gói Swift
Cách thêm Trình quản lý thẻ thông qua Trình quản lý gói Swift:
- Nếu di chuyển từ một dự án dựa trên CocoaPods, hãy chạy
pod deintegrate
để xoá CocoaPods khỏi dự án Xcode của bạn. Sau đó, bạn có thể xoá tệp CocoaPods.xcworkspace
một cách an toàn. Nếu đang thêm Firebase vào một dự án lần đầu tiên, bạn có thể bỏ qua bước này. - Trong Xcode 12, hãy cài đặt thư viện Trình quản lý thẻ bằng cách chuyển đến File > Tag Manager Packages > Add Package Dependency... (Tệp > Gói Trình quản lý thẻ > Thêm phần phụ thuộc gói...)
Khi lời nhắc xuất hiện, hãy nhập kho lưu trữ GitHub của Trình quản lý thẻ:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
Chọn phiên bản Trình quản lý thẻ mà bạn muốn sử dụng. Đối với các dự án mới, bạn nên sử dụng phiên bản Trình quản lý thẻ mới nhất.
Thêm
-ObjC
vào Cờ trình liên kết khác trong phần Cài đặt bản dựng của dự án.
Tạo vùng chứa iOS nếu tài khoản Trình quản lý thẻ của bạn chưa có:
- Đăng nhập vào tài khoản Trình quản lý thẻ của bạn.
- Nhấp vào QUẢN TRỊ trong thanh điều hướng trên cùng.
- Trên cột CONTAINER, hãy nhấp vào trình đơn thả xuống rồi chọn TẠO CONTAINER.
- Nhập tên vùng chứa.
- Chọn vùng chứa iOS.
- Chọn SDK Firebase (iOS).
- Nhấp vào TẠO.
Tải vùng chứa xuống:
- Đăng nhập vào tài khoản Trình quản lý thẻ của bạn.
- Chọn vùng chứa iOS của bạn.
- Nhấp vào Phiên bản ở thanh điều hướng trên cùng.
Nhấp vào Thao tác > Tải xuống trên phiên bản vùng chứa đã chọn.
Thêm vùng chứa đã tải xuống vào dự án của bạn:
- Sao chép tệp đã tải xuống vào một thư mục có tên
container
trong thư mục gốc của dự án XCode (thường làPROJECT_ROOT/container/GTM-XXXXXX.json
). - Mở Xcode.
- Từ trình đơn Tệp, hãy chọn Thêm tệp vào...
- Chọn thư mục
container
. - Nhấp vào Options (Tuỳ chọn) và nhớ chọn Create library reference (Tạo tham chiếu thư mục).
- Nhấp vào Finish (Hoàn tất).
- Sao chép tệp đã tải xuống vào một thư mục có tên
2. Ghi nhật ký các sự kiện và biến
Trình quản lý thẻ sử dụng các sự kiện, thông số và thuộc tính người dùng do SDK Google Analytics cho Firebase ghi lại để kích hoạt và tạo các thẻ mà bạn đã định cấu hình trong 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 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ẻ
Để nắm bắt 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 Trình quản lý thẻ của Google, bạn có thể thiết lập các biến trong giao diện Trình quản lý thẻ.
Ví dụ: bạn có thể ghi nhật ký sự kiện tuỳ chỉnh sau đây trong ứng dụng của mình:
Analytics.logEvent("share_image", parameters: [
"image_name": name,
"full_text": text
])
Sau đó, bạn có thể định cấu hình các biến Thông số sự kiện mới trong Trình quản lý thẻ như 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 khó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 khó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:
Analytics.setUserProperty(food, forName: "favorite_food")
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 Trình quản lý thẻ của Google để 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 khó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 SDK Google Analytics cho Firebase ghi lại các sự kiện đó. 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. Những sự kiện không bị chặn sẽ được SDK Google Analytics cho Firebase ghi lại.
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à thuộc tính được thu thập tự động trong Trình quản lý thẻ mà không cần thêm mã. Tuy nhiên, bạn không thể chặn chúng.
3. Gửi sự kiện
Các 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 dùng để thiết lập điều kiện kích hoạt. Điều kiện kích hoạt được đánh giá bất cứ khi nào bạn ghi nhật ký một sự kiện Firebase. Theo mặc định, các sự kiện Google Analytics cho Firebase sẽ tự động kích hoạt. Bạn có thể thêm thẻ Google Analytics cho Firebase trong Trình quản lý thẻ để chặn việc gửi các 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 một phiên bản vùng chứa, bạn nên xem trước phiên bản đó để đảm bảo nó hoạt động như dự kiến. Trình quản lý thẻ cho phép bạn xem trước các phiên bản của vùng chứa bằng cách tạo đường liên kết và mã QR trong giao diện web của Trình quản lý thẻ, đồng thời sử dụng chúng để mở ứng dụng của bạn.
Vùng chứa xem trước
Để xem trước vùng chứa, hãy tạo URL xem trước trong giao diện web của Trình quản lý thẻ:
- Đă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 cho 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 trên phiên bản vùng chứa mà bạn muố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.
Lưu URL xem trước này cho các bước sau.
Để bật bản xem trước vùng chứa, bạn phải xác định lược đồ URL xem trước của Trình quản lý thẻ trong danh sách thuộc tính của dự án. Trong phần Loại URL của tệp danh sách thuộc tính của ứng dụng, hãy đăng ký giá trị nhận dạng URL và lược đồ URL sau đây:
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
Dừng ứng dụng và mở URL xem trước trên trình mô phỏng hoặc thiết bị thực để xem trước vùng chứa nháp trong ứng dụng.
Vùng chứa gỡ lỗi
Khi bạn chạy ứng dụng trong trình mô phỏng hoặc ở chế độ xem trước, Trình quản lý thẻ sẽ tự động chuyển chế độ ghi nhật ký sang chế độ chi tiết.
Xuất bản vùng chứa
Sau khi xem trước vùng chứa và xác minh rằng vùng chứa đó đang hoạt động, bạn có thể xuất bản vùng chứa đó. Sau khi bạn đã xuất bản vùng chứa, người dùng ứng dụng dành cho thiết bị di động sẽ có thể sử dụng cấu hình thẻ của bạn.
Thông tin có liên quan
Đọc phần Cấu hình nâng cao.