API Chuyển đổi cho Trình quản lý thẻ của Google (GTM) bên phía máy chủ

API Chuyển đổi có chức năng tạo kết nối trực tiếp giữa dữ liệu marketing của bạn và hệ thống, qua đó tối ưu hóa hoạt động nhắm mục tiêu quảng cáo, giảm chi phí trên mỗi hành động và đo lường kết quả trên các công nghệ của Meta. Bạn có thể đặt cấu hình máy chủ mà mình thiết lập trên Google Cloud Platform (GCP) hoặc bất kỳ nhà cung cấp dịch vụ đám mây nào khác để gửi dữ liệu chính về sự kiện offline và sự kiện trên web thông qua API Chuyển đổi. Với cách thiết lập này, sau khi đặt cấu hình Thẻ web Google Analytics 4 (GA4), bạn có thể gửi dữ liệu đó đến máy chủ của chính mình được lưu trữ trên Google Cloud Platform (GCP) và cuối cùng là gửi đến Meta thông qua API Chuyển đổi.

Thẻ API Chuyển đổi được Meta viết và duy trì dựa trên Mẫu thẻ tùy chỉnh của Google. Vui lòng liên hệ với Google nếu bạn có bất kỳ câu hỏi nào về cách thiết lập sản phẩm của Google hoặc tài liệu dành cho nhà phát triển của Google.

Tài liệu này trình bày những nội dung sau đây:

• Điều kiện tiên quyết - bao gồm cả cách tạo vùng chứa máy chủ
• Cách đặt cấu hình vùng chứa này để hỗ trợ bạn triển khai Thẻ web GA4
• Cách gửi dữ liệu từ trang web của bạn đến máy chủ GCP
• Cách chia sẻ dữ liệu đó với Meta thông qua API Chuyển đổi
• Câu hỏi thường gặp

Điều kiện tiên quyết

Trước khi tiến hành quá trình tích hợp này, bạn nên:

1. Tìm hiểu cách tích hợp API Chuyển đổi và cách tốt nhất để thiết lập
2. Tìm hiểu về Gắn thẻ phía máy chủ và Mẫu thẻ tùy chỉnh.

Nếu hệ thống của bạn dùng phiên bản cũ hơn GA4, bạn sẽ cần nâng cấp cách thiết lập trình quản lý thẻ hiện tại để sử dụng GA4 trước khi tiến hành quá trình tích hợp này.

Tích hợp

Tạo vùng chứa máy chủ GTM

Bạn sẽ cần đặt cấu hình một vùng chứa máy chủ và một vùng chứa web:

• Vùng chứa web: Nếu đây là lần đầu tiên bạn sử dụng GTM, hãy bắt đầu cài đặt một vùng chứa web cho tài khoản của bạn. Tìm hiểu thêm tại đây.
• Vùng chứa máy chủ: Bạn sẽ cần tạo một vùng chứa máy chủ trong Cổng thông tin GTM để thiết lập URL máy chủ gắn thẻ. Tìm hiểu thêm về bước này.

Bạn cần đặt cấu hình máy chủ gắn thẻ khi thiết lập vùng chứa máy chủ. Bạn có thể hoàn tất quy trình triển khai GCP mặc định khi thiết lập vùng chứa máy chủ. Hãy tham khảo hướng dẫn dưới đây. Đối với bất kỳ nhà cung cấp dịch vụ đám mây nào khác (ví dụ: AWS hoặc Microsoft Azure), hãy tham khảo hướng dẫn thiết lập máy chủ theo cách thủ công.

Đặt cấu hình vùng chứa web và vùng chứa máy chủ

1. Trên vùng chứa web, hãy tạo các cấu phần phần mềm sau:
   • Cấu hình GA4 để đặt cấu hình URL máy chủ gắn thẻ.
   • Sự kiện GA4 để đặt cấu hình lược đồ sự kiện sẽ được phân phối đến máy chủ.
2. Trên vùng chứa máy chủ, hãy tạo các cấu phần phần mềm sau:
   • Máy khách GA4 - trình lắng nghe cho sự kiện kích hoạt sự kiện đến Meta.
   • Thẻ API Chuyển đổi của Meta - thẻ phía máy chủ chuyển đổi mô hình sự kiện tiêu chuẩn từ Máy khách GA4 thành lược đồ sự kiện API Chuyển đổi rồi gửi lược đồ đó đến graph.facebook.com.

