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)
  },
  "discoveryCampaignSettings": {
    object (DiscoveryCampaignSettings)
  },
  "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)
    }
  ],
  "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 một 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 thực thể 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. Những lý do chính khiến chiến dịch có trạng thái.

Cung cấp thông tin chi tiết về lý do khiến một 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 một CampaignPrimaryStatus chung.

status

enum (CampaignStatus)

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

Khi một chiến dịch mới được thêm vào, 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 hóa 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 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.

Bạn chỉ có thể đặt khi đang tạo chiến dịch. Sau khi tạo chiến dịch, bạn không thể thay đổi trường.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

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

Bạn chỉ có thể đặt khi đang 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 các 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)

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.

discoveryCampaignSettings

object (DiscoveryCampaignSettings)

Chế độ cài đặt cho chiến dịch Khám phá.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Cài đặt cho Đặt giá thầu thời gian thực, một 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 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 việc nhắm mục tiêu.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

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

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: bình thường, bản 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 tạo trường biddingStrategy để tạo chiến lược giá thầu danh mục đầu tư.

Trường này chỉ để đọc.

accessibleBiddingStrategy

string

Chỉ có đầu ra. Tên tài nguyên của AccessibleBiddingStrategy, một chế độ xem chỉ có thể đọc về 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ởi "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 đều có thể sử dụng thuộc tính chiến lược không bị hạn chế từ tài nguyên AccessibleBiddingStrategy. Ngược lại, các thuộc tính bị hạn chế chỉ có sẵn cho khách hàng là chủ sở hữu của chiến lược và người quản lý của họ. Bạn chỉ có thể đọc các thuộc tính bị hạn chế từ 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ó đầu ra. Chế độ cài đặt An toàn thương hiệu ở cấp chiến dịch riêng lẻ. Cho phép chọn một loại khoảng không quảng cáo để hiển thị quảng cáo trên những 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 hiển thị quảng cáo hiệu thuốc không có thương hiệu.

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 quảng cáo ứng dụng sử dụng MULTI_CHANNEL dưới dạng AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT dưới dạng 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 cần được loại trừ khỏi chiến dịch này. Chiến dịch này sẽ không kế thừa các đường liên kết đến thành phần có những 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 được 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 đến nhóm thành phần thuộc những loại này ở cấp cao hơn. Loại nhóm vị trí (GMB_Mô hình khách sạn LOCATION_GROUP, CHAIN_dynamic_LOCATION_GROUP và StatIC_LOCATION_GROUP) là các loại nhóm vị trí con của LOCATION_SYNC. Do đó, nếu bạn đặt LOCATION_SYNC cho trường này, thì bạn không được phép liên kết tất cả nhóm thành phần nhóm địa điểm với chiến dịch này, đồng thời 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 tham gia/không tham gia của từng AssetTự động hoá. Xem tài liệu về từng enum loại tự động hoá thành phần để biết hành vi chọn sử dụng/không sử dụng mặc định.

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.

Mã 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 một chiến dịch dự thảo hoặc thử nghiệm. Đối với chiến dịch căn bản, giá trị này bằng resourceName.

Trường này chỉ để đọc.

campaignBudget

string

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

startDate

string

Ngày bắt đầu chiến dịch phân phát theo múi giờ của khách hàng ở đị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 ở định dạng YYYY-MM-DD. Khi tạo, mặc định là 2037-12-30, có nghĩa là chiến dịch sẽ chạy vô thời hạn. Để đặ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 để nối tham số truy vấn vào trang đích được phân phát bằng 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 mức độ hiệu quả của việc thiết lập hoạt động của một chiến dịch. Điểm số này dao động từ 0% (0,0) đến 100% (1,0), với 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 chưa được tính điểm.

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ỉ để đọ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 bạn chọn không sử dụng (true), thì chỉ những URL cuối cùng trong nhóm thành phần hoặc các URL được chỉ định trong Google Merchant Center của nhà quảng cáo hoặc nguồn cấp dữ liệu doanh nghiệp mới được nhắm đến. Nếu bạn 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 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. Tập hợp các cơ sở lưu trú khách sạn cho chiến dịch Tối đa hoá hiệu suất cho các mục tiêu trong ngành du lịch.

listingType

enum (ListingType)

Không thể thay đổi. Loại trang thông tin của quảng cáo được phân phát cho chiến dịch này. Bạn chỉ có thể sử dụng trường này với các chiến dịch Tối đa hoá hiệu suất.

