Campaign

Chiến dịch.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của chiến dịch. Tên tài nguyên chiến dịch có dạng:

customers/{customerId}/campaigns/{campaignId}

primaryStatus

enum (CampaignPrimaryStatus)

Chỉ có đầu ra. Trạng thái chính của chiến dịch.

Cung cấp thông tin chi tiết về lý do khiến chiến dịch không phân phát hoặc không phân phát một cách tối ưu. Nội dung sửa đổi đối với chiến dịch và các mục có liên quan của chiến dịch có thể mất một chút thời gian mới được thể hiện trong trạng thái này.

primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

Chỉ có đầu ra. Nguyên nhân của trạng thái chính của chiến dịch.

Cung cấp thông tin chi tiết về lý do khiến chiến dịch không phân phát hoặc không phân phát một cách tối ưu. Những lý do này được tổng hợp để xác định CampaignPrimaryStatus tổng thể.

status

enum (CampaignStatus)

Trạng thái của chiến dịch.

Khi thêm một chiến dịch mới, trạng thái mặc định là BẬT.

servingStatus

enum (CampaignServingStatus)

Chỉ có đầu ra. Trạng thái phân phát quảng cáo của chiến dịch.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Chỉ có đầu ra. Trạng thái hệ thống của chiến lược đặt giá thầu của chiến dịch.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Trạng thái tối ưu hoá việc phân phát quảng cáo của chiến dịch.

advertisingChannelType

enum (AdvertisingChannelType)

Không thể thay đổi. Mục tiêu phân phát chính cho các quảng cáo trong chiến dịch. Bạn có thể tinh chỉnh các lựa chọn nhắm mục tiêu trong networkSettings.

Đây là trường bắt buộc và không được để trống khi tạo chiến dịch mới.

Chỉ có thể thiết lập khi tạo chiến dịch. Sau khi tạo chiến dịch, bạn không thể thay đổi trường này.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

Không thể thay đổi. Tinh chỉnh (không bắt buộc) đối với advertisingChannelType. Phải là loại phụ hợp lệ của loại kênh chính.

Chỉ có thể thiết lập khi tạo chiến dịch. Sau khi tạo chiến dịch, bạn không thể thay đổi trường này.

urlCustomParameters[]

object (CustomParameter)

Danh sách mối liên kết dùng để thay thế các thẻ thông số tuỳ chỉnh trong trackingUrlTemplate, finalUrls hoặc mobile_final_urls.

localServicesCampaignSettings

object (LocalServicesCampaignSettings)

Các chế độ cài đặt liên quan đến Chiến dịch dịch vụ địa phương.

travelCampaignSettings

object (TravelCampaignSettings)

Chế độ cài đặt cho chiến dịch Du lịch.

demandGenCampaignSettings

object (DemandGenCampaignSettings)

Chế độ cài đặt cho chiến dịch Tạo nhu cầu.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Cài đặt cho Đặt giá thầu theo thời gian thực, tính năng chỉ có sẵn cho các chiến dịch nhắm mục tiêu mạng Ad Exchange.

networkSettings

object (NetworkSettings)

Chế độ cài đặt mạng cho chiến dịch.

hotelSetting

object (HotelSettingInfo)

Không thể thay đổi. Chế độ cài đặt của khách sạn cho chiến dịch.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Chế độ cài đặt để kiểm soát Quảng cáo tìm kiếm động (DSA).

shoppingSetting

object (ShoppingSetting)

Chế độ cài đặt để kiểm soát chiến dịch Mua sắm.

targetingSetting

object (TargetingSetting)

Chế độ cài đặt cho các tính năng liên quan đến tiêu chí nhắm mục tiêu.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Chế độ cài đặt cho tiêu chí nhắm mục tiêu theo địa lý của quảng cáo.

localCampaignSetting

object (LocalCampaignSetting)

Chế độ cài đặt cho chiến dịch địa phương.

appCampaignSetting

object (AppCampaignSetting)

Chế độ cài đặt liên quan đến Chiến dịch quảng cáo ứng dụng.

labels[]

string

Chỉ có đầu ra. Tên tài nguyên của các nhãn được đính kèm với chiến dịch này.

experimentType

enum (CampaignExperimentType)

Chỉ có đầu ra. Loại chiến dịch: thông thường, nháp hoặc thử nghiệm.

biddingStrategyType

enum (BiddingStrategyType)

Chỉ có đầu ra. Loại chiến lược đặt giá thầu.

Bạn có thể tạo chiến lược đặt giá thầu bằng cách thiết lập lược đồ đặt giá thầu để tạo chiến lược đặt giá thầu chuẩn hoặc trường biddingStrategy để tạo chiến lược giá thầu danh mục đầu tư.

Trường này ở chế độ chỉ đọc.

accessibleBiddingStrategy

string

Chỉ có đầu ra. Tên tài nguyên của AccessibleBidStrategy, chế độ xem chỉ có thể đọc gồm các thuộc tính không bị hạn chế của chiến lược đặt giá thầu danh mục đầu tư đính kèm được xác định bằng "biddingStrategy". Để trống, nếu chiến dịch không sử dụng chiến lược danh mục đầu tư. Tất cả khách hàng được chia sẻ chiến lược này đều có thể sử dụng các thuộc tính chiến lược không bị hạn chế cũng như được đọc trong tài nguyên AccessibleBidStrategy. Ngược lại, các thuộc tính bị hạn chế chỉ được cung cấp cho khách hàng là chủ sở hữu của chiến lược và người quản lý của chiến lược đó. Bạn chỉ có thể đọc các thuộc tính bị hạn chế trong tài nguyên BiddingStrategy.

frequencyCaps[]

object (FrequencyCapEntry)

Danh sách giới hạn tần suất mỗi người dùng sẽ thấy quảng cáo của chiến dịch này.

videoBrandSafetySuitability

enum (BrandSafetySuitability)

Chế độ cài đặt Sự an toàn cho thương hiệu ở cấp chiến dịch riêng lẻ. Cho phép bạn chọn loại khoảng không quảng cáo để hiển thị quảng cáo trên nội dung phù hợp với thương hiệu của bạn. Hãy xem https://support.google.com/google-ads/answer/7515513.

vanityPharma

object (VanityPharma)

Mô tả cách quảng cáo hiệu thuốc không có thương hiệu sẽ hiển thị.

selectiveOptimization

object (SelectiveOptimization)

Chế độ cài đặt tối ưu hoá có chọn lọc cho chiến dịch này, bao gồm một nhóm hành động chuyển đổi để tối ưu hoá chiến dịch này. Tính năng này chỉ áp dụng cho những chiến dịch ứng dụng sử dụng MULTI_CHANNEL làm AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT làm AdvertisingChannelSubType.

optimizationGoalSetting

object (OptimizationGoalSetting)

Chế độ cài đặt mục tiêu tối ưu hoá cho chiến dịch này, bao gồm một nhóm các loại mục tiêu tối ưu hoá.

trackingSetting

object (TrackingSetting)

Chỉ có đầu ra. Chế độ cài đặt cấp chiến dịch cho thông tin theo dõi.

paymentMode

enum (PaymentMode)