Bước 1: Cấu hình GA4 - Đặt cấu hình URL máy chủ gắn thẻ

Đặt cấu hình vùng chứa web để gửi dữ liệu trên trang web của bạn đến máy chủ gắn thẻ đã tạo. Tìm hiểu thêm về cách đặt cấu hình Google Analytics: Thẻ cấu hình GA4.

• Nếu bạn chọn Send to server container (Gửi đến vùng chứa máy chủ), hãy đặt Server Container URL (URL vùng chứa máy chủ) làm URL máy chủ gắn thẻ.
• Nếu bạn không chọn Send to server container (Gửi đến vùng chứa máy chủ), trong mục Fields to Set (Trường cần đặt), hãy nhấp vào Add Row (Thêm hàng) và đặt:

  • Tên trường: transport_url
  • Giá trị trường: URL máy chủ gắn thẻ của bạn

Bạn có thể đặt cấu hình các trường bổ sung cho bất kỳ thông số nào khác mà bạn muốn gửi cho tất cả sự kiện.

• Đặt cờ first_party_collection thành true. Bạn phải thực hiện việc này thì mới có thể chuyển thông số user_data cho GTM phía máy chủ. Trong mục Fields to Set (Trường cần đặt), hãy nhấp vào Add Row (Thêm hàng) và đặt:

  • Tên trường: first_party_collection
  • Giá trị trường: true

Sử dụng thẻ cấu hình GA4 hiện có

Nếu đã thiết lập sẵn Cấu hình GA4, bạn có thể sửa đổi cấu hình hiện có hoặc tạo thẻ Cấu hình bổ sung cho GTM phía máy chủ.

Nếu bạn đang thiết lập GTM phía máy chủ lần đầu, thao tác thêm URL vùng chứa máy chủ sẽ bắt đầu chuyển tất cả lưu lượng truy cập của bạn đến Vùng chứa máy chủ. Nếu muốn tiếp tục gửi dữ liệu đến GA4, bạn cần thêm thẻ Phía máy chủ GA4 vào Vùng chứa máy chủ để đảm bảo thẻ này kích hoạt trên tất cả sự kiện. Bạn có thể cần tạo thẻ Sự kiện GA4 bổ sung hoặc sửa đổi thẻ hiện có để đảm bảo ánh xạ hoàn chỉnh với các sự kiện Meta Pixel.

Gửi ID trình duyệt của Meta và ID lượt click của Meta

Nếu bạn đã thiết lập miền tùy chỉnh và miền máy chủ gắn thẻ GTM của bạn là bên thứ nhất, hệ thống sẽ tự động gửi ID trình duyệt của Meta và ID lượt click của Meta.

Nếu đang sử dụng miền mặc định được cung cấp hoặc nhận thấy hệ thống không gửi các trường ID trình duyệt và ID lượt click trong Trình quản lý sự kiện, bạn có thể đặt cấu hình các trường này như sau:

• Điều hướng đến phần biến và tạo Biến mới do người dùng xác định cho cả ID trình duyệt của Meta và ID lượt click của Meta. Sử dụng loại biến Cookie bên thứ nhất.

  • Đối với ID trình duyệt của Meta, hãy đặt Tên cookie thành _fbp
  • Đối với ID lượt click của Meta, hãy đặt Tên cookie thành _fbc
• Lưu các biến này.
• Trong thẻ Cấu hình GA4, trong mục Fields to Set (Trường cần đặt), hãy nhấp vào Add Row (Thêm hàng) và đặt:

  • Tên trường: x-fb-ck-fbp
  • Giá trị trường: biến ID trình duyệt của Meta
• Thêm một hàng bổ sung cho ID lượt click:
• Tên trường: x-fb-ck-fbc
• Giá trị trường: biến ID lượt click của Meta

Tạo Biến lớp dữ liệu cho từng thông số user_data của lược đồ sự kiện chung trong GTM. Tìm hiểu thêm về cách thiết lập các biến lớp dữ liệu. Ví dụ: để chuyển một địa chỉ email cho GTM phía máy chủ, hãy tạo biến (chẳng hạn như user_data_email_address) mà bạn có thể ánh xạ với Tên biến lớp dữ liệu - eventModel.user_data.email_address.