Trường 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ư (tạo thông qua dịch vụ BiddingStrategy) hoặc danh mục đầu tư 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:

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. Tính năng này chỉ được hỗ trợ cho các 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 thông thường. Đặ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 sẽ trả một 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 hóa lượt chuyển đổi chuẩn sẽ tự động tối đa hóa 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 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 tự động đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở 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 theo Tỷ lệ hiển thị mục tiêu. 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 theo lợi tức mục tiêu trên chi tiêu quảng cáo chuẩn, giúp tự động tối đa hóa doanh thu trong khi vẫn tính trung bình 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 tự động đặt giá thầu để giúp bạn nhận được nhiều lần nhấp nhất có thể trong phạm vi ngân sách của mình.

percentCpc

object (PercentCpc)

Chiến lược đặt giá thầu theo Tỷ lệ phần trăm Cpc chuẩn, trong đó giá thầu là một phần của giá quảng cáo cho một số hàng hoá 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 một 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 thực thể 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ề. Đại diện cho 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 bị tạm dừng.
REMOVED Trạng thái chiến dịch do người dùng chỉ định sẽ bị xoá.
ENDED Thời gian do người dùng chỉ định để kết thúc 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ể được liên kết 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 những 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ả các nguyên nhân 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 một 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 của chiến dịch tổng thể.

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.
CAMPAIGN_REMOVED Trạng thái chiến dịch do 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 bị 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à thời gian trong tương lai.
CAMPAIGN_ENDED Thời gian do người dùng chỉ định để kết thúc chiến dịch này đã trôi qua.
CAMPAIGN_DRAFT Chiến dịch là 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 các chế độ cài đặt tương tự.
BIDDING_STRATEGY_LEARNING Hệ thống đặt giá thầu tự động sẽ điều chỉnh theo những 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ị 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 đang 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 một số cụm từ tìm kiếm có liên quan.
AD_GROUPS_PAUSED Tất cả trạng thái 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ả trạng thái từ khóa 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ả trạng thái quảng cáo của 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 nhóm quảng cáo đủ điều kiện nào trong chiến dịch này.
HAS_ADS_LIMITED_BY_POLICY Ít nhất một quảng cáo trong chiến dịch này bị hạn chế do vấn đề về 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 có một mục tiêu về biểu mẫu khách hàng tiềm năng nhưng lại 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 nhưng 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í nào đủ điều kiện cho nhóm quảng cáo ứng dụng dành cho thiết bị di động trong chiến dịch này.
CAMPAIGN_GROUP_PAUSED Trạng thái nhóm chiến dịch do người dùng chỉ định bị 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 liên kết với chiến dịch ACi này chưa được phát hành ở các quốc gia mục tiêu của chiến dịch.
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 của chiến dịch.
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 Ít nhất một nhóm thành phần trong chiến dịch này bị hạn chế do vấn đề về 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 nào đủ điều kiện 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 bị tạm dừng.

CampaignStatus

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ề. Đại diện cho 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 Người dùng đã tạm dừng chiến dịch.
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 Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đâ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 một BiddingStrategy.

