Hướng dẫn thiết lập hành động chuyển đổi trong Google Ads

Hướng dẫn này cung cấp danh sách các loại hành động chuyển đổi mà bạn có thể thiết lập thông qua API Google Ads, cùng với thông tin chi tiết về cách các hành động này được liên kết với trang web và ví dụ mã minh hoạ cách tạo mới ConversionAction.

Để theo dõi và đo lường chính xác các lượt chuyển đổi, bạn cần thiết lập ConversionAction phù hợp với loại chuyển đổi mà bạn muốn theo dõi. Ví dụ, hành động mua hàng trực tuyến và cuộc gọi từ số điện thoại yêu cầu những hành động chuyển đổi khác nhau.

Phương pháp hiệu quả nhất để thiết lập một hành động chuyển đổi mới trong API Google Ads là áp dụng mã mẫu đi kèm bên dưới. Các thao tác xác thực sẽ được thực hiện ngầm và mã hướng dẫn sẽ giúp bạn tạo ConversionAction một cách chính xác.

Hầu hết các hành động chuyển đổi đều yêu cầu thực hiện thêm các bước để đảm bảo theo dõi đầy đủ. Chẳng hạn, để theo dõi các lượt chuyển đổi trên trang web, bạn cần thêm một đoạn mã, gọi là thẻ (tag), vào trang chuyển đổi của mình. Đối với những hành động chuyển đổi khác, hãy tham khảo các bài viết chi tiết trên Trung tâm trợ giúp của Google Ads để biết thêm thông tin.

Chuyển đổi trang web

Chuyển đổi trang web là một phương pháp cho phép bạn theo dõi các hành vi người dùng trên trang web, bao gồm các hành động như mua hàng trực tuyến, nhấp vào liên kết, xem trang hoặc đăng ký thông tin.

Để thiết lập việc theo dõi lượt chuyển đổi trên trang web, bạn cần tạo một ConversionAction với ConversionActionType được thiết lập là WEBPAGE. Sau đó, thêm một đoạn mã theo dõi, gọi là thẻ (tag), vào các trang chuyển đổi trên trang web của bạn.

ConversionAction hỗ trợ nhiều loại chuyển đổi trên trang web và các loại này được phân biệt trong API thông qua trường type trong mỗi TagSnippet. Những đoạn mã này được liệt kê trong trường tag_snippets của một ConversionAction.

TagSnippet chứa mã theo dõi, cần được chèn vào trang web để theo dõi các hành động chuyển đổi. Các chuyển đổi trên trang web và lượt nhấp vào số điện thoại yêu cầu sử dụng event_snippet. Đoạn mã này nên được đặt trên các trang biểu thị hành động chuyển đổi, như trang xác nhận thanh toán hoặc trang gửi biểu mẫu khách hàng tiềm năng. Ngoài ra, global_site_tag phải được cài đặt trên tất cả các trang của website. Cả event_snippet và global_site_tag đều có thể được truy xuất thông qua ConversionActionService. Để biết thêm thông tin chi tiết về cách triển khai các đoạn mã này, bạn có thể tham khảo thêm tài liệu tại Trung tâm trợ giúp của Google Ads.

Bảng dưới đây cung cấp các tham số API tương ứng để sử dụng cho từng nguồn chuyển đổi trong giao diện web của Google Ads:

Loại mã theo dõi	Nguồn Google Ads
WEBPAGE	Trang web (Google Analytics GA4)
WEBPAGE_ONCLICK	Trang web (Google Analytics GA4)
CLICK_TO_CALL	Nhấp vào số điện thoại
—	Trang web (Google Analytics UA)

Lưu ý: WEBPAGE và WEBPAGE_ONCLICK đều có chung nguồn là trang web. Sự khác biệt nằm ở cách sự kiện được kích hoạt. WEBPAGE tương ứng với việc tải trang, trong khi WEBPAGE_ONCLICK tương ứng với hành động nhấp chuột.

Chuyển đổi ứng dụng

Chuyển đổi ứng dụng là một công cụ giúp theo dõi các lượt cài đặt ứng dụng trên thiết bị di động hoặc các giao dịch mua hàng trong ứng dụng từ Google Play. Việc theo dõi này cho phép nhà quảng cáo đo lường hiệu quả của các chiến dịch quảng cáo ứng dụng, từ đó tối ưu hóa quảng cáo để đạt được mục tiêu kinh doanh.

Bảng dưới đây cung cấp các giá trị ConversionActionType tương ứng mà bạn cần thiết lập trong API Google Ads để theo dõi chuyển đổi ứng dụng:

Loại hành động chuyển đổi	Nguồn Google Ads
GOOGLE_PLAY_DOWNLOAD	Google Play > Số lượt cài đặt
GOOGLE_PLAY_IN_APP_PURCHASE	Google Play > Giao dịch mua hàng trong ứng dụng

Nếu bạn muốn theo dõi thêm các hành động khác trong ứng dụng di động bằng cách sử dụng Google Analytics 4 hoặc các công cụ phân tích ứng dụng bên thứ ba, hãy tham khảo bài viết liên quan về các loại hành động chuyển đổi khác.

Lưu ý: Khi chỉ định trường category, chỉ đặt trường này thành DOWNLOAD nếu loại chuyển đổi bạn muốn theo dõi là GOOGLE_PLAY_DOWNLOAD.

Chuyển đổi cuộc gọi điện thoại

Việc theo dõi chuyển đổi cuộc gọi điện thoại cho phép bạn đo lường các cuộc gọi từ quảng cáo, cuộc gọi đến số điện thoại hiển thị trên trang web, hoặc lượt nhấp vào số điện thoại trên các trang web di động.

Dưới đây là bảng giá trị ConversionActionType tương ứng mà bạn cần thiết lập trong API Google Ads để theo dõi các hành động liên quan đến cuộc gọi điện thoại:

Loại hành động chuyển đổi	Nguồn Google Ads
AD_CALL	Cuộc gọi từ quảng cáo sử dụng phần mở rộng cuộc gọi hoặc quảng cáo chỉ cho cuộc gọi
WEBSITE_CALL	Cuộc gọi đến số điện thoại hiển thị trên trang web của bạn
CLICK_TO_CALL	Nhấp vào số điện thoại trên trang web di động của bạn

Điểm khác biệt giữa CLICK_TO_CALL và AD_CALL là CLICK_TO_CALL chỉ theo dõi lượt nhấp vào số điện thoại trên thiết bị di động, thay vì theo dõi cuộc gọi thực tế. Điều này đặc biệt hữu ích trong trường hợp bạn không thể sử dụng số chuyển tiếp của Google để theo dõi các cuộc gọi điện thoại.

AD_CALL

AD_CALL là một hành động chuyển đổi được hiển thị dưới dạng “Cuộc gọi từ quảng cáo” trong giao diện web của Google Ads. Sau khi bạn tạo hành động chuyển đổi AD_CALL, bạn cần chỉ định tên tài nguyên của hành động này trong trường call_conversion_action khi tạo CallAsset. Tính năng này cho phép bạn hiển thị số điện thoại trực tiếp trong quảng cáo, giúp người dùng dễ dàng liên hệ qua cuộc gọi.

Lượt gọi sẽ được báo cáo là chuyển đổi nếu cuộc gọi kéo dài hơn khoảng thời gian tối thiểu đã chỉ định, mặc định là 60 giây.

WEBSITE_CALL

WEBSITE_CALL là hành động chuyển đổi được hiển thị dưới dạng “Cuộc gọi từ lượt chuyển đổi trên trang web” trong giao diện web của Google Ads. Không giống như AD_CALL, việc theo dõi này yêu cầu bạn tích hợp event_snippet và global_site_tag vào trang web. Các đoạn mã này giúp truy xuất số chuyển tiếp động của Google để theo dõi các cuộc gọi đến số điện thoại hiển thị trên trang web.

Ngoài ra, bạn cần phải thiết lập và liên kết các tài sản này với khách hàng, chiến dịch hoặc nhóm quảng cáo để hoàn tất việc theo dõi chuyển đổi cuộc gọi từ website.

Nhập lượt chuyển đổi ngoại tuyến

Dưới đây là bảng giá trị tương đương của ConversionActionType và các tham số API cần sử dụng cho từng nguồn chuyển đổi trong giao diện web của Google Ads, cùng với liên kết tài liệu hướng dẫn cho từng loại hành động chuyển đổi cụ thể:

Loại hành động chuyển đổi	Nguồn Google Ads	Hướng dẫn thiết lập API
UPLOAD_CLICKS	Theo dõi lượt chuyển đổi từ lượt nhấp và chuyển đổi nâng cao cho khách hàng tiềm năng	Hướng dẫn về lượt nhấp để tải lên
UPLOAD_CALLS	Theo dõi lượt chuyển đổi từ cuộc gọi	Hướng dẫn thiết lập API
STORE_SALES	Theo dõi lượt chuyển đổi từ lượt bán hàng tại cửa hàng thực tế	Thiết lập API Hướng dẫn