Nếu bạn hiện không sử dụng lớp dữ liệu, hãy đặt cấu hình biến cho từng thông số như được nêu dưới đây để sử dụng. Dưới đây là danh sách tất cả các trường hợp ánh xạ cho thông số user_data của Meta và GTM cùng mức độ ưu tiên chung của những trường hợp đó trong việc giúp tăng Chất lượng so khớp sự kiện. Để khai thác tối đa quảng cáo trên Meta, bạn nên áp dụng các cách làm tốt nhất cho API Chuyển đổi khi thiết lập quá trình tích hợp. Nếu đã thiết lập API Chuyển đổi, bạn nên xem xét những cách làm tốt nhất này để cải thiện cách thiết lập hiện tại. Khi áp dụng những cách làm tốt nhất về API Chuyển đổi, bạn có thể giảm chi phí trên mỗi hành động, qua đó cải thiện hiệu quả quảng cáo.

Bước 2: Sự kiện GA4 - Đặt cấu hình lược đồ sự kiện sẽ được phân phối đến máy chủ

• Đặt cấu hình vùng chứa web để gửi dữ liệu trên trang web của bạn đến máy chủ gắn thẻ đã tạo nhằm thêm Google Analytics. Tìm hiểu thêm về cách đặt cấu hình Google Analytics: Thẻ cấu hình GA4.

• Thêm Google Analytics: Thẻ sự kiện GA4 từ Thư viện mẫu vào Không gian làm việc của bạn:

  • Thiết lập Tên sự kiện cho thẻ này. Bạn có thể đặt giá trị tĩnh cho tên sự kiện hoặc đặt cấu hình để đọc tên sự kiện từ biến. Đối với một số sự kiện tiêu chuẩn, chúng tôi sẽ ánh xạ các sự kiện tiêu chuẩn trên Google Analytics với sự kiện tiêu chuẩn tương đương trên Meta. Đối với những sự kiện này, bạn có thể sử dụng tên sự kiện trên Google Analytics hoặc tên sự kiện trên Meta. Đối với tất cả sự kiện tiêu chuẩn khác, hãy sử dụng tên sự kiện trên Meta. Đối với Sự kiện tùy chỉnh, hãy sử dụng tên Sự kiện tùy chỉnh. Tìm hiểu thêm.

• Trong phần Thông số sự kiện:

  • Nếu bạn đang sử dụng Meta Pixel, hãy thêm thông số ID sự kiện. Sử dụng event_id làm tên thông số và biến được tạo cho ID sự kiện làm giá trị thông số. Hãy tham khảo phần Loại bỏ trùng lặp để xem hướng dẫn cách tạo biến ID sự kiện cũng như sửa đổi Meta Pixel.
  • Ánh xạ từng thông số mà bạn muốn đặt cấu hình. Tên biến sẽ được đọc từ sự kiện thông qua lược đồ sự kiện chung. Ví dụ: để thiết lập email làm thông số sự kiện, bạn phải xác định email là Tên thông số: user_data.email_address và thiết lập Giá trị là tên biến đọc email_address (như xác định trước đó ở Phần 1).
  • Để có danh sách đầy đủ, hãy xem phần Thông số dữ liệu tùy chỉnh bên dưới.

Bước 3: Tạo trình lắng nghe cho sự kiện kích hoạt sự kiện đến Meta

Mỗi vùng chứa phía máy chủ trong GTM đều có một Máy khách GA4 mặc định để lắng nghe các sự kiện được đặt cấu hình từ Thẻ web GA4. Máy khách GA4 lắng nghe lộ trình /g/collect trên URL máy chủ gắn thẻ của bạn và gửi eventModel đến thẻ luồng dữ liệu tải về. Nếu đã cài đặt Máy khách GA4 mặc định trong vùng chứa máy chủ ở phần Máy khách, bạn có thể chuyển sang Bước 4.

Bước 4: Tạo Thẻ API Chuyển đổi của Meta - thẻ phía máy chủ chuyển đổi mô hình sự kiện tiêu chuẩn từ Máy khách GA4 thành lược đồ sự kiện API Chuyển đổi rồi gửi lược đồ đó đến graph.facebook.com