Enum
UNSPECIFIED Các 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 trạng thái.
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 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 giá thầu đã được tạo gần đây hoặc gần đây đã được kích hoạt lại.
LEARNING_SETTING_CHANGE Chiến lược giá thầu đang học do có sự thay đổi gần đây về chế độ cài đặt.
LEARNING_BUDGET_CHANGE Chiến lược giá thầu đang học do có sự thay đổi gần đây về ngân sách.
LEARNING_COMPOSITION_CHANGE Chiến lược giá thầu đang học do có sự thay đổi gần đây về số chiến dịch, nhóm quảng cáo hoặc từ khoá đi kèm.
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à khách hàng đã sửa đổi các loại chuyển đổi liên quan đến chiến lược giá thầu trong thời gian gần đây.
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 của mình.
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 bởi 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ể các 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 đến mức chi tiêu mục tiêu bởi 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 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 đang thiếu các loại chuyển đổi có thể được báo cáo cho 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 có 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à không được phân phát.
PAUSED Chiến lược giá thầu 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 đi kèm với chiến lược giá thầu. Hoặc không có ngân sách đang hoạt động nào đượ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ợ báo cáo trạng thái.
MULTIPLE_LEARNING Có nhiều trạng thái hệ thốngLEARNING_* cho chiến lược giá thầu này trong 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 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 Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đâ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 tỷ lệ nhấp (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 ở trong chiến lược đặt giá thầu bằng trình tối ưu hóa chuyển đổi, 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 hoạt động tốt hơn và không tối ưu hóa.
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 tuyệt đối được liên kết với chiến lược đặt giá thầu MANUAL_CPA.

CategoryBid

Giá thầu 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ới. Ví dụ: xcat:service_area_business_link.

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 theo micrô và đơ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.

DiscoveryCampaignSettings

Chế độ cài đặt cho chiến dịch Khám phá.

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 tính năng nhắm mục tiêu theo vị trí và ngôn ngữ ở cấp nhóm quảng cáo khác với 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ể đặt trường này khi tạo chiến dịch.

RealTimeBiddingSetting

Cài đặt cho Đặt giá thầu thời gian thực, một 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

Chiến dịch có 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 ở các vị trí được chỉ định 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

Liệu 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.

targetYoutube

boolean

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

targetGoogleTvNetwork

boolean

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

HotelSettingInfo

Các 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 đã 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

Liệu chiến dịch có chỉ sử dụng URL 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 nhóm sản phẩm có thể được quảng cáo bằng chiến dịch này 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 để đưa vào chiến dịch. Bạn chỉ có thể đặt một trong số feedLabel hoặc salesCountry. Nếu được sử dụng thay cho salesCountry, trường feedLabel sẽ chấp nhận mã quốc gia có cùng định dạng, ví dụ: "XX". Nếu không, bạn có thể dùng bất kỳ chuỗi nào 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 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 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 để tạo các thao tác. Bạn không thể thay đổi trường này đối với chiến dịch Mua sắm.

campaignPriority

integer

Mức độ ưu tiên của chiến dịch. Những 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 những chiến dịch có mức độ ưu tiên thấp hơn. Trường này là bắt buộc cho chiến dịch Mua sắm, có các giá trị từ 0 đến 2 (bao gồm cả hai giá trị này). Đây là trường không bắt buộc đối với chiến dịch Mua sắm thông minh, nhưng bạn phải đặt trường này thành 3.

enableLocal

boolean

Có thêm các 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 tài nguyên Đối tượng để nhắm mục tiêu theo đối tượng. Nếu giá trị là sai, chiến dịch này có thể sử dụng tiêu chí phân khúc đối tượng.

GeoTargetTypeSetting

Đại diện cho một tập hợp các cài đặt liên quan đến 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 được dùng để nhắm mục tiêu khẳng định theo địa lý trong chiến dịch cụ thể này.

negativeGeoTargetType

enum (NegativeGeoTargetType)

Tùy chọn cài đặt được 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 Giá trị không xác định trong phiên bản này.
PRESENCE_OR_INTEREST Chỉ định rằng quảng cáo được kích hoạt nếu người dùng ở những vị trí được nhắm mục tiêu 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 quảng cáo được kích hoạt nếu người dùng tìm kiếm vị trí được nhắm mục tiêu của nhà quảng cáo. Tính năng này chỉ dùng được cho chiến dịch Tìm kiếm và chiến dịch Mua sắm thông thường.
PRESENCE Chỉ định rằng quảng cáo được kích hoạt nếu người dùng ở những vị trí mà nhà quảng cáo nhắm mục tiêu hoặc thường xuyên ở những vị trí đó.

NegativeGeoTargetType

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
PRESENCE_OR_INTEREST Chỉ định rằng người dùng sẽ không nhìn thấy quảng cáo nếu họ đang ở 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ọ ở các 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 vị trí cho chiến dịch địa phương này.

LocationSourceType

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

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
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.
GOOGLE_MY_BUSINESS Các địa điểm được liên kết với Trang doanh nghiệp được 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

Các 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. Một 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ề. Đại diện cho giá trị không xác định trong phiên bản này.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST Mục tiêu là 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 mục đích tối đa hoá số lượt chuyển đổi dài hạn đã chọ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 mục đích tối đa hoá số lượt chuyển đổi dài hạn đã chọ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. Xin lưu ý rằng cpa thực tế có vẻ cao hơn cpa mục tiêu lúc đầu, vì lượt chuyển đổi dài hạn chưa xảy ra.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND Hướng tới 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) trong khi vẫn đạt được hoặc vượt lợi tức mục tiêu trên chi tiêu quảng cáo.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME Nhằm mục đích tối đa hoá lượt đăng ký trước ứng dụng.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST Cố gắng tối đa hoá lượt cài đặt ứng dụng mà không đặt 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ề. Đại diện cho 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ề. Đại diện cho giá trị không xác định trong phiên bản này.
BASE Đây là chiến dịch thông thường.
DRAFT Đây là phiên bản dự thảo của chiến dịch. Chiến dịch này có một số nội dung sửa đổi so với 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. Chiến dịch này có một số nội dung sửa đổi so với chiến dịch căn bản và một tỷ lệ phần trăm lưu lượng truy cập đang được chuyển từ chiến dịch CƠ SỞ đế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 thể có nhiều hơn một giới hạn tần suất với cùng một khoá.

