ConversionAction

Hành động chuyển đổi.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Các trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của hành động chuyển đổi. Tên tài nguyên hành động chuyển đổi có dạng:

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

Trạng thái của hành động chuyển đổi này để tích luỹ sự kiện chuyển đổi.
type

enum (ConversionActionType)

Không thể thay đổi. Loại hành động chuyển đổi này.
origin

enum (ConversionOrigin)

Chỉ có đầu ra. Nguồn gốc chuyển đổi của hành động chuyển đổi này.
category

enum (ConversionActionCategory)

Danh mục lượt chuyển đổi được báo cáo cho hành động chuyển đổi này.
valueSettings

object (ValueSettings)

Chế độ cài đặt liên quan đến giá trị của sự kiện chuyển đổi được liên kết với hành động chuyển đổi này.
countingType

enum (ConversionActionCountingType)

Cách tính sự kiện chuyển đổi cho hành động chuyển đổi đó.
attributionModelSettings

object (AttributionModelSettings)

Chế độ cài đặt liên quan đến mô hình phân bổ của hành động chuyển đổi này.
tagSnippets[]

object (TagSnippet)

Chỉ có đầu ra. Các đoạn mã được dùng để theo dõi lượt chuyển đổi.
mobileAppVendor

enum (MobileAppVendor)

Chỉ có đầu ra. Nhà cung cấp ứng dụng di động cho hành động chuyển đổi ứng dụng.
firebaseSettings

object (FirebaseSettings)

Chỉ có đầu ra. Chế độ cài đặt Firebase cho loại chuyển đổi trên Firebase.
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

Chỉ có đầu ra. Chế độ cài đặt Phân tích ứng dụng của bên thứ ba cho các loại chuyển đổi của bên thứ ba.
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Chỉ có đầu ra. Chế độ cài đặt Google Analytics 4 cho các loại chuyển đổi Google Analytics 4.
id

string (int64 format)

Chỉ có đầu ra. Mã của hành động chuyển đổi.
name

string

Tên của hành động chuyển đổi.

Đây là trường bắt buộc và không được để trống khi tạo hành động chuyển đổi mới.
primaryForGoal

boolean

Nếu giá trịprimaryForTarget của một hành động chuyển đổi là false, thì hành động chuyển đổi đó không thể đặt giá thầu cho tất cả các chiến dịch, bất kể mục tiêu lượt chuyển đổi của khách hàng hoặc mục tiêu lượt chuyển đổi của chiến dịch. Tuy nhiên, mục tiêu lượt chuyển đổi tuỳ chỉnh không tuân theo primaryForMục tiêu, vì vậy, nếu một chiến dịch có mục tiêu lượt chuyển đổi tuỳ chỉnh được định cấu hình với hành động chuyển đổi primaryForTarget = false, thì hành động chuyển đổi đó vẫn có thể đặt giá thầu được. Theo mặc định, primaryForGoals sẽ là true (đúng) nếu không được đặt. Trong V9, primaryForTable chỉ có thể được đặt thành false sau khi tạo thông qua thao tác "update" vì nó không được khai báo là không bắt buộc.
ownerCustomer

string

Chỉ có đầu ra. Tên tài nguyên của khách hàng của chủ sở hữu hành động chuyển đổi hoặc rỗng nếu đây là hành động chuyển đổi do hệ thống xác định.
includeInConversionsMetric

boolean

Liệu có nên đưa hành động chuyển đổi này vào chỉ số "lượt chuyển đổi" không.
clickThroughLookbackWindowDays

string (int64 format)

Số ngày tối đa có thể trôi qua giữa một lượt tương tác (ví dụ: lượt nhấp) và một sự kiện chuyển đổi.
viewThroughLookbackWindowDays

string (int64 format)

Số ngày tối đa có thể trôi qua giữa một lượt hiển thị và một lượt chuyển đổi mà không có một lượt tương tác.
phoneCallDurationSeconds

string (int64 format)

Thời lượng cuộc gọi điện thoại tính bằng giây mà sau đó một lượt chuyển đổi sẽ được báo cáo cho hành động chuyển đổi này.

Giá trị phải nằm trong khoảng từ 0 đến 10.000.
appId

string

Mã ứng dụng cho hành động chuyển đổi ứng dụng.

ConversionActionStatus

Trạng thái có thể có của một hành động chuyển đổi.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Lượt chuyển đổi sẽ được ghi lại.
REMOVED Lượt chuyển đổi sẽ không được ghi lại.
HIDDEN Lượt chuyển đổi sẽ không được ghi lại và hành động chuyển đổi đó sẽ không xuất hiện trong giao diện người dùng.

