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ể tạo bằng Google Ads API, cũng như thông tin về cách các hành động này liên kết với giao diện web của Google Ads.
Chọn loại hành động chuyển đổi phù hợp
Để chọn đúng loại hành động chuyển đổi và hướng dẫn thiết lập cho hoạt động tích hợp của bạn, hãy làm theo quy trình ra quyết định sau:
Sự kiện chuyển đổi xảy ra ở đâu?
- Trong thế giới thực (ví dụ: tại văn phòng, địa điểm kinh doanh hoặc qua điện thoại): Chuyển đến bước 2.
- Trực tiếp trên trang web của bạn (ví dụ: lượt mua hàng, lượt đăng ký hoặc lượt gửi biểu mẫu trên trang web): Chuyển đến bước 3.
- Trong ứng dụng di động: Chuyển đến bước 4.
- Qua cuộc gọi điện thoại được thực hiện trực tiếp từ quảng cáo của bạn: Sử dụng Cuộc gọi từ
quảng cáo (
AD_CALL) (sử dụngCallAsset).
Lượt chuyển đổi ngoại tuyến:
Đó có phải là cuộc gọi điện thoại không?
Có: Sử dụng
Nhập lượt chuyển đổi dạng cuộc gọi (
UPLOAD_CALLS) để theo dõi kết quả cuộc gọi.
Đây có phải là chương trình giảm giá tại cửa hàng thực tế không?
Đó có phải là lượt bán hàng ngoại tuyến hay tiến trình tạo khách hàng tiềm năng bắt nguồn từ một lượt truy cập vào trang web không?
- Có: Sử dụng tính năng Lượt chuyển đổi nâng cao cho khách hàng tiềm năng bằng Data Manager API (nên dùng) hoặc xem bài viết Quản lý lượt chuyển đổi ngoại tuyến dẫn đến lượt nhấp đối với các hoạt động tích hợp Google Ads API hiện có. (Lưu ý: Kể từ ngày 15 tháng 6 năm 2026, việc tải lượt chuyển đổi dẫn đến lượt nhấp lên bằng
UploadClickConversionschỉ dành cho những mã của nhà phát triển đã từng tải lượt chuyển đổi dẫn đến lượt nhấp ngoại tuyến lên).
- Có: Sử dụng tính năng Lượt chuyển đổi nâng cao cho khách hàng tiềm năng bằng Data Manager API (nên dùng) hoặc xem bài viết Quản lý lượt chuyển đổi ngoại tuyến dẫn đến lượt nhấp đối với các hoạt động tích hợp Google Ads API hiện có. (Lưu ý: Kể từ ngày 15 tháng 6 năm 2026, việc tải lượt chuyển đổi dẫn đến lượt nhấp lên bằng
Lượt chuyển đổi trực tuyến (trên trang web):
- Bạn muốn theo dõi lượt tải trang (giao dịch mua, biên nhận) hay lượt nhấp của người dùng?
- Có: Sử dụng Lượt chuyển đổi trên trang web với đoạn mã thẻ được đặt thành
WEBPAGEhoặcWEBPAGE_ONCLICK.
- Có: Sử dụng Lượt chuyển đổi trên trang web với đoạn mã thẻ được đặt thành
Bạn có muốn theo dõi các cuộc gọi được thực hiện từ một số điện thoại có trên trang web của mình không?
Theo dõi thời lượng cuộc gọi thực tế?
Có: Sử dụng
Cuộc gọi từ trang web (
WEBSITE_CALL) bằng số chuyển tiếp của Google động và đoạn mã sự kiện thẻ.Không (chỉ theo dõi lượt nhấp vào nút/đường liên kết trên trang web dành cho thiết bị di động)? Sử dụng
Số lượt nhấp vào số điện thoại di động của bạn (
CLICK_TO_CALL).
- Bạn muốn theo dõi lượt tải trang (giao dịch mua, biên nhận) hay lượt nhấp của người dùng?
Lượt chuyển đổi đối với ứng dụng di động:
- Có cần theo dõi lượt cài đặt hoặc lượt mua hàng trên Cửa hàng Google Play không?
- Có: Sử dụng Lượt chuyển đổi đối với ứng dụng (
GOOGLE_PLAY_DOWNLOADhoặcGOOGLE_PLAY_IN_APP_PURCHASE).
- Có: Sử dụng Lượt chuyển đổi đối với ứng dụng (
Bạn có theo dõi hành động trong ứng dụng bằng Google Analytics (GA4) hoặc công cụ phân tích ứng dụng của bên thứ ba không?
Có: Sử dụng
Firebase và dịch vụ phân tích ứng dụng bên thứ ba (bằng cách bật hành động chuyển đổi
FIREBASE_*hoặcTHIRD_PARTY_*).
- Có cần theo dõi lượt cài đặt hoặc lượt mua hàng trên Cửa hàng Google Play không?
Lượt chuyển đổi ngoại tuyến
Lượt chuyển đổi ngoại tuyến giúp bạn theo dõi các sự kiện chuyển đổi xảy ra trong thế giới thực, chẳng hạn như tại văn phòng, địa điểm kinh doanh hoặc qua điện thoại.
Bảng sau đây cho biết các tham số API ConversionActionType tương đương cần sử dụng cho từng Nguồn trong giao diện web của Google Ads và đường liên kết đến tài liệu 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à lượt chuyển đổi nâng cao cho khách hàng tiềm năng | Sử dụng Data Manager API (nên dùng) hoặc xem bài viết Quản lý lượt chuyển đổi dẫn đến lượt nhấp ngoại tuyến đối với các hoạt động tích hợp Google Ads API hiện có |
UPLOAD_CALLS |
Theo dõi lượt chuyển đổi từ cuộc gọi | Hướng dẫn nhập lượt chuyển đổi dạng cuộc gọi |
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ế | Xem bài viết Lượt bán hàng tại cửa hàng thực tế: nhập vào hành động chuyển đổi có báo cáo để biết thông tin chi tiết |
Lượt chuyển đổi trực tuyến (trên trang web)
Lượt chuyển đổi trên trang web giúp bạn theo dõi các hành động trên trang web, chẳng hạn như lượt bán hàng trực tuyến, lượt nhấp vào đường liên kết, lượt xem trang và lượt đăng ký.
Để theo dõi lượt chuyển đổi trên trang web, bạn phải tạo một
ConversionAction có
ConversionActionType được đặt thành WEBPAGE, rồi thêm một đoạn mã
gọi là thẻ vào trang chuyển đổi trên trang web của bạn.
ConversionAction bao gồm nhiều loại lượt chuyển đổi trên trang web, được phân biệt trong API bằng trường type trong mỗi TagSnippet được liệt kê trong trường tag_snippets của một ConversionAction.
TagSnippet cung cấp mã theo dõi mà bạn phải đưa vào trang web của mình để theo dõi các hành động chuyển đổi.
Lượt chuyển đổi Trang web và Lượt nhấp vào số điện thoại yêu cầu event_snippet (phải được đặt trên các trang web cho biết một hành động chuyển đổi, chẳng hạn 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) và global_site_tag (phải được cài đặt trên mọi trang của trang web). Bạn có thể truy xuất cả hai thuộc tính này bằng ConversionActionService. Hãy xem Trung tâm trợ giúp của chúng tôi để biết thêm thông tin về cách gắn thẻ cho các trang của bạn.
Bảng sau đây cho biết các tham số API tương đương cần sử dụng cho từng Nguồn trong giao diện web của Google Ads:
| Loại mã theo dõi | Nguồn Google Ads |
|---|---|
WEBPAGE |
Trang web, Trang web (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Trang web, Trang web (Google Analytics (GA4)) |
CLICK_TO_CALL |
Nhấp chuột vào số điện thoại |
Lượt chuyển đổi đối với ứng dụng
Lượt chuyển đổi đối với ứng dụng cho phép bạn theo dõi số lượt cài đặt ứng dụng di động hoặc số lượt mua hàng trong ứng dụng từ Cửa hàng Google Play.
Bảng sau đây cho biết các tham số API ConversionActionType tương đương cần sử dụng cho từng Nguồn trong giao diện người dùng web của Google Ads:
| Loại hành động chuyển đổi | Nguồn Google Ads |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Lượt cài đặt |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > Mua hàng trong ứng dụng |
Để theo dõi các hành động khác trong ứng dụng di động bằng cách sử dụng tài sản Google Analytics 4 hoặc dịch vụ phân tích ứng dụng bên thứ ba, hãy xem bài viết Các loại hành động chuyển đổi khác.
Lượt chuyển đổi dẫn đến cuộc gọi điện thoại
Tính năng theo dõi lượt chuyển đổi cuộc gọi điện thoại cho phép bạn theo dõi cuộc gọi từ quảng cáo, cuộc gọi đến một số điện thoại trên trang web và lượt nhấp vào số điện thoại trên trang web dành cho thiết bị di động.
Bảng sau đây cho biết các tham số API ConversionActionType tương đương cần sử dụng cho từng Nguồn trong giao diện web của Google Ads:
| 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 về cuộc gọi hoặc quảng cáo chỉ tạo cuộc gọi điện thoại |
WEBSITE_CALL |
Cuộc gọi đến số điện thoại trên trang web của bạn |
CLICK_TO_CALL |
Nhấp vào số điện thoại trên trang web dành cho thiết bị di động của bạn |
AD_CALL
Hành động chuyển đổi AD_CALL xuất hiện dưới dạng lượt chuyển đổi 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, hãy chỉ định tên tài nguyên của hành động đó trong trường call_conversion_action khi bạn tạo CallAsset.
Thành phần cuộc gọi cho phép bạn hiển thị số điện thoại ngay trong quảng cáo.
Cuộc gọi được báo cáo là lượt chuyển đổi nếu kéo dài hơn một khoảng thời gian cụ thể. Giá trị mặc định là 60 giây.
WEBSITE_CALL
Hành động chuyển đổi WEBSITE_CALL xuất hiện dưới dạng lượt chuyển đổi Cuộc gọi từ một trang web trong giao diện web của Google Ads.
Không giống như AD_CALL, trình theo dõi này yêu cầu bạn phải thêm event_snippet và global_site_tag vào trang web của mình để truy xuất số chuyển tiếp linh động của Google nhằm theo dõi cuộc gọi đến các số điện thoại được liệt kê trên trang web của bạn. Ngoài ra, bạn phải thiết lập một thành phần cuộc gọi và
liên kết ở cấp khách hàng, chiến dịch hoặc nhóm quảng cáo.
CLICK_TO_CALL
Một hành động chuyển đổi CLICK_TO_CALL sẽ xuất hiện dưới dạng lượt chuyển đổi Lượt nhấp vào số điện thoại trên trang web dành cho thiết bị di động trong giao diện web của Google Ads.
Loại CLICK_TO_CALL khác với loại AD_CALL ở chỗ loại này không theo dõi các cuộc gọi điện thoại thực tế. Thay vào đó, 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. Điều này hữu ích khi bạn không thể sử dụng số chuyển tiếp của Google để theo dõi cuộc gọi điện thoại.
Lượt chuyển đổi nâng cao
Tính năng lượt chuyển đổi nâng cao giúp bạn cải thiện độ chính xác của kết quả đo lường lượt chuyển đổi bằng cách bổ sung dữ liệu lượt chuyển đổi của bên thứ nhất (như địa chỉ email, tên, địa chỉ nhà riêng và số điện thoại) cho các thẻ lượt chuyển đổi hiện có.
Bảng sau đây cho biết các tham số API tương đương cần sử dụng cho từng Loại lượt chuyển đổi nâng cao:
| Loại hành động chuyển đổi | Loại lượt chuyển đổi nâng cao | Hướng dẫn thiết lập API |
|---|---|---|
UPLOAD_CLICKS |
Lượt chuyển đổi nâng cao cho khách hàng tiềm năng
Cải thiện kết quả đo lường giao dịch ngoại tuyến đến từ khách hàng tiềm năng hoặc khách truy cập vào trang web |
Sử dụng Data Manager API (nên dùng) hoặc xem phần Quản lý lượt chuyển đổi từ lượt nhấp ngoại tuyến cho các chế độ tích hợp Google Ads API hiện có |
WEBPAGE |
Lượt chuyển đổi nâng cao cho web
Cải thiện kết quả đo lường lượt chuyển đổi trực tuyến |
Hướng dẫn thiết lập API |
Các loại hành động chuyển đổi khác
Google Ads API cung cấp thêm các loại hành động chuyển đổi trong báo cáo,
nhưng có thể giới hạn hoặc cấm tạo hoặc sửa đổi các hành động đó. Bạn có thể truy vấn các hành động chuyển đổi và loại hành động chuyển đổi bằng GoogleAdsService:
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
Lượt chuyển đổi SKAdNetwork
Nếu chạy Chiến dịch quảng cáo ứng dụng iOS và đã triển khai SKAdNetwork, bạn có thể truy cập vào dữ liệu SKAdNetwork được cung cấp cho Google ở cấp Customer và Campaign bằng cách sử dụng 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 do Apple báo cáo. Bạn chỉ có thể phân đoạn chỉ số này
bằng bất kỳ tổ hợp segments.sk_ad_network_conversion_value và
phân đoạn nào liên quan đến ngày.
|
metrics.sk_ad_network_total_conversions |
Tổng số lượt chuyển đổi, bao gồm cả lượt cài đặt và các loại lượt chuyển đổi khác do Apple báo cáo. Bạn chỉ có thể phân đoạn chỉ số này theo các phân đoạn liên quan đến SKAdNetwork và các phân đoạn liên quan đến ngày. |
segments.sk_ad_network_ad_event_type |
Loại sự kiện đã xảy ra cho một lượt chuyển đổi cụ thể. |
segments.sk_ad_network_attribution_credit |
Cách phân bổ giá trị đóng góp cho một lượt chuyển đổi cụ thể. |
segments.sk_ad_network_fine_conversion_value |
Giá trị của một lượt chuyển đổi do Apple báo cáo. Bạn không thể áp dụng phân khúc này cho bất kỳ chỉ số nào khác ngoài Giá trị |
segments.sk_ad_network_coarse_conversion_value |
Giá trị thô cho một lượt chuyển đổi riêng lẻ. |
segments.sk_ad_network_postback_sequence_index |
Vị trí của postback, theo trình tự, cho 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 nơi quảng cáo thúc đẩy lượt cài đặt Mạng quảng cáo Bộ công cụ iOS Store được hiển thị. |
segments.sk_ad_network_source_domain |
Trang web nơi quảng cáo thúc đẩy lượt cài đặt Mạng quảng cáo Bộ công cụ iOS Store được hiển thị. Giá trị rỗng có nghĩa là phân khúc này không áp dụng (ví dụ: chiến dịch không phải iOS) hoặc không có trong bất kỳ thông báo đăng lại nào do Apple gửi. |
segments.sk_ad_network_source_type |
Loại nguồn nơi quảng cáo thúc đẩy lượt cài đặt Mạng quảng cáo Bộ công cụ iOS Store được hiển thị. Giá trị rỗng có nghĩa là phân khúc này không áp dụng (ví dụ: chiến dịch không phải iOS) hoặc cả miền nguồn lẫn ứng dụng nguồn đều không có trong bất kỳ lệnh gọi lại nào do Apple gửi. |
segments.sk_ad_network_user_type |
Loại người dùng đã tạo ra một lượt chuyển đổi cụ thể. |
segments.sk_ad_network_redistributed_fine_conversion_value |
Giá trị lượt chuyển đổi trong phân khúc này bao gồm các giá trị rỗng đã được phân phối lại thành giá trị lượt chuyển đổi. Phân khúc này thể hiện tổng giá trị lượt chuyển đổi chi tiết được ghi nhận do Apple trả về và giá trị rỗng được mô hình hoá của Google. |
segments.sk_ad_network_version |
Phiên bản API Mạng quảng cáo StoreKit của iOS đã được sử dụng. |
Google Analytics
Lượt chuyển đổi từ một
tài sản Google Analytics được liên kết có một trong
các giá trị type sau:
Lượt chuyển đổi trong tài sản GA4:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_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 từ trường
google_analytics_4_settings.
Bạn có thể thực hiện các thay đổi sau đối với lượt chuyển đổi trong tài sản GA4:
- Nhập lượt chuyển đổi từ tài sản GA4 vào tài khoản Google Ads bằng cách sửa đổi trường
statustừHIDDENthànhENABLED. - Sửa đổi các trường
primary_for_goalvàcategoryđể cho biết mức độ ảnh hưởng của mục tiêu đó đến hoạt động đặt giá thầu và báo cáo của Google Ads. - Cập nhật
namehoặcvalue_settingscủa ứng dụng. - Xoá lượt chuyển đổi khỏi tài khoản Google Ads bằng thao tác
remove.
Mọi nỗ lực sửa đổi 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 Universal Analytics đã nhập đều dẫn đến lỗi MUTATE_NOT_ALLOWED. Bạn chỉ có thể thực hiện những thay đổi đó bằng giao diện người dùng Google Ads.
Firebase và số liệu phân tích ứng dụng của bên thứ ba
Để nhập lượt chuyển đổi từ giải pháp phân tích ứng dụng của bên thứ ba hoặc Firebase, hãy thay đổi status của ConversionAction từ HIDDEN thành ENABLED bằng phương thức mutate của ConversionActionService. Không hỗ trợ cập nhật
app_id cho những hành động chuyển đổi này.
FIREBASE_ANDROID_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Lượt bán hàng tại cửa hàng thực tế: nhập vào hành động chuyển đổi có báo cáo
Mặc dù bạn không thể tạo hành động chuyển đổi STORE_SALES hoặc STORE_SALES_DIRECT_UPLOAD bằng Google Ads API, nhưng API này có hỗ trợ nhập giao dịch bán hàng tại cửa hàng thực tế.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
Các loại hành động chuyển đổi chỉ có thể đọc
Các loại hành động chuyển đổi sau đây chỉ có thể đọc trong Google Ads API và được cung cấp cho mục đích báo cáo.
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
Không xác định
Nếu tài khoản Google Ads của bạn có các loại hành động chuyển đổi khác, thì bạn có thể thấy
rằng các truy vấn và báo cáo trả về những hành động chuyển đổi có
ConversionAction.type là UNKNOWN. API này không hỗ trợ quản lý các hành động chuyển đổi này, nhưng sẽ trả về các hành động chuyển đổi này trong báo cáo để cung cấp kết quả đầy đủ cho các chỉ số lượt chuyển đổi chính như metrics.conversions và metrics.conversions_value.