Để gửi sự kiện đến API Chuyển đổi, bạn cần cài đặt Thẻ API Chuyển đổi của Meta từ Thư viện mẫu. Mẫu thẻ này được facebookincubator gọi là Thẻ API Chuyển đổi. Bạn có thể thiết lập để kích hoạt thẻ này trên những sự kiện mà Máy khách GA4 nhận được ở bước trước và gửi thẻ này đến API Chuyển đổi. Để cài đặt Thẻ API Chuyển đổi của Meta, bạn sẽ cần có ID pixel, mã truy cập và chỉ định nguồn hành động là "website" (trang web). Bằng cách sử dụng API Chuyển đổi, bạn đồng ý rằng thông số action_source là chính xác theo hiểu biết của bạn.

Thử nghiệm tiện ích tích hợp

Bạn nên sử dụng chế độ xem trước của Trình quản lý thẻ của Google để thử nghiệm tiện ích tích hợp trước khi đăng thay đổi. Cả vùng chứa web và vùng chứa máy chủ đều có chế độ xem trước. Bạn có thể chạy cả 2 chế độ xem trước này cùng lúc.

Bạn có thể xác minh để đảm bảo rằng hệ thống nhận được sự kiện từ máy chủ của bạn như dự kiến thông qua tính năng Thử nghiệm sự kiện trong Trình quản lý sự kiện. Để tìm công cụ này, hãy chuyển đến Trình quản lý sự kiện > Nguồn dữ liệu > Pixel của bạn > Thử nghiệm sự kiện.

Công cụ Thử nghiệm sự kiện sẽ tạo một ID thử nghiệm. Hãy gửi ID thử nghiệm này dưới dạng thông số test_event_code trong thẻ API Chuyển đổi để bắt đầu thấy hoạt động trong sự kiện xuất hiện ở cửa sổ Thử nghiệm sự kiện. Đừng quên gỡ mã này trước khi đăng thay đổi.

Với công cụ thử nghiệm sự kiện, bạn có thể xem hệ thống có nhận được và loại bỏ trùng lặp các sự kiện đúng cách hay không. Nếu bạn không thấy các sự kiện xuất hiện sau 1 hoặc 2 phút, hãy kiểm tra trình gỡ lỗi Phía máy chủ GTM để đảm bảo yêu cầu được thực hiện:

1. Trong trình gỡ lỗi Phía máy chủ, hãy chọn sự kiện phù hợp mà bạn muốn kiểm tra trong menu bên trái.
2. Xác nhận rằng thẻ của bạn đang hiển thị trong phần Thẻ đã kích hoạt. Nếu vậy, bạn sẽ thấy Thẻ API Chuyển đổi - Đã thành công hoặc Thẻ API Chuyển đổi - Không thành công.
   • Chưa kích hoạt thẻ: Xem lại trình kích hoạt Thẻ API Chuyển đổi và trình kích hoạt sự kiện GA4 phù hợp trên vùng chứa web. Xác nhận rằng Sự kiện GA4 đã kích hoạt trong trình gỡ lỗi web.
   • Đã kích hoạt thẻ: Thành công: Nhấp vào thẻ và kiểm tra để đảm bảo Mã thử nghiệm sự kiện chính xác. Cập nhật mã thử nghiệm sự kiện nếu cần và khởi động lại chế độ xem trước.
   • Đã kích hoạt thẻ: Không thành công: Mở tab Yêu cầu rồi nhấp vào yêu cầu Gửi đi đã gửi đến https://graph.facebook.com. Xem lại Nội dung phản hồi ở cuối chi tiết yêu cầu để xem thông tin lỗi và cập nhật tiện ích tích hợp của bạn nếu thích hợp. Hãy nhớ khởi động lại chế độ xem trước sau khi thực hiện bất kỳ thay đổi nào.

Sau khi sự kiện hiển thị, hãy xác minh rằng ID sự kiện cho mỗi sự kiện được gửi chính xác, đồng thời tất cả khóa so khớp dự kiến và thông số dữ liệu tùy chỉnh đều hiển thị chính xác. Công cụ thử nghiệm sự kiện sẽ cho bạn biết hệ thống có loại bỏ trùng lặp sự kiện đúng cách hay không. Nếu các ID sự kiện khác nhau, hãy đảm bảo rằng các thẻ GA4 và Meta Pixel đang kích hoạt trên cùng một trình kích hoạt, đồng thời xem lại cách triển khai biến ID sự kiện của bạn.

