Danh mục hành động chuyển đổi

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:

  1. Sự kiện chuyển đổi xảy ra ở đâu?

  2. Lượt chuyển đổi ngoại tuyến:

  3. Lượt chuyển đổi trực tuyến (trên trang web):

  4. Lượt chuyển đổi đối với ứng dụng di độ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 từ 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, đồng thờ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 một số 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 ứng dụng giú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 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 phần 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à một lượt chuyển đổi nếu kéo dài hơn thời lượng đã chỉ định. 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 thành phần đó ở cấp khách hàng, chiến dịch hoặc nhóm quảng cáo.

CLICK_TO_CALL

Hành động chuyển đổi CLICK_TO_CALL xuất hiện dưới dạng lượt chuyển đổi Lượt nhấp vào số điện thoại của bạn 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. Tính năng này rất 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 nâng cao độ 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) vào 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 bài viết Quản lý lượt chuyển đổi từ 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ó
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

API Google Ads 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 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.origin,
  conversion_action.category,
  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. Chỉ số này chỉ có thể được phân đoạn theo bất kỳ tổ hợp nào của segments.sk_ad_network_conversion_value và các phân đoạn 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 đoạn này cho bất kỳ chỉ số nào khác ngoài metrics.sk_ad_network_installs, metrics.sk_ad_network_total_conversions và chỉ có thể kết hợp phân đoạn này với các phân đoạn liên quan đến ngày.

Giá trị 0 sẽ được trả về nếu Apple báo cáo giá trị 0 và không có giá trị nào khác. Hãy kiểm tra sự hiện diện của trường để phân biệt giữa hai trường hợp.

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 thông báo sau, 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ã nhận dạng ứ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 đoạn 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 sau khi cài đặt 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 đoạn 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 và ứng dụng nguồn đều không có trong bất kỳ thông báo xác nhận nào do Apple gửi.
segments.sk_ad_network_user_type Loại người dùng đã tạo 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ả những giá trị rỗng đã được phân phối lại cho 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 chính xác được ghi nhận do Apple trả về và giá trị rỗng được mô hình hoá từ Google.
segments.sk_ad_network_version Phiên bản API mạng quảng cáo Store Kit 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_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 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:

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à dịch vụ phân tích ứng dụng 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_IMPRESSION
  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • FIREBASE_IOS_APP_AD_IMPRESSION
  • FIREBASE_IOS_FIRST_OPEN
  • FIREBASE_IOS_IN_APP_PURCHASE
  • FIREBASE_IOS_CUSTOM
  • 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

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_SALES
  • STORE_SALES_DIRECT_UPLOAD

Lượt chuyển đổi dẫn đến hành động liên quan đến địa điểm thực tế

Google Ads tự động tạo lượt chuyển đổi dạng hành động đối với địa điểm thực tế để theo dõi các hành động trên các sản phẩm và dịch vụ dựa trên vị trí của Google (chẳng hạn như Google Maps) sau khi có người tương tác với quảng cáo.

Trong Google Ads API, tất cả lượt chuyển đổi dạng hành động đối với địa điểm thực tế đều là tài nguyên ConversionAction chỉ có thể đọc với các giá trị trường sau:

Các trường name (được bản địa hoá theo ngôn ngữ của tài khoản) và category xác định từng lượt chuyển đổi dạng hành động đối với địa điểm thực tế, như trong bảng sau. Hành động liên quan đến địa điểm thực tế – Lượt truy cập vào trang web và Hành động liên quan đến địa điểm thực tế – Lượt xem thực đơn đều sử dụng danh mục PAGE_VIEW và được phân biệt trong báo cáo bằng conversion_action.name hoặc conversion_action.id.

Tên hành động chuyển đổi trên Google Ads Trường ConversionAction.category Mô tả
Số lượt nhấp để gọi CONTACT Lượt nhấp vào nút Gọi trên một quảng cáo hoặc dịch vụ dựa trên vị trí của Google.
Hành động liên quan đến địa điểm thực tế – Đường đi GET_DIRECTIONS Số lượt nhấp vào nút Xem đường đi trên một quảng cáo hoặc dịch vụ dựa trên vị trí của Google.
Hành động liên quan đến địa điểm thực tế – Lượt truy cập trang web PAGE_VIEW Nhấp vào đường liên kết đến trang web trên một quảng cáo hoặc dịch vụ dựa trên vị trí của Google.
Hành động liên quan đến địa điểm thực tế – Lượt xem thực đơn PAGE_VIEW Nhấp vào đường liên kết đến thực đơn trên một quảng cáo hoặc dịch vụ dựa trên vị trí của Google.
Hành động liên quan đến địa điểm thực tế – Số đơn đặt hàng BEGIN_CHECKOUT Nhấp vào nút Đặt hàng trên một quảng cáo hoặc dịch vụ dựa trên vị trí của Google.
Hành động liên quan đến địa điểm thực tế – Các lượt tương tác khác ENGAGEMENT Các lượt nhấp dẫn đến hành động được theo dõi khác (chẳng hạn như chia sẻ hoặc lưu một vị trí) trên một quảng cáo hoặc dịch vụ dựa trên vị trí của Google.

Theo mặc định, tất cả mục tiêu lượt chuyển đổi GOOGLE_HOSTED đều không thể đặt giá thầu (biddable là false). Bạn chỉ có thể bật tính năng đặt giá thầu cho các mục tiêu hành động liên quan đến địa điểm thực tế sau đây:

  • Hành động liên quan đến địa điểm thực tế – Đường đi (category là GET_DIRECTIONS, origin là GOOGLE_HOSTED):
    • Cấp tài khoản: Đặt trường biddable thành true trên tài nguyên CustomerConversionGoal cho danh mục GET_DIRECTIONS và nguồn gốc GOOGLE_HOSTED, hoặc đưa hành động chuyển đổi vào CustomConversionGoal.
    • Cấp chiến dịch (chỉ dành cho chiến dịch Tối đa hoá hiệu suất, chiến dịch Tìm kiếm và chiến dịch Mua sắm): Đặt trường biddable thành true trên tài nguyên CampaignConversionGoal cho danh mục GET_DIRECTIONS và nguồn gốc GOOGLE_HOSTED.
  • Lượt nhấp để gọi điện (category là CONTACT, origin là GOOGLE_HOSTED):
    • Cấp chiến dịch (chỉ dành cho chiến dịch Tối đa hoá hiệu suất): Đặt trường biddable thành true trên tài nguyên CampaignConversionGoal cho danh mục CONTACT và nguồn gốc GOOGLE_HOSTED. Mục tiêu này không hỗ trợ chiến lược đặt giá thầu cấp tài khoản bằng CustomerConversionGoal.

Tất cả các danh mục GOOGLE_HOSTED khác (PAGE_VIEW, BEGIN_CHECKOUT và ENGAGEMENT) đều không thể đặt giá thầu. Để biết thêm thông tin, hãy xem bài viết Mục tiêu lượt chuyển đổi.

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_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

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, 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 không hỗ trợ việc 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.