cap

integer

Số sự kiện tối đa được cho 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. Chỉ được có tối đa một giới hạn tần suất với 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 áp dụng giới hạn (ví dụ: lượt hiển thị).

timeUnit

enum (FrequencyCapTimeUnit)

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

timeLength

integer

Số đơn vị thời gian của giới hạn.

FrequencyCapLevel

Cấp độ mà giới hạn sẽ được áp dụng (ví dụ: quảng cáo trong nhóm quảng cáo, nhóm quảng cáo). Giới hạn được áp dụng cho mọi 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ề. Đại diện cho giá trị không xác định trong phiên bản này.
AD_GROUP_AD Giới hạn được áp dụng ở cấp quảng cáo của nhóm quảng cáo.
AD_GROUP Giới hạn được áp dụng ở cấp nhóm quảng cáo.
CAMPAIGN Giới hạn được áp dụng ở cấp chiến dịch.

FrequencyCapEventType

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

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.
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 lượt xem quảng cáo dạng video.

VanityPharma

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

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 các URL hiệu thuốc rút gọn.

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 mô tả trang web là chế độ hiển thị được chọn cho các URL hiệu thuốc rút gọn.

VanityPharmaDisplayUrlMode

Enum mô tả các chế độ hiển thị có thể có cho các URL hiệu thuốc rút gọn.

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.
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 hợp lệ.

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.
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 trên trang web bằng tiếng Tây Ban Nha (Sitio de banantikhivos 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 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 quảng cáo ứng dụng sử dụng MULTI_CHANNEL dưới dạng AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT dưới dạng 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ề. Đại diện cho 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 một 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 về đường đi lái xe là những lần mọi người chọn "Xem đường đi" để đi đến một 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. 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 được dùng để theo dõi linh động.

PaymentMode

Enum mô tả các phương thức thanh toán 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.
CLICKS Trả phí cho mỗi lượt tương tác.
CONVERSION_VALUE Trả tiền cho mỗi giá trị chuyển đổi. Chế độ này chỉ được hỗ trợ bởi những chiến dịch có AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION và CPMType.STANDARD hỗ trợ chế độ này.
CONVERSIONS Trả tiền cho mỗi lượt chuyển đổi. Chế độ này chỉ được hỗ trợ bởi những chiến dịch có AdvertisingChannelType.DISPLAY (ngoại trừ AdvertisingChannelSubType.DISPLAY_ nhằm), BiddingStrategyType.TARGET_CPA vàCPAType.FIXED_CPA hỗ trợ. 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 Trả tiền cho mỗi lượt lưu trú của khách. Chế độ này chỉ được hỗ trợ bởi những chiến dịch có AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION và CPMType.STANDARD hỗ trợ chế độ này.

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 đã được nâng cấp lên chiến dịch nào.

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 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ề. Đại diện cho giá trị không xác định trong phiên bản này.
UPGRADE_IN_PROGRESS Quá trình nâng cấp lên chiến dịch Tối đa hoá hiệu suất đang trong quá trình.
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ề. Đại diện cho 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 bao gồm cặp Asset tự động hoá và trạng thái chọn tham gia/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)

Loại tự động hoá thành phần mà nhà quảng cáo 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 loại tự động hoá thành phần.

AssetAutomationType

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng làm giá trị trả về. Đại diện cho 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 cả dòng tiêu đề và nội dung mô tả. Theo mặc định, nhà quảng cáo chọn sử dụng chiến dịch Tối đa hoá hiệu suất và chọn không sử dụng chiến dịch Tìm kiếm.

AssetAutomationStatus

Trạng thái của tính năng tự động hoá thành phần.

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

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ẽ bị tính phí. Tỷ lệ phí hoa hồng x nên được chuyển vào trường này dưới dạng (x * 1.000.000). Ví dụ: 106.000 thì tỷ lệ phí hoa hồng là 0, 106 (10,6%).

ManualCpa

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

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.

Đặ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.

Đặ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 mà giá thầu là một phần giá được quảng cáo cho một số hàng hoá hoặc dịch vụ.

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

string (int64 format)

Giới hạn 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 đơn vị cực nhỏ tại địa phương. Lưu ý: Giá trị 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á lên hoặc xuống, 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 mục tiêu (chi phí mỗi nghìn lượt hiển thị) 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 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:
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ố 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 được chỉ định.