Loại bỏ trùng lặp

Bạn nên sử dụng cách thiết lập sự kiện dự phòng, đồng thời chia sẻ sự kiện giống nhau từ cả API Chuyển đổi lẫn Meta Pixel. Hãy đảm bảo cả hai sự kiện đều sử dụng event_name giống nhau, đồng thời nhớ thêm event_id hoặc kết hợp giữa external_id và fbp.

Nhờ vậy, Meta có thể loại bỏ sự kiện trùng lặp và giảm tình trạng báo cáo 2 lần các sự kiện giống hệt nhau. Tìm hiểu thêm về tính năng loại bỏ trùng lặp, trường hợp cần dùng và cách thiết lập. external_id và fbp là các giải pháp thay thế để loại bỏ trùng lặp cũng như cải thiện chất lượng thiết lập. Bạn nên thêm 3 thông số này nếu có thể.

GTM hỗ trợ nhiều cách thiết lập thông số có giá trị giống nhau trên cả thẻ trình duyệt lẫn thẻ máy chủ. Một cách trong đó là sử dụng cùng sự kiện GA4 làm yếu tố kích hoạt để kích hoạt thẻ Meta Pixel và sự kiện máy chủ. Cách thực hiện như sau:

• Sử dụng cùng một trình kích hoạt cho Thẻ HTML tùy chỉnh của Meta Pixel và Thẻ sự kiện GA4. Ví dụ: bạn có thể xác định điều kiện kích hoạt dựa trên URL trang xác nhận đơn đặt hàng.
• Sử dụng cùng event_id trong cả hai thẻ:

  1. Đặt một ID duy nhất từ Máy khách: Đặt thông số tùy chỉnh (x-fb-event_id) từ sự kiện gtag. Hãy tạo ID duy nhất (cho mỗi sự kiện) trên trang web bằng phương thức JavaScript (hoặc sử dụng biến JavaScript tùy chỉnh trong Trình quản lý thẻ của Google) rồi đặt giá trị trong sự kiện như sau:

  gtag('event', 'purchase', {
   'x-fb-event_id': generateEventId(),
  ...:...
  
   });

  Bạn có thể tạo một biến chỉ đến JavaScript tùy chỉnh như minh họa ở trên. Mỗi khi biến này được tham chiếu, hệ thống sẽ tải JavaScript bên dưới vào dòng:

  function() {
  var gtmData = window.google_tag_manager[{{Container ID}}].dataLayer.get('gtm');
  return gtmData.start + '.' + gtmData.uniqueEventId;
  }

  2. Tạo và điền sẵn Biến lớp dữ liệu: Bạn có thể tạo biến của riêng mình trên vùng chứa web để đọc giá trị từ event_id. Bạn có thể thực hiện việc này bằng cách tạo Biến lớp dữ liệu mới, chẳng hạn như FBEventIdVar có Tên biến lớp dữ liệu là eventModel.event_id.
  3. Sau khi đặt biến này, bạn sẽ đưa biến vào sự kiện web trong thẻ HTML tùy chỉnh và sự kiện máy chủ ở dạng Thông số sự kiện GA4 bổ sung.
  4. Trên web, bạn có thể thiết lập Thẻ Meta trên vùng chứa web trong Trình quản lý thẻ của Google để đọc event_id từ biến.

  fbq('track', Purchase, {..}, {eventID: FBEventIDVar });

  Đặt cấu hình Sự kiện GA4 để gửi thông số bổ sung có tên là event_id, đặt là biến FBEventIdVar.

Thông số dữ liệu tùy chỉnh

Để gửi dữ liệu tùy chỉnh, hãy sử dụng các trường hợp ánh xạ bên dưới trong thẻ Sự kiện GA4 của bạn:

Gửi dữ liệu từ trang web của bạn đến máy chủ GCP