ConversionActionType

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

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AD_CALL Lượt chuyển đổi xảy ra khi người dùng nhấp vào phần mở rộng về cuộc gọi của quảng cáo.
CLICK_TO_CALL Lượt chuyển đổi xảy ra khi người dùng nhấp vào một số điện thoại trên thiết bị di động.
GOOGLE_PLAY_DOWNLOAD Lượt chuyển đổi xảy ra khi người dùng tải một ứng dụng di động xuống từ Cửa hàng Google Play.
GOOGLE_PLAY_IN_APP_PURCHASE Lượt chuyển đổi xảy ra khi người dùng mua hàng trong một ứng dụng thông qua phương thức thanh toán cho Android.
UPLOAD_CALLS Lượt chuyển đổi cuộc gọi được nhà quảng cáo theo dõi và tải lên.
UPLOAD_CLICKS Lượt chuyển đổi được nhà quảng cáo theo dõi và tải lên cùng với lượt nhấp được phân bổ.
WEBPAGE Các lượt chuyển đổi xảy ra trên một trang web.
WEBSITE_CALL Lượt chuyển đổi xảy ra khi người dùng gọi đến một số điện thoại được tạo động từ trang web của nhà quảng cáo.
STORE_SALES_DIRECT_UPLOAD Lượt chuyển đổi từ Lượt bán hàng tại cửa hàng thực tế dựa trên dữ liệu người bán của bên thứ nhất hoặc bên thứ ba mà bạn tải lên. Chỉ những khách hàng trong danh sách cho phép mới có thể sử dụng các loại tệp tải lên trực tiếp dẫn đến lượt bán hàng tại cửa hàng thực tế.
STORE_SALES Lượt chuyển đổi từ Lượt bán hàng tại cửa hàng thực tế dựa trên dữ liệu người bán do bên thứ nhất hoặc bên thứ ba tải lên và/hoặc từ các giao dịch mua hàng tại cửa hàng thực tế bằng thẻ thuộc các mạng thanh toán. Chỉ những khách hàng trong danh sách cho phép mới có thể sử dụng các loại lượt bán hàng tại cửa hàng thực tế. Chỉ đọc.
FIREBASE_ANDROID_FIRST_OPEN Lượt chuyển đổi lần mở đầu tiên trong ứng dụng Android được theo dõi thông qua Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua hàng trong ứng dụng Android được theo dõi thông qua Firebase.
FIREBASE_ANDROID_CUSTOM Lượt chuyển đổi tuỳ chỉnh trong ứng dụng Android được theo dõi thông qua Firebase.
FIREBASE_IOS_FIRST_OPEN Lượt chuyển đổi lần mở đầu tiên trong ứng dụng iOS được theo dõi thông qua Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua hàng trong ứng dụng dành cho iOS được theo dõi thông qua Firebase.
FIREBASE_IOS_CUSTOM Lượt chuyển đổi tuỳ chỉnh trong ứng dụng dành cho iOS được theo dõi thông qua Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Lượt chuyển đổi lần mở đầu tiên trong ứng dụng Android được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Các lượt chuyển đổi giao dịch mua hàng trong ứng dụng Android được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Chuyển đổi tùy chỉnh trong ứng dụng Android được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Lượt chuyển đổi lần mở đầu tiên trong ứng dụng iOS được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua hàng trong ứng dụng iOS được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Lượt chuyển đổi tuỳ chỉnh trong ứng dụng iOS được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
ANDROID_APP_PRE_REGISTRATION Lượt chuyển đổi xảy ra khi người dùng đăng ký trước một ứng dụng dành cho thiết bị di động trên Cửa hàng Google Play. Chỉ đọc.
ANDROID_INSTALLS_ALL_OTHER_APPS Lượt chuyển đổi theo dõi tất cả lượt tải xuống trên Google Play không được theo dõi theo một loại ứng dụng cụ thể. Chỉ đọc.
FLOODLIGHT_ACTION Hoạt động Floodlight đếm số lần người dùng đã truy cập vào một trang web cụ thể sau khi xem hoặc nhấp vào một trong các quảng cáo của nhà quảng cáo. Chỉ đọc.
FLOODLIGHT_TRANSACTION Hoạt động Floodlight theo dõi số lượt bán hàng hoặc số lượng mặt hàng đã mua. Cũng có thể thu thập tổng giá trị của mỗi lượt bán hàng. Chỉ đọc.
GOOGLE_HOSTED Lượt chuyển đổi giúp theo dõi hành động liên quan đến địa điểm thực tế trên các sản phẩm và dịch vụ của Google sau khi tương tác với quảng cáo. Chỉ đọc.
LEAD_FORM_SUBMIT Lượt chuyển đổi được báo cáo khi người dùng gửi một biểu mẫu khách hàng tiềm năng. Chỉ đọc.
SALESFORCE Lượt chuyển đổi từ Salesforce. Chỉ đọc.
SEARCH_ADS_360 Lượt chuyển đổi được nhập từ dữ liệu Floodlight của Search Ads 360. Chỉ đọc.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Lượt chuyển đổi cuộc gọi xảy ra trên Quảng cáo chiến dịch Thông minh mà không cần thiết lập tính năng theo dõi cuộc gọi, bằng cách sử dụng tiêu chí tùy chỉnh của chiến dịch Thông minh. Chỉ đọc.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Người dùng nhấp vào một thành phần cuộc gọi trong Google Maps. Chỉ chiến dịch Thông minh. Chỉ đọc.
SMART_CAMPAIGN_MAP_DIRECTIONS Người dùng yêu cầu xem đường đi đến địa điểm của doanh nghiệp trong Google Maps. Chỉ chiến dịch Thông minh. Chỉ đọc.
SMART_CAMPAIGN_TRACKED_CALLS Lượt chuyển đổi cuộc gọi diễn ra trên những Quảng cáo sử dụng chiến dịch Thông minh có chế độ theo dõi cuộc gọi, bằng cách sử dụng các tiêu chí tùy chỉnh của chiến dịch Thông minh. Chỉ đọc.
STORE_VISITS Lượt chuyển đổi xảy ra khi người dùng ghé thăm cửa hàng bán lẻ của nhà quảng cáo. Chỉ đọc.
WEBPAGE_CODELESS Lượt chuyển đổi được tạo từ các sự kiện trên trang web (chẳng hạn như lượt gửi biểu mẫu hoặc lượt tải trang) mà không sử dụng đoạn mã sự kiện được mã hoá riêng. Chỉ đọc.
UNIVERSAL_ANALYTICS_GOAL Lượt chuyển đổi đến từ mục tiêu Universal Analytics được liên kết.
UNIVERSAL_ANALYTICS_TRANSACTION Lượt chuyển đổi đến từ các giao dịch Universal Analytics được liên kết.
GOOGLE_ANALYTICS_4_CUSTOM Lượt chuyển đổi đến từ lượt chuyển đổi sự kiện tuỳ chỉnh Google Analytics 4 được liên kết.
GOOGLE_ANALYTICS_4_PURCHASE Lượt chuyển đổi đến từ lượt chuyển đổi giao dịch mua trên Google Analytics 4 được liên kết.