Lượt chuyển đổi nâng cao cho web

Lượt chuyển đổi nâng cao cho web cho phép bạn gửi dữ liệu lượt chuyển đổi của bên thứ nhất cho hành động chuyển đổi WEBPAGE trong vòng 24 giờ kể từ khi sự kiện chuyển đổi diễn ra, thay vì cùng lúc. Điều này giúp bạn tổng hợp dữ liệu bên thứ nhất từ nhiều nguồn khác nhau, chẳng hạn như cơ sở dữ liệu khách hàng hoặc hệ thống quản lý quan hệ khách hàng (CRM). Việc này tối ưu hoá quá trình theo dõi và cải thiện hiệu quả chiến dịch quảng cáo của bạn.

Các loại hành động chuyển đổi khác

API Google Ads cung cấp nhiều loại hành động chuyển đổi khác nhau trong báo cáo. Tuy nhiên, việc tạo mới hoặc chỉnh sửa một số hành động chuyển đổi có thể bị giới hạn hoặc không được phép.

Lượt chuyển đổi SKAdNetwork

Nếu bạn đang chạy chiến dịch quảng cáo cho ứng dụng iOS và đã triển khai SKAdNetwork, bạn có thể truy cập dữ liệu SKAdNetwork mà Google cung cấp ở cấp độ Customer (khách hàng) và Campaign (chiến dịch) thông qua các tài nguyên sau:

Trường báo cáo	Mô tả
metrics.sk_ad_network_installs	Số lượt cài đặt được Apple báo cáo. Chỉ số này có thể được phân đoạn theo segments.sk_ad_network_conversion_value và phân đoạn ngày tháng.
metrics.sk_ad_network_total_conversions	Tổng số lượt chuyển đổi, bao gồm lượt cài đặt và các loại chuyển đổi khác mà Apple báo cáo. Chỉ số này có thể phân đoạn theo các phân khúc liên quan đến SKAdNetwork và ngày tháng.
segments.sk_ad_network_ad_event_type	Loại sự kiện đã xảy ra cho lượt chuyển đổi cụ thể.
segments.sk_ad_network_attribution_credit	Cách thức phân bổ được ghi nhận cho lượt chuyển đổi.
segments.sk_ad_network_fine_conversion_value	Giá trị chính xác của lượt chuyển đổi do Apple báo cáo. Chỉ áp dụng phân đoạn này với metrics.sk_ad_network_installs và metrics.sk_ad_network_total_conversions cùng các phân đoạn theo ngày.
segments.sk_ad_network_coarse_conversion_value	Giá trị thô của một lượt chuyển đổi cụ thể.
segments.sk_ad_network_postback_sequence_index	Vị trí của hệ thống đăng lại, theo trình tự, với một lượt chuyển đổi cụ thể.
segments.sk_ad_network_source_app.sk_ad_network_source_app_id	Mã ứng dụng mà quảng cáo thúc đẩy lượt cài đặt trên SKAdNetwork.
segments.sk_ad_network_source_domain	Trang web mà quảng cáo thúc đẩy lượt cài đặt qua SKAdNetwork. Giá trị rỗng nếu không áp dụng phân đoạn này, chẳng hạn như trong chiến dịch không dành cho iOS.
segments.sk_ad_network_source_type	Loại nguồn mà quảng cáo thúc đẩy lượt cài đặt trên SKAdNetwork. Giá trị rỗng nếu không có nguồn hoặc hệ thống đăng lại từ Apple.
segments.sk_ad_network_user_type	Kiểu người dùng tạo ra lượt chuyển đổi cụ thể.
segments.sk_ad_network_redistributed_fine_conversion_value	Giá trị chuyển đổi bao gồm cả giá trị được ghi nhận từ Apple và các giá trị rỗng được mô hình hóa bởi Google.
segments.sk_ad_network_version	Phiên bản API SKAdNetwork của Bộ công cụ iOS Store được sử dụng.

Bạn cũng có thể liên kết giá trị lượt chuyển đổi SKAdNetwork với các khách hàng sử dụng ứng dụng iOS thông qua CustomerSkAdNetworkConversionValueSchema.

Google Analytics

Các lượt chuyển đổi từ một tài sản Google Analytics được liên kết sẽ có một trong các giá trị type sau:

Lượt chuyển đổi từ tài sản GA4:

• GOOGLE_ANALYTICS_4_CUSTOM
• GOOGLE_ANALYTICS_4_PURCHASE