Phương thức thanh toán cho chiến dịch.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Các loại trường thành phần sẽ bị loại trừ khỏi chiến dịch này. Chiến dịch này sẽ không kế thừa những đường liên kết tài sản có các loại trường này ở cấp cao hơn.

excludedParentAssetSetTypes[]

enum (AssetSetType)

Các loại nhóm thành phần cần loại trừ khỏi chiến dịch này. Những đường liên kết đến nhóm thành phần thuộc các loại này sẽ không được chiến dịch này kế thừa từ cấp cao hơn. Loại nhóm vị trí (GMB_dynamic_LOCATION_GROUP, CHAIN_dynamic_LOCATION_GROUP và StatIC_LOCATION_GROUP) là các loại con của LOCATION_SYNC. Do đó, nếu bạn đặt LOCATION_SYNC cho trường này, thì tất cả các nhóm thành phần nhóm vị trí sẽ không được phép liên kết với chiến dịch này, và tất cả Phần mở rộng về địa điểm (LE) và Phần mở rộng về địa điểm của đơn vị liên kết (ALE) sẽ không được phân phát trong chiến dịch này. Hiện chỉ hỗ trợ LOCATION_SYNC.

performanceMaxUpgrade

object (PerformanceMaxUpgrade)

Chỉ có đầu ra. Thông tin về những chiến dịch được nâng cấp lên chiến dịch Tối đa hoá hiệu suất.

assetAutomationSettings[]

object (AssetAutomationSetting)

Chứa trạng thái chọn sử dụng/không sử dụng của từng AssetAutomaticType. Xem tài liệu liệt kê từng loại tự động hoá thành phần để biết hành vi chọn tham gia/không tham gia mặc định.

keywordMatchType

enum (CampaignKeywordMatchType)

Kiểu khớp từ khoá của Chiến dịch. Đặt thành MỞ RỘNG để đặt kiểu khớp mở rộng cho tất cả từ khoá trong một chiến dịch.

id

string (int64 format)

Chỉ có đầu ra. Mã của chiến dịch.

name

string

Tên của chiến dịch.

Đây là trường bắt buộc và không được để trống khi tạo chiến dịch mới.

Nó không được chứa bất kỳ ký tự rỗng (điểm mã 0x0), nguồn cấp dữ liệu dòng NL (điểm mã 0xA) hoặc ký tự trả lại vị trí đầu dòng (điểm mã 0xD).

trackingUrlTemplate

string

Mẫu URL để tạo URL theo dõi.

audienceSetting

object (AudienceSetting)

Không thể thay đổi. Chế độ cài đặt cho các tính năng liên quan đến đối tượng.

baseCampaign

string

Chỉ có đầu ra. Tên tài nguyên của chiến dịch căn bản của chiến dịch dự thảo hoặc thử nghiệm. Đối với chiến dịch cơ sở, giá trị này bằng resourceName.

Trường này ở chế độ chỉ đọc.

campaignBudget

string

Ngân sách của chiến dịch.

startDate

string

Ngày chiến dịch bắt đầu phân phát theo múi giờ của khách hàng theo định dạng YYYY-MM-DD.

campaignGroup

string

Nhóm chiến dịch chứa chiến dịch này.

endDate

string

Ngày cuối cùng của chiến dịch phân phát theo múi giờ của khách hàng theo định dạng YYYY-MM-DD. Khi tạo, giá trị mặc định là 2037-12-30, nghĩa là chiến dịch sẽ chạy vô thời hạn. Để đặt một chiến dịch hiện tại chạy vô thời hạn, hãy đặt trường này thành 2037-12-30.

finalUrlSuffix

string

Hậu tố dùng để thêm các tham số truy vấn vào trang đích được phân phát thông qua tính năng theo dõi song song.

optimizationScore

number

Chỉ có đầu ra. Điểm tối ưu hoá của chiến dịch.

Điểm tối ưu hoá là điểm số ước tính về mức độ hiệu quả của chiến dịch được thiết lập để hoạt động. Giá trị này dao động từ 0% (0) đến 100% (1), trong đó 100% cho biết chiến dịch đang hoạt động hết tiềm năng. Trường này rỗng đối với các chiến dịch không được tính điểm.

Hãy xem bài viết "Giới thiệu về điểm tối ưu hoá" tại https://support.google.com/google-ads/answer/9061546.

Trường này ở chế độ chỉ đọc.

urlExpansionOptOut

boolean

Thể hiện việc chọn không sử dụng tính năng mở rộng URL cho các URL được nhắm mục tiêu khác. Nếu chọn không sử dụng (true), thì chỉ các URL cuối cùng trong nhóm thành phần hoặc các URL được chỉ định trong Google Merchant Center hoặc nguồn cấp dữ liệu doanh nghiệp của nhà quảng cáo mới được nhắm mục tiêu. Nếu chọn sử dụng (false), toàn bộ miền sẽ được nhắm mục tiêu. Bạn chỉ có thể đặt trường này cho những chiến dịch Tối đa hoá hiệu suất có giá trị mặc định là false.

hotelPropertyAssetSet

string

Không thể thay đổi. Nhóm cơ sở lưu trú khách sạn cho chiến dịch Tối đa hoá hiệu suất cho mục tiêu về du lịch.

listingType

enum (ListingType)

Không thể thay đổi. Loại trang thông tin đã phân phát quảng cáo cho chiến dịch này. Trường này bị hạn chế sử dụng cho chiến dịch Tối đa hoá hiệu suất.

Trường kết hợp campaign_bidding_strategy. Chiến lược đặt giá thầu cho chiến dịch.

Phải là danh mục đầu tư (được tạo thông qua dịch vụ Đặt giá thầu) hoặc danh mục chuẩn được nhúng vào chiến dịch. campaign_bidding_strategy chỉ có thể là một trong những trạng thái sau đây:

biddingStrategy

string

Chiến lược giá thầu danh mục đầu tư mà chiến dịch sử dụng.

commission

object (Commission)

Phí hoa hồng là một chiến lược đặt giá thầu tự động, trong đó nhà quảng cáo trả một phần nhất định của giá trị lượt chuyển đổi.

manualCpa

object (ManualCpa)

Chiến lược đặt giá thầu CPA thủ công chuẩn. Chiến lược đặt giá thầu thủ công cho phép nhà quảng cáo đặt giá thầu cho mỗi hành động do nhà quảng cáo chỉ định. Chỉ được hỗ trợ cho chiến dịch Dịch vụ địa phương.

manualCpc

object (ManualCpc)

Chiến lược đặt giá thầu CPC thủ công chuẩn. Đặt giá thầu dựa trên lượt nhấp thủ công, trong đó người dùng trả tiền cho mỗi lượt nhấp.

manualCpm

object (ManualCpm)

Chiến lược đặt giá thầu CPM thủ công chuẩn. Đặt giá thầu dựa trên lượt hiển thị thủ công, trong đó người dùng trả tiền cho mỗi nghìn lượt hiển thị.

manualCpv

object (ManualCpv)

Chiến lược đặt giá thầu trả số tiền có thể định cấu hình cho mỗi lượt xem video.

maximizeConversions

object (MaximizeConversions)

Chiến lược đặt giá thầu Tối đa hoá lượt chuyển đổi chuẩn tự động tối đa hoá số lượt chuyển đổi trong khi chi tiêu ngân sách của bạn.