ValueSettings

Chế độ cài đặt liên quan đến giá trị của sự kiện chuyển đổi được liên kết với hành động chuyển đổi này.

Biểu diễn dưới dạng JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Các trường
defaultValue

number

Giá trị cần sử dụng khi sự kiện chuyển đổi cho hành động chuyển đổi này được gửi kèm theo giá trị không hợp lệ, không được phép hoặc bị thiếu, hoặc khi hành động chuyển đổi này được định cấu hình để luôn sử dụng giá trị mặc định.
defaultCurrencyCode

string

Mã đơn vị tiền tệ cần sử dụng khi hệ thống gửi sự kiện chuyển đổi cho hành động chuyển đổi này kèm theo mã đơn vị tiền tệ không hợp lệ hoặc bị thiếu, hoặc khi bạn định cấu hình hành động chuyển đổi này để luôn sử dụng giá trị mặc định.
alwaysUseDefaultValue

boolean

Kiểm soát việc có dùng giá trị mặc định và mã đơn vị tiền tệ mặc định thay cho giá trị và mã đơn vị tiền tệ được chỉ định trong sự kiện chuyển đổi cho hành động chuyển đổi này hay không.

ConversionActionCountingType

Cho biết cách tính số lượt chuyển đổi cho hành động này. Để biết thêm thông tin, hãy xem https://support.google.com/google-ads/answer/3438531.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ONE_PER_CLICK Chỉ tính một lượt chuyển đổi cho mỗi lượt nhấp.
MANY_PER_CLICK Đếm tất cả lượt chuyển đổi cho mỗi lượt nhấp.

AttributionModelSettings

Chế độ cài đặt liên quan đến mô hình phân bổ của hành động chuyển đổi này.

Biểu diễn dưới dạng JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Các trường
attributionModel

enum (AttributionModel)

