Trình quản lý thẻ của Google dành cho iOS

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à thực hiện các thay đổi đối với 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

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 iOS của bạn.

1. Thêm Trình quản lý thẻ vào dự án

  1. 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:

    1. Trong thiết bị đầu cuối, hãy chạy lệnh sau:

      $ sudo gem install cocoapods

    2. Thay đổi sang thư mục dự án của bạn.

    3. Chạy lệnh sau đây để tạo một tệp có tên Podfile:

      $ pod init

    4. Trong Podfile, hãy thêm đoạn mã sau:

      pod 'GoogleTagManager', '~> 6.0'

    5. Chạy lệnh sau để tải xuống và cài đặt Trình quản lý thẻ vào dự á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:

    1. Nếu di chuyển từ dự án dựa trên CocoaPods, hãy chạy pod deintegrate đến hãy xoá CocoaPods khỏi dự án Xcode của bạn. Do CocoaPods tạo Sau đó, bạn có thể xoá an toàn .xcworkspace tệp. Nếu bạn đang thêm Firebase với một dự án lần đầu tiên, nên bạn có thể bỏ qua bước này.
    2. Trong Xcode 12, hãy cài đặt thư viện Trình quản lý thẻ bằng cách chuyển đến Tệp > Gói Trình quản lý thẻ > Thêm phần phụ thuộc của gói...

    3. Khi lời nhắc xuất hiện, hãy nhập GitHub của Trình quản lý thẻ kho lưu trữ:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git

    4. Chọn phiên bản Trình quản lý thẻ bạn muốn sử dụng. Cho người mới dự án của mình, bạn nên sử dụng phiên bản Trình quản lý thẻ mới nhất.

    5. 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 của bạn.

  2. Tạo vùng chứa iOS nếu tài khoản Trình quản lý thẻ của bạn không có vùng chứa:

    1. Đăng nhập vào tài khoản Trình quản lý thẻ của bạn.
    2. Trong thẻ Tài khoản, hãy chọn vùng chứa iOS của bạn.
    3. Nhấp vào Quản trị ở thanh điều hướng trên cùng.
    4. Trên cột CONTAINER, hãy nhấp vào dấu '+' để tạo vùng chứa.
    5. Nhập tên vùng chứa.
    6. Chọn vùng chứa iOS.
    7. Nhấp vào Tạo.

  3. Tải vùng chứa của bạn xuống:

    1. Đăng nhập vào tài khoản Trình quản lý thẻ của bạn.
    2. Trong thẻ Tài khoản, hãy chọn vùng chứa iOS của bạn.
    3. Nhấp vào Phiên bản ở thanh điều hướng trên cùng.
    4. Chọn phiên bản vùng chứa bạn muốn tải xuống.

    5. Nhấp vào Download (Tải xuống).

  4. Thêm vùng chứa đã tải xuống vào dự án của bạn:

    1. Sao chép tệp đã tải xuống vào thư mục có tên container trong XCode thư mục gốc của dự án (thường là PROJECT_ROOT/container/GTM-XXXXXX.json).
    2. Mở Xcode.
    3. Từ trình đơn Tệp, hãy chọn Thêm tệp vào...
    4. Chọn thư mục container.
    5. Nhấp vào Options (Tuỳ chọn) và đảm bảo phần Create Folder tham chiếu (Tạo tham chiếu đến thư mục) đã chọn.
    6. Nhấp vào Hoàn tất.

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 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:

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

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 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 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ẻ cho phép bạn xem trước các phiên bản của bằng cách tạo các liên kết và mã QR trong giao diện web của Trình quản lý thẻ và bằng cách sử dụng chúng để mở ứng dụng của bạn.

Vùng chứa xem trước

Để xem trước một vùng chứa, hãy tạo URL xem trước trong Trình quản lý thẻ trên web giao diện:

  1. Đăng nhập vào tài khoản Trình quản lý thẻ của bạn.
  2. Chọn một vùng chứa thiết bị di động.
  3. Nhấp vào Phiên bản ở thanh điều hướng trên cùng.
  4. Nhấp vào Thao tác > Xem trước phiên bản vùng chứa mà bạn muốn xem trước.
  5. Nhập tên gói cho ứng dụng của bạn.

  6. Nhấp vào Tạo đường liên kết bắt đầu xem trước.

    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ý

    Hình 1: Nhận URL xem trước từ Giao diện web của Trình quản lý thẻ.

    Lưu URL xem trước này cho các bước sau.

Để bật tính năng 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 thông tin đăng ký tệp danh sách thuộc tính, hãy đăng ký giá trị nhận dạng URL và lược đồ URL sau:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
Đăng ký lược đồ URL xem trước của trình quản lý thẻ trong tệp danh sách thuộc tính.
Hình 2: Thêm lược đồ URL xem trước của Trình quản lý thẻ vào tệp danh sách thuộc tính của ứng dụng.

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 dự thảo trong ứng dụng của bạn.

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ẻ tự động chuyển nhật ký thành chi tiết.

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 phần Cấu hình nâng cao.