Thiết lập cổng thẻ Google cho nhà quảng cáo

Tài liệu này dành cho những người dùng muốn triển khai cổng thẻ Google cho nhà quảng cáo. Bạn nên sử dụng cổng thẻ Google cho nhà quảng cáo để có cấu hình thẻ bền bỉ nhất.

Tổng quan

Cổng thẻ Google cho nhà quảng cáo cho phép bạn triển khai thẻ Google bằng cơ sở hạ tầng bên thứ nhất của riêng mình, được lưu trữ trên miền của trang web. Cơ sở hạ tầng này nằm giữa trang web của bạn và các dịch vụ của Google. Quy trình thiết lập trong tài liệu này sẽ giúp bạn đo lường trang web của mình hiệu quả hơn. Bạn có thể thiết lập cổng này bằng mạng phân phối nội dung (CDN), trình cân bằng tải hoặc máy chủ web hiện có.

Trong chế độ thiết lập thẻ Google tiêu chuẩn, trang web của bạn sẽ yêu cầu thẻ Google từ một miền của Google. Khi thẻ kích hoạt, thẻ sẽ gửi yêu cầu đo lường trực tiếp đến sản phẩm của Google. Với cổng thẻ Google cho nhà quảng cáo, trang web của bạn sẽ tải thẻ Google từ miền của bên thứ nhất. Khi thẻ kích hoạt, một số yêu cầu đo lường sẽ được gửi đến Google bằng miền của bên thứ nhất.

Sơ đồ này minh hoạ luồng thông tin trong cổng thẻ Google cho nhà quảng cáo:

Luồng thông tin về cấu trúc cổng thẻ Google cho nhà quảng cáo.

Trước khi bắt đầu

Hướng dẫn này giả định rằng trang web của bạn đã được định cấu hình với:

Để bắt đầu, hãy chọn loại chế độ thiết lập.

1. Chọn các đường dẫn đo lường

Bạn phải đặt trước một đường dẫn đo lường riêng biệt trên miền trang web của mình để phân phát từng thẻ hoặc vùng chứa Trình quản lý thẻ của Google.

Các yêu cầu đối với đường dẫn gửi dữ liệu đo lường:

  • Đường dẫn không được sử dụng trên miền của bạn.
  • Mỗi đường dẫn không được là đường dẫn gốc /.
  • Mỗi đường dẫn không được dài quá 100 ký tự.

Google Tag Manager:

Nếu đang sử dụng Trình quản lý thẻ của Google, bạn chỉ cần cung cấp Mã vùng chứa (ví dụ: GTM-XXXXXX). Một chế độ thiết lập duy nhất này là đủ cho tất cả các thẻ (như Google Analytics, Google Ads, v.v.) đã được thêm vào vùng chứa đó.

Đối với mỗi vùng chứa hoặc thẻ độc lập duy nhất, bạn sẽ cần một đường dẫn phân phát duy nhất và mã nhận dạng tương ứng.

Để thiết lập cổng thẻ Google cho nhà quảng cáo, hãy chọn một đường dẫn chưa được sử dụng trên trang web của bạn. Để giảm khả năng xung đột với một đường dẫn đã có trên trang web, bạn có thể chọn kết hợp bất kỳ chữ cái và số nào, hoặc nếu muốn có một đường dẫn dễ đọc hơn, bạn có thể chọn sử dụng một từ như /gtm, /metrics, /analytics hoặc bất kỳ từ nào khác mà bạn muốn.

Ví dụ:

Trường hợp sử dụng ID Đường dẫn phân phát thẻ Điểm cuối nguồn
Thẻ độc lập 1 G-12345 /abjfo/ g-12345.fps.goog
Standalone Tag 2 G-67890 /fjdso/ g-67890.fps.goog
Vùng chứa GTM GTM-ABCDEF /cvfjk/ gtm-abcdef.fps.goog

Hãy điền thông tin sau đây để điền sẵn các ví dụ trong tài liệu này.

Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics

Cách xử lý nhiều thẻ hoặc vùng chứa:

Nếu các thẻ của bạn nằm trong cùng một vùng chứa GTM, thì bạn không cần lặp lại quy trình thiết lập này. Bạn chỉ cần thêm một vùng chứa Trình quản lý thẻ của Google và tất cả thẻ bên trong vùng chứa đó sẽ được xử lý.

Nếu thẻ của bạn nằm trong các vùng chứa GTM riêng biệt HOẶC chưa được liên kết... Bạn phải lặp lại quy trình thiết lập này cho từng phiên bản. Điều này áp dụng nếu bạn đang chạy:

  • Nhiều vùng chứa Trình quản lý thẻ của Google riêng biệt.
  • Các thẻ riêng lẻ (ví dụ: G-XXXXXX) không nằm trong vùng chứa.

Khi thực hiện việc này, bạn phải chỉ định một đường dẫn phân phát thẻ riêng biệt cho mỗi vùng chứa hoặc thẻ.

2. Lưu lượng truy cập trên tuyến đường

Phần này giả định rằng trang web của bạn đã sử dụng một CDN hoặc trình cân bằng tải hỗ trợ định tuyến lưu lượng truy cập theo đường dẫn.

Google Cloud

Bạn cần thiết lập một phần phụ trợ mới để tra cứu vị trí địa lý gần đúng của khách truy cập trang web và tạo các quy tắc định tuyến trong Trình cân bằng tải ứng dụng bên ngoài hiện có.

Tạo phần phụ trợ mới

  1. Mở trình cân bằng tải GCP

  2. Trong trình cân bằng tải, hãy mở phần Cấu hình phụ trợ. Tạo một dịch vụ phụ trợ mới. chế độ cài đặt cấu hình phụ trợ

  3. Định cấu hình dịch vụ phụ trợ mới bằng thông tin vị trí địa lý:

    • Chỉ định một tên, chẳng hạn như measurement-be-svc.
    • Đặt Loại phụ trợ thành Nhóm điểm cuối mạng Internet.
    • Đặt Giao thức thành HTTPS và giữ nguyên giá trị được điền sẵn cho Thời gian chờ.
    • Trong phần Phụ trợ, hãy nhấp vào trình đơn thả xuống Nhóm thiết bị đầu cuối mạng Internet rồi tạo một nhóm thiết bị đầu cuối mạng Internet mới:
      • Đặt Loại nhóm điểm cuối mạng thành NEG Internet (Toàn cầu, Khu vực).
      • Đặt Phạm vi thành Toàn cầu.
      • Đặt Thêm qua thành Tên miền đủ điều kiện và cổng.
      • Đặt Tên miền đủ điều kiện thành G-12345.fps.goog.
      • Nhấp vào TẠO để tạo điểm cuối.
      • Đóng thẻ Nhóm điểm cuối mạng để quay lại thẻ Dịch vụ phụ trợ mới.
    • Tìm kiếm tên của nhóm điểm cuối mạng mới rồi chọn nhóm đó.
    • Mở mục Cấu hình nâng cao. Thêm các tiêu đề yêu cầu tuỳ chỉnh sau.
      Tên tiêu đề Giá trị tiêu đề
      Host G-12345.fps.goog
      X-Forwarded-CountryRegion {client_region_subdivision}
      X-Forwarded-Geolocation latlong={client_city_lat_long};city={client_city}
    • Xem xét các chế độ cài đặt khác. Bạn không bắt buộc phải dùng Cloud CDN hay Cloud Armor cho hoạt động tích hợp này, vì vậy, bạn có thể tắt cả hai một cách an toàn.
    • Lưu dịch vụ phụ trợ mới.