Bạn cũng có thể truy xuất mã tài sản GA4, tên tài sản và tên sự kiện thông qua thời gian cấu hình từ google_analytics_4_settings.

Lượt chuyển đổi từ tài sản Universal Analytics:

• UNIVERSAL_ANALYTICS_GOAL
• UNIVERSAL_ANALYTICS_TRANSACTION

Đối với tài sản GA4, bạn có thể thực hiện các thay đổi sau đối với lượt chuyển đổi đã được nhập vào tài khoản Google Ads:

• Nhập lượt chuyển đổi từ tài sản GA4 bằng cách thay đổi trường status từ HIDDEN thành ENABLED.
• Sửa đổi các trường primary_for_goal và category để xác định cách lượt chuyển đổi ảnh hưởng đến việc đặt giá thầu và báo cáo của Google Ads.
• Cập nhật trường name hoặc value_settings để thay đổi tên hoặc giá trị của lượt chuyển đổi.
• Xóa lượt chuyển đổi khỏi tài khoản Google Ads bằng thao tác remove.

Mọi hành động chỉnh sửa các thuộc tính khác của lượt chuyển đổi GA4 đã nhập, hoặc bất kỳ thuộc tính nào của lượt chuyển đổi từ Universal Analytics đã nhập, sẽ dẫn đến lỗi MUTATE_NOT_ALLOWED. Để thực hiện các thay đổi này, bạn chỉ có thể sử dụng giao diện người dùng của Google Ads.

Firebase và dịch vụ phân tích ứng dụng của bên thứ ba

Để nhập dữ liệu phân tích ứng dụng của bên thứ ba hoặc theo dõi lượt chuyển đổi từ Firebase, bạn cần thay đổi trạng thái của ConversionAction từ HIDDEN thành ENABLED thông qua phương thức mutate của ConversionActionService. Việc cập nhật app_id không được hỗ trợ đối với các hành động chuyển đổi này.

Các loại hành động chuyển đổi từ Firebase bao gồm:

• FIREBASE_ANDROID_FIRST_OPEN
• FIREBASE_ANDROID_IN_APP_PURCHASE
• FIREBASE_ANDROID_CUSTOM
• FIREBASE_IOS_FIRST_OPEN
• FIREBASE_IOS_IN_APP_PURCHASE
• FIREBASE_IOS_CUSTOM

Đối với các dịch vụ phân tích ứng dụng của bên thứ ba, các loại hành động chuyển đổi bao gồm:

• THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

Doanh số tại cửa hàng

Mặc dù bạn không thể tạo hành động chuyển đổi STORE_SALES hoặc STORE_SALES_DIRECT_UPLOAD thông qua API Google Ads, nhưng API này hỗ trợ tải lên dữ liệu giao dịch bán hàng tại cửa hàng.

• STORE_SALES
• STORE_SALES_DIRECT_UPLOAD

Khác

Dưới đây là các loại hành động chuyển đổi chỉ có thể đọc trong API Google Ads và được cung cấp cho mục đích báo cáo:

• ANDROID_APP_PRE_REGISTRATION
• ANDROID_INSTALLS_ALL_OTHER_APPS
• FLOODLIGHT_ACTION
• FLOODLIGHT_TRANSACTION
• GOOGLE_HOSTED
• LEAD_FORM_SUBMIT
• SALESFORCE
• SEARCH_ADS_360
• SMART_CAMPAIGN_AD_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_DIRECTIONS
• SMART_CAMPAIGN_TRACKED_CALLS
• STORE_VISITS
• WEBPAGE_CODELESS

Không xác định

Trong một số trường hợp, tài khoản Google Ads của bạn có thể bao gồm các loại hành động chuyển đổi mà hệ thống trả về với loại ConversionAction.type là UNKNOWN. Điều này có nghĩa là API Google Ads không hỗ trợ quản lý trực tiếp những hành động chuyển đổi này. Tuy nhiên, các hành động chuyển đổi đó vẫn sẽ được trả về trong báo cáo để cung cấp dữ liệu đầy đủ cho các chỉ số chuyển đổi chính, chẳng hạn như metrics.conversions và metrics.conversions_value.

Ví dụ về mã

Ví dụ mã sau đây minh họa quy trình tạo một hành động chuyển đổi. Trong trường hợp này, mã sẽ tạo một hành động chuyển đổi với type được thiết lập là UPLOAD_CLICKS. Quy trình này tương tự như việc tạo hành động chuyển đổi thông qua giao diện người dùng Google Ads, bằng cách sử dụng tùy chọn Nhập > Nhập thủ công bằng API hoặc Tải lên > Theo dõi lượt chuyển đổi từ số lượt nhấp. Mã này cũng thiết lập category mặc định là DEFAULT.