maximizeConversionValue

object (MaximizeConversionValue)

Chiến lược đặt giá thầu Tối đa hoá giá trị lượt chuyển đổi chuẩn. Chiến lược này sẽ tự động đặt giá thầu để tối đa hoá doanh thu trong khi chi tiêu ngân sách của bạn.

targetCpa

object (TargetCpa)

Chiến lược đặt giá thầu CPA mục tiêu chuẩn sẽ tự động đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể với mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.

targetImpressionShare

object (TargetImpressionShare)

Chiến lược đặt giá thầu Tỷ lệ hiển thị mục tiêu. Một chiến lược đặt giá thầu tự động giúp đặt giá thầu để đạt được tỷ lệ phần trăm lượt hiển thị đã chọn.

targetRoas

object (TargetRoas)

Chiến lược đặt giá thầu ROAS mục tiêu chuẩn giúp tự động tối đa hoá doanh thu trong khi vẫn đạt được một mức lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

targetSpend

object (TargetSpend)

Chiến lược đặt giá thầu Chi tiêu mục tiêu chuẩn sẽ tự động đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách.

percentCpc

object (PercentCpc)

Chiến lược đặt giá thầu Phần trăm Cpc chuẩn, trong đó giá thầu bằng một phần giá quảng cáo cho một số hàng hóa hoặc dịch vụ.

targetCpm

object (TargetCpm)

Chiến lược đặt giá thầu tự động tối ưu hoá chi phí mỗi nghìn lượt hiển thị.

CampaignPrimaryStatus

Enum mô tả trạng thái chính có thể có của chiến dịch. Cung cấp thông tin chi tiết về lý do khiến chiến dịch không phân phát hoặc không phân phát một cách tối ưu. Nội dung sửa đổi đối với chiến dịch và các mục có liên quan của chiến dịch có thể mất một chút thời gian mới được thể hiện trong trạng thái này.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ELIGIBLE Chiến dịch đủ điều kiện để phân phát.
PAUSED Trạng thái chiến dịch do người dùng chỉ định là tạm dừng.
REMOVED Trạng thái chiến dịch theo người dùng chỉ định sẽ bị xoá.
ENDED Thời gian kết thúc do người dùng chỉ định để chiến dịch này đã trôi qua.
PENDING Chiến dịch có thể phân phát trong tương lai.
MISCONFIGURED Chiến dịch hoặc các thực thể liên quan của chiến dịch có chế độ cài đặt do người dùng chỉ định không chính xác.
LIMITED Chiến dịch hoặc các thực thể liên quan của chiến dịch bị giới hạn bởi các chế độ cài đặt do người dùng chỉ định.
LEARNING Hệ thống đặt giá thầu tự động sẽ điều chỉnh theo các thay đổi do người dùng chỉ định đối với chiến dịch hoặc các thực thể được liên kết.
NOT_ELIGIBLE Chiến dịch không đủ điều kiện để phân phát.

CampaignPrimaryStatusReason

Enum mô tả lý do có thể dẫn đến trạng thái chính của chiến dịch. Cung cấp thông tin chi tiết về lý do khiến chiến dịch không phân phát hoặc không phân phát một cách tối ưu. Những lý do này được tổng hợp để xác định trạng thái chính tổng thể của chiến dịch.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
CAMPAIGN_REMOVED Trạng thái chiến dịch theo người dùng chỉ định sẽ bị xoá.
CAMPAIGN_PAUSED Trạng thái chiến dịch do người dùng chỉ định là tạm dừng.
CAMPAIGN_PENDING Thời gian do người dùng chỉ định để bắt đầu chiến dịch này là trong tương lai.
CAMPAIGN_ENDED Thời gian kết thúc do người dùng chỉ định để chiến dịch này đã trôi qua.
CAMPAIGN_DRAFT Chiến dịch này là một bản nháp.
BIDDING_STRATEGY_MISCONFIGURED Chiến lược đặt giá thầu có chế độ cài đặt do người dùng chỉ định không chính xác.
BIDDING_STRATEGY_LIMITED Chiến lược đặt giá thầu bị giới hạn bởi các chế độ cài đặt do người dùng chỉ định, chẳng hạn như thiếu dữ liệu hoặc tương tự.
BIDDING_STRATEGY_LEARNING Hệ thống đặt giá thầu tự động đang điều chỉnh theo các thay đổi do người dùng chỉ định đối với chiến lược đặt giá thầu.
BIDDING_STRATEGY_CONSTRAINED Chiến dịch có thể thu được nhiều giá trị lượt chuyển đổi hơn bằng cách điều chỉnh mục tiêu CPA/ROAS.
BUDGET_CONSTRAINED Ngân sách hạn chế khả năng phân phát của chiến dịch.
BUDGET_MISCONFIGURED Ngân sách có chế độ cài đặt do người dùng chỉ định không chính xác.
SEARCH_VOLUME_LIMITED Chiến dịch hiện không nhắm đến tất cả các cụm từ tìm kiếm có liên quan.
AD_GROUPS_PAUSED Tất cả các trạng thái của nhóm quảng cáo do người dùng chỉ định đều bị tạm dừng.
NO_AD_GROUPS Không có nhóm quảng cáo đủ điều kiện nào trong chiến dịch này.
KEYWORDS_PAUSED Tất cả các trạng thái từ khoá do người dùng chỉ định đều bị tạm dừng.
NO_KEYWORDS Không có từ khoá đủ điều kiện nào trong chiến dịch này.
AD_GROUP_ADS_PAUSED Tất cả các trạng thái quảng cáo trong nhóm quảng cáo do người dùng chỉ định đều bị tạm dừng.
NO_AD_GROUP_ADS Không có quảng cáo đủ điều kiện nào trong nhóm quảng cáo trong chiến dịch này.
HAS_ADS_LIMITED_BY_POLICY Có ít nhất một quảng cáo trong chiến dịch này bị giới hạn theo chính sách.
HAS_ADS_DISAPPROVED Ít nhất một quảng cáo trong chiến dịch này bị từ chối.
MOST_ADS_UNDER_REVIEW Hầu hết quảng cáo trong chiến dịch này đang chờ xem xét.
MISSING_LEAD_FORM_EXTENSION Chiến dịch này có một mục tiêu về biểu mẫu khách hàng tiềm năng và thiếu phần mở rộng về biểu mẫu khách hàng tiềm năng.
MISSING_CALL_EXTENSION Chiến dịch này có một mục tiêu về cuộc gọi và bị thiếu phần mở rộng về cuộc gọi.
LEAD_FORM_EXTENSION_UNDER_REVIEW Phần mở rộng về biểu mẫu khách hàng tiềm năng đang được xem xét.
LEAD_FORM_EXTENSION_DISAPPROVED Phần mở rộng về khách hàng tiềm năng đã bị từ chối.
CALL_EXTENSION_UNDER_REVIEW Phần mở rộng về cuộc gọi đang được xem xét.
CALL_EXTENSION_DISAPPROVED Phần mở rộng về cuộc gọi bị từ chối.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA Không có tiêu chí nhóm quảng cáo ứng dụng di động đủ điều kiện nào trong chiến dịch này.
CAMPAIGN_GROUP_PAUSED Trạng thái của nhóm chiến dịch do người dùng chỉ định là tạm dừng.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED Đã qua thời gian do người dùng chỉ định của tất cả ngân sách nhóm được liên kết với nhóm chiến dịch gốc.
APP_NOT_RELEASED Ứng dụng được liên kết với chiến dịch ACi này không được phát hành ở các quốc gia mục tiêu của chiến dịch này.
APP_PARTIALLY_RELEASED Ứng dụng liên kết với chiến dịch ACi này được phát hành một phần ở các quốc gia mục tiêu trong chiến dịch này.
HAS_ASSET_GROUPS_DISAPPROVED Có ít nhất 1 nhóm thành phần trong chiến dịch này bị từ chối.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY Có ít nhất một nhóm thành phần trong chiến dịch này bị giới hạn theo chính sách.
MOST_ASSET_GROUPS_UNDER_REVIEW Hầu hết các nhóm thành phần trong chiến dịch này đang chờ xem xét.
NO_ASSET_GROUPS Không có nhóm thành phần đủ điều kiện nào trong chiến dịch này.
ASSET_GROUPS_PAUSED Tất cả các nhóm thành phần trong chiến dịch này đều đang tạm dừng.