Định cấu hình quy tắc định tuyến

  1. Trong trình cân bằng tải, hãy mở mục Quy tắc định tuyến.

  2. Thêm các quy tắc sau về máy chủ lưu trữ và đường dẫn:

    Máy chủ Đường dẫn Phụ trợ
    * /metrics/* measurement-be-svc

  3. Cập nhật cấu hình bộ cân bằng tải.

  4. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/healthy. Trang này phải có văn bản ok. Xác minh rằng thông tin địa lý đang được đưa vào bằng cách chuyển đến: https://example.com/metrics/?validate_geo=healthy. Trang này phải có văn bản ok.

Cloudflare

Để phân phát thẻ trong cổng thẻ Google cho nhà quảng cáo, bạn sẽ tạo một mục nhập CNAME cho một miền con mới, tạo một Quy tắc nguồn gốc để chuyển tiếp các yêu cầu và tạo một Quy tắc biến đổi để thêm thông tin vị trí địa lý. Để hoàn tất quá trình thiết lập này, bạn cần có gói Cloudflare Enterprise. Nếu không có gói Enterprise, hãy cân nhắc sử dụng chế độ thiết lập Cloudflare trong giao diện người dùng.

Tạo mục CNAME

Chọn một miền phụ để đặt trước cho mục nhập CNAME. Điền thông tin sau để điền sẵn các ví dụ trong tài liệu này. CNAME này không bao giờ được hiển thị bên ngoài cấu hình Cloudflare của bạn, vì vậy, tên này là tuỳ ý.

CNAME subdomain: fps
  1. Trong thẻ DNS, hãy mở mục Bản ghi.
  2. Thêm một bản ghi mới có cấu hình sau:
    • Đặt Loại thành CNAME.
    • Đặt Name thành fps.
    • Đặt Target (Mục tiêu) thành G-12345.fps.goog.
  3. Lưu bản ghi CNAME.

Tạo quy tắc nguồn gốc

  1. Trong thẻ Rules (Quy tắc), hãy mở Origin Rules (Quy tắc nguồn gốc) rồi tạo quy tắc.
  2. Nhập tên quy tắc, chẳng hạn như Route measurement.
  3. So khớp các yêu cầu đến dựa trên Biểu thức bộ lọc tuỳ chỉnh và nhấp vào Chỉnh sửa biểu thức.
  4. Dán biểu thức sau vào trình tạo: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
  5. Cập nhật Tiêu đề máy chủ lưu trữ thành Viết lại thành... G-12345.fps.goog.
  6. Cập nhật Bản ghi DNS thành Ghi đè thành... fps.example.com.
  7. Lưu quy tắc nguồn.
  8. Nếu có các Quy tắc nguồn gốc khác, hãy tăng vị trí của Quy tắc mới tạo để quy tắc này sẽ chạy sau bất kỳ đường dẫn ký tự đại diện nào khác.
  9. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/healthy. Trang này phải có nội dung ok.

Thêm thông tin về vị trí địa lý

  1. Trong thẻ Rules (Quy tắc), hãy mở phần Settings (Cài đặt)
  2. Bật tuỳ chọn Thêm tiêu đề vị trí của khách truy cập.
  3. Đợi vài phút để quy tắc được truyền đi. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/?validate_geo=healthy. Trang này sẽ có nội dung ok.

Akamai

Để phân phát thẻ trong cổng thẻ Google cho nhà quảng cáo, bạn cần thêm một quy tắc mới vào tài sản của mình để chuyển tiếp các yêu cầu và thêm thông tin về vị trí địa lý.

Tạo quy tắc chuyển hướng

  1. Tạo phiên bản mới cho cấu hình phân phối trong trình quản lý tài sản
  2. Trong phần Property Configuration Settings (Cài đặt cấu hình tài sản), hãy thêm một Rule mới
    • Nhập tên, chẳng hạn như Route measurement
  3. Thêm một Kết quả trùng khớp mới
    • Đặt trình đơn thả xuống về tiêu chí khớp thành Đường dẫn và là một trong các
    • Đặt giá trị trùng khớp thành /metrics/*
  4. Thêm Hành vi mới
    • Chọn Standard Property Behavior (Hành vi chuẩn của tài sản) rồi chọn hành vi Origin Server (Máy chủ gốc)
    • Đặt Tên máy chủ lưu trữ của máy chủ gốc thành G-12345.fps.goog
    • Đặt Forward Host Header (Chuyển tiếp tiêu đề máy chủ lưu trữ) thành Origin Hostname (Tên máy chủ lưu trữ gốc)
  5. Lưu quy tắc mới và triển khai các thay đổi
    • Hãy nhớ kiểm thử quy tắc chuyển hướng mới trong môi trường dàn dựng trước khi triển khai cho môi trường sản xuất
    • Lưu ý: hãy đảm bảo bạn không có quy tắc nào sửa đổi hoặc xoá tiêu đề phản hồi đi. Điều này có thể khiến các tập lệnh của Google không hoạt động nếu thiếu tiêu đề phản hồi Content-Type.

Thêm thông tin về vị trí địa lý

  1. Chọn Quy tắc chuyển hướng (bạn đã tạo ở trên) trong phần Cài đặt cấu hình tài sản

  2. Thêm một Hành vi mới

    • Chọn Standard Property Behavior (Hành vi tiêu chuẩn của tài sản) rồi chọn hành vi Content Targeting (EdgeScape) (Nhắm mục tiêu theo nội dung (EdgeScape))
    • Đặt Bật thành true

  3. Lưu hành vi mới và triển khai các thay đổi.

    • Hãy nhớ kiểm thử quy tắc chuyển hướng mới trong môi trường dàn dựng trước khi triển khai cho môi trường sản xuất

  4. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/healthy. Trang này phải có văn bản ok. Xác minh rằng thông tin địa lý đang được đưa vào bằng cách chuyển đến: https://example.com/metrics/?validate_geo=healthy. Trang này phải có văn bản ok.

Amazon CloudFront

Để phân phát thẻ bằng cổng thẻ Google cho nhà quảng cáo, bạn sẽ cần định cấu hình hành vi của phân phối để chuyển tiếp các yêu cầu và thêm thông tin về vị trí địa lý.

Thêm một nguồn gốc mới

  1. Chuyển đến trang CloudFront trong Amazon Web Services (AWS)
  2. Chọn Phân phối CloudFront
  3. Trong thẻ Nguồn, hãy tạo một nguồn có các chế độ cài đặt sau:
    • Đặt Miền gốc thành G-12345.fps.goog
    • Đặt Giao thức thành Chỉ HTTPS

Tạo hành vi chuyển hướng

  1. Chuyển đến trang CloudFront trong AWS
  2. Chọn Phân phối CloudFront
  3. Trên thẻ Hành vi, hãy tạo một Hành vi mới với các chế độ cài đặt sau:
    • Đặt Mẫu đường dẫn thành /metrics/*
    • Đặt Nguồn gốc và nhóm nguồn gốc thành G-12345.fps.goog
    • Đặt chế độ Tự động nén các đối tượng thành Không
    • Đặt Chính sách về giao thức cho người xem thành Chỉ HTTPS
    • Đặt Phương thức HTTP được cho phép thành GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE
    • Trong mục Khoá bộ nhớ đệm và yêu cầu về nguồn gốc, hãy chọn Chính sách về bộ nhớ đệm và chính sách yêu cầu về nguồn gốc
      • Đặt Chính sách về bộ nhớ đệm thành CachingDisabled
      • Đặt Chính sách yêu cầu về nguồn gốc thành AllViewerExceptHostHeader
  4. Trong danh sách Hành vi, hãy xác minh Precedence của hành vi mới cao hơn tất cả các hành vi khác
    • Để thay đổi Precedence, hãy chọn hành vi của bạn rồi chọn nút Di chuyển lên cho đến khi hành vi đó ở vị trí cao hơn tất cả các hành vi khác.
  5. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/healthy. Trang này phải có nội dung ok.

Thêm thông tin về vị trí địa lý

  1. Để chuyển tiếp thông tin cần thiết về vị trí địa lý, hãy đặt Tiêu đề thành AllViewerExceptHostHeader trong hành vi chuyển hướng của bạn.
    • Danh sách đầy đủ các tiêu đề vị trí của người xem CloudFront được trình bày chi tiết trong bài viết này
  2. Đợi vài phút để bản phân phối của bạn được triển khai. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/?validate_geo=healthy. Trang này phải có nội dung ok.

Fastly

Để phân phát thẻ trong cổng thẻ Google cho nhà quảng cáo, bạn cần định cấu hình dịch vụ CDN của Fastly để chuyển tiếp các yêu cầu và thêm thông tin về vị trí địa lý. Quá trình này bao gồm việc tạo một Điều kiện, một Máy chủ lưu trữ và hai đoạn mã VCL.

Tạo Điều kiện và Máy chủ lưu trữ

Trước tiên, bạn sẽ thiết lập một điều kiện để xác định các yêu cầu đối với cổng và một máy chủ lưu trữ để định tuyến các yêu cầu đó đến Google.

  1. Tạo một Điều kiện mới có chế độ cài đặt sau:

    • Loại: Request
    • Tên: Google Tag Gateway Path (hoặc tên bạn muốn)
    • Áp dụng nếu…: req.url.path ~ "^/metrics"

  2. Tạo một Máy chủ lưu trữ mới bằng các chế độ cài đặt sau:

    • Tên/địa chỉ máy chủ lưu trữ: fps.goog

  3. Định cấu hình Máy chủ mới bằng các chế độ cài đặt bổ sung sau:

    • Nhấp vào Đính kèm điều kiện rồi chọn điều kiện mà bạn đã tạo ở bước 1.
    • Đặt Ghi đè máy chủ lưu trữ thành fps.goog.
    • Giữ nguyên các chế độ cài đặt khác theo mặc định.
    • Nhấp vào Cập nhật để lưu máy chủ lưu trữ.

Thêm mã thẻ Google và tiêu đề vị trí địa lý

Tiếp theo, bạn sẽ thêm các đoạn mã VCL (Varnish Configuration Language) để đính kèm mã thẻ Google và dữ liệu vị trí địa lý của khách hàng. Bạn phải tạo 2 đoạn mã riêng biệt (một cho vcl_miss và một cho vcl_pass) bằng chính xác cùng một mã.

  1. Trong dịch vụ của bạn, hãy chuyển đến VCL Snippets (Đoạn mã VCL) rồi tạo một Đoạn mã có các trường sau:

    • Tên: Geo_MISS (hoặc tên bạn muốn)
    • Vị trí đặt quảng cáo: Within Subroutine
    • Chương trình con: vcl_miss

    • VCL:

      if (req.url.path ~ "^/metrics") {
  set bereq.http.X-Gtg-Tag-Id = "G-12345";
  set bereq.http.X-Forwarded-Country = client.geo.country_code;
  set bereq.http.X-Forwarded-Region = client.geo.region;
  set bereq.http.X-Forwarded-Geolocation = "latlong=" +
    client.geo.latitude + "," + client.geo.longitude + ";city=" +
    client.geo.city;
}

  2. Tạo một đoạn mã khác có các trường sau:

    • Tên: Geo_PASS (hoặc tên bạn muốn)
    • Loại: vcl_pass

    • VCL:

      if (req.url.path ~ "^/metrics") {
  set bereq.http.X-Gtg-Tag-Id = "G-12345";
  set bereq.http.X-Forwarded-Country = client.geo.country_code;
  set bereq.http.X-Forwarded-Region = client.geo.region;
  set bereq.http.X-Forwarded-Geolocation = "latlong=" +
    client.geo.latitude + "," + client.geo.longitude + ";city=" +
    client.geo.city;
}

    Giờ đây, bạn sẽ có 2 đoạn mã mới, riêng biệt. Điều này đảm bảo rằng các tiêu đề định vị vị trí được thêm vào mọi yêu cầu cần được tìm nạp từ máy chủ lưu trữ của bạn, cho dù đó là "thiếu bộ nhớ đệm" (vcl_miss) hay "truy cập bộ nhớ đệm" (vcl_pass).

Kích hoạt và xác minh cấu hình đầy đủ

Sau khi tạo xong đoạn mã máy chủ lưu trữ, điều kiện và VCL, giờ đây, bạn có thể kích hoạt và kiểm thử toàn bộ chế độ thiết lập.

  1. Nhấp vào Kích hoạt để triển khai tất cả các thay đổi mới.

  2. Xác minh cấu hình bằng cách chạy cả hai kiểm thử trong trình duyệt:

    • Bài kiểm tra 1 (Gắn thẻ và định tuyến): Chuyển đến https://example.com/metrics/healthy
    • Thử nghiệm 2 (Vị trí địa lý): Chuyển đến https://example.com/metrics/?validate_geo=healthy

    Cả hai trang đều phải có nội dung ok

Khác

Để phân phát thẻ trong cổng thẻ Google cho nhà quảng cáo, bạn cần định cấu hình CDN hoặc trình cân bằng tải để định tuyến các yêu cầu đến điểm cuối cổng thẻ Google cho nhà quảng cáo.

  1. Thêm một nguồn gốc hoặc phần phụ trợ trỏ đến G-12345.fps.goog.
  2. Ghi đè tiêu đề Máy chủ lưu trữ thành G-12345.fps.goog. Cho phép chuyển tiếp tất cả cookie và chuỗi truy vấn.
  3. Truyền thông tin vị trí địa lý của khách truy cập bằng cách thêm một trong các tiêu đề sau:
    • X-Forwarded-CountryRegion – Quốc gia và khu vực của người dùng trong một mã ISO 3166-2 duy nhất (ví dụ: US-CA).
    • X-Forwarded-Country và X-Forwarded-Region:
      • X-Forwarded-Country – Quốc gia của người dùng dưới dạng mã ISO 3166-1 alpha-2 (ví dụ: US).
      • X-Forwarded-Region – Mã phân vùng theo khu vực của người dùng (ví dụ: CA).
    • Nếu bạn thêm cả hai nhóm tiêu đề, thì X-Forwarded-CountryRegion sẽ được dùng.
  4. Thêm một quy tắc đường dẫn cho /metrics/* để định tuyến lưu lượng truy cập đến cổng thẻ Google cho nhà quảng cáo.
  5. Định cấu hình đường dẫn dành riêng có mức độ ưu tiên cao hơn so với quy tắc mặc định.
  6. Trong trình duyệt, hãy xác minh chế độ thiết lập bằng cách chuyển đến: https://example.com/metrics/healthy. Trang này phải có nội dung ok. Xác minh rằng thông tin địa lý đang được đưa vào bằng cách chuyển đến: https://example.com/metrics/?validate_geo=healthy. Trang này phải có nội dung ok.

Bước 3: Cập nhật tập lệnh trên trang web để sử dụng Đường dẫn đo lường

Thay thế tập lệnh trên mỗi trang của trang web bằng một trong những tập lệnh sau:

gtag.js

Ở đầu mục <head>, hãy tìm hai dòng tập lệnh có mã thẻ Google của bạn:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>

và thay thế bằng đường dẫn đo lường:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

Ở đầu mục <head>, hãy thay thế đoạn mã Trình quản lý thẻ bằng đoạn mã sau:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Kiểm tra chế độ thiết lập tính năng đo lường

Để thử nghiệm chế độ thiết lập tính năng đo lường, hãy định cấu hình vùng chứa sao cho có ít nhất một thẻ được kích hoạt.

  1. Chuyển đến Tag Assistant rồi xem trước vùng chứa của bạn.
  2. Di chuyển trong trang web để kích hoạt sự kiện.

  3. Trong thẻ Tóm tắt > Đầu ra > Các lượt truy cập được gửi, hãy xác minh rằng các lượt truy cập được chuyển đến /metrics.

    Ảnh chụp màn hình xác minh chế độ thiết lập