Các thiết lập mặc định được áp dụng như sau:

• API Google Ads tự động thiết lập trường primary_for_goal, tuy nhiên, bạn có thể tùy chỉnh để kiểm soát cách hành động chuyển đổi ảnh hưởng đến việc báo cáo và đặt giá thầu.
• Trường counting_type sẽ tự động được thiết lập thành MANY_PER_CLICK. Tham khảo thêm bài viết về cách tính lượt chuyển đổi để hiểu chi tiết hơn.
• Mô hình phân bổ sẽ được đặt mặc định là GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN trong attribution_model_settings.

Dưới đây là ví dụ mã bằng Java (có thể áp dụng với các ngôn ngữ lập trình khác như C#, PHP, Python, Ruby, Perl):

Bạn có thể tìm thấy ví dụ mã này trong thư mục Tái tiếp thị của thư viện ứng dụng Google Ads, cũng như trong các tập hợp mã ví dụ về Thêm mã hành động chuyển đổi.

Xác nhận kết quả

Google Ads và API Google Ads hỗ trợ nhiều loại hành động chuyển đổi, vì vậy các quy tắc xác thực có thể khác nhau tùy thuộc vào type của hành động chuyển đổi.

Lỗi phổ biến nhất khi tạo một hành động chuyển đổi là DUPLICATE_NAME. Để tránh lỗi này, hãy đảm bảo rằng mỗi hành động chuyển đổi có tên riêng biệt.

Dưới đây là một số lưu ý về cách thiết lập các trường trong ConversionAction:

• Tất cả các trường enum: Việc cố gắng đặt giá trị của một trường enum thành UNKNOWN sẽ dẫn đến lỗi RequestError.INVALID_ENUM_VALUE.
• app_id: Thuộc tính app_id không thể thay đổi và chỉ có thể thiết lập khi tạo mới một hành động chuyển đổi dành cho ứng dụng.
• attribution_model_settings: Đặt giá trị này thành tùy chọn không còn được hỗ trợ sẽ gây ra lỗi CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Google Ads hiện chỉ hỗ trợ GOOGLE_ADS_LAST_CLICK và GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN.
• click_through_lookback_window_days: Thiết lập giá trị này nằm ngoài phạm vi cho phép sẽ dẫn đến lỗi RangeError.TOO_LOW hoặc RangeError.TOO_HIGH. Đối với các hành động chuyển đổi AD_CALL hoặc WEBSITE_CALL, phạm vi cho phép là từ [1,60]. Đối với các hành động chuyển đổi khác, phạm vi cho phép là [1,30].
• include_in_conversions_metric: Không thể thiết lập giá trị này trong quá trình tạo hoặc cập nhật thông qua lỗi FieldError.IMMUTABLE_FIELD. Thay vào đó, hãy thiết lập primary_for_goal như mô tả trong tài liệu về mục tiêu lượt chuyển đổi.
• phone_call_duration_seconds: Thiết lập thuộc tính này cho một hành động chuyển đổi không liên quan đến cuộc gọi sẽ dẫn đến lỗi FieldError.VALUE_MUST_BE_UNSET.
• type: Thuộc tính type không thể thay đổi sau khi đã thiết lập và chỉ có thể được đặt khi tạo mới một hành động chuyển đổi. Việc cập nhật một hành động chuyển đổi có type là UNKNOWN sẽ dẫn đến lỗi MutateError.MUTATE_NOT_ALLOWED.
• value_settings: Đối với hành động chuyển đổi WEBSITE_CALL hoặc AD_CALL, thuộc tính value_settings phải có always_use_default_value được đặt là true. Nếu đặt giá trị này thành false khi tạo hoặc cập nhật sẽ dẫn đến lỗi INVALID_VALUE.
• view_through_lookback_window_days: Thiết lập giá trị nằm ngoài phạm vi cho phép sẽ dẫn đến lỗi RangeError.TOO_LOW hoặc RangeError.TOO_HIGH. Đối với hầu hết các hành động chuyển đổi, phạm vi cho phép là [1,30]. Không thể thiết lập thuộc tính này cho các hành động chuyển đổi AD_CALL hoặc WEBSITE_CALL, việc chỉ định giá trị sẽ gây ra lỗi VALUE_MUST_BE_UNSET.