Loại mô hình phân bổ của hành động chuyển đổi này.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

Chỉ có đầu ra. Trạng thái của mô hình phân bổ dựa trên dữ liệu cho hành động chuyển đổi.

AttributionModel

Mô hình phân bổ mô tả cách phân bổ giá trị đóng góp cho một lượt chuyển đổi cụ thể dựa trên nhiều lượt tương tác trước đó có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
EXTERNAL Sử dụng mô hình phân bổ bên ngoài.
GOOGLE_ADS_LAST_CLICK Tất cả giá trị đóng góp cho một lượt chuyển đổi đều được phân bổ cho lượt nhấp cuối cùng.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Phân bổ toàn bộ giá trị đóng góp cho một lượt chuyển đổi cho lượt nhấp đầu tiên của lượt chuyển đổi đó bằng mô hình phân bổ trên Google Tìm kiếm.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Phân bổ giá trị đóng góp bằng nhau cho một lượt chuyển đổi cho tất cả các lượt nhấp vào lượt chuyển đổi đó bằng cách sử dụng mô hình phân bổ trên Google Tìm kiếm.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Phân bổ giá trị đóng góp nhiều hơn theo cấp số nhân cho một lượt chuyển đổi cho các lượt nhấp gần đây hơn bằng cách sử dụng mô hình phân bổ trên Google Tìm kiếm (chu kỳ phân nửa là 1 tuần).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 40% giá trị đóng góp để đạt được một lượt chuyển đổi đến từ các lượt nhấp đầu tiên và lượt nhấp cuối cùng. 20% còn lại được phân bổ đồng đều cho tất cả các lượt nhấp khác. Phương thức này sử dụng mô hình phân bổ của Google Tìm kiếm.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Mô hình linh hoạt sử dụng công nghệ học máy để xác định mức phân bổ giá trị đóng góp phù hợp cho các lượt nhấp bằng mô hình phân bổ trên Google Tìm kiếm.

DataDrivenModelStatus

Liệt kê các trạng thái của mô hình dựa trên dữ liệu.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AVAILABLE Bạn có thể sử dụng mô hình dựa trên dữ liệu.
STALE Mô hình dựa trên dữ liệu đã lỗi thời. Thông tin này chưa được cập nhật trong ít nhất 7 ngày. Mã này vẫn đang được sử dụng nhưng sẽ hết hạn nếu bạn không cập nhật trong vòng 30 ngày.
EXPIRED Mô hình dựa trên dữ liệu đã hết hạn. Tệp này chưa được cập nhật trong ít nhất 30 ngày nên không thể sử dụng. Trường hợp phổ biến nhất là do không có đủ số lượng sự kiện cần thiết trong khoảng thời gian 30 ngày gần đây.
NEVER_GENERATED Mô hình dựa trên dữ liệu chưa từng được tạo. Trường hợp phổ biến nhất là do chưa từng có số lượng sự kiện cần thiết trong khoảng thời gian 30 ngày bất kỳ.

FirebaseSettings

Chế độ cài đặt liên quan đến một hành động chuyển đổi trên Firebase.

Biểu diễn dưới dạng JSON 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Các trường
propertyId

string (int64 format)

Chỉ có đầu ra. Mã tài sản GA của lượt chuyển đổi.
propertyName

string

Chỉ có đầu ra. Tên tài sản GA của lượt chuyển đổi.
eventName

string

Chỉ có đầu ra. Tên sự kiện của một lượt chuyển đổi trên Firebase.
projectId

string

Chỉ có đầu ra. Mã dự án Firebase của lượt chuyển đổi.

ThirdPartyAppAnalyticsSettings

Chế độ cài đặt liên quan đến hành động chuyển đổi phân tích ứng dụng của bên thứ ba.

Biểu diễn dưới dạng JSON 
{
  "providerName": string,
  "eventName": string
}
Các trường
providerName

string

Chỉ có đầu ra. Tên của nhà cung cấp phân tích ứng dụng bên thứ ba.
eventName

string

Chỉ có đầu ra. Tên sự kiện của lượt chuyển đổi phân tích ứng dụng bên thứ ba.

GoogleAnalytics4Settings

Chế độ cài đặt liên quan đến hành động chuyển đổi trên Google Analytics 4.

Biểu diễn dưới dạng JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
Các trường
eventName

string

Chỉ có đầu ra. Tên của sự kiện GA4.
propertyName

string

Chỉ có đầu ra. Tên của tài sản GA4.
propertyId

string (int64 format)

Chỉ có đầu ra. Mã của tài sản GA4.