CampaignStatus

Các trạng thái có thể có của chiến dịch.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ENABLED Chiến dịch đang hoạt động và có thể hiển thị quảng cáo.
PAUSED Chiến dịch đã bị người dùng tạm dừng.
REMOVED Chiến dịch đã bị xóa.

CampaignServingStatus

Các trạng thái phân phát có thể có của chiến dịch.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN

Không xác định được giá trị đã nhận trong phiên bản này.

Đây là giá trị chỉ phản hồi.

SERVING Đang phân phát.
NONE Không nội dung nào.
ENDED Đã kết thúc.
PENDING Pending.
SUSPENDED Đã tạm ngưng.

BiddingStrategySystemStatus

Các trạng thái hệ thống có thể có của chiến lược Đặt giá thầu.

Enum
UNSPECIFIED Tín hiệu cho thấy đã xảy ra lỗi ngoài dự kiến, ví dụ: không tìm thấy loại chiến lược đặt giá thầu hoặc không tìm thấy thông tin về trạng thái.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ENABLED Chiến lược giá thầu đang hoạt động và AdWords không thể tìm thấy bất kỳ vấn đề cụ thể nào với chiến lược.
LEARNING_NEW Chiến lược giá thầu đang được học vì chiến lược này mới được tạo hoặc kích hoạt lại gần đây.
LEARNING_SETTING_CHANGE Chiến lược giá thầu đang học do có sự thay đổi gần đây đối với chế độ cài đặt.
LEARNING_BUDGET_CHANGE Chiến lược giá thầu đang học do có sự thay đổi về ngân sách gần đây.
LEARNING_COMPOSITION_CHANGE Chiến lược giá thầu đang học do thay đổi gần đây về số lượng chiến dịch, nhóm quảng cáo hoặc từ khoá đi kèm với chiến lược đó.
LEARNING_CONVERSION_TYPE_CHANGE Chiến lược giá thầu phụ thuộc vào báo cáo lượt chuyển đổi và những loại chuyển đổi đã sửa đổi gần đây của khách hàng có liên quan đến chiến lược giá thầu.
LEARNING_CONVERSION_SETTING_CHANGE Chiến lược giá thầu phụ thuộc vào báo cáo lượt chuyển đổi và gần đây khách hàng đã thay đổi chế độ cài đặt lượt chuyển đổi.
LIMITED_BY_CPC_BID_CEILING Chiến lược giá thầu bị giới hạn bởi mức trần giá thầu.
LIMITED_BY_CPC_BID_FLOOR Chiến lược giá thầu bị giới hạn bởi giá thầu sàn.
LIMITED_BY_DATA Chiến lược giá thầu bị giới hạn vì không có đủ lưu lượng truy cập chuyển đổi trong những tuần qua.
LIMITED_BY_BUDGET Một phần đáng kể từ khoá trong chiến lược giá thầu này bị giới hạn theo ngân sách.
LIMITED_BY_LOW_PRIORITY_SPEND Chiến lược giá thầu không thể đạt được mức chi tiêu mục tiêu vì mức chi tiêu của chiến lược đó đã bị giảm mức độ ưu tiên.
LIMITED_BY_LOW_QUALITY Một phần đáng kể các từ khóa trong chiến lược giá thầu này có Điểm chất lượng thấp.
LIMITED_BY_INVENTORY Chiến lược giá thầu không thể chi tiêu hết ngân sách do phạm vi nhắm mục tiêu hẹp.
MISCONFIGURED_ZERO_ELIGIBILITY Thiếu tính năng theo dõi lượt chuyển đổi (không có ping) và/hoặc danh sách tái tiếp thị cho Chiến dịch mua sắm thông minh (SSC).
MISCONFIGURED_CONVERSION_TYPES Chiến lược giá thầu phụ thuộc vào báo cáo lượt chuyển đổi và khách hàng thiếu loại chuyển đổi có thể được báo cáo theo chiến lược này.
MISCONFIGURED_CONVERSION_SETTINGS Chiến lược giá thầu phụ thuộc vào báo cáo lượt chuyển đổi và chế độ cài đặt lượt chuyển đổi của khách hàng bị định cấu hình sai.
MISCONFIGURED_SHARED_BUDGET Có các chiến dịch nằm ngoài chiến lược giá thầu chia sẻ ngân sách với các chiến dịch được đưa vào chiến lược này.
MISCONFIGURED_STRATEGY_TYPE Chiến dịch có loại chiến lược không hợp lệ và hiện không phân phát.
PAUSED Chiến lược giá thầu hiện không hoạt động. Không có chiến dịch, nhóm quảng cáo hoặc từ khóa đang hoạt động nào được đính kèm với chiến lược giá thầu. Hoặc không có ngân sách nào đang hoạt động được kết nối với chiến lược giá thầu.
UNAVAILABLE Chiến lược giá thầu này hiện không hỗ trợ tính năng báo cáo trạng thái.
MULTIPLE_LEARNING Có nhiều trạng thái hệ thống LearnING_* cho chiến lược giá thầu này trong khoảng thời gian được đề cập.
MULTIPLE_LIMITED Có nhiều trạng thái hệ thống LIMITED_* cho chiến lược giá thầu này trong thời gian được đề cập.
MULTIPLE_MISCONFIGURED Có nhiều trạng thái hệ thống MISCONFIGURED_* cho chiến lược giá thầu này trong thời gian được đề cập.
MULTIPLE Có nhiều trạng thái hệ thống cho chiến lược giá thầu này trong khoảng thời gian được đề cập.

AdServingOptimizationStatus

Enum mô tả các trạng thái phân phát có thể có.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN

Không xác định được giá trị đã nhận trong phiên bản này.

Đây là giá trị chỉ phản hồi.

