ConversionAction

Một 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
}
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ị cho 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 một hành động chuyển đổi ứng dụng.
firebaseSettings

object (FirebaseSettings)

Chỉ có đầu ra. Chế độ cài đặt Firebase cho các 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ị primaryForObjective của một hành động chuyển đổi là false, thì hành động chuyển đổi đó sẽ 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 hay 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 primaryForTarget, vì vậy, nếu một chiến dịch có một 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. Theo mặc định, primaryForTarget sẽ là true nếu không được đặt. Trong V9, primaryForTarget 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 là chủ sở hữu hành động chuyển đổi hoặc tên rỗng nếu đây là hành động chuyển đổi do hệ thống xác định.
includeInConversionsMetric

boolean

Liệu hành động chuyển đổi này có được đưa vào chỉ số "lượt chuyển đổi" hay 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ụ: một lượt nhấp) đến 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ó lượt tương tác nào.
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 một hành động chuyển đổi ứng dụng.

ConversionActionStatus

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

Enum
UNSPECIFIED Chưa chỉ đị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 chỉ đị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 một 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 hệ thống thanh toán trên 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 trang web.
WEBSITE_CALL 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 dẫn đến lượt bán hàng tại cửa hàng thực tế dựa trên dữ liệu do bên thứ nhất hoặc bên thứ ba của người bán tải lên. Chỉ những khách hàng có 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 cho lượt bán hàng tại cửa hàng thực tế.
STORE_SALES Lượt chuyển đổi dẫn đến Lượt bán hàng tại cửa hàng thực tế dựa trên dữ liệu do bên thứ nhất hoặc bên thứ ba tải lên của người bá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ẻ của các mạng thanh toán. Chỉ những khách hàng có 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ó thể đọc.
FIREBASE_ANDROID_FIRST_OPEN Lượt chuyển đổi khi mở ứng dụng Android lần đầu đượ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 khi mở ứng dụng iOS lần đầu đượ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 iOS được theo dõi thông qua Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Lượt chuyển đổi khi mở ứng dụng Android lần đầu đượ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 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 Lượt chuyển đổi tuỳ 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 khi mở ứng dụng iOS lần đầu đượ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 ứng dụng iOS trong ứng dụng đượ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 trên ứ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 di động trên Cửa hàng Google Play. Chỉ có thể đọc.
ANDROID_INSTALLS_ALL_OTHER_APPS Lượt chuyển đổi theo dõi tất cả các lượt tải xuống trên Google Play nhưng không được theo dõi theo một loại ứng dụng cụ thể. Chỉ có thể đọc.
FLOODLIGHT_ACTION Hoạt động Floodlight tính 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ó thể đọc.
FLOODLIGHT_TRANSACTION Hoạt động Floodlight theo dõi số lượt bán hàng được thực hiện hoặc số lượng mặt hàng được mua. Cũng có thể thu thập tổng giá trị của mỗi lượt bán hàng. Chỉ có thể đọ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ế từ 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ó thể đọc.
LEAD_FORM_SUBMIT Lượt chuyển đổi sẽ được báo cáo khi người dùng gửi biểu mẫu khách hàng tiềm năng. Chỉ có thể đọc.
SALESFORCE Lượt chuyển đổi đến từ Salesforce. Chỉ có thể đọc.
SEARCH_ADS_360 Lượt chuyển đổi được nhập từ dữ liệu Floodlight của Search Ads 360. Chỉ có thể đọ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 tiêu chí tùy chỉnh của Chiến dịch thông minh. Chỉ có thể đọ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ó thể đọc.
SMART_CAMPAIGN_MAP_DIRECTIONS Người dùng yêu cầu chỉ đường đến vị trí của doanh nghiệp trong Google Maps. Chỉ chiến dịch Thông minh. Chỉ có thể đọc.
SMART_CAMPAIGN_TRACKED_CALLS 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 có chế độ 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í tuỳ chỉnh của Chiến dịch thông minh. Chỉ có thể đọ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ó thể đọ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ư gửi biểu mẫu hoặc tải trang) mà không sử dụng các đoạn mã sự kiện được mã hoá riêng. Chỉ có thể đọc.
UNIVERSAL_ANALYTICS_GOAL Lượt chuyển đổi đến từ mục tiêu Universal Analytics đã 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ừ các lượt chuyển đổi giao dịch mua được liên kết trên Google Analytics 4.

ValueSettings

Chế độ cài đặt liên quan đến giá trị cho 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
}
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 sự kiện chuyển đổi cho hành động chuyển đổi này được gửi kèm theo mã đơn vị tiền tệ không hợp lệ 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.
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 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 chỉ đị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ả chuyển đổi cho mỗi nhấp chuột.

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)
}
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ể trên nhiều lượt tương tác trước đó có thể xảy ra.

Enum
UNSPECIFIED Chưa chỉ đị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 Phân bổ toàn bộ giá trị đóng góp để đạt được một lượt chuyển đổi cho lượt nhấp cuối cùng của lượt chuyển đổi đó.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Phân bổ toàn bộ giá trị đóng góp để đạt được 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ổ đều giá trị đóng góp cho một lượt chuyển đổi cho tất cả lượt nhấp vào lượt chuyển đổi đó bằ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ổ của 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ừ 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. Chiến dịch này sử dụng mô hình phân bổ trên 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 chỉ đị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 Hiện đã có 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. Tệp này vẫn đang được sử dụng nhưng sẽ hết hạn nếu không được cập nhật trong 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 chưa 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 bất kỳ khoảng thời gian 30 ngày nào.

FirebaseSettings

Chế độ cài đặt liên quan đến 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
}
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
}
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 một 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 trong Google Analytics 4.

Biểu diễn dưới dạng JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
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 GA 4.
propertyId

string (int64 format)

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