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:
Trước khi tiến hành quá trình tích hợp này, bạn nên:
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.
Bước này giúp bạn quản lý và lưu trữ thẻ theo dõi cũng như thẻ marketing. Nhờ vậy, bạn cũng có thể theo dõi cách người dùng tương tác với trang web của mình.
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:
Truy cập vào trang web Trình quản lý thẻ của Google để chuyển đến Trình quản lý này.
Nếu bạn đã có tài khoản, hãy chọn tài khoản đó. Nếu không, hãy tạo một tài khoản GTM mới.
Nhấp vào Create Container (Tạo vùng chứa)
Đặt tên cho vùng chứa của bạn và chọn "Server" (Máy chủ) làm nền tảng mục tiêu
Nhấp vào Create (Tạo)
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 sau đâ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ủ
graph.facebook.com
.Đặ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.
transport_url
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.
first_party_collection
true
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.
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:
_fbp
_fbc
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.
Thông số API Chuyển đổi của Meta | Tên trường GA4 | Tên biến lớp dữ liệu của GTM | Mức độ ưu tiên |
---|---|---|---|
| user_data.email_address | eventModel.user_data.email_address | Cao |
ID lượt click
| x-fb-ck-fbc | Không áp dụng | Cao |
ID Đăng nhập bằng Facebook | user_data.fb_login_id | Không áp dụng | Trung bình |
Ngày sinh
| x-fb-ud-db | Không áp dụng | Trung bình |
Quốc gia
| user_data.address.country | eventModel.user_data.address.country | Trung bình |
Số điện thoại
| user_data.phone_number | eventModel.user_data.phone_number | Trung bình |
ID bên ngoài
| x-fb-ud-external_id | Không áp dụng | Trung bình |
ID trình duyệt
| x-fb-ck-fbp | Không áp dụng | Trung bình |
Tiểu bang
| user_data.address.region | eventModel.user_data.address.region | Trung bình |
Giới tính
| x-fb-ud-ge | Không áp dụng | Trung bình |
Tên
| user_data.address.first_name | eventModel.user_data.address.first_name | Thấp |
Họ
| user_data.address.last_name | eventModel.user_data.address.last_name | Thấp |
Thành phố
| user_data.address.city | eventModel.user_data.address.city | Thấp |
Mã Zip | user_data.address.postal_code | eventModel.user_data.address.postal_code | Thấp |
Đặ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:
Tên sự kiện tiêu chuẩn trên Meta | Tên sự kiện trên Google Analytics |
---|---|
AddPaymentInfo | add_payment_info |
AddToCart | add_to_cart |
AddToWishlist | add_to_wishlist |
PageView | gtm.dom |
PageView | page_view |
Purchase | purchase |
Search | search |
InitiateCheckout | begin_checkout |
Lead | generate_lead |
ViewContent | view_item |
CompleteRegistration | sign_up |
Trong phần Thông số sự kiện:
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.
Để 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.
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.
Nếu bạn thay đổi cách thiết lập trong khi chạy chế độ xem trước, hãy khởi động lại chế độ xem trước để đảm bảo thay đổi được phản ánh trong khi thử nghiệm.
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:
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.
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:
event_id
trong cả hai thẻ:
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; }
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
.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
.
Để 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:
Tên thông số trên Meta | Tên thông số GA4 |
---|---|
value | value |
currency | currency |
search_string | search_term |
order_id | transaction_id |
content_ids | x-fb-cd-content_ids |
content_type | x-fb-cd-content_type |
content_name | x-fb-cd-content_name |
content_category | x-fb-cd-content_category |
contents* | items OR x-fb-cd-contents |
num_items | x-fb-cd-num_items |
predicted_ltv | x-fb-cd-predicted_ltv |
status | x-fb-cd-status |
delivery_category | x-fb-cd-delivery_category |
custom_properties* | custom_properties |
Vui lòng JSON.stringify x-fb-cd-contents và custom_properties trước khi gửi, vì đây là các thông số JSON do Meta xác định.
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.
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.