OPTIMIZE Hoạt động phân phát quảng cáo được tối ưu hoá dựa trên CTR của chiến dịch.
CONVERSION_OPTIMIZE Hoạt động phân phát quảng cáo được tối ưu hoá dựa trên CTR * Lượt chuyển đổi cho chiến dịch. Nếu chiến dịch không nằm trong chiến lược đặt giá thầu của trình tối ưu hóa chuyển đổi, thì chiến dịch sẽ mặc định là TỐI ƯU HOÁ.
ROTATE Quảng cáo được xoay vòng đồng đều trong 90 ngày, sau đó được tối ưu hoá cho lượt nhấp.
ROTATE_INDEFINITELY Hiển thị quảng cáo có hiệu suất thấp hơn đồng đều hơn với các quảng cáo có hiệu suất cao hơn và không tối ưu hoá.
UNAVAILABLE Trạng thái tối ưu hóa phân phát quảng cáo không có sẵn.

LocalServicesCampaignSettings

Chế độ cài đặt cho tài nguyên phụ LocalServicesCampaign.

Biểu diễn dưới dạng JSON
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
Trường
categoryBids[]

object (CategoryBid)

Giá thầu cấp phân loại được kết hợp với chiến lược đặt giá thầu MANUAL_CPA.

CategoryBid

Giá thầu theo danh mục trong LocalServicesReportingCampaignSettings.

Biểu diễn dưới dạng JSON
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
Trường
categoryId

string

Danh mục mà giá thầu sẽ được liên kết. Ví dụ: xcat:service_area_business_ Gemini.

manualCpaBidMicros

string (int64 format)

Giá thầu CPA thủ công cho danh mục. Giá thầu phải lớn hơn giá khởi điểm được liên kết cho danh mục đó. Giá trị được tính bằng phần triệu và theo đơn vị tiền tệ của nhà quảng cáo.

TravelCampaignSettings

Chế độ cài đặt cho chiến dịch Du lịch.

Biểu diễn dưới dạng JSON
{
  "travelAccountId": string
}
Trường
travelAccountId

string (int64 format)

Không thể thay đổi. Mã tài khoản Du lịch được liên kết với chiến dịch Du lịch.

DemandGenCampaignSettings

Chế độ cài đặt cho chiến dịch Tạo nhu cầu.

Biểu diễn dưới dạng JSON
{
  "upgradedTargeting": boolean
}
Trường
upgradedTargeting

boolean

Không thể thay đổi. Chỉ định xem chiến dịch này có sử dụng tùy chọn nhắm mục tiêu được nâng cấp hay không. Khi đặt trường này thành true, bạn có thể sử dụng tiêu chí nhắm mục tiêu theo vị trí và ngôn ngữ ở cấp nhóm quảng cáo thay vì tiêu chí nhắm mục tiêu cấp chiến dịch chuẩn. Trường này được đặt mặc định là false và bạn chỉ có thể thiết lập trường này khi tạo chiến dịch.

RealTimeBiddingSetting

Cài đặt cho Đặt giá thầu theo thời gian thực, tính năng chỉ có sẵn cho các chiến dịch nhắm mục tiêu mạng Ad Exchange.

Biểu diễn dưới dạng JSON
{
  "optIn": boolean
}
Trường
optIn

boolean

Liệu chiến dịch có được chọn sử dụng tính năng đặt giá thầu theo thời gian thực hay không.

NetworkSettings

Chế độ cài đặt mạng cho chiến dịch.

Biểu diễn dưới dạng JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
Trường
targetSearchNetwork

boolean

Liệu quảng cáo có được phân phát trên các trang web đối tác trong Mạng Tìm kiếm của Google hay không (yêu cầu targetGoogleSearch cũng phải là true).

targetContentNetwork

boolean

Liệu quảng cáo có được phân phát trên các vị trí cụ thể trong Mạng Hiển thị của Google hay không. Vị trí được chỉ định bằng tiêu chí Vị trí.

targetPartnerSearchNetwork

boolean

Quảng cáo có được phân phát trên Mạng đối tác của Google hay không. Tính năng này chỉ dành cho một số tài khoản đối tác của Google được chọn.

targetYoutube

boolean

Liệu quảng cáo có được phân phát trên YouTube hay không.

targetGoogleTvNetwork

boolean

Quảng cáo có được phân phát trên mạng Google TV hay không.

HotelSettingInfo

Chế độ cài đặt cấp chiến dịch cho quảng cáo khách sạn.

Biểu diễn dưới dạng JSON
{
  "hotelCenterId": string
}
Trường
hotelCenterId

string (int64 format)

Không thể thay đổi. Tài khoản Hotel Center được liên kết.

DynamicSearchAdsSetting

Chế độ cài đặt để kiểm soát Quảng cáo tìm kiếm động (DSA).

Biểu diễn dưới dạng JSON
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
Trường
domainName

string

Bắt buộc. Tên miền Internet mà chế độ cài đặt này đại diện, ví dụ: "google.com" hoặc "www.google.com".

languageCode

string

Bắt buộc. Mã ngôn ngữ chỉ định ngôn ngữ của miền, ví dụ: "en".

feeds[]

string

Danh sách nguồn cấp dữ liệu trang được liên kết với chiến dịch.

useSuppliedUrlsOnly

boolean

Chiến dịch có sử dụng URL độc quyền do nhà quảng cáo cung cấp hay không.

ShoppingSetting

Chế độ cài đặt cho chiến dịch Mua sắm. Xác định nhiều loại sản phẩm mà chiến dịch có thể quảng cáo và cách chiến dịch này tương tác với các chiến dịch Mua sắm khác.

Biểu diễn dưới dạng JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
Trường
feedLabel

string

Nhãn nguồn cấp dữ liệu của sản phẩm cần thêm vào chiến dịch. Bạn chỉ có thể đặt một trong hai giá trị feedLabel hoặc salesCountry. Nếu được dùng thay cho salesCountry, thì trường feedLabel sẽ chấp nhận mã quốc gia ở cùng định dạng, ví dụ như "XX". Nếu không, có thể là bất kỳ chuỗi nào dùng cho nhãn nguồn cấp dữ liệu trong Google Merchant Center.

useVehicleInventory

boolean

Không thể thay đổi. Liệu có nhắm đến khoảng không quảng cáo của Trang thông tin xe hay không. Trường này chỉ được hỗ trợ trong chiến dịch Mua sắm thông minh. Để thiết lập khoảng không quảng cáo của Trang thông tin xe trong chiến dịch Tối đa hoá hiệu suất, hãy sử dụng listingType.

advertisingPartnerIds[]

string (int64 format)

Không thể thay đổi. Mã tài khoản Google Ads của các đối tác quảng cáo hợp tác trong chiến dịch.

merchantId

string (int64 format)

Mã của tài khoản Merchant Center. Đây là trường bắt buộc cho các thao tác tạo. Trường này không thể thay đổi cho chiến dịch Mua sắm.

campaignPriority

integer

Mức độ ưu tiên của chiến dịch. Các chiến dịch có mức độ ưu tiên cao hơn về mặt số lượng sẽ được ưu tiên hơn các chiến dịch có mức độ ưu tiên thấp hơn. Đây là trường bắt buộc đối với chiến dịch Mua sắm, có giá trị từ 0 đến 2. Trường này không bắt buộc đối với chiến dịch Mua sắm thông minh, nhưng nếu bạn đặt trường này thì giá trị phải bằng 3.

enableLocal

boolean

Liệu có thêm sản phẩm tại cửa hàng địa phương hay không.

disableProductFeed

boolean