Sau khi đặt cấu hình vùng chứa web và vùng chứa máy chủ, bạn có thể gửi sự kiện mẫu từ trang web để xác minh sự kiện máy chủ. Một sự kiện mẫu với các thông số đã đặt cấu hình sẽ có dạng như sau

 gtag('event', 'purchase', 
  {
    'event_id': generateEventId(),
    'transaction_id': 't_12345',
    'currency': 'USD',
    'value': 1.23,
    user_data: {
      email_address: '<HASHED_DATA>',
      phone_number: '<HASHED_DATA>',
      address: {
        first_name: '<HASHED_DATA>',
        last_name: '<HASHED_DATA>',
        city: '<HASHED DATA>',
        region: '<HASHED_DATA>',
        postal_code: '<HASHED_DATA>',
        country: '<HASHED_DATA>'     
      },    
    },
    items: [
      {
        item_id: '1',
        item_name: 'foo',
        quantity: 5,
        price: 123.45,
        item_category: 'bar',
        item_brand: 'baz'     
      }
    ], 
  });      
     

Sau khi sự kiện này được kích hoạt, bạn sẽ nhìn thấy một yêu cầu cùng với những thông số đã đặt cấu hình được gửi đến liên kết mẫu: www.analytics.example.com/g/collect (đây chỉ là ví dụ). Bạn có thể thêm mã sự kiện thử nghiệm vào Thẻ API Chuyển đổi của Meta để xác minh những sự kiện được gửi đến API Chuyển đổi. Bạn chỉ nên sử dụng mã thử nghiệm sự kiện để thử nghiệm. Bạn cần gỡ mã đó khi gửi phần tải dữ liệu chính thức.

Sau khi đăng thay đổi của bạn, hãy sử dụng trang Xác minh thiết lập của bạn tại đây để đảm bảo các sự kiện được gửi chính xác bằng cách kiểm tra quy trình Xác minh thiết lập - API Chuyển đổi sau đây rồi đánh giá xem tiện ích tích hợp chất lượng có phù hợp với cách làm tốt nhất của chúng tôi hay không.

Câu hỏi thường gặp

Meta có kế hoạch bổ sung thêm tính năng gửi các thông số tùy chỉnh không? Nếu có thì khi nào sẽ triển khai?
Đáp: Chúng tôi đã bổ sung thêm tính năng ánh xạ cho hầu hết các thông số tùy chỉnh tiêu chuẩn của API Chuyển đổi được hỗ trợ trong lược đồ của GTM. Chúng tôi cũng đã cung cấp tính năng ánh xạ tùy chỉnh. Xem tại đây để tìm hiểu thêm.

Một máy chủ đơn lẻ hay cụm máy chủ có thể chạy nhiều vùng chứa không?
Đáp: Hiện tại, GTM chỉ hỗ trợ ánh xạ 1:1. Đọc các đề xuất về cách sắp xếp vùng chứa.

GTM phía máy chủ có yêu cầu thẻ dựa trên trình duyệt để tạo sự kiện không?
Đáp: Có

Có thể tách riêng GA4 khỏi tiện ích tích hợp Phía máy chủ không?
A: Để tách riêng GA4 khỏi tiện ích tích hợp GTM phía máy chủ, bạn có thể tạo thêm ID đo lường trong Google Analytics. Hãy làm theo các bước nêu trên để tạo thẻ Cấu hình GA4 riêng cho GTM phía máy chủ bằng ID đo lường này. Trong trường hợp này, thẻ Cấu hình GA4 hiện tại của bạn sẽ tiếp tục chuyển lưu lượng truy cập GA qua Vùng chứa web, trong khi thẻ Cấu hình mới sẽ gửi dữ liệu đến Vùng chứa máy chủ. Tạo thẻ Sự kiện GA4 bổ sung theo Bước 2 để gửi sự kiện phía máy chủ thông qua thẻ Cấu hình mới

Tiện ích tích hợp API Chuyển đổi của GTM có tương thích với các giải pháp lưu trữ đám mây khác ngoài GCP không?
Đáp: Tiện ích tích hợp API Chuyển đổi của GTM sẽ tương thích với GCP hoặc bất kỳ nền tảng nào khác mà bạn chọn. Đọc thêm về phương thức cấp phép thủ công tại đây.

Tìm hiểu thêm

• API Chuyển đổi
• Loại bỏ trùng lặp cho sự kiện Meta Pixel và sự kiện API Chuyển đổi