Tắt nguồn cấp dữ liệu sản phẩm không bắt buộc. Trường này hiện chỉ được hỗ trợ cho chiến dịch Tạo nhu cầu. Hãy xem https://support.google.com/google-ads/answer/13721750 để tìm hiểu thêm về tính năng này.

AudienceSetting

Chế độ cài đặt cho tính năng nhắm mục tiêu theo đối tượng.

Biểu diễn dưới dạng JSON
{
  "useAudienceGrouped": boolean
}
Trường
useAudienceGrouped

boolean

Không thể thay đổi. Nếu đúng, chiến dịch này sẽ sử dụng một tài nguyên Đối tượng để nhắm mục tiêu theo đối tượng. Nếu đặt là false, chiến dịch này có thể sử dụng tiêu chí về phân khúc đối tượng.

GeoTargetTypeSetting

Trình bày tập hợp các chế độ cài đặt liên quan đến việc nhắm mục tiêu theo địa lý của quảng cáo.

Biểu diễn dưới dạng JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Trường
positiveGeoTargetType

enum (PositiveGeoTargetType)

Chế độ cài đặt dùng để nhắm mục tiêu theo địa lý khẳng định trong chiến dịch cụ thể này.

negativeGeoTargetType

enum (NegativeGeoTargetType)

Chế độ cài đặt dùng để nhắm mục tiêu theo địa lý phủ định trong chiến dịch cụ thể này.

PositiveGeoTargetType

Các loại mục tiêu địa lý khẳng định có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
PRESENCE_OR_INTEREST Chỉ định rằng một quảng cáo sẽ được kích hoạt nếu người dùng ở trong hoặc thể hiện sự quan tâm đến những vị trí được nhắm mục tiêu của nhà quảng cáo.
SEARCH_INTEREST Chỉ định rằng một quảng cáo được kích hoạt khi người dùng tìm kiếm vị trí được nhắm mục tiêu của nhà quảng cáo. Bạn chỉ có thể sử dụng tính năng này cho chiến dịch Tìm kiếm và chiến dịch Mua sắm thông thường.
PRESENCE Chỉ định một quảng cáo được kích hoạt nếu người dùng đang ở hoặc thường xuyên ở vị trí mà nhà quảng cáo nhắm mục tiêu.

NegativeGeoTargetType

Các loại mục tiêu địa lý phủ định có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
PRESENCE_OR_INTEREST Chỉ định rằng người dùng bị loại trừ khỏi việc nhìn thấy quảng cáo nếu họ ở trong hoặc thể hiện sự quan tâm đến các vị trí bị loại trừ của nhà quảng cáo.
PRESENCE Chỉ định rằng người dùng sẽ không nhìn thấy quảng cáo nếu họ ở vị trí bị loại trừ của nhà quảng cáo.

LocalCampaignSetting

Chế độ cài đặt chiến dịch cho chiến dịch địa phương.

Biểu diễn dưới dạng JSON
{
  "locationSourceType": enum (LocationSourceType)
}
Trường
locationSourceType

enum (LocationSourceType)

Loại nguồn địa điểm cho chiến dịch địa phương này.

LocationSourceType

Các loại nguồn vị trí có thể có.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
GOOGLE_MY_BUSINESS Các địa điểm được liên kết với Trang doanh nghiệp đã liên kết của khách hàng.
AFFILIATE Vị trí cửa hàng của đơn vị liên kết (chuỗi). Ví dụ: vị trí cửa hàng Best Buy.

AppCampaignSetting

Chế độ cài đặt cấp chiến dịch cho chiến dịch Quảng cáo ứng dụng.

Biểu diễn dưới dạng JSON
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
Trường
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

Thể hiện mục tiêu mà chiến lược đặt giá thầu của chiến dịch quảng cáo ứng dụng này sẽ tối ưu hoá.

appStore

enum (AppCampaignAppStore)

Không thể thay đổi. Cửa hàng ứng dụng phân phối ứng dụng cụ thể này.

appId

string

Không thể thay đổi. Chuỗi xác định duy nhất một ứng dụng dành cho thiết bị di động.

AppCampaignBiddingStrategyGoalType

Loại mục tiêu của Chiến lược đặt giá thầu trong chiến dịch Quảng cáo ứng dụng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST Nhắm đến việc tối đa hoá số lượt cài đặt ứng dụng. Giá thầu cpa là chi phí mục tiêu cho mỗi lượt cài đặt.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST Nhắm đến việc tối đa hoá số lượt chuyển đổi dài hạn trong ứng dụng từ các lượt cài đặt ứng dụng. Giá thầu cpa là chi phí mục tiêu cho mỗi lượt cài đặt.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST Nhắm đến việc tối đa hoá số lượt chuyển đổi dài hạn trong ứng dụng từ các lượt cài đặt ứng dụng. Giá thầu cpa là chi phí mục tiêu cho mỗi lượt chuyển đổi trong ứng dụng. Hãy lưu ý rằng cpa thực tế lúc đầu có vẻ cao hơn cpa mục tiêu, vì lượt chuyển đổi dài hạn chưa xảy ra.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND Cố gắng tối đa hoá giá trị của tất cả lượt chuyển đổi (ví dụ: lượt cài đặt + lượt chuyển đổi trong ứng dụng đã chọn), đồng thời đạt được hoặc vượt mức lợi tức mục tiêu trên chi tiêu quảng cáo.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME Cố gắng tăng tối đa lượt đăng ký trước cho ứng dụng.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST Nhắm đến việc tối đa hoá lượt cài đặt ứng dụng mà không đặt ra chi phí mục tiêu cho mỗi lượt cài đặt.

AppCampaignAppStore

Enum mô tả cửa hàng ứng dụng của chiến dịch quảng cáo ứng dụng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
APPLE_APP_STORE Apple App Store.
GOOGLE_APP_STORE Google Play.

CampaignExperimentType

Cho biết chiến dịch này là chiến dịch thông thường, chiến dịch dự thảo hay chiến dịch thử nghiệm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
BASE Đây là một chiến dịch thông thường.
DRAFT Đây là phiên bản nháp của chiến dịch. Chiến dịch này có một số nội dung sửa đổi từ chiến dịch căn bản, nhưng không phân phát hoặc tích luỹ chỉ số.
EXPERIMENT Đây là phiên bản thử nghiệm của chiến dịch. Nó có một số sửa đổi từ chiến dịch cơ sở và tỷ lệ phần trăm lưu lượng truy cập đang được chuyển từ chiến dịch BASE đến chiến dịch thử nghiệm này.

FrequencyCapEntry

Quy tắc chỉ định số lần tối đa một quảng cáo (hoặc một số nhóm quảng cáo) có thể hiển thị cho người dùng trong một khoảng thời gian cụ thể.

Biểu diễn dưới dạng JSON
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
Trường
key

object (FrequencyCapKey)

Khoá của một giới hạn tần suất cụ thể. Không được có nhiều hơn một giới hạn tần suất có cùng một khoá.

cap

integer

Số sự kiện tối đa được phép trong phạm vi thời gian này theo giới hạn này.

FrequencyCapKey

Một nhóm các trường được dùng làm khoá cho một giới hạn tần suất. Không được có nhiều hơn một giới hạn tần suất có cùng một khoá.

Biểu diễn dưới dạng JSON
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
Trường
level

enum (FrequencyCapLevel)

Cấp mà giới hạn sẽ được áp dụng (ví dụ: quảng cáo của nhóm quảng cáo, nhóm quảng cáo). Giới hạn này được áp dụng cho tất cả các thực thể của cấp này.

eventType

enum (FrequencyCapEventType)

Loại sự kiện mà giới hạn này áp dụng (ví dụ: lượt hiển thị).

timeUnit

enum (FrequencyCapTimeUnit)

Đơn vị thời gian mà giới hạn được xác định (ví dụ: ngày, tuần).

timeLength

integer

Số đơn vị thời gian mà giới hạn kéo dài.

FrequencyCapLevel

Cấp mà giới hạn sẽ được áp dụng (ví dụ: quảng cáo của nhóm quảng cáo, nhóm quảng cáo). Giới hạn được áp dụng cho tất cả tài nguyên của cấp này.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
AD_GROUP_AD Giới hạn này được áp dụng ở cấp nhóm quảng cáo.
AD_GROUP Giới hạn này được áp dụng ở cấp nhóm quảng cáo.
CAMPAIGN Giới hạn này được áp dụng ở cấp chiến dịch.

FrequencyCapEventType

Loại sự kiện mà giới hạn này áp dụng (ví dụ: lượt hiển thị).

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
IMPRESSION Giới hạn này áp dụng cho số lượt hiển thị quảng cáo.
VIDEO_VIEW Giới hạn này áp dụng cho số lượt xem quảng cáo dạng video.

VanityPharma

Mô tả cách quảng cáo hiệu thuốc không có thương hiệu sẽ hiển thị.

Biểu diễn dưới dạng JSON
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
Trường
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

Chế độ hiển thị cho URL hiệu thuốc ảo.

vanityPharmaText

enum (VanityPharmaText)

Văn bản sẽ được hiển thị trong URL hiển thị của quảng cáo văn bản khi nội dung mô tả trang web là chế độ hiển thị được chọn cho URL dược phẩm ảo.

VanityPharmaDisplayUrlMode

Enum mô tả các chế độ hiển thị có thể thực hiện cho URL trang hiệu thuốc ảo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
MANUFACTURER_WEBSITE_URL Thay thế URL hiệu thuốc ảo bằng URL trang web của nhà sản xuất.
WEBSITE_DESCRIPTION Thay thế URL hiệu thuốc ảo bằng nội dung mô tả của trang web.

VanityPharmaText

Enum mô tả văn bản có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
PRESCRIPTION_TREATMENT_WEBSITE_EN Trang web về phương pháp điều trị theo toa có nội dung trang web bằng tiếng Anh.
PRESCRIPTION_TREATMENT_WEBSITE_ES Trang web về phương pháp điều trị theo toa có nội dung trang web bằng tiếng Tây Ban Nha (Sitio de tratamientos con receta).
PRESCRIPTION_DEVICE_WEBSITE_EN Trang web về thiết bị theo toa có nội dung trang web bằng tiếng Anh.
PRESCRIPTION_DEVICE_WEBSITE_ES Trang web về thiết bị theo toa có nội dung trang web bằng tiếng Tây Ban Nha (Sitio de dispositivos con receta).
MEDICAL_DEVICE_WEBSITE_EN Trang web về thiết bị y tế có nội dung trang web bằng tiếng Anh.
MEDICAL_DEVICE_WEBSITE_ES Trang web về thiết bị y tế có nội dung trang web bằng tiếng Tây Ban Nha (Sitio de dispositivos médicos).
PREVENTATIVE_TREATMENT_WEBSITE_EN Trang web về phương pháp điều trị dự phòng có nội dung trang web bằng tiếng Anh.
PREVENTATIVE_TREATMENT_WEBSITE_ES Trang web về phương pháp điều trị dự phòng có nội dung trang web bằng tiếng Tây Ban Nha (Sitio de tratamientos preventivos).
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN Trang web về thuốc tránh thai theo toa có nội dung trang web bằng tiếng Anh.
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES Trang web về thuốc tránh thai theo toa có nội dung của trang web bằng tiếng Tây Ban Nha (Sitio de AntiConceptivos con receta).
PRESCRIPTION_VACCINE_WEBSITE_EN Trang web về vắc-xin theo toa có nội dung trang web bằng tiếng Anh.
PRESCRIPTION_VACCINE_WEBSITE_ES Trang web về vắc-xin theo toa có nội dung trên trang web bằng tiếng Tây Ban Nha (Sitio de vacunas con receta).

SelectiveOptimization

Chế độ cài đặt tối ưu hoá có chọn lọc cho chiến dịch này, bao gồm một nhóm hành động chuyển đổi để tối ưu hoá chiến dịch này. Tính năng này chỉ áp dụng cho những chiến dịch ứng dụng sử dụng MULTI_CHANNEL làm AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT làm AdvertisingChannelSubType.

Biểu diễn dưới dạng JSON
{
  "conversionActions": [
    string
  ]
}
Trường
conversionActions[]

string

Nhóm hành động chuyển đổi đã chọn để tối ưu hoá chiến dịch này.

OptimizationGoalSetting

Chế độ cài đặt mục tiêu tối ưu hoá cho chiến dịch này, bao gồm một nhóm các loại mục tiêu tối ưu hoá.

Biểu diễn dưới dạng JSON
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Trường
optimizationGoalTypes[]

enum (OptimizationGoalType)

Danh sách các loại mục tiêu tối ưu hoá.

OptimizationGoalType

Loại mục tiêu tối ưu hoá

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng làm giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
CALL_CLICKS Tối ưu hóa cho số lần nhấp dẫn đến cuộc gọi. Lượt chuyển đổi từ lượt nhấp dẫn đến cuộc gọi là số lần mọi người đã chọn "Gọi" để liên hệ với cửa hàng sau khi xem quảng cáo.
DRIVING_DIRECTIONS Tối ưu hoá cho chỉ đường lái xe. Lượt chuyển đổi chỉ đường lái xe là thời điểm mọi người chọn "Xem đường đi" để đi đến cửa hàng sau khi xem quảng cáo.
APP_PRE_REGISTRATION Tối ưu hoá cho lượt đăng ký trước. Số lượt chuyển đổi đăng ký trước là số lượt đăng ký trước nhận được thông báo khi ứng dụng được phát hành.

TrackingSetting

Chế độ cài đặt cấp chiến dịch cho thông tin theo dõi.

Biểu diễn dưới dạng JSON
{
  "trackingUrl": string
}
Trường
trackingUrl

string

Chỉ có đầu ra. URL dùng để theo dõi linh động.

PaymentMode

Enum mô tả các phương thức thanh toán có thể sử dụng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
CLICKS Trả tiền cho mỗi lần tương tác.
CONVERSION_VALUE Trả tiền cho mỗi giá trị chuyển đổi. Chế độ này chỉ được hỗ trợ cho những chiến dịch có AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION vàBudgetType.STANDARD.
CONVERSIONS Trả cho mỗi lượt chuyển đổi. Chế độ này chỉ được hỗ trợ bởi các chiến dịch có AdvertisingChannelType.DISPLAY (ngoại trừ AdvertisingChannelSubType.DISPLAY_ Nhập), Khách hàng cũng phải đủ điều kiện sử dụng chế độ này. Hãy truy cập vào Customer.eligibility_failure_reasons để biết thông tin chi tiết.
GUEST_STAY Giá trị thanh toán cho mỗi lượt lưu trú. Chế độ này chỉ được hỗ trợ cho những chiến dịch có AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION vàBudgetType.STANDARD.

PerformanceMaxUpgrade

Thông tin về một chiến dịch đang được nâng cấp lên chiến dịch Tối đa hoá hiệu suất.

Biểu diễn dưới dạng JSON
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
Trường
performanceMaxCampaign

string

Chỉ có đầu ra. Cho biết chiến dịch Tối đa hoá hiệu suất nào được nâng cấp lên.

preUpgradeCampaign

string

Chỉ có đầu ra. Cho biết chiến dịch cũ đã được nâng cấp lên chiến dịch Tối đa hoá hiệu suất.

status

enum (PerformanceMaxUpgradeStatus)

Chỉ có đầu ra. Trạng thái nâng cấp của một chiến dịch đã yêu cầu nâng cấp lên chiến dịch Tối đa hoá hiệu suất.

PerformanceMaxUpgradeStatus

Enum trạng thái Nâng cấp lên chiến dịch Tối đa hoá hiệu suất cho chiến dịch.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
UPGRADE_IN_PROGRESS Đang nâng cấp lên chiến dịch Tối đa hoá hiệu suất.
UPGRADE_COMPLETE Quá trình nâng cấp lên chiến dịch Tối đa hoá hiệu suất đã hoàn tất.
UPGRADE_FAILED Không nâng cấp được lên chiến dịch Tối đa hoá hiệu suất. Chiến dịch sẽ vẫn phân phát như trước khi nâng cấp.
UPGRADE_ELIGIBLE Chiến dịch này đủ điều kiện nâng cấp lên chiến dịch Tối đa hoá hiệu suất.

ListingType

Các loại trang thông tin có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
VEHICLES Chiến dịch này phân phát quảng cáo xe.

AssetAutomationSetting

Chế độ cài đặt tự động hoá thành phần chứa cặp AssetAutomaticType và trạng thái chọn sử dụng/không sử dụng tính năng tự động hoá thành phần

Biểu diễn dưới dạng JSON
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
Trường
assetAutomationType

enum (AssetAutomationType)

Nhà quảng cáo thuộc loại tự động hoá thành phần muốn chọn sử dụng/không sử dụng.

assetAutomationStatus

enum (AssetAutomationStatus)

Trạng thái chọn sử dụng/không sử dụng đối với loại tự động hoá thành phần.

AssetAutomationType

Loại tự động hoá thành phần.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng làm giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
TEXT_ASSET_AUTOMATION Tính năng tự động hoá thành phần văn bản bao gồm dòng tiêu đề và nội dung mô tả. Theo mặc định, các nhà quảng cáo chọn sử dụng chiến dịch Tối đa hoá hiệu suất nhưng không sử dụng Mạng Tìm kiếm.

AssetAutomationStatus

Trạng thái tự động hoá thành phần.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng làm giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
OPTED_IN Khi bạn chọn sử dụng, hệ thống sẽ cho phép tạo và phân phát một loại thành phần tự động hoá.
OPTED_OUT Khi bạn chọn không sử dụng, đối tượng sẽ ngừng tạo và phân phát một loại thành phần tự động hoá.

CampaignKeywordMatchType

Enum mô tả loại so khớp từ khóa của Chiến dịch.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
BROAD Kiểu khớp mở rộng cấp chiến dịch.

Phí hoa hồng

Phí hoa hồng là một chiến lược đặt giá thầu tự động, trong đó nhà quảng cáo trả một phần nhất định của giá trị lượt chuyển đổi.

Biểu diễn dưới dạng JSON
{
  "commissionRateMicros": string
}
Trường
commissionRateMicros

string (int64 format)

Tỷ lệ phí hoa hồng xác định phần giá trị lượt chuyển đổi mà nhà quảng cáo sẽ được lập hóa đơn. Trường này sẽ chuyển tỷ lệ phí hoa hồng x dưới dạng (x * 1.000.000). Ví dụ: 106.000 tức là tỷ lệ hoa hồng là 0, 106 (10,6%).

ManualCpa

Loại này không có trường nào.

Chiến lược đặt giá thầu thủ công cho phép nhà quảng cáo đặt giá thầu cho mỗi hành động do nhà quảng cáo chỉ định.

ManualCpc

Đặt giá thầu dựa trên lượt nhấp thủ công, trong đó người dùng trả tiền cho mỗi lượt nhấp.

Biểu diễn dưới dạng JSON
{
  "enhancedCpcEnabled": boolean
}
Trường
enhancedCpcEnabled

boolean

Liệu giá thầu có được nâng cao dựa trên dữ liệu trình tối ưu hóa chuyển đổi hay không.

ManualCpm

Loại này không có trường nào.

Đặt giá thầu dựa trên lượt hiển thị thủ công, trong đó người dùng trả tiền cho mỗi nghìn lượt hiển thị.

ManualCpv

Loại này không có trường nào.

Chiến lược đặt giá thầu dựa trên lượt xem, trong đó người dùng trả tiền cho mỗi lượt xem video.

PercentCpc

Chiến lược đặt giá thầu trong đó giá thầu bằng một phần giá quảng cáo đối với một số hàng hóa hoặc dịch vụ.

Biểu diễn dưới dạng JSON
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Trường
cpcBidCeilingMicros

string (int64 format)

Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Đây là trường không bắt buộc do nhà quảng cáo nhập vào và được chỉ định trong phần cực nhỏ cục bộ. Lưu ý: Giá trị bằng 0 được diễn giải theo cách tương tự như việc không xác định giá thầu trần.

enhancedCpcEnabled

boolean

Điều chỉnh giá thầu cho mỗi phiên đấu giá tăng hoặc giảm, tuỳ thuộc vào khả năng chuyển đổi. Giá thầu riêng lẻ có thể vượt quá cpcBidCeilingMicros, nhưng số tiền giá thầu trung bình cho một chiến dịch thì không.

TargetCpm

CPM (chi phí mỗi nghìn lượt hiển thị) mục tiêu là một chiến lược đặt giá thầu tự động. Chiến lược này sẽ đặt giá thầu để tối ưu hoá hiệu suất dựa trên CPM mục tiêu mà bạn đặt.

Biểu diễn dưới dạng JSON
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
Trường
Trường kết hợp goal. Thông tin bổ sung liên quan đến mục tiêu đặt giá thầu. goal chỉ có thể là một trong những trạng thái sau đây:
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

Thông tin chi tiết về mục tiêu đặt giá thầu theo Tần suất mục tiêu.

TargetCpmTargetFrequencyGoal

Thông tin chi tiết về mục tiêu đặt giá thầu theo Tần suất mục tiêu.

Biểu diễn dưới dạng JSON
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
Trường
targetCount

string (int64 format)

Số lượng tần suất mục tiêu thể hiện số lần bạn muốn tiếp cận một người dùng.

timeUnit

enum (TargetFrequencyTimeUnit)

Khoảng thời gian thể hiện khoảng thời gian bạn muốn đạt đến targetCount đã chỉ định.