SearchAds360Row

แถวที่แสดงผลจากการค้นหา

การแสดง JSON 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
ช่อง
adGroup

object (AdGroup)

กลุ่มโฆษณาที่อ้างอิงในคําค้นหา
adGroupAd

object (AdGroupAd)

โฆษณาที่อ้างอิงในคําค้นหา
adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

ป้ายกํากับโฆษณาที่มีประสิทธิภาพของกลุ่มโฆษณาที่อ้างอิงในคําค้นหา
adGroupAdLabel

object (AdGroupAdLabel)

ป้ายกํากับโฆษณากลุ่มโฆษณาที่อ้างอิงในคําค้นหา
adGroupAsset

object (AdGroupAsset)

ชิ้นงานกลุ่มโฆษณาที่อ้างอิงในคําค้นหา
adGroupAssetSet

object (AdGroupAssetSet)

ชุดชิ้นงานกลุ่มโฆษณาที่อ้างอิงในคําค้นหา
adGroupAudienceView

object (AdGroupAudienceView)

มุมมองกลุ่มเป้าหมายของกลุ่มโฆษณาที่อ้างอิงในคําค้นหา
adGroupBidModifier

object (AdGroupBidModifier)

ตัวปรับราคาเสนอที่อ้างอิงในคําค้นหา
adGroupCriterion

object (AdGroupCriterion)

เกณฑ์ที่อ้างอิงในข้อความค้นหา
adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

ป้ายกำกับเกณฑ์ของกลุ่มโฆษณาที่มีประสิทธิภาพซึ่งอ้างอิงในข้อความค้นหา
adGroupCriterionLabel

object (AdGroupCriterionLabel)

ป้ายกํากับเกณฑ์ของกลุ่มโฆษณาที่อ้างอิงในคําค้นหา
adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

ป้ายกํากับที่มีประสิทธิภาพของกลุ่มโฆษณาที่อ้างอิงในคําค้นหา
adGroupLabel

object (AdGroupLabel)

ป้ายกํากับกลุ่มโฆษณาที่อ้างอิงในคําค้นหา
ageRangeView

object (AgeRangeView)

มุมมองช่วงอายุที่อ้างอิงในคําค้นหา
asset

object (Asset)

ชิ้นงานที่อ้างอิงในข้อความค้นหา
assetGroupAsset

object (AssetGroupAsset)

ชิ้นงานกลุ่มชิ้นงานที่อ้างอิงในคําค้นหา
assetGroupSignal

object (AssetGroupSignal)

สัญญาณกลุ่มชิ้นงานที่อ้างอิงในข้อความค้นหา
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

ตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงานที่อ้างอิงในข้อความค้นหา
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

มุมมองชุดค่าผสมยอดนิยมของกลุ่มชิ้นงานที่อ้างอิงในคําค้นหา
assetGroup

object (AssetGroup)

กลุ่มชิ้นงานที่อ้างอิงในข้อความค้นหา
assetSetAsset

object (AssetSetAsset)

ชิ้นงานในชุดชิ้นงานที่อ้างอิงในคําค้นหา
assetSet

object (AssetSet)

ชุดชิ้นงานที่อ้างอิงในคําค้นหา
biddingStrategy

object (BiddingStrategy)

กลยุทธ์การเสนอราคาที่อ้างอิงในคําค้นหา
campaignBudget

object (CampaignBudget)

งบประมาณแคมเปญที่อ้างอิงในคําค้นหา
campaign

object (Campaign)

แคมเปญที่อ้างอิงในคําค้นหา
campaignAsset

object (CampaignAsset)

ชิ้นงานแคมเปญที่อ้างอิงในข้อความค้นหา
campaignAssetSet

object (CampaignAssetSet)

ชุดชิ้นงานแคมเปญที่อ้างอิงในข้อความค้นหา
campaignAudienceView

object (CampaignAudienceView)

มุมมองกลุ่มเป้าหมายของแคมเปญที่อ้างอิงในคําค้นหา
campaignCriterion

object (CampaignCriterion)

เกณฑ์แคมเปญที่อ้างอิงในคําค้นหา
campaignEffectiveLabel

object (CampaignEffectiveLabel)

ป้ายกํากับประสิทธิภาพของแคมเปญที่อ้างอิงในคําค้นหา
campaignLabel

object (CampaignLabel)

ป้ายกํากับแคมเปญที่อ้างอิงในคําค้นหา
cartDataSalesView

object (CartDataSalesView)

มุมมองยอดขายจากข้อมูลรถเข็นช็อปปิ้งที่อ้างอิงในการค้นหา
audience

object (Audience)

กลุ่มเป้าหมายที่อ้างอิงในคําค้นหา
conversionAction

object (ConversionAction)

การกระทําที่ถือเป็น Conversion ที่อ้างอิงในคําค้นหา
conversionCustomVariable

object (ConversionCustomVariable)

ตัวแปรที่กําหนดเองของ Conversion ที่อ้างอิงในการค้นหา
customer

object (Customer)

ลูกค้าที่มีการอ้างอิงในข้อความค้นหา
customerAsset

object (CustomerAsset)

ชิ้นงานของลูกค้าที่อ้างอิงในคําค้นหา
customerAssetSet

object (CustomerAssetSet)

ชุดชิ้นงานลูกค้าที่ใช้อ้างอิงในคําค้นหา
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

กลยุทธ์การเสนอราคาที่เข้าถึงได้ซึ่งอ้างอิงในคําค้นหา
customerClient

object (CustomerClient)

CustomerClient ที่อ้างอิงในคําค้นหา
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

มุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิกที่อ้างอิงในคําค้นหา
genderView

object (GenderView)

มุมมองเพศที่อ้างอิงในข้อความค้นหา
geoTargetConstant

object (GeoTargetConstant)

ค่าคงที่ของเป้าหมายทางภูมิศาสตร์ที่อ้างอิงในการค้นหา
keywordView

object (KeywordView)

มุมมองคีย์เวิร์ดที่อ้างอิงในคําค้นหา
label

object (Label)

ป้ายกำกับที่อ้างอิงในการค้นหา
languageConstant

object (LanguageConstant)

ค่าคงที่ภาษาที่อ้างอิงในข้อความค้นหา
locationView

object (LocationView)

มุมมองสถานที่ที่อ้างอิงในข้อความค้นหา
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

หมวดหมู่การเสนอราคาผลิตภัณฑ์ที่อ้างอิงในข้อความค้นหา
productGroupView

object (ProductGroupView)

มุมมองกลุ่มผลิตภัณฑ์ที่อ้างอิงในข้อความค้นหา
shoppingPerformanceView

object (ShoppingPerformanceView)

มุมมองประสิทธิภาพ Shopping ที่อ้างอิงในคําค้นหา
userList

object (UserList)

รายการผู้ใช้ที่อ้างอิงในข้อความค้นหา
userLocationView

object (UserLocationView)

มุมมองสถานที่ตั้งของผู้ใช้ที่อ้างอิงในคําค้นหา
webpageView

object (WebpageView)

มุมมองหน้าเว็บที่อ้างอิงในข้อความค้นหา
visit

object (Visit)

การเข้าชมระดับเหตุการณ์ที่อ้างอิงในคําค้นหา
conversion

object (Conversion)

Conversion ระดับเหตุการณ์ที่อ้างอิงในคําค้นหา
metrics

object (Metrics)

เมตริก
segments

object (Segments)

กลุ่ม
customColumns[]

object (Value)

คอลัมน์ที่กำหนดเอง

กลุ่มโฆษณา :

กลุ่มโฆษณา

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
ช่อง
resourceName

string

ชื่อทรัพยากรของกลุ่มโฆษณา ชื่อทรัพยากรกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customerId}/adGroups/{ad_group_id}
status

enum (AdGroupStatus)

สถานะของกลุ่มโฆษณา
type

enum (AdGroupType)

ประเภทของกลุ่มโฆษณา
adRotationMode

enum (AdGroupAdRotationMode)

โหมดการหมุนเวียนโฆษณาของกลุ่มโฆษณา
creationTime

string

การประทับเวลาที่สร้าง adGroup นี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss"
targetingSetting

object (TargetingSetting)

การตั้งค่าสําหรับฟีเจอร์ที่เกี่ยวข้องกับการกําหนดเป้าหมาย
labels[]

string

ชื่อทรัพยากรของป้ายกำกับที่แนบมากับกลุ่มโฆษณานี้
effectiveLabels[]

string

ชื่อทรัพยากรของป้ายกำกับที่มีประสิทธิภาพซึ่งแนบอยู่กับกลุ่มโฆษณานี้ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับค่ามาหรือกำหนดให้กับกลุ่มโฆษณานี้โดยตรง
engineId

string

รหัสของกลุ่มโฆษณาในบัญชีเครื่องมือค้นหาภายนอก ฟิลด์นี้มีไว้สําหรับบัญชีที่ไม่ใช่ Google Ads เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu ฯลฯ สําหรับเอนทิตี Google Ads ให้ใช้ "adGroup.id" แทน
startDate

string

วันที่กลุ่มโฆษณานี้เริ่มแสดงโฆษณา โดยค่าเริ่มต้น กลุ่มโฆษณาจะเริ่มทํางานทันทีหรือวันที่เริ่มต้นของกลุ่มโฆษณา ขึ้นอยู่กับว่าวันที่ใดมาหลัง หากตั้งค่าช่องนี้ไว้ กลุ่มโฆษณาจะเริ่มทํางานตั้งแต่ช่วงต้นของวันที่ที่ระบุในเขตเวลาของลูกค้า ฟิลด์นี้ใช้ได้กับบัญชีเกตเวย์ Microsoft Advertising และ Facebook เท่านั้น

รูปแบบ: YYYY-MM-DD ตัวอย่างเช่น 2019-03-14
endDate

string

วันที่กลุ่มโฆษณาสิ้นสุดการแสดงโฆษณา โดยค่าเริ่มต้น กลุ่มโฆษณาจะสิ้นสุดในวันที่สิ้นสุดของกลุ่มโฆษณา หากตั้งค่าช่องนี้ไว้ กลุ่มโฆษณาจะสิ้นสุดเมื่อถึงวันที่ที่ระบุตามเขตเวลาของลูกค้า ฟิลด์นี้ใช้ได้กับบัญชีเกตเวย์ Microsoft Advertising และ Facebook เท่านั้น

รูปแบบ: YYYY-MM-DD ตัวอย่างเช่น 2019-03-14
languageCode

string

ภาษาของโฆษณาและคีย์เวิร์ดในกลุ่มโฆษณา ช่องนี้ใช้ได้กับบัญชี Microsoft Advertising เท่านั้น รายละเอียดเพิ่มเติม: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
lastModifiedTime

string

วันที่และเวลาที่แก้ไขกลุ่มโฆษณานี้ครั้งล่าสุด โดยค่าวันที่และเวลาจะอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" และอยู่ตามเขตเวลาของลูกค้า
id

string (int64 format)

รหัสของกลุ่มโฆษณา
name

string

ชื่อของกลุ่มโฆษณา

ต้องกรอกข้อมูลในช่องนี้และไม่ควรเว้นว่างไว้เมื่อสร้างกลุ่มโฆษณาใหม่

ต้องมีอักขระแบบเต็มความกว้าง UTF-8 ไม่เกิน 255 ตัว

โดยต้องไม่มีอักขระ Null (Code Point 0x0), NL (Code Point 0xA) หรือขึ้นบรรทัดใหม่ (Code Point 0xD)
cpcBidMicros

string (int64 format)

การเสนอราคา CPC (ต้นทุนต่อคลิก) สูงสุด
engineStatus

enum (AdGroupEngineStatus)

สถานะเครื่องมือค้นหาสําหรับกลุ่มโฆษณา

AdGroupStatus

สถานะที่เป็นไปได้ของกลุ่มโฆษณา

Enum
UNSPECIFIED ไม่ได้ระบุสถานะ
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED กลุ่มโฆษณาเปิดใช้งานแล้ว
PAUSED กลุ่มโฆษณาหยุดชั่วคราว
REMOVED ระบบจะนำกลุ่มโฆษณาออก

AdGroupType

Enum ที่แสดงรายการประเภทกลุ่มโฆษณาที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุประเภท
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
SEARCH_STANDARD ประเภทกลุ่มโฆษณาเริ่มต้นสําหรับแคมเปญ Search
DISPLAY_STANDARD ประเภทกลุ่มโฆษณาเริ่มต้นสําหรับแคมเปญ Display
SHOPPING_PRODUCT_ADS ประเภทกลุ่มโฆษณาสําหรับแคมเปญ Shopping ที่แสดงโฆษณาผลิตภัณฑ์มาตรฐาน
SHOPPING_SHOWCASE_ADS ประเภทของกลุ่มโฆษณาที่จำกัดไว้สำหรับการแสดงโฆษณา Showcase หรือโฆษณาของผู้ขายในผลการค้นหา Shopping
HOTEL_ADS ประเภทกลุ่มโฆษณาเริ่มต้นสําหรับแคมเปญโรงแรม
SHOPPING_SMART_ADS ประเภทของกลุ่มโฆษณาในแคมเปญ Smart Shopping
VIDEO_BUMPER โฆษณาวิดีโอในสตรีมแบบข้ามไม่ได้ที่มีความยาวสั้น
VIDEO_TRUE_VIEW_IN_STREAM โฆษณาวิดีโอ TrueView (แบบข้ามได้) ในสตรีม
VIDEO_TRUE_VIEW_IN_DISPLAY โฆษณาวิดีโอ TrueView ใน Display
VIDEO_NON_SKIPPABLE_IN_STREAM โฆษณาวิดีโอในสตรีมแบบข้ามไม่ได้
VIDEO_OUTSTREAM โฆษณาวิดีโอนอกสตรีม
SEARCH_DYNAMIC_ADS ประเภทกลุ่มโฆษณาสําหรับกลุ่มโฆษณา Search แบบไดนามิก
SHOPPING_COMPARISON_LISTING_ADS ประเภทของกลุ่มโฆษณาในแคมเปญข้อมูลเปรียบเทียบสินค้า Shopping
PROMOTED_HOTEL_ADS ประเภทกลุ่มโฆษณาสําหรับกลุ่มโฆษณาโรงแรมที่โปรโมต
VIDEO_RESPONSIVE กลุ่มโฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณา
VIDEO_EFFICIENT_REACH กลุ่มโฆษณาเพื่อการเข้าถึงที่มีประสิทธิภาพของวิดีโอ
SMART_CAMPAIGN_ADS ประเภทกลุ่มโฆษณาสําหรับ Smart Campaign
TRAVEL_ADS ประเภทกลุ่มโฆษณาสําหรับแคมเปญการเดินทาง

AdGroupAdRotationMode

โหมดการหมุนเวียนโฆษณาที่เป็นไปได้ของกลุ่มโฆษณา

Enum
UNSPECIFIED ไม่ได้ระบุโหมดการหมุนเวียนโฆษณา
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
OPTIMIZE เพิ่มประสิทธิภาพโฆษณากลุ่มตามการคลิกหรือ Conversion
ROTATE_FOREVER หมุนเวียนอย่างเท่าเทียมไปตลอด

AdGroupEngineStatus

สถานะของเครื่องมือกลุ่มโฆษณา

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AD_GROUP_ELIGIBLE

เลิกใช้งานแล้ว โปรดอย่าใช้
AD_GROUP_EXPIRED ไม่มีโฆษณาที่ทำงานสําหรับกลุ่มโฆษณานี้ เนื่องจากเลยวันที่สิ้นสุดของกลุ่มโฆษณาไปแล้ว
AD_GROUP_REMOVED กลุ่มโฆษณาถูกลบแล้ว
AD_GROUP_DRAFT ไม่มีโฆษณาใดแสดงสําหรับกลุ่มโฆษณานี้เนื่องจากกลุ่มโฆษณาที่เกี่ยวข้องยังอยู่ในรูปแบบฉบับร่าง
AD_GROUP_PAUSED กลุ่มโฆษณาหยุดชั่วคราวแล้ว
AD_GROUP_SERVING กลุ่มโฆษณาทํางานอยู่และแสดงโฆษณาอยู่
AD_GROUP_SUBMITTED ส่งกลุ่มโฆษณาแล้ว (สถานะเดิมของ Microsoft Bing Ads)
CAMPAIGN_PAUSED ไม่มีโฆษณาที่ทํางานสําหรับกลุ่มโฆษณานี้เนื่องจากแคมเปญถูกหยุดชั่วคราว
ACCOUNT_PAUSED ไม่มีโฆษณาที่ทํางานสําหรับกลุ่มโฆษณานี้เนื่องจากบัญชีถูกหยุดชั่วคราว

TargetingSetting

การตั้งค่าสําหรับฟีเจอร์ที่เกี่ยวข้องกับการกําหนดเป้าหมายที่ระดับแคมเปญและกลุ่มโฆษณา ดูรายละเอียดเพิ่มเติมเกี่ยวกับการตั้งค่าการกําหนดเป้าหมายได้ที่ https://support.google.com/google-ads/answer/7365594

การแสดง JSON 
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
ช่อง
targetRestrictions[]

object (TargetRestriction)

การตั้งค่าตามมิติข้อมูลการกําหนดเป้าหมายเพื่อจํากัดการเข้าถึงของแคมเปญหรือกลุ่มโฆษณา

TargetRestriction

รายการการตั้งค่าการกําหนดเป้าหมายตามมิติข้อมูลการกําหนดเป้าหมาย

การแสดง JSON 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
ช่อง
targetingDimension

enum (TargetingDimension)

มิติข้อมูลการกําหนดเป้าหมายที่ใช้การตั้งค่าเหล่านี้
bidOnly

boolean

ระบุว่าจะจํากัดโฆษณาให้แสดงเฉพาะสําหรับเกณฑ์ที่คุณเลือกสําหรับมิติข้อมูลการกําหนดเป้าหมายนี้ หรือกําหนดเป้าหมายค่าทั้งหมดสําหรับมิติข้อมูลการกําหนดเป้าหมายนี้และแสดงโฆษณาตามการกําหนดเป้าหมายในมิติข้อมูลการกําหนดเป้าหมายอื่นๆ ค่า true หมายความว่าเกณฑ์เหล่านี้จะใช้ตัวคูณราคาเสนอเท่านั้น และไม่ส่งผลต่อการกำหนดเป้าหมาย ค่า false หมายความว่าเกณฑ์เหล่านี้จะจํากัดการกําหนดเป้าหมาย รวมถึงการใช้ตัวปรับราคาเสนอ

TargetingDimension

Enum ที่อธิบายมิติข้อมูลการกําหนดเป้าหมายที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
KEYWORD เกณฑ์คีย์เวิร์ด เช่น "เที่ยวชมดาวอังคาร" ระบบอาจใช้ KEYWORD เป็นมิติข้อมูลการเสนอราคาที่กําหนดเอง คีย์เวิร์ดเป็นมิติข้อมูลการกําหนดเป้าหมายเสมอ จึงไม่สามารถกําหนดเป็นมิติข้อมูลเป้าหมาย "ทั้งหมด" ที่มี TargetRestriction
AUDIENCE เกณฑ์กลุ่มเป้าหมาย ซึ่งรวมถึงรายชื่อผู้ใช้ ความสนใจของผู้ใช้ กลุ่มความสนใจที่กําหนดเอง และผู้ที่กําลังมีแผนจะซื้อที่กําหนดเอง
TOPIC เกณฑ์หัวข้อสําหรับกําหนดเป้าหมายหมวดหมู่เนื้อหา เช่น "category::Animals>Pets" ใช้สําหรับการกําหนดเป้าหมาย Display และวิดีโอ
GENDER เกณฑ์สําหรับการกําหนดเป้าหมายตามเพศ
AGE_RANGE เกณฑ์สําหรับการกําหนดเป้าหมายช่วงอายุ
PLACEMENT เกณฑ์ตําแหน่งโฆษณา ซึ่งรวมถึงเว็บไซต์ เช่น "www.flowers4sale.com" รวมถึงแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ หมวดหมู่แอปบนอุปกรณ์เคลื่อนที่ วิดีโอ YouTube และช่อง YouTube
PARENTAL_STATUS เกณฑ์สําหรับการกําหนดเป้าหมายตามสถานะความเป็นบิดามารดา
INCOME_RANGE เกณฑ์สําหรับการกําหนดเป้าหมายตามช่วงรายได้

AdGroupAd

โฆษณากลุ่มโฆษณา

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของโฆษณา ชื่อแหล่งข้อมูลโฆษณาของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}
status

enum (AdGroupAdStatus)

สถานะของโฆษณา
ad

object (Ad)

โฆษณา
creationTime

string

การประทับเวลาที่สร้าง adGroupAd นี้ โดยค่าวันที่และเวลาจะอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" และอยู่ตามเขตเวลาของลูกค้า
labels[]

string

ชื่อทรัพยากรของป้ายกำกับที่แนบมากับโฆษณาของกลุ่มโฆษณานี้
effectiveLabels[]

string

ชื่อทรัพยากรของป้ายกำกับที่มีประสิทธิภาพซึ่งแนบอยู่กับโฆษณานี้ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับช่วงมาหรือกำหนดให้กับโฆษณานี้โดยตรง
engineId

string

รหัสของโฆษณาในบัญชีเครื่องมือค้นหาภายนอก ช่องนี้มีไว้สําหรับบัญชี Search Ads 360 เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu ฯลฯ สําหรับเอนทิตีที่ไม่ใช่ Search Ads 360 ให้ใช้ "adGroupAd.ad.id" แทน
engineStatus

enum (AdGroupAdEngineStatus)

สถานะเพิ่มเติมของโฆษณาในบัญชีเครื่องมือค้นหาภายนอก สถานะที่เป็นไปได้ (ขึ้นอยู่กับประเภทของบัญชีภายนอก) ได้แก่ ใช้งานอยู่ มีสิทธิ์ รอตรวจสอบ ฯลฯ
lastModifiedTime

string

วันที่และเวลาที่มีการแก้ไขโฆษณากลุ่มนี้ครั้งล่าสุด โดยค่าวันที่และเวลาจะอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" และอยู่ตามเขตเวลาของลูกค้า

AdGroupAdStatus

สถานะที่เป็นไปได้ของ AdGroupAd

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED โฆษณากลุ่มโฆษณาเปิดใช้งานแล้ว
PAUSED โฆษณากลุ่มโฆษณาหยุดชั่วคราว
REMOVED ระบบจะนำโฆษณากลุ่มโฆษณาออก

AdType

ประเภทโฆษณาที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
TEXT_AD โฆษณาเป็นโฆษณาแบบข้อความ
EXPANDED_TEXT_AD โฆษณาเป็นโฆษณาแบบข้อความที่ขยายออก
CALL_ONLY_AD โฆษณาเป็นโฆษณาแบบโทรออกเท่านั้น
EXPANDED_DYNAMIC_SEARCH_AD โฆษณานี้เป็นโฆษณา Search แบบไดนามิกอย่างกว้าง
HOTEL_AD โฆษณาเป็นโฆษณาโรงแรม
SHOPPING_SMART_AD โฆษณาเป็นโฆษณา Smart Shopping
SHOPPING_PRODUCT_AD โฆษณานี้เป็นโฆษณา Shopping มาตรฐาน
VIDEO_AD โฆษณาเป็นโฆษณาวิดีโอ
GMAIL_AD โฆษณานี้เป็นโฆษณา Gmail
IMAGE_AD โฆษณานี้เป็นโฆษณาแบบรูปภาพ
RESPONSIVE_SEARCH_AD โฆษณาเป็นโฆษณา Search ที่ปรับเปลี่ยนตามบริบท
LEGACY_RESPONSIVE_DISPLAY_AD โฆษณานี้เป็นโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณารุ่นเดิม
APP_AD โฆษณาเป็นแอปโฆษณา
LEGACY_APP_INSTALL_AD โฆษณานี้เป็นโฆษณาเพื่อการติดตั้งแอปรุ่นเดิม
RESPONSIVE_DISPLAY_AD โฆษณาเป็นโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา
LOCAL_AD โฆษณาเป็นโฆษณาในพื้นที่
HTML5_UPLOAD_AD โฆษณาเป็นโฆษณา Display ที่อัปโหลดซึ่งมีประเภทผลิตภัณฑ์ HTML5_UPLOAD_AD
DYNAMIC_HTML5_AD โฆษณาเป็นโฆษณา Display ที่อัปโหลดซึ่งมีผลิตภัณฑ์ประเภท DYNAMIC_HTML5_* ประเภทใดประเภทหนึ่ง
APP_ENGAGEMENT_AD โฆษณานี้เป็นโฆษณาเพื่อการมีส่วนร่วมกับแอป
SHOPPING_COMPARISON_LISTING_AD โฆษณาเป็นโฆษณาเปรียบเทียบสินค้า Shopping
VIDEO_BUMPER_AD โฆษณาวิดีโอบัมเปอร์
VIDEO_NON_SKIPPABLE_IN_STREAM_AD โฆษณาในสตรีมแบบข้ามไม่ได้สำหรับวิดีโอ
VIDEO_OUTSTREAM_AD โฆษณาวิดีโอนอกสตรีม
VIDEO_TRUEVIEW_DISCOVERY_AD โฆษณา TrueView In-Display วิดีโอ
VIDEO_TRUEVIEW_IN_STREAM_AD โฆษณา TrueView ในสตรีมวิดีโอ
VIDEO_RESPONSIVE_AD โฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณา
SMART_CAMPAIGN_AD โฆษณา Smart Campaign
APP_PRE_REGISTRATION_AD โฆษณาการลงทะเบียนล่วงหน้าของ Universal App
DISCOVERY_MULTI_ASSET_AD โฆษณา Discovery แบบหลายชิ้นงาน
TRAVEL_AD โฆษณาการท่องเที่ยว
DISCOVERY_VIDEO_RESPONSIVE_AD โฆษณาวิดีโอ Discovery ที่ปรับเปลี่ยนตามพื้นที่โฆษณา
MULTIMEDIA_AD โฆษณามัลติมีเดีย

SearchAds360TextAdInfo

โฆษณาแบบข้อความของ Search Ads 360

การแสดง JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
ช่อง
headline

string

บรรทัดแรกของโฆษณา
description1

string

บรรทัดแรกของคําอธิบายโฆษณา
description2

string

บรรทัดที่สองของคําอธิบายโฆษณา
displayUrl

string

URL ที่แสดงของโฆษณา
displayMobileUrl

string

URL ของโฆษณาบนอุปกรณ์เคลื่อนที่ที่แสดง
adTrackingId

string (int64 format)

รหัสติดตามของโฆษณา

SearchAds360ExpandedTextAdInfo

โฆษณาแบบข้อความที่ขยายออกของ Search Ads 360

การแสดง JSON 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
ช่อง
headline

string

บรรทัดแรกของโฆษณา
headline2

string

บรรทัดแรกของโฆษณา
headline3

string

บรรทัดแรกที่ 3 ของโฆษณา
description1

string

บรรทัดแรกของคําอธิบายโฆษณา
description2

string

บรรทัดที่สองของคําอธิบายโฆษณา
path1

string

ข้อความต่อท้าย URL ที่มองเห็นได้ซึ่งสร้างขึ้นโดยอัตโนมัติด้วยตัวคั่น
path2

string

ข้อความต่อท้าย path1 ด้วยตัวคั่น
adTrackingId

string (int64 format)

รหัสติดตามของโฆษณา

SearchAds360ResponsiveSearchAdInfo

โฆษณา Search ที่ปรับเปลี่ยนตามบริบทของ Search Ads 360

การแสดง JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
ช่อง
headlines[]

object (AdTextAsset)

รายการชิ้นงานข้อความสำหรับบรรทัดแรก เมื่อโฆษณาแสดง ระบบจะเลือกบรรทัดแรกจากรายการนี้
descriptions[]

object (AdTextAsset)

รายการชิ้นงานข้อความสําหรับคําอธิบาย เมื่อโฆษณาแสดง ระบบจะเลือกคําอธิบายจากรายการนี้
path1

string

ข้อความต่อท้าย URL ที่มองเห็นได้ซึ่งสร้างขึ้นโดยอัตโนมัติด้วยตัวคั่น
path2

string

ข้อความต่อท้าย path1 ด้วยตัวคั่น
adTrackingId

string (int64 format)

รหัสติดตามของโฆษณา

AdTextAsset

ชิ้นงานข้อความที่ใช้ภายในโฆษณา

การแสดง JSON 
{
  "text": string
}
ช่อง
text

string

ข้อความชิ้นงาน

SearchAds360ProductAdInfo

ประเภทนี้ไม่มีช่อง

โฆษณาผลิตภัณฑ์ Search Ads 360

SearchAds360ExpandedDynamicSearchAdInfo

โฆษณา Search แบบไดนามิกอย่างกว้าง

การแสดง JSON 
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
ช่อง
description1

string

บรรทัดแรกของคําอธิบายโฆษณา
description2

string

บรรทัดที่สองของคําอธิบายโฆษณา
adTrackingId

string (int64 format)

รหัสติดตามของโฆษณา

AdGroupAdEngineStatus

แสดงสถานะเครื่องมือ AdGroupAd

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AD_GROUP_AD_ELIGIBLE

เลิกใช้งานแล้ว โปรดอย่าใช้
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: ครีเอทีฟโฆษณาไม่ได้รับการอนุมัติ
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: URL อุปกรณ์เคลื่อนที่อยู่ระหว่างการตรวจสอบ
AD_GROUP_AD_PARTIALLY_INVALID Baidu: ครีเอทีฟโฆษณาใช้ไม่ได้บนอุปกรณ์เคลื่อนที่ แต่ใช้ได้บนเดสก์ท็อป
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: ครีเอทีฟโฆษณาพร้อมเปิดใช้งานแล้ว
AD_GROUP_AD_NOT_REVIEWED Baidu: ครีเอทีฟโฆษณาไม่ได้รับการตรวจสอบ
AD_GROUP_AD_ON_HOLD

เลิกใช้งานแล้ว โปรดอย่าใช้ เคยใช้โดย Gemini
AD_GROUP_AD_PAUSED ครีเอทีฟโฆษณาหยุดชั่วคราวแล้ว
AD_GROUP_AD_REMOVED นําครีเอทีฟโฆษณาออกแล้ว
AD_GROUP_AD_PENDING_REVIEW ครีเอทีฟโฆษณาอยู่ระหว่างรอการตรวจสอบ
AD_GROUP_AD_UNDER_REVIEW ครีเอทีฟโฆษณาอยู่ระหว่างตรวจสอบ
AD_GROUP_AD_APPROVED ครีเอทีฟโฆษณาได้รับอนุมัติแล้ว
AD_GROUP_AD_DISAPPROVED ครีเอทีฟโฆษณาไม่ได้รับอนุมัติ
AD_GROUP_AD_SERVING ครีเอทีฟโฆษณากำลังแสดงอยู่
AD_GROUP_AD_ACCOUNT_PAUSED ครีเอทีฟโฆษณาหยุดชั่วคราวเนื่องจากบัญชีหยุดชั่วคราว
AD_GROUP_AD_CAMPAIGN_PAUSED ครีเอทีฟโฆษณาหยุดชั่วคราวเนื่องจากแคมเปญหยุดชั่วคราว
AD_GROUP_AD_AD_GROUP_PAUSED ครีเอทีฟโฆษณาหยุดชั่วคราวเนื่องจากกลุ่มโฆษณาหยุดชั่วคราว

AdGroupAdEffectiveLabel

ความสัมพันธ์ระหว่างโฆษณากลุ่มโฆษณากับป้ายกำกับที่มีประสิทธิภาพ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับค่ามาหรือกำหนดให้กับโฆษณากลุ่มโฆษณานี้โดยตรง

การแสดง JSON 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของป้ายกํากับประสิทธิภาพโฆษณากลุ่มโฆษณา ชื่อทรัพยากรป้ายกํากับโฆษณาที่มีประสิทธิภาพของกลุ่มโฆษณาอยู่ในรูปแบบ customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

โฆษณากลุ่มโฆษณาที่ติดป้ายกำกับที่มีประสิทธิภาพ
label

string

ป้ายกำกับที่มีประสิทธิภาพซึ่งกําหนดให้กับโฆษณากลุ่มโฆษณา
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับที่มีผล

AdGroupAdLabel

ความสัมพันธ์ระหว่างโฆษณากลุ่มโฆษณากับป้ายกํากับ

การแสดง JSON 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของป้ายกํากับโฆษณากลุ่มโฆษณา ชื่อทรัพยากรป้ายกํากับโฆษณากลุ่มโฆษณาอยู่ในรูปแบบ customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

โฆษณากลุ่มโฆษณาที่ติดป้ายกํากับ
label

string

ป้ายกํากับที่กําหนดให้กับโฆษณากลุ่มโฆษณา
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับ

AdGroupAsset

ลิงก์ระหว่างกลุ่มโฆษณากับชิ้นงาน

การแสดง JSON 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
ช่อง
resourceName

string

ชื่อทรัพยากรของชิ้นงานกลุ่มโฆษณา ชื่อทรัพยากร AdGroupAsset มีรูปแบบดังนี้

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}
adGroup

string

ต้องระบุ กลุ่มโฆษณาที่ลิงก์กับชิ้นงาน
asset

string

ต้องระบุ ชิ้นงานที่ลิงก์กับกลุ่มโฆษณา
status

enum (AssetLinkStatus)

สถานะของชิ้นงานกลุ่มโฆษณา

AssetLinkStatus

Enum ที่อธิบายสถานะของลิงก์เนื้อหา

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED ลิงก์ชิ้นงานเปิดใช้งานแล้ว
REMOVED นําลิงก์ชิ้นงานออกแล้ว
PAUSED ลิงก์ชิ้นงานหยุดชั่วคราว

AdGroupAssetSet

AdGroupAssetSet คือลิงก์ระหว่างกลุ่มโฆษณากับชุดชิ้นงาน การสร้าง AdGroupAssetSet จะลิงก์ชุดชิ้นงานกับกลุ่มโฆษณา

การแสดง JSON 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
ช่อง
resourceName

string

ชื่อทรัพยากรของชุดชิ้นงานกลุ่มโฆษณา ชื่อทรัพยากรชุดชิ้นงานของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
adGroup

string

กลุ่มโฆษณาที่ลิงก์กับชุดชิ้นงานนี้
assetSet

string

ชุดชิ้นงานที่ลิงก์กับกลุ่มโฆษณา
status

enum (AssetSetLinkStatus)

สถานะของชุดชิ้นงานกลุ่มโฆษณา อ่านอย่างเดียว

AssetSetLinkStatus

สถานะการลิงก์ระหว่างชุดชิ้นงานกับคอนเทนเนอร์ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุสถานะ
UNKNOWN ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้ ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED ลิงก์ระหว่างชุดชิ้นงานกับคอนเทนเนอร์ของชุดชิ้นงานเปิดใช้งานอยู่
REMOVED ระบบจะนำการลิงก์ระหว่างชุดชิ้นงานกับคอนเทนเนอร์ออก

AdGroupAudienceView

มุมมองกลุ่มเป้าหมายของกลุ่มโฆษณา มีข้อมูลประสิทธิภาพจากความสนใจและรายการรีมาร์เก็ตติ้งสําหรับโฆษณาเครือข่าย Display และเครือข่าย YouTube รวมถึงรายการรีมาร์เก็ตติ้งสําหรับโฆษณา Search (RLSA) ซึ่งรวบรวมที่ระดับกลุ่มเป้าหมาย

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองกลุ่มเป้าหมายของกลุ่มโฆษณา ชื่อทรัพยากรมุมมองกลุ่มเป้าหมายของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

แสดงตัวปรับราคาเสนอระดับกลุ่มโฆษณา

การแสดง JSON 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
ช่อง
resourceName

string

ชื่อทรัพยากรของตัวปรับราคาเสนอของกลุ่มโฆษณา ชื่อทรัพยากรตัวปรับราคาเสนอของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}
bidModifier

number

ตัวปรับราคาเสนอเมื่อเกณฑ์ตรงกัน ตัวแก้ไขต้องอยู่ในช่วง 0.1 - 10.0 ช่วงของ PreferredContent คือ 1.0 - 6.0 ใช้ 0 เพื่อเลือกไม่ใช้ประเภทอุปกรณ์

ฟิลด์สหภาพ criterion เกณฑ์ของตัวปรับราคาเสนอของกลุ่มโฆษณานี้

ต้องระบุในการดำเนินการสร้างที่เริ่มตั้งแต่เวอร์ชัน 5 criterion ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
device

object (DeviceInfo)

เกณฑ์อุปกรณ์

DeviceInfo

เกณฑ์อุปกรณ์

การแสดง JSON 
{
  "type": enum (Device)
}
ช่อง
type

enum (Device)

ประเภทของอุปกรณ์

อุปกรณ์

แสดงรายการอุปกรณ์ Google Ads ที่พร้อมสําหรับการกําหนดเป้าหมาย

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
MOBILE อุปกรณ์เคลื่อนที่ที่มีเบราว์เซอร์เต็มรูปแบบ
TABLET แท็บเล็ตที่มีเบราว์เซอร์เต็มรูปแบบ
DESKTOP คอมพิวเตอร์
CONNECTED_TV สมาร์ททีวีและคอนโซลเกม
OTHER อุปกรณ์ประเภทอื่นๆ

AdGroupCriterion

เกณฑ์ของกลุ่มโฆษณา รายงาน adGroupCriterion จะแสดงเฉพาะเกณฑ์ที่เพิ่มลงในกลุ่มโฆษณาอย่างชัดเจน

การแสดง JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
ช่อง
resourceName

string

ชื่อทรัพยากรของเกณฑ์กลุ่มโฆษณา ชื่อทรัพยากรของเกณฑ์กลุ่มโฆษณามีรูปแบบดังนี้

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}
creationTime

string

การประทับเวลาที่สร้างเกณฑ์กลุ่มโฆษณานี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss"
status

enum (AdGroupCriterionStatus)

สถานะของเกณฑ์

นี่คือสถานะของเอนทิตีเกณฑ์ของกลุ่มโฆษณาซึ่งลูกค้าเป็นผู้ตั้งค่า หมายเหตุ: รายงาน UI อาจรวมข้อมูลเพิ่มเติมที่ส่งผลต่อการมีสิทธิ์เรียกใช้ของเกณฑ์ ในบางกรณี เกณฑ์ที่นําออกแล้วใน API อาจยังแสดงเป็น "เปิดใช้" ใน UI เช่น แคมเปญจะแสดงต่อผู้ใช้ทุกช่วงอายุโดยค่าเริ่มต้น เว้นแต่จะยกเว้น UI จะแสดงช่วงอายุแต่ละช่วงเป็น "เปิดใช้" เนื่องจากมีสิทธิ์ดูโฆษณา แต่ AdGroupCriterion.status จะแสดงเป็น "นําออกแล้ว" เนื่องจากไม่มีการเพิ่มเกณฑ์เชิงบวก
qualityInfo

object (QualityInfo)

ข้อมูลเกี่ยวกับคุณภาพของเกณฑ์
type

enum (CriterionType)

ประเภทของเกณฑ์
labels[]

string

ชื่อทรัพยากรของป้ายกำกับที่แนบมากับเกณฑ์กลุ่มโฆษณานี้
effectiveLabels[]

string

ชื่อทรัพยากรของป้ายกำกับที่มีประสิทธิภาพซึ่งแนบอยู่กับเกณฑ์กลุ่มโฆษณานี้ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับค่ามาหรือกำหนดให้กับเกณฑ์กลุ่มโฆษณานี้โดยตรง
positionEstimates

object (PositionEstimates)

ค่าประมาณสำหรับราคาเสนอตามเกณฑ์ในตําแหน่งต่างๆ
finalUrls[]

string

รายการ URL สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสําหรับโฆษณา
engineId

string

รหัสของเกณฑ์กลุ่มโฆษณาในบัญชีเครื่องมือค้นหาภายนอก ฟิลด์นี้มีไว้สําหรับบัญชีที่ไม่ใช่ Google Ads เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu ฯลฯ สําหรับเอนทิตี Google Ads ให้ใช้ "adGroupCriterion.criterion_id" แทน
lastModifiedTime

string

วันที่และเวลาที่แก้ไขเกณฑ์กลุ่มโฆษณานี้ครั้งล่าสุด โดยค่าวันที่และเวลาจะอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" และอยู่ตามเขตเวลาของลูกค้า
criterionId

string (int64 format)

รหัสของเกณฑ์
adGroup

string

กลุ่มโฆษณาที่เกณฑ์อยู่
negative

boolean

กำหนดว่าจะกําหนดเป้าหมาย (false) หรือยกเว้น (true) เกณฑ์

ช่องนี้แก้ไขไม่ได้ หากต้องการเปลี่ยนเกณฑ์จากเชิงบวกเป็นเชิงลบ ให้นำเกณฑ์นั้นออกแล้วเพิ่มอีกครั้ง
bidModifier

number

ตัวปรับราคาเสนอเมื่อเกณฑ์ตรงกัน ตัวแก้ไขต้องอยู่ในช่วง 0.1 - 10.0 เกณฑ์ประเภทต่างๆ ที่กําหนดเป้าหมายได้ส่วนใหญ่รองรับตัวแก้ไข
cpcBidMicros

string (int64 format)

ราคาเสนอ CPC (ต้นทุนต่อคลิก)
effectiveCpcBidMicros

string (int64 format)

ราคาเสนอ CPC (ต้นทุนต่อคลิก) ที่มีประสิทธิภาพ
engineStatus

enum (AdGroupCriterionEngineStatus)

สถานะเครื่องมือค้นหาสําหรับเกณฑ์ของกลุ่มโฆษณา
finalUrlSuffix

string

เทมเพลต URL สําหรับต่อท้ายพารามิเตอร์ไปยัง URL สุดท้าย
trackingUrlTemplate

string

เทมเพลต URL สำหรับสร้าง URL ติดตาม

ฟิลด์สหภาพ criterion เกณฑ์ของกลุ่มโฆษณา

ต้องตั้งค่าเพียงรายการเดียว criterion ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
keyword

object (KeywordInfo)

คีย์เวิร์ด
listingGroup

object (ListingGroupInfo)

กลุ่มรายชื่อ
ageRange

object (AgeRangeInfo)

ช่วงอายุ
gender

object (GenderInfo)

เพศ
userList

object (UserListInfo)

รายชื่อผู้ใช้
webpage

object (WebpageInfo)

หน้าเว็บ
location

object (LocationInfo)

ตำแหน่ง

AdGroupCriterionStatus

สถานะที่เป็นไปได้ของ AdGroupCriterion

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED เกณฑ์ของกลุ่มโฆษณาเปิดใช้งานแล้ว
PAUSED เกณฑ์ของกลุ่มโฆษณาหยุดชั่วคราว
REMOVED ระบบจะนำเกณฑ์ของกลุ่มโฆษณาออก

QualityInfo

ที่เก็บข้อมูลคุณภาพของเกณฑ์กลุ่มโฆษณา

การแสดง JSON 
{
  "qualityScore": integer
}
ช่อง
qualityScore

integer

คะแนนคุณภาพ

ระบบอาจไม่ป้อนข้อมูลในช่องนี้หาก Google มีข้อมูลไม่เพียงพอที่จะระบุค่า

CriterionType

Enum ที่อธิบายประเภทเกณฑ์ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
KEYWORD คีย์เวิร์ด เช่น "เที่ยวชมดาวอังคาร"
PLACEMENT ตําแหน่งโฆษณาหรือที่เรียกว่าเว็บไซต์ เช่น "www.flowers4sale.com"
MOBILE_APP_CATEGORY หมวดหมู่แอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่จะกําหนดเป้าหมาย
MOBILE_APPLICATION แอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่จะกําหนดเป้าหมาย
DEVICE อุปกรณ์ที่จะกําหนดเป้าหมาย
LOCATION สถานที่ที่จะกําหนดเป้าหมาย
LISTING_GROUP กลุ่มรายชื่อที่จะกําหนดเป้าหมาย
AD_SCHEDULE ช่วงเวลาที่โฆษณาทำงาน
AGE_RANGE ช่วงอายุ
GENDER เพศ
INCOME_RANGE ช่วงรายได้
PARENTAL_STATUS สถานะความเป็นบิดามารดา
YOUTUBE_VIDEO วิดีโอ YouTube
YOUTUBE_CHANNEL ช่อง YouTube
USER_LIST รายชื่อผู้ใช้
PROXIMITY ระยะใกล้
TOPIC หัวข้อเป้าหมายในเครือข่าย Display (เช่น "สัตว์เลี้ยงและสัตว์")
LISTING_SCOPE ขอบเขตข้อมูลที่จะกําหนดเป้าหมาย
LANGUAGE ภาษา
IP_BLOCK IpBlock
CONTENT_LABEL ป้ายกำกับเนื้อหาสำหรับการยกเว้นหมวดหมู่
CARRIER ผู้ให้บริการ
USER_INTEREST หมวดหมู่ที่ผู้ใช้สนใจ
WEBPAGE เกณฑ์หน้าเว็บสําหรับโฆษณา Search แบบไดนามิก
OPERATING_SYSTEM_VERSION เวอร์ชันของระบบปฏิบัติการ
APP_PAYMENT_MODEL รูปแบบการชำระเงินสำหรับแอป
MOBILE_DEVICE อุปกรณ์เคลื่อนที่
CUSTOM_AFFINITY กลุ่มความสนใจที่กำหนดเอง
CUSTOM_INTENT ความตั้งใจที่กำหนดเอง
LOCATION_GROUP กลุ่มสถานที่ตั้ง
CUSTOM_AUDIENCE กลุ่มเป้าหมายที่กำหนดเอง
COMBINED_AUDIENCE กลุ่มเป้าหมายแบบรวม
KEYWORD_THEME ธีมคีย์เวิร์ดของ Smart Campaign
AUDIENCE ผู้ชม
LOCAL_SERVICE_ID รหัสบริการของโฆษณาบริการในพื้นที่
BRAND แบรนด์
BRAND_LIST รายการแบรนด์
LIFE_EVENT เหตุการณ์สำคัญในชีวิต

PositionEstimates

ค่าประมาณสำหรับราคาเสนอตามเกณฑ์ในตําแหน่งต่างๆ

การแสดง JSON 
{
  "topOfPageCpcMicros": string
}
ช่อง
topOfPageCpcMicros

string (int64 format)

ค่าประมาณราคาเสนอ CPC ที่จําเป็นสําหรับการแสดงโฆษณาที่ด้านบนของหน้าแรกของผลการค้นหา

AdGroupCriterionEngineStatus

แสดงสถานะการทำงานของเครื่องมือ AdGroupCriterion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AD_GROUP_CRITERION_ELIGIBLE

เลิกใช้งานแล้ว โปรดอย่าใช้
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: ราคาเสนอหรือคุณภาพต่ำเกินไปที่จะแสดง
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: หยุดชั่วคราวโดย Baidu เนื่องจากมีปริมาณการค้นหาต่ำ
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: URL อุปกรณ์เคลื่อนที่อยู่ระหว่างการตรวจสอบ
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: หน้า Landing Page สําหรับอุปกรณ์หนึ่งไม่ถูกต้อง ขณะที่หน้า Landing Page สําหรับอุปกรณ์อีกเครื่องหนึ่งถูกต้อง
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: การจัดการบัญชี Baidu ได้สร้างและหยุดคีย์เวิร์ดไว้ชั่วคราวแล้ว ตอนนี้คุณพร้อมที่จะเปิดใช้งานคีย์เวิร์ดแล้ว
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: อยู่ระหว่างการตรวจสอบโดย Baidu Gemini: เกณฑ์อยู่ระหว่างตรวจสอบ
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: เกณฑ์ที่จะตรวจสอบ
AD_GROUP_CRITERION_ON_HOLD

เลิกใช้งานแล้ว โปรดอย่าใช้ เคยใช้โดย Gemini
AD_GROUP_CRITERION_PENDING_REVIEW Y!J : เกณฑ์รอการตรวจสอบ
AD_GROUP_CRITERION_PAUSED เกณฑ์หยุดชั่วคราวแล้ว
AD_GROUP_CRITERION_REMOVED นําเกณฑ์ออกแล้ว
AD_GROUP_CRITERION_APPROVED เกณฑ์ได้รับอนุมัติแล้ว
AD_GROUP_CRITERION_DISAPPROVED เกณฑ์ไม่ได้รับอนุมัติ
AD_GROUP_CRITERION_SERVING เกณฑ์ทํางานอยู่และแสดงอยู่
AD_GROUP_CRITERION_ACCOUNT_PAUSED เกณฑ์ถูกหยุดชั่วคราวเนื่องจากบัญชีหยุดชั่วคราว

KeywordInfo

เกณฑ์คีย์เวิร์ด

การแสดง JSON 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
ช่อง
matchType

enum (KeywordMatchType)

ประเภทการทำงานของคีย์เวิร์ด
text

string

ข้อความของคีย์เวิร์ด (ไม่เกิน 80 อักขระและ 10 คำ)

KeywordMatchType

ประเภทการทำงานของคีย์เวิร์ดที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
EXACT การทำงานแบบตรงทั้งหมด
PHRASE การทำงานแบบวลี
BROAD การทํางานแบบกว้าง

ListingGroupInfo

เกณฑ์กลุ่มรายชื่อ

การแสดง JSON 
{
  "type": enum (ListingGroupType)
}
ช่อง
type

enum (ListingGroupType)

ประเภทของกลุ่มข้อมูล

ListingGroupType

ประเภทของกลุ่มข้อมูล

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SUBDIVISION การแบ่งผลิตภัณฑ์ตามมิติข้อมูลข้อมูลผลิตภัณฑ์ที่แสดงบางรายการ โหนดเหล่านี้ไม่ได้ใช้เพื่อแสดงเพื่อกําหนดเป้าหมายรายการ แต่ใช้เพื่อกําหนดโครงสร้างของต้นไม้เท่านั้น
UNIT หน่วยกลุ่มข้อมูลซึ่งกำหนดราคาเสนอ

AgeRangeInfo

เกณฑ์ช่วงอายุ

การแสดง JSON 
{
  "type": enum (AgeRangeType)
}
ช่อง
type

enum (AgeRangeType)

ประเภทของช่วงอายุ

AgeRangeType

ประเภทของช่วงอายุตามข้อมูลประชากร (เช่น 18-24 ปี)

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AGE_RANGE_18_24 มีอายุระหว่าง 18 ถึง 24 ปี
AGE_RANGE_25_34 มีอายุระหว่าง 25 ถึง 34 ปี
AGE_RANGE_35_44 มีอายุระหว่าง 35 ถึง 44 ปี
AGE_RANGE_45_54 มีอายุระหว่าง 45 ถึง 54 ปี
AGE_RANGE_55_64 มีอายุระหว่าง 55 ถึง 64 ปี
AGE_RANGE_65_UP มีอายุ 65 ปีขึ้นไป
AGE_RANGE_UNDETERMINED ช่วงอายุที่ไม่ระบุ

GenderInfo

เกณฑ์เพศ

การแสดง JSON 
{
  "type": enum (GenderType)
}
ช่อง
type

enum (GenderType)

ประเภทของเพศ

GenderType

ประเภทเพศตามข้อมูลประชากร (เช่น หญิง)

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
MALE ชาย
FEMALE เพศหญิง
UNDETERMINED ไม่กำหนดเพศ

UserListInfo

เกณฑ์รายชื่อผู้ใช้ แสดงรายการผู้ใช้ที่ผู้ลงโฆษณากําหนดให้กําหนดเป้าหมาย

การแสดง JSON 
{
  "userList": string
}
ช่อง
userList

string

ชื่อแหล่งข้อมูลรายการผู้ใช้

WebpageInfo

แสดงถึงเกณฑ์สําหรับกําหนดเป้าหมายหน้าเว็บของเว็บไซต์ผู้ลงโฆษณา

การแสดง JSON 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
ช่อง
conditions[]

object (WebpageConditionInfo)

เงื่อนไขหรือนิพจน์เชิงตรรกะสําหรับการกําหนดเป้าหมายหน้าเว็บ ระบบจะรวมรายการเงื่อนไขการกําหนดเป้าหมายหน้าเว็บเข้าด้วยกันเมื่อประเมินการกําหนดเป้าหมาย รายการเงื่อนไขที่ว่างเปล่าบ่งบอกว่ามีการกําหนดเป้าหมายทุกหน้าของเว็บไซต์ของแคมเปญ

ฟิลด์นี้ต้องระบุสำหรับการดำเนินการ CREATE และไม่ได้รับอนุญาตในการดำเนินการ UPDATE
coveragePercentage

number

เปอร์เซ็นต์ความครอบคลุมของเกณฑ์เว็บไซต์ เปอร์เซ็นต์นี้คํานวณจากความครอบคลุมเว็บไซต์ตามเป้าหมายเว็บไซต์ เป้าหมายเว็บไซต์เชิงลบ และคีย์เวิร์ดเชิงลบในกลุ่มโฆษณาและแคมเปญ เช่น เมื่อการครอบคลุมแสดงผลเป็น 1 แสดงว่ามีการครอบคลุม 100% ช่องนี้เป็นแบบอ่านอย่างเดียว
criterionName

string

ชื่อของเกณฑ์ที่กําหนดโดยพารามิเตอร์นี้ ระบบจะใช้ค่าชื่อเพื่อระบุ จัดเรียง และกรองเกณฑ์ด้วยพารามิเตอร์ประเภทนี้

ฟิลด์นี้ต้องระบุสำหรับการดำเนินการ CREATE และไม่ได้รับอนุญาตในการดำเนินการ UPDATE

WebpageConditionInfo

นิพจน์เชิงตรรกะสําหรับกําหนดเป้าหมายหน้าเว็บของเว็บไซต์ผู้ลงโฆษณา

การแสดง JSON 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
ช่อง
operand

enum (WebpageConditionOperand)

ออบเจ็กต์ของเงื่อนไขการกําหนดเป้าหมายหน้าเว็บ
operator

enum (WebpageConditionOperator)

โอเปอเรเตอร์ของเงื่อนไขการกําหนดเป้าหมายหน้าเว็บ
argument

string

อาร์กิวเมนต์ของเงื่อนไขการกําหนดเป้าหมายหน้าเว็บ

WebpageConditionOperand

ออบเจ็กต์เงื่อนไขหน้าเว็บในเกณฑ์หน้าเว็บ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
URL ออบเจ็กต์ที่แสดงถึงเงื่อนไขการกําหนดเป้าหมาย URL ของหน้าเว็บ
CATEGORY ออบเจ็กต์ที่แสดงถึงเงื่อนไขการกําหนดเป้าหมายหมวดหมู่หน้าเว็บ
PAGE_TITLE ออบเจ็กต์ที่ระบุเงื่อนไขการกําหนดเป้าหมายชื่อหน้าเว็บ
PAGE_CONTENT ออบเจ็กต์ที่ระบุเงื่อนไขการกําหนดเป้าหมายตามเนื้อหาของหน้าเว็บ
CUSTOM_LABEL ออบเจ็กต์ที่แสดงถึงเงื่อนไขการกําหนดเป้าหมายป้ายกํากับที่กําหนดเองของหน้าเว็บ

WebpageConditionOperator

โอเปอเรเตอร์เงื่อนไขหน้าเว็บในเกณฑ์หน้าเว็บ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
EQUALS เงื่อนไขเว็บของอาร์กิวเมนต์เท่ากับเงื่อนไขเว็บที่เปรียบเทียบ
CONTAINS เงื่อนไขเว็บของอาร์กิวเมนต์เป็นส่วนหนึ่งของเงื่อนไขเว็บที่เปรียบเทียบ

LocationInfo

เกณฑ์สถานที่ตั้ง

การแสดง JSON 
{
  "geoTargetConstant": string
}
ช่อง
geoTargetConstant

string

ชื่อทรัพยากรคงที่ของเป้าหมายตามภูมิศาสตร์

AdGroupCriterionEffectiveLabel

ความสัมพันธ์ระหว่างเกณฑ์ของกลุ่มโฆษณากับป้ายกำกับที่มีประสิทธิภาพ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับค่ามาหรือกำหนดให้กับเกณฑ์กลุ่มโฆษณานี้โดยตรง

การแสดง JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของป้ายกำกับที่มีประสิทธิภาพของเกณฑ์กลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับที่มีประสิทธิภาพของเกณฑ์กลุ่มโฆษณามีรูปแบบดังนี้ customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

เกณฑ์ของกลุ่มโฆษณาที่ติดป้ายกำกับที่มีประสิทธิภาพ
label

string

ป้ายกำกับที่มีประสิทธิภาพซึ่งกำหนดให้กับเกณฑ์ของกลุ่มโฆษณา
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับที่มีผล

AdGroupCriterionLabel

ความสัมพันธ์ระหว่างเกณฑ์ของกลุ่มโฆษณากับป้ายกํากับ

การแสดง JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของป้ายกํากับเกณฑ์กลุ่มโฆษณา ชื่อทรัพยากรป้ายกํากับของกลุ่มโฆษณาอยู่ในรูปแบบ customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

เกณฑ์ของกลุ่มโฆษณาที่ติดป้ายกำกับ
label

string

ป้ายกํากับที่กําหนดให้กับเกณฑ์ของกลุ่มโฆษณา
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับ

AdGroupEffectiveLabel

ความสัมพันธ์ระหว่างกลุ่มโฆษณากับป้ายกำกับที่มีประสิทธิภาพ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับค่ามาหรือกำหนดให้กับกลุ่มโฆษณานี้โดยตรง

การแสดง JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของป้ายกำกับกลุ่มโฆษณาที่มีประสิทธิภาพ ชื่อแหล่งข้อมูลป้ายกํากับที่มีประสิทธิภาพของกลุ่มโฆษณาอยู่ในรูปแบบ customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
adGroup

string

กลุ่มโฆษณาที่ติดป้ายกำกับที่มีประสิทธิภาพ
label

string

ป้ายกำกับที่มีประสิทธิภาพซึ่งกำหนดให้กับกลุ่มโฆษณา
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับที่มีผล

AdGroupLabel

ความสัมพันธ์ระหว่างกลุ่มโฆษณากับป้ายกำกับ

การแสดง JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของป้ายกํากับกลุ่มโฆษณา ชื่อทรัพยากรป้ายกํากับกลุ่มโฆษณาอยู่ในรูปแบบ customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}
adGroup

string

กลุ่มโฆษณาที่ติดป้ายกํากับ
label

string

ป้ายกํากับที่กำหนดให้กับกลุ่มโฆษณา
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับ

AgeRangeView

มุมมองช่วงอายุ

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองช่วงอายุ ชื่อทรัพยากรของมุมมองช่วงอายุมีรูปแบบดังนี้

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

ชิ้นงาน

ชิ้นงานคือส่วนหนึ่งของโฆษณาที่แชร์ในโฆษณาหลายรายการได้ อาจเป็นรูปภาพ (ImageAsset), วิดีโอ (YoutubeVideoAsset) ฯลฯ ชิ้นงานจะเปลี่ยนแปลงไม่ได้และนำออกไม่ได้ หากต้องการหยุดไม่ให้ชิ้นงานแสดง ให้นําชิ้นงานออกจากเอนทิตีที่ใช้ชิ้นงานนั้น

การแสดง JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
ช่อง
resourceName

string

ชื่อทรัพยากรของเนื้อหา ชื่อทรัพยากรของชิ้นงานอยู่ในรูปแบบต่อไปนี้

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

ประเภทของชิ้นงาน
finalUrls[]

string

รายการ URL สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
status

enum (AssetStatus)

สถานะของเนื้อหา
creationTime

string

การประทับเวลาที่สร้างเนื้อหานี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss"
lastModifiedTime

string

วันที่และเวลาที่แก้ไขเนื้อหานี้ครั้งล่าสุด โดยค่าวันที่และเวลาจะอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" และอยู่ตามเขตเวลาของลูกค้า
id

string (int64 format)

รหัสเนื้อหา
name

string

ชื่อชิ้นงาน (ไม่บังคับ)
trackingUrlTemplate

string

เทมเพลต URL สำหรับสร้าง URL ติดตาม
engineStatus

enum (AssetEngineStatus)

สถานะเครื่องมือของชิ้นงาน
ฟิลด์สหภาพ asset_data ประเภทที่เฉพาะเจาะจงของชิ้นงาน asset_data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
youtubeVideoAsset

object (YoutubeVideoAsset)

ชิ้นงานวิดีโอ YouTube
imageAsset

object (ImageAsset)

ชิ้นงานรูปภาพ
textAsset

object (TextAsset)

ชิ้นงานข้อความ
calloutAsset

object (UnifiedCalloutAsset)

ชิ้นงานข้อความไฮไลต์แบบรวม
pageFeedAsset

object (UnifiedPageFeedAsset)

ชิ้นงานฟีดหน้าเว็บแบบรวม
mobileAppAsset

object (MobileAppAsset)

ชิ้นงานแอปบนอุปกรณ์เคลื่อนที่
callAsset

object (UnifiedCallAsset)

ชิ้นงานการโทรแบบรวม
callToActionAsset

object (CallToActionAsset)

ชิ้นงานคำกระตุ้นให้ดำเนินการ
locationAsset

object (UnifiedLocationAsset)

ชิ้นงานสถานที่ตั้งแบบรวม

AssetType

Enum ที่อธิบายประเภทเนื้อหาที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
YOUTUBE_VIDEO ชิ้นงานวิดีโอ YouTube
MEDIA_BUNDLE ชิ้นงานไฟล์ครีเอทีฟโฆษณา
IMAGE ชิ้นงานรูปภาพ
TEXT ชิ้นงานข้อความ
LEAD_FORM ชิ้นงานโฆษณาแบบกรอกฟอร์ม
BOOK_ON_GOOGLE ชิ้นงาน "จองใน Google"
PROMOTION ชิ้นงานโปรโมชัน
CALLOUT ชิ้นงานข้อความไฮไลต์
STRUCTURED_SNIPPET ชิ้นงานข้อมูลเพิ่มเติม
PAGE_FEED ชิ้นงานฟีดหน้าเว็บ
DYNAMIC_EDUCATION ชิ้นงานการศึกษาแบบไดนามิก
MOBILE_APP ชิ้นงานแอปบนอุปกรณ์เคลื่อนที่
HOTEL_CALLOUT ชิ้นงานข้อความไฮไลต์สำหรับโรงแรม
CALL ชิ้นงานการโทร
PRICE ชิ้นงานราคา
CALL_TO_ACTION ชิ้นงานคำกระตุ้นให้ดำเนินการ
DYNAMIC_REAL_ESTATE ชิ้นงานอสังหาริมทรัพย์แบบไดนามิก
DYNAMIC_CUSTOM ชิ้นงานที่กําหนดเองแบบไดนามิก
DYNAMIC_HOTELS_AND_RENTALS ชิ้นงานแบบไดนามิกเกี่ยวกับโรงแรมและที่พักให้เช่า
DYNAMIC_FLIGHTS ชิ้นงานเที่ยวบินแบบไดนามิก
DYNAMIC_TRAVEL ชิ้นงานการเดินทางแบบไดนามิก
DYNAMIC_LOCAL ชิ้นงานในเครื่องแบบไดนามิก
DYNAMIC_JOBS ชิ้นงานสำหรับงานแบบไดนามิก
LOCATION ชิ้นงานสถานที่ตั้ง
HOTEL_PROPERTY ชิ้นงานของโรงแรม

AssetStatus

สถานะที่เป็นไปได้ของเนื้อหา

Enum
UNSPECIFIED ไม่ได้ระบุสถานะ
UNKNOWN ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้ ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED ชิ้นงานเปิดใช้งานแล้ว
REMOVED ระบบจะนำชิ้นงานออก
ARCHIVED ชิ้นงานได้รับการเก็บถาวรแล้ว
PENDING_SYSTEM_GENERATED ชิ้นงานเป็นชิ้นงานที่ระบบสร้างขึ้นและรอการตรวจสอบของผู้ใช้

AssetEngineStatus

รหัสถัดไป = 11

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SERVING ชิ้นงานทํางานอยู่
SERVING_LIMITED ชิ้นงานมีการใช้งานแบบจํากัด
DISAPPROVED ชิ้นงานไม่ได้รับอนุมัติ (ไม่มีสิทธิ์)
DISABLED ชิ้นงานไม่มีการใช้งาน (รอดำเนินการ)
REMOVED นําชิ้นงานออกแล้ว

YoutubeVideoAsset

เนื้อหา YouTube

การแสดง JSON 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
ช่อง
youtubeVideoTitle

string

ชื่อวิดีโอ YouTube
youtubeVideoId

string

รหัสวิดีโอ YouTube ค่านี้เป็นสตริง 11 อักขระที่ใช้ใน URL ของวิดีโอ YouTube

ImageAsset

ชิ้นงานรูปภาพ

การแสดง JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
ช่อง
mimeType

enum (MimeType)

ประเภท MIME ของชิ้นงานรูปภาพ
fullSize

object (ImageDimension)

ข้อมูลเมตาของรูปภาพนี้ในขนาดเดิม
fileSize

string (int64 format)

ขนาดไฟล์ของชิ้นงานรูปภาพเป็นไบต์

MimeType

ประเภท MIME

Enum
UNSPECIFIED ไม่ได้ระบุประเภท MIME
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
IMAGE_JPEG ประเภท MIME ของ image/jpeg
IMAGE_GIF ประเภท MIME ของ image/gif
IMAGE_PNG ประเภท MIME ของรูปภาพ/png
FLASH ประเภท MIME ของ application/x-shockwave-flash
TEXT_HTML ประเภท MIME ของ text/html
PDF ประเภท MIME ของ application/pdf
MSWORD ประเภท MIME ของ application/msword
MSEXCEL ประเภท MIME ของ application/vnd.ms-excel
RTF ประเภท MIME ของ application/rtf
AUDIO_WAV ประเภท MIME ของ audio/wav
AUDIO_MP3 ประเภท MIME ของ audio/mp3
HTML5_AD_ZIP ประเภท MIME ของ application/x-html5-ad-zip

ImageDimension

ข้อมูลเมตาของรูปภาพขนาดหนึ่งๆ ไม่ว่าจะเป็นขนาดเดิมหรือปรับขนาดแล้ว

การแสดง JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
ช่อง
heightPixels

string (int64 format)

ความสูงของรูปภาพ
widthPixels

string (int64 format)

ความกว้างของรูปภาพ
url

string

URL ที่แสดงผลรูปภาพที่มีความสูงและความกว้างนี้

TextAsset

ชิ้นงานข้อความ

การแสดง JSON 
{
  "text": string
}
ช่อง
text

string

เนื้อหาข้อความของชิ้นงานข้อความ

UnifiedCalloutAsset

ชิ้นงานข้อความไฮไลต์แบบรวม

การแสดง JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
ช่อง
calloutText

string

ข้อความไฮไลต์ ความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 25 อักขระ
startDate

string

วันที่เริ่มต้นที่ชิ้นงานนี้มีผลและสามารถเริ่มแสดงในรูปแบบ yyyy-MM-dd
endDate

string

วันที่สุดท้ายที่ชิ้นงานนี้มีผลและยังแสดงอยู่ในรูปแบบ yyyy-MM-dd
adScheduleTargets[]

object (AdScheduleInfo)

รายการกําหนดเวลาที่ไม่ซ้อนทับกันซึ่งระบุช่วงเวลาทั้งหมดที่ชิ้นงานอาจแสดง โดยจะมีกำหนดการได้สูงสุด 6 รายการต่อวัน รวมเป็น 42 รายการ
useSearcherTimeZone

boolean

แสดงชิ้นงานในเขตเวลาของผู้ใช้การค้นหาหรือไม่ ใช้กับ Microsoft Ads

AdScheduleInfo

แสดงถึงเกณฑ์ AdSchedule

AdSchedule จะระบุเป็นวันของสัปดาห์และช่วงเวลาที่โฆษณาจะแสดง

คุณจะเพิ่ม AdSchedule ในวันเดียวกันได้ไม่เกิน 6 รายการ

การแสดง JSON 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
ช่อง
startMinute

enum (MinuteOfHour)

นาทีหลังจากชั่วโมงเริ่มต้นที่กําหนดการนี้เริ่มทํางาน

ฟิลด์นี้ต้องระบุสำหรับการดำเนินการ CREATE และไม่ได้รับอนุญาตในการดำเนินการ UPDATE
endMinute

enum (MinuteOfHour)

นาทีหลังจากเวลาสิ้นสุดที่กำหนดการนี้ โดยจะไม่รวมนาทีสุดท้าย

ฟิลด์นี้ต้องระบุสำหรับการดำเนินการ CREATE และไม่ได้รับอนุญาตในการดำเนินการ UPDATE
dayOfWeek

enum (DayOfWeek)

วันในสัปดาห์ที่กําหนดเวลามีผล

ฟิลด์นี้ต้องระบุสำหรับการดำเนินการ CREATE และไม่ได้รับอนุญาตในการดำเนินการ UPDATE
startHour

integer

เวลาเริ่มต้นในรูปแบบ 24 ชั่วโมง ฟิลด์นี้ต้องอยู่ระหว่าง 0 ถึง 23

ฟิลด์นี้ต้องระบุสำหรับการดำเนินการ CREATE และไม่ได้รับอนุญาตในการดำเนินการ UPDATE
endHour

integer

เวลาสิ้นสุดในรูปแบบ 24 ชั่วโมง โดย 24 หมายถึงสิ้นสุดของวัน ฟิลด์นี้ต้องอยู่ระหว่าง 0 ถึง 24 เท่านั้น

ฟิลด์นี้ต้องระบุสำหรับการดำเนินการ CREATE และไม่ได้รับอนุญาตในการดำเนินการ UPDATE

MinuteOfHour

แสดงรายการของช่วง 15 นาที เช่น "FIFTEEN"

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
ZERO 0 นาทีหลังจากผ่านไป 1 ชั่วโมง
FIFTEEN 15 นาทีหลังจากชั่วโมง
THIRTY 30 นาทีหลังจากเวลาเต็มชั่วโมง
FORTY_FIVE 45 นาทีหลังจากเริ่มชั่วโมง

วันของสัปดาห์

แสดงรายการวันในสัปดาห์ เช่น "วันจันทร์"

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
MONDAY วันจันทร์
TUESDAY วันอังคาร
WEDNESDAY วันพุธ
THURSDAY วันพฤหัสบดี
FRIDAY วันศุกร์
SATURDAY วันเสาร์
SUNDAY วันอาทิตย์

UnifiedSitelinkAsset

ชิ้นงานไซต์ลิงก์แบบรวม

การแสดง JSON 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
ช่อง
linkText

string

ข้อความที่แสดงของ URL สําหรับไซต์ลิงก์ ความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 25 อักขระ
description1

string

บรรทัดแรกของคําอธิบายสําหรับไซต์ลิงก์ หากตั้งค่าไว้ ความยาวควรอยู่ระหว่าง 1 ถึง 35 อักขระ และจะต้องตั้งค่า description2 ด้วย
description2

string

บรรทัดที่สองของคำอธิบายไซต์ลิงก์ หากตั้งค่าไว้ ความยาวควรอยู่ระหว่าง 1 ถึง 35 อักขระ และจะต้องตั้งค่า description1 ด้วย
startDate

string

วันที่เริ่มต้นที่ชิ้นงานนี้มีผลและสามารถเริ่มแสดงในรูปแบบ yyyy-MM-dd
endDate

string

วันที่สุดท้ายที่ชิ้นงานนี้มีผลและยังแสดงอยู่ในรูปแบบ yyyy-MM-dd
adScheduleTargets[]

object (AdScheduleInfo)

รายการกําหนดเวลาที่ไม่ซ้อนทับกันซึ่งระบุช่วงเวลาทั้งหมดที่ชิ้นงานอาจแสดง โดยจะมีกำหนดการได้สูงสุด 6 รายการต่อวัน รวมเป็น 42 รายการ
trackingId

string (int64 format)

รหัสที่ใช้ติดตามการคลิกสําหรับชิ้นงานไซต์ลิงก์ นี่คือ Yahoo! ช่องญี่ปุ่นเท่านั้น
useSearcherTimeZone

boolean

แสดงชิ้นงานไซต์ลิงก์ในเขตเวลาของผู้ใช้ที่ค้นหาหรือไม่ ใช้กับ Microsoft Ads
mobilePreferred

boolean

ค่ากําหนดสำหรับชิ้นงานไซต์ลิงก์ที่จะแสดงบนอุปกรณ์เคลื่อนที่หรือไม่ ใช้กับ Microsoft Ads

UnifiedPageFeedAsset

ชิ้นงานฟีดหน้าเว็บแบบรวม

การแสดง JSON 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
ช่อง
pageUrl

string

หน้าเว็บที่ผู้ลงโฆษณาต้องการกําหนดเป้าหมาย
labels[]

string

ป้ายกำกับที่ใช้จัดกลุ่ม URL ของหน้าเว็บ

MobileAppAsset

ชิ้นงานที่แสดงถึงแอปบนอุปกรณ์เคลื่อนที่

การแสดง JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
ช่อง
appId

string

ต้องระบุ สตริงที่ระบุแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ไม่ซ้ำกัน รหัสดังกล่าวควรมีเพียงรหัสเนทีฟของแพลตฟอร์ม เช่น "com.android.ebay" สำหรับ Android หรือ "12345689" สำหรับ iOS
appStore

enum (MobileAppVendor)

ต้องระบุ Store ของแอปพลิเคชันที่เผยแพร่แอปนี้

MobileAppVendor

ประเภทของผู้ให้บริการแอปบนอุปกรณ์เคลื่อนที่

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
APPLE_APP_STORE ผู้ให้บริการแอปบนอุปกรณ์เคลื่อนที่สําหรับ App Store ของ Apple
GOOGLE_APP_STORE ผู้ให้บริการแอปบนอุปกรณ์เคลื่อนที่สําหรับ Google App Store

UnifiedCallAsset

ชิ้นงานการโทรแบบรวม

การแสดง JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
ช่อง
countryCode

string

รหัสประเทศ 2 ตัวอักษรของหมายเลขโทรศัพท์ เช่น 'US', 'us'
phoneNumber

string

หมายเลขโทรศัพท์ดิบของผู้ลงโฆษณา ตัวอย่าง: "1234567890", "(123)456-7890"
callConversionReportingState

enum (CallConversionReportingState)

ระบุว่า CallAsset นี้ควรใช้การตั้งค่า Conversion การโทรของตัวเอง เป็นไปตามการตั้งค่าระดับบัญชี หรือปิดใช้ Conversion การโทร
callConversionAction

string

การกระทําที่ถือเป็น Conversion ที่จะระบุแหล่งที่มาของ Conversion การโทร หากไม่ได้ตั้งค่า ระบบจะใช้การกระทําที่ถือเป็น Conversion เริ่มต้น ช่องนี้จะมีผลเฉพาะในกรณีที่ตั้งค่า callConversionReportingState เป็น USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION
adScheduleTargets[]

object (AdScheduleInfo)

รายการกําหนดเวลาที่ไม่ซ้อนทับกันซึ่งระบุช่วงเวลาทั้งหมดที่ชิ้นงานอาจแสดง โดยจะมีกำหนดการได้สูงสุด 6 รายการต่อวัน รวมเป็น 42 รายการ
callOnly

boolean

โฆษณาแบบโทรออกเท่านั้นแสดงเฉพาะหมายเลขโทรศัพท์โดยไม่มีลิงก์ไปยังเว็บไซต์หรือไม่ ใช้กับ Microsoft Ads
callTrackingEnabled

boolean

ควรเปิดใช้การโทรในการติดตามการโทรหรือไม่ ใช้กับ Microsoft Ads
useSearcherTimeZone

boolean

แสดงชิ้นงานการโทรในเขตเวลาของผู้ใช้การค้นหาหรือไม่ ใช้กับ Microsoft Ads
startDate

string

วันที่เริ่มต้นที่ชิ้นงานนี้มีผลและสามารถเริ่มแสดงในรูปแบบ yyyy-MM-dd
endDate

string

วันที่สุดท้ายที่ชิ้นงานนี้มีผลและยังแสดงอยู่ในรูปแบบ yyyy-MM-dd

CallConversionReportingState

ประเภทข้อมูลที่เป็นไปได้สำหรับสถานะการกระทําที่ถือเป็น Conversion การโทร

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DISABLED การกระทำที่ถือเป็น Conversion การโทรปิดอยู่
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION การกระทําที่ถือเป็น Conversion การโทรจะใช้ประเภท Conversion การโทรที่ตั้งไว้ที่ระดับบัญชี
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION การกระทําที่ถือเป็น Conversion การโทรจะใช้ประเภท Conversion การโทรที่ตั้งไว้ที่ระดับทรัพยากร (โฆษณาแบบโทรออกเท่านั้น/ส่วนขยายการโทร)

CallToActionAsset

ชิ้นงานคำกระตุ้นให้ดำเนินการ

การแสดง JSON 
{
  "callToAction": enum (CallToActionType)
}
ช่อง
callToAction

enum (CallToActionType)

คำกระตุ้นให้ดำเนินการ

CallToActionType

Enum ที่อธิบายประเภทคำกระตุ้นให้ดำเนินการที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
LEARN_MORE ประเภทคำกระตุ้นให้ดำเนินการคือดูข้อมูลเพิ่มเติม
GET_QUOTE ประเภทคำกระตุ้นให้ดำเนินการคือ "ขอใบเสนอราคา"
APPLY_NOW ประเภทคำกระตุ้นให้ดำเนินการคือสมัครเลย
SIGN_UP ประเภทคำกระตุ้นให้ดำเนินการคือลงชื่อสมัครใช้
CONTACT_US ประเภทคำกระตุ้นให้ดำเนินการคือ "ติดต่อเรา"
SUBSCRIBE ประเภทคำกระตุ้นให้ดำเนินการคือ "สมัคร"
DOWNLOAD ประเภทคำกระตุ้นให้ดำเนินการคือ "ดาวน์โหลด"
BOOK_NOW ประเภทคำกระตุ้นให้ดำเนินการคือ "จองเลย"
SHOP_NOW ประเภทคำกระตุ้นให้ดำเนินการคือ "เลือกซื้อเลย"
BUY_NOW ประเภทคำกระตุ้นให้ดำเนินการคือซื้อเลย
DONATE_NOW ประเภทคำกระตุ้นให้ดำเนินการคือ "บริจาคเลย"
ORDER_NOW ประเภทคำกระตุ้นให้ดำเนินการคือสั่งซื้อเลย
PLAY_NOW ประเภทคำกระตุ้นให้ดำเนินการคือ "เล่นเลย"
SEE_MORE ประเภทคำกระตุ้นให้ดำเนินการคือดูเพิ่มเติม
START_NOW ประเภทคำกระตุ้นให้ดำเนินการคือ "เริ่มเลย"
VISIT_SITE ประเภทคำกระตุ้นให้ดำเนินการคือเข้าชมเว็บไซต์
WATCH_NOW ประเภทคำกระตุ้นให้ดำเนินการคือ "ดูเลย"

UnifiedLocationAsset

ชิ้นงานสถานที่ตั้งแบบรวม

การแสดง JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
ช่อง
placeId

string

รหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน ฟิลด์นี้ไม่ซ้ำกันสำหรับรหัสลูกค้าและประเภทเนื้อหาที่ระบุ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ https://developers.google.com/places/web-service/place-id
businessProfileLocations[]

object (BusinessProfileLocation)

รายชื่อสถานที่ตั้งธุรกิจของลูกค้า ระบบจะแสดงผลเฉพาะในกรณีที่ชิ้นงานสถานที่ตั้งกำลังซิงค์จากบัญชี Business Profile คุณมีข้อมูล Business Profile หลายรายการในบัญชีเดียวกันซึ่งชี้ไปยังรหัสสถานที่เดียวกันได้
locationOwnershipType

enum (LocationOwnershipType)

ประเภทการเป็นเจ้าของสถานที่ตั้ง หากประเภทคือ BUSINESS_OWNER ระบบจะแสดงเป็นชิ้นงานสถานที่ตั้ง หากประเภทคือ AFFILIATE ระบบจะแสดงเป็นสถานที่ตั้งของแอฟฟิลิเอต

BusinessProfileLocation

ข้อมูลตำแหน่ง Business Profile ที่ซิงค์จากบัญชี Business Profile ที่ลิงก์

การแสดง JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
ช่อง
labels[]

string

ป้ายกำกับที่ระบุโดยผู้ลงโฆษณาสำหรับสถานที่ตั้งในบัญชี Business Profile ซึ่งข้อมูลนี้ซิงค์มาจากบัญชี Business Profile
storeCode

string

รหัสร้านค้า Business Profile ของสถานที่ตั้งนี้ ซึ่งข้อมูลนี้ซิงค์มาจากบัญชี Business Profile
listingId

string (int64 format)

รหัสข้อมูลของสถานที่ตั้ง Business Profile นี้ ซึ่งข้อมูลนี้ซิงค์มาจากบัญชี Business Profile ที่ลิงก์

LocationOwnershipType

ประเภทการเป็นเจ้าของสถานที่ตั้งที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BUSINESS_OWNER เจ้าของธุรกิจของสถานที่ตั้ง(ชิ้นงานสถานที่ตั้งเดิม - LE)
AFFILIATE สถานที่ตั้งของแอฟฟิลิเอต(ชิ้นงานสถานที่ตั้งของบุคคลที่สาม - ALE)

AssetGroupAsset

AssetGroupAsset คือลิงก์ระหว่างชิ้นงานกับกลุ่มชิ้นงาน การเพิ่ม AssetGroupAsset จะลิงก์ชิ้นงานกับกลุ่มชิ้นงาน

การแสดง JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
ช่อง
resourceName

string

ชื่อทรัพยากรของชิ้นงานกลุ่มชิ้นงาน ชื่อทรัพยากรชิ้นงานของกลุ่มชิ้นงานมีรูปแบบดังนี้

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}
assetGroup

string

กลุ่มชิ้นงานที่ชิ้นงานกลุ่มชิ้นงานนี้ลิงก์อยู่
asset

string

ชิ้นงานที่กลุ่มชิ้นงานนี้ลิงก์อยู่
fieldType

enum (AssetFieldType)

คําอธิบายตําแหน่งชิ้นงานภายในกลุ่มชิ้นงาน เช่น HEADLINE, YOUTUBE_VIDEO ฯลฯ
status

enum (AssetLinkStatus)

สถานะของการลิงก์ระหว่างชิ้นงานกับกลุ่มชิ้นงาน

AssetFieldType

Enum ที่อธิบายตําแหน่งโฆษณาที่เป็นไปได้ของชิ้นงาน

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
HEADLINE ชิ้นงานลิงก์ไว้เพื่อใช้เป็นบรรทัดแรก
DESCRIPTION ชิ้นงานลิงก์ไว้เพื่อใช้เป็นคำอธิบาย
MANDATORY_AD_TEXT ชิ้นงานลิงก์ไว้เพื่อใช้เป็นข้อความโฆษณาบังคับ
MARKETING_IMAGE ชิ้นงานลิงก์ไว้เพื่อใช้เป็นรูปภาพการตลาด
MEDIA_BUNDLE ชิ้นงานลิงก์ไว้เพื่อใช้เป็นไฟล์ครีเอทีฟโฆษณา
YOUTUBE_VIDEO เนื้อหาลิงก์ไว้เพื่อใช้เป็นวิดีโอ YouTube
BOOK_ON_GOOGLE ชิ้นงานจะลิงก์เพื่อระบุว่าแคมเปญโรงแรมเปิดใช้ "จองใน Google"
LEAD_FORM ชิ้นงานจะลิงก์เพื่อใช้เป็นชิ้นงานโฆษณาแบบกรอกฟอร์ม
PROMOTION ชิ้นงานลิงก์ไว้เพื่อใช้เป็นชิ้นงานโปรโมชัน
CALLOUT ชิ้นงานลิงก์ไว้เพื่อใช้เป็นชิ้นงานข้อความไฮไลต์
STRUCTURED_SNIPPET ชิ้นงานลิงก์ไว้เพื่อใช้เป็นชิ้นงานข้อมูลเพิ่มเติม
MOBILE_APP ชิ้นงานลิงก์ไว้เพื่อใช้เป็นชิ้นงานแอปบนอุปกรณ์เคลื่อนที่
HOTEL_CALLOUT ชิ้นงานลิงก์ไว้เพื่อใช้เป็นชิ้นงานข้อความไฮไลต์สําหรับโรงแรม
CALL ชิ้นงานลิงก์เพื่อใช้เป็นชิ้นงานการโทร
PRICE ชิ้นงานลิงก์ไว้เพื่อใช้เป็นชิ้นงานราคา
LONG_HEADLINE มีการลิงก์ชิ้นงานเพื่อใช้เป็นบรรทัดแรกแบบยาว
BUSINESS_NAME เนื้อหาลิงก์ไว้เพื่อใช้เป็นชื่อธุรกิจ
SQUARE_MARKETING_IMAGE ชิ้นงานลิงก์ไว้เพื่อใช้เป็นรูปภาพการตลาดสี่เหลี่ยมจัตุรัส
PORTRAIT_MARKETING_IMAGE ชิ้นงานลิงก์ไว้เพื่อใช้เป็นรูปภาพการตลาดแนวตั้ง
VIDEO ชิ้นงานลิงก์ไว้เพื่อใช้เป็นโลโก้ที่ไม่ใช่ของ YouTube
CALL_TO_ACTION_SELECTION ชิ้นงานจะลิงก์ไว้เพื่อใช้เลือกคำกระตุ้นให้ดำเนินการ
AD_IMAGE ชิ้นงานจะลิงก์ไว้เพื่อใช้เลือกรูปภาพโฆษณา
HOTEL_PROPERTY ชิ้นงานจะลิงก์เพื่อใช้เป็นที่พักในแคมเปญ Performance Max สำหรับเป้าหมายการท่องเที่ยว

AssetGroupSignal

AssetGroupSignal แสดงถึงสัญญาณในกลุ่มชิ้นงาน สัญญาณที่มีอยู่จะบอกแคมเปญ Performance Max ว่าใครมีแนวโน้มสูงสุดที่จะทํา Conversion แคมเปญ Performance Max ใช้สัญญาณเพื่อมองหาผู้ใช้ใหม่ๆ ที่มีความตั้งใจใกล้เคียงหรือมากกว่ากลุ่มเป้าหมายปัจจุบันเพื่อให้ได้ Conversion ใน Search, Display, วิดีโอ และอื่นๆ

การแสดง JSON 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
ช่อง
resourceName

string

ชื่อทรัพยากรของสัญญาณกลุ่มชิ้นงาน ชื่อทรัพยากรสัญญาณของกลุ่มชิ้นงานมีรูปแบบดังนี้

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}
assetGroup

string

กลุ่มชิ้นงานที่สัญญาณของกลุ่มชิ้นงานนี้อยู่
ฟิลด์สหภาพ signal สัญญาณของกลุ่มชิ้นงาน signal ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
audience

object (AudienceInfo)

สัญญาณของกลุ่มเป้าหมายที่จะใช้โดยแคมเปญ Performance Max

AudienceInfo

เกณฑ์กลุ่มเป้าหมาย

การแสดง JSON 
{
  "audience": string
}
ช่อง
audience

string

ชื่อทรัพยากรกลุ่มเป้าหมาย

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter แสดงโหนดต้นไม้ของตัวกรองกลุ่มรายชื่อในกลุ่มชิ้นงาน

การแสดง JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
ช่อง
resourceName

string

ชื่อทรัพยากรของตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงาน ชื่อทรัพยากรตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงานมีรูปแบบดังนี้

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

กลุ่มชิ้นงานที่เป็นตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงานนี้
id

string (int64 format)

รหัสของ ListingGroupFilter
type

enum (ListingGroupFilterType)

ประเภทของโหนดตัวกรองกลุ่มรายชื่อ
vertical

enum (ListingGroupFilterVertical)

แนวตั้งที่แสดงถึงต้นไม้โหนดปัจจุบัน โหนดทั้งหมดในต้นไม้เดียวกันต้องอยู่ในประเภทเดียวกัน
caseValue

object (ListingGroupFilterDimension)

ค่ามิติข้อมูลซึ่งกลุ่มรายชื่อนี้ใช้ปรับแต่งรายการหลัก ไม่ได้กําหนดไว้สําหรับกลุ่มรูท
parentListingGroupFilter

string

ชื่อทรัพยากรของหมวดหมู่ย่อยของกลุ่มรายชื่อหลัก ค่า Null สำหรับโหนดตัวกรองกลุ่มรายชื่อระดับรูท
path

object (ListingGroupFilterDimensionPath)

เส้นทางของมิติข้อมูลที่กําหนดตัวกรองกลุ่มรายชื่อนี้

ListingGroupFilterType

ประเภทของตัวกรองกลุ่มรายชื่อ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SUBDIVISION การแบ่งผลิตภัณฑ์ตามมิติข้อมูลข้อมูลผลิตภัณฑ์ที่แสดงบางรายการ
UNIT_INCLUDED โหนดใบของตัวกรองกลุ่มรายชื่อที่รวมอยู่
UNIT_EXCLUDED โหนดใบของตัวกรองกลุ่มรายชื่อที่ยกเว้น

ListingGroupFilterVertical

ประเภทของธุรกิจแนวตั้งของตัวกรองกลุ่มรายชื่อ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SHOPPING แสดงประเภทธุรกิจช็อปปิ้ง ธุรกิจนี้ใช้ได้เฉพาะในแคมเปญ Performance Max สําหรับค้าปลีกเท่านั้น

ListingGroupFilterDimension

มิติข้อมูลของข้อมูลสำหรับตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงาน

การแสดง JSON 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
ช่อง
ฟิลด์สหภาพ dimension มิติข้อมูลประเภทใดประเภทหนึ่งด้านล่างนี้จะแสดงอยู่เสมอ dimension ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
productBiddingCategory

object (ProductBiddingCategory)

หมวดหมู่การเสนอราคาของข้อเสนอผลิตภัณฑ์
productBrand

object (ProductBrand)

แบรนด์ของข้อเสนอผลิตภัณฑ์
productChannel

object (ProductChannel)

สถานที่ตั้งของข้อเสนอผลิตภัณฑ์
productCondition

object (ProductCondition)

สภาพของข้อเสนอผลิตภัณฑ์
productCustomAttribute

object (ProductCustomAttribute)

แอตทริบิวต์ที่กำหนดเองของข้อเสนอผลิตภัณฑ์
productItemId

object (ProductItemId)

รหัสสินค้าของข้อเสนอผลิตภัณฑ์
productType

object (ProductType)

ประเภทข้อเสนอผลิตภัณฑ์

ProductBiddingCategory

องค์ประกอบหนึ่งของหมวดหมู่การเสนอราคาที่ระดับหนึ่งๆ หมวดหมู่ระดับบนสุดจะอยู่ในระดับ 1 ส่วนหมวดหมู่ย่อยจะอยู่ในระดับ 2 และอื่นๆ ตามลำดับ ปัจจุบันเรารองรับสูงสุด 5 ระดับ ผู้ใช้ต้องระบุประเภทมิติข้อมูลที่ระบุระดับของหมวดหมู่ เคสทั้งหมดของการแบ่งย่อยเดียวกันต้องมีมิติข้อมูลประเภทเดียวกัน (ระดับหมวดหมู่)

การแสดง JSON 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
ช่อง
level

enum (ListingGroupFilterBiddingCategoryLevel)

ระบุระดับของหมวดหมู่ในการจัดหมวดหมู่
id

string (int64 format)

รหัสของหมวดหมู่การเสนอราคาผลิตภัณฑ์

รหัสนี้เทียบเท่ากับรหัส google_product_category ตามที่อธิบายไว้ในบทความนี้ https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

ระดับของหมวดหมู่การเสนอราคาของตัวกรองกลุ่มรายชื่อ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
LEVEL1 ระดับ 1
LEVEL2 ระดับ 2
LEVEL3 ระดับ 3
LEVEL4 ระดับ 4
LEVEL5 ระดับ 5

ProductBrand

แบรนด์ของผลิตภัณฑ์

การแสดง JSON 
{
  "value": string
}
ช่อง
value

string

ค่าสตริงของแบรนด์ผลิตภัณฑ์

ProductChannel

สถานที่ตั้งของข้อเสนอผลิตภัณฑ์

การแสดง JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
ช่อง
channel

enum (ListingGroupFilterProductChannel)

ค่าของย่าน

ListingGroupFilterProductChannel

Enum ที่อธิบายสถานที่ตั้งของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ONLINE สินค้าขายทางออนไลน์
LOCAL สินค้ามีจำหน่ายในร้านค้าในพื้นที่

ProductCondition

สภาพของข้อเสนอผลิตภัณฑ์

การแสดง JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
ช่อง
condition

enum (ListingGroupFilterProductCondition)

ค่าของเงื่อนไข

ListingGroupFilterProductCondition

Enum ที่อธิบายสภาพของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
NEW สภาพผลิตภัณฑ์คือใหม่
REFURBISHED สภาพผลิตภัณฑ์ได้รับการซ่อมแซมใหม่
USED มีการใช้สภาพผลิตภัณฑ์

ProductCustomAttribute

แอตทริบิวต์ที่กำหนดเองของข้อเสนอผลิตภัณฑ์

การแสดง JSON 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
ช่อง
index

enum (ListingGroupFilterCustomAttributeIndex)

ระบุดัชนีของแอตทริบิวต์ที่กำหนดเอง
value

string

ค่าสตริงของแอตทริบิวต์ที่กำหนดเองของผลิตภัณฑ์

ListingGroupFilterCustomAttributeIndex

ดัชนีแอตทริบิวต์ของลูกค้า

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
INDEX0 แอตทริบิวต์ที่กำหนดเองของตัวกรองกลุ่มรายชื่อแรก
INDEX1 แอตทริบิวต์ที่กำหนดเองของตัวกรองกลุ่มรายชื่อที่ 2
INDEX2 แอตทริบิวต์ที่กำหนดเองของตัวกรองกลุ่มรายชื่อที่ 3
INDEX3 แอตทริบิวต์ที่กำหนดเองของตัวกรองกลุ่มรายชื่อที่ 4
INDEX4 แอตทริบิวต์ที่กำหนดเองของตัวกรองกลุ่มรายชื่อที่ 5

ProductItemId

รหัสสินค้าของข้อเสนอผลิตภัณฑ์

การแสดง JSON 
{
  "value": string
}
ช่อง
value

string

ค่าของรหัส

ProductType

ประเภทข้อเสนอผลิตภัณฑ์

การแสดง JSON 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
ช่อง
level

enum (ListingGroupFilterProductTypeLevel)

ระดับของประเภท
value

string

ค่าของประเภท

ListingGroupFilterProductTypeLevel

Enum ที่อธิบายระดับของประเภทข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
LEVEL1 ระดับ 1
LEVEL2 ระดับ 2
LEVEL3 ระดับ 3
LEVEL4 ระดับ 4
LEVEL5 ระดับ 5

ListingGroupFilterDimensionPath

เส้นทางที่กําหนดมิติข้อมูลที่กําหนดตัวกรองกลุ่มข้อมูล

การแสดง JSON 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
ช่อง
dimensions[]

object (ListingGroupFilterDimension)

เส้นทางที่สมบูรณ์ของมิติข้อมูลผ่านลําดับชั้นตัวกรองกลุ่มรายชื่อ (ยกเว้นโหนดรูท) ไปยังตัวกรองกลุ่มรายชื่อนี้

AssetGroupTopCombinationView

มุมมองเกี่ยวกับการใช้ชุดค่าผสมชิ้นงานยอดนิยมของกลุ่มชิ้นงาน

การแสดง JSON 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองชุดค่าผสมยอดนิยมของกลุ่มชิ้นงาน ชื่อทรัพยากรมุมมองการผสมผสานยอดนิยมของกลุ่มชิ้นงานมีรูปแบบดังนี้ `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

ชุดค่าผสมชิ้นงานที่แสดงร่วมกันสูงสุด

AssetGroupAssetCombinationData

ข้อมูลชุดค่าผสมของชิ้นงานกลุ่มชิ้นงาน

การแสดง JSON 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
ช่อง
assetCombinationServedAssets[]

object (AssetUsage)

ชิ้นงานที่แสดง

AssetUsage

มีข้อมูลการใช้งานเนื้อหา

การแสดง JSON 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
ช่อง
asset

string

ชื่อทรัพยากรของเนื้อหา
servedAssetFieldType

enum (ServedAssetFieldType)

ประเภทช่องที่แสดงของชิ้นงาน

ServedAssetFieldType

ประเภทช่องชิ้นงานที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
HEADLINE_1 มีการใช้ชิ้นงานในบรรทัดแรก 1
HEADLINE_2 ชิ้นงานนี้ใช้ในบรรทัดแรก 2
HEADLINE_3 มีการใช้ชิ้นงานในบรรทัดแรก 3
DESCRIPTION_1 มีการใช้ชิ้นงานในคำอธิบาย 1
DESCRIPTION_2 มีการใช้ชิ้นงานในคำอธิบาย 2
HEADLINE มีการใช้ชิ้นงานในบรรทัดแรก ใช้เฉพาะในกรณีที่โฆษณามีบรรทัดแรกเพียงรายการเดียว หรือใช้เอนทิตี HEADLINE_1, HEADLINE_2 หรือ HEADLINE_3
HEADLINE_IN_PORTRAIT มีการใช้ชิ้นงานเป็นบรรทัดแรกในรูปภาพแนวตั้ง
LONG_HEADLINE มีการใช้ชิ้นงานในบรรทัดแรกแบบยาว (ใช้ใน MultiAssetResponsiveAd)
DESCRIPTION มีการใช้ชิ้นงานในคำอธิบาย ใช้เฉพาะในกรณีที่โฆษณามีคำอธิบายเพียงรายการเดียว หรือจะใช้ชุดค่าผสม DESCRIPTION_1 หรือ DESCRIPTION_@ ก็ได้
DESCRIPTION_IN_PORTRAIT มีการใช้ชิ้นงานเป็นคำอธิบายในรูปภาพแนวตั้ง
BUSINESS_NAME_IN_PORTRAIT มีการใช้ชิ้นงานเป็นชื่อธุรกิจในรูปภาพแนวตั้ง
BUSINESS_NAME มีการใช้เนื้อหาเป็นชื่อธุรกิจ
MARKETING_IMAGE มีการใช้ชิ้นงานเป็นภาพการตลาด
MARKETING_IMAGE_IN_PORTRAIT มีการใช้ชิ้นงานเป็นรูปภาพการตลาดในแนวตั้ง
SQUARE_MARKETING_IMAGE มีการใช้ชิ้นงานเป็นรูปภาพการตลาดสี่เหลี่ยมจัตุรัส
PORTRAIT_MARKETING_IMAGE มีการใช้ชิ้นงานเป็นรูปภาพการตลาดแนวตั้ง
CALL_TO_ACTION มีการใช้ชิ้นงานเป็นคำกระตุ้นให้ดำเนินการ
YOU_TUBE_VIDEO มีการใช้เนื้อหาเป็นวิดีโอ YouTube
CALL ชิ้นงานนี้ใช้เป็นการเรียก
MOBILE_APP ชิ้นงานนี้ใช้เป็นแอปบนอุปกรณ์เคลื่อนที่
CALLOUT ชิ้นงานนี้ใช้เป็นแบบข้อความไฮไลต์
STRUCTURED_SNIPPET ชิ้นงานนี้ใช้เป็นข้อมูลเพิ่มเติม
PRICE ใช้ชิ้นงานนี้เป็นราคา
PROMOTION ชิ้นงานนี้ใช้เป็นโปรโมชัน
AD_IMAGE ชิ้นงานนี้ใช้เป็นรูปภาพ
LEAD_FORM ชิ้นงานนี้ใช้เป็นโฆษณาแบบกรอกฟอร์ม

AssetGroup

กลุ่มชิ้นงาน AssetGroupAsset ใช้เพื่อลิงก์ชิ้นงานกับกลุ่มชิ้นงาน AssetGroupSignal ใช้เพื่อเชื่อมโยงสัญญาณกับกลุ่มชิ้นงาน

การแสดง JSON 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของกลุ่มชิ้นงาน ชื่อทรัพยากรกลุ่มชิ้นงานมีรูปแบบดังนี้

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

รหัสของกลุ่มชิ้นงาน
campaign

string

แคมเปญที่เชื่อมโยงกับกลุ่มชิ้นงานนี้ ชิ้นงานที่ลิงก์กับกลุ่มชิ้นงาน
name

string

ต้องระบุ ชื่อกลุ่มชิ้นงาน ต้องระบุ โดยต้องมีความยาวขั้นต่ำ 1 และสูงสุด 128 โดยต้องไม่ซ้ำกันภายในแคมเปญ
finalUrls[]

string

รายการ URL สุดท้ายหลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด ใน Performance Max โดยค่าเริ่มต้น URL จะมีสิทธิ์ขยาย เว้นแต่ว่าจะมีการเลือกไม่ใช้
finalMobileUrls[]

string

รายการ URL สุดท้ายในอุปกรณ์เคลื่อนที่หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด ใน Performance Max โดยค่าเริ่มต้น URL จะมีสิทธิ์ขยาย เว้นแต่ว่าจะมีการเลือกไม่ใช้
status

enum (AssetGroupStatus)

สถานะของกลุ่มชิ้นงาน
path1

string

ส่วนแรกของข้อความที่อาจปรากฏต่อท้าย URL ที่แสดงในโฆษณา
path2

string

ข้อความส่วนที่ 2 ที่อาจปรากฏต่อท้าย URL ที่แสดงในโฆษณา ฟิลด์นี้จะตั้งค่าได้ก็ต่อเมื่อตั้งค่า path1 เท่านั้น
adStrength

enum (AdStrength)

คุณภาพของโฆษณาโดยรวมของกลุ่มชิ้นงานนี้

AssetGroupStatus

สถานะที่เป็นไปได้ของกลุ่มชิ้นงาน

Enum
UNSPECIFIED ไม่ได้ระบุสถานะ
UNKNOWN ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้
ENABLED กลุ่มชิ้นงานเปิดใช้แล้ว
PAUSED กลุ่มชิ้นงานหยุดชั่วคราว
REMOVED ระบบจะนำกลุ่มชิ้นงานออก

AdStrength

Enum ที่แสดงคุณภาพของโฆษณาที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
PENDING คุณภาพของโฆษณาอยู่ระหว่างรอดำเนินการ
NO_ADS สร้างโฆษณาไม่ได้
POOR คุณภาพไม่ดี
AVERAGE คุณภาพระดับปานกลาง
GOOD สัญญาณมีความแรงดี
EXCELLENT แข็งแรงมาก

AssetSetAsset

AssetSetAsset คือลิงก์ระหว่างเนื้อหากับชุดชิ้นงาน การเพิ่ม AssetSetAsset จะลิงก์ชิ้นงานกับชุดชิ้นงาน

การแสดง JSON 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
ช่อง
resourceName

string

ชื่อทรัพยากรของชิ้นงานในชุดชิ้นงาน ชื่อทรัพยากรชิ้นงานชุดมีรูปแบบดังนี้

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}
assetSet

string

ชุดชิ้นงานที่ชิ้นงานในชุดชิ้นงานนี้ลิงก์อยู่
asset

string

ชิ้นงานที่ชิ้นงานในชุดชิ้นงานนี้ลิงก์อยู่
status

enum (AssetSetAssetStatus)

สถานะของชิ้นงานในชุดชิ้นงาน อ่านอย่างเดียว

AssetSetAssetStatus

สถานะที่เป็นไปได้ของชิ้นงานในชุดชิ้นงาน

Enum
UNSPECIFIED ไม่ได้ระบุสถานะ
UNKNOWN ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้ ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED ชิ้นงานในชุดชิ้นงานเปิดใช้แล้ว
REMOVED ระบบจะนำชิ้นงานในชุดชิ้นงานออก

AssetSet

ชุดชิ้นงานที่แสดงถึงคอลเล็กชันชิ้นงาน ใช้ AssetSetAsset เพื่อลิงก์ชิ้นงานกับชุดชิ้นงาน

การแสดง JSON 
{
  "id": string,
  "resourceName": string
}
ช่อง
id

string (int64 format)

รหัสของชุดชิ้นงาน
resourceName

string

ชื่อทรัพยากรของชุดชิ้นงาน ชื่อทรัพยากรชุดชิ้นงานมีรูปแบบดังนี้

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

กลยุทธ์การเสนอราคา

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของกลยุทธ์การเสนอราคา ชื่อทรัพยากรกลยุทธ์การเสนอราคามีรูปแบบดังนี้

customers/{customerId}/biddingStrategies/{bidding_strategy_id}
status

enum (BiddingStrategyStatus)

สถานะกลยุทธ์การเสนอราคา

ช่องนี้เป็นแบบอ่านอย่างเดียว
type

enum (BiddingStrategyType)

ประเภทของกลยุทธ์การเสนอราคา สร้างกลยุทธ์การเสนอราคาโดยการตั้งค่ารูปแบบการเสนอราคา

ช่องนี้เป็นแบบอ่านอย่างเดียว
currencyCode

string

สกุลเงินที่ใช้โดยกลยุทธ์การเสนอราคา (รหัส 3 ตัวอักษรตามมาตรฐาน ISO 4217)

สําหรับกลยุทธ์การเสนอราคาในลูกค้าบัญชีดูแลจัดการ คุณสามารถตั้งค่าสกุลเงินนี้เมื่อสร้างกลยุทธ์ และระบบจะตั้งค่าเริ่มต้นเป็นสกุลเงินของลูกค้าบัญชีดูแลจัดการ สําหรับลูกค้าที่ใช้แสดง คุณจะตั้งค่าช่องนี้ไม่ได้ กลยุทธ์ทั้งหมดในลูกค้าที่ใช้แสดงจะใช้สกุลเงินของลูกค้าที่ใช้แสดงโดยนัย ในทุกกรณี ช่อง effectiveCurrencyCode จะแสดงผลสกุลเงินที่กลยุทธ์ใช้
id

string (int64 format)

รหัสของกลยุทธ์การเสนอราคา
name

string

ชื่อกลยุทธ์การเสนอราคา กลยุทธ์การเสนอราคาทั้งหมดภายในบัญชีต้องตั้งชื่อให้แตกต่างกัน

ความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 255 ไบต์ (ตัด) ใน UTF-8
effectiveCurrencyCode

string

สกุลเงินที่ใช้โดยกลยุทธ์การเสนอราคา (รหัส 3 ตัวอักษรตามมาตรฐาน ISO 4217)

สําหรับกลยุทธ์การเสนอราคาในลูกค้าบัญชีดูแลจัดการ สกุลเงินนี้คือสกุลเงินที่ผู้ลงโฆษณากําหนดไว้เมื่อสร้างกลยุทธ์ สำหรับการแสดงโฆษณาต่อลูกค้า นี่เป็น currencyCode ของลูกค้า

ระบบจะรายงานเมตริกกลยุทธ์การเสนอราคาในสกุลเงินนี้

ช่องนี้เป็นแบบอ่านอย่างเดียว
campaignCount

string (int64 format)

จํานวนแคมเปญที่แนบอยู่กับกลยุทธ์การเสนอราคานี้

ช่องนี้เป็นแบบอ่านอย่างเดียว
nonRemovedCampaignCount

string (int64 format)

จํานวนแคมเปญที่ไม่ได้นําออกซึ่งแนบอยู่กับกลยุทธ์การเสนอราคานี้

ช่องนี้เป็นแบบอ่านอย่างเดียว

ฟิลด์สหภาพ scheme รูปแบบการเสนอราคา

ตั้งค่าได้เพียงรายการเดียว scheme ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
enhancedCpc

object (EnhancedCpc)

กลยุทธ์การเสนอราคาที่เพิ่มราคาเสนอสำหรับการคลิกที่ดูเหมือนว่าจะมีแนวโน้มที่จะทําให้เกิด Conversion และลดราคาเสนอสําหรับคลิกที่ดูเหมือนว่าจะมีแนวโน้มน้อย
maximizeConversionValue

object (MaximizeConversionValue)

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้แคมเปญได้รับมูลค่า Conversion สูงสุดโดยอยู่ภายในงบประมาณที่กำหนดไว้
maximizeConversions

object (MaximizeConversions)

กลยุทธ์การเสนอราคาอัตโนมัติที่ช่วยให้แคมเปญได้รับ Conversion มากที่สุดภายในงบประมาณที่ตั้งไว้
targetCpa

object (TargetCpa)

กลยุทธ์การเสนอราคาที่กำหนดราคาเสนอเพื่อช่วยให้ได้รับ Conversion มากที่สุดที่ต้นทุนต่อการกระทำหนึ่งครั้ง (CPA) เป้าหมายที่ตั้งไว้
targetImpressionShare

object (TargetImpressionShare)

กลยุทธ์การเสนอราคาที่เพิ่มประสิทธิภาพโดยอัตโนมัติเพื่อการแสดงผลตามเปอร์เซ็นต์ที่เลือก
targetOutrankShare

object (TargetOutrankShare)

กลยุทธ์การเสนอราคาที่ตั้งราคาเสนอตามเศษส่วนของการประมูลเป้าหมายที่ผู้ลงโฆษณาควรได้อันดับเหนือกว่าคู่แข่งที่เฉพาะเจาะจง ช่องนี้เลิกใช้งานแล้ว การสร้างกลยุทธ์การเสนอราคาใหม่ด้วยช่องนี้หรือการแนบกลยุทธ์การเสนอราคาที่มีช่องนี้กับแคมเปญจะไม่สําเร็จ ระบบอนุญาตให้เปลี่ยนรูปแบบเป็นกลยุทธ์ที่มีการสร้างรูปแบบนี้อยู่แล้ว
targetRoas

object (TargetRoas)

กลยุทธ์การเสนอราคาที่ช่วยเพิ่มรายได้สูงสุดไปพร้อมกับผลตอบแทนจากค่าโฆษณา (ROAS) เป้าหมายโดยเฉลี่ยที่ต้องการ
targetSpend

object (TargetSpend)

กลยุทธ์การเสนอราคาที่กำหนดราคาเสนอเพื่อให้คุณได้รับจำนวนคลิกมากที่สุดเท่าที่จะเป็นไปได้ภายในงบประมาณที่ตั้งไว้

BiddingStrategyStatus

สถานะที่เป็นไปได้ของกลยุทธ์การเสนอราคา

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED กลยุทธ์การเสนอราคาเปิดใช้งานแล้ว
REMOVED ระบบจะนำกลยุทธ์การเสนอราคาออก

BiddingStrategyType

Enum ที่อธิบายประเภทกลยุทธ์การเสนอราคาที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
COMMISSION ค่าคอมมิชชันเป็นกลยุทธ์การเสนอราคาอัตโนมัติที่ผู้ลงโฆษณาจ่ายมูลค่า Conversion บางส่วน
ENHANCED_CPC CPC ที่ปรับปรุงแล้วเป็นกลยุทธ์การเสนอราคาที่เพิ่มราคาเสนอสำหรับการคลิกที่ดูเหมือนจะมีแนวโน้มที่จะทําให้เกิด Conversion และลดราคาเสนอสําหรับการคลิกที่ดูเหมือนจะไม่มีแนวโน้ม
INVALID ใช้สำหรับค่าที่แสดงผลเท่านั้น บ่งบอกว่าแคมเปญไม่มีกลยุทธ์การเสนอราคา ซึ่งทำให้แคมเปญไม่แสดง เช่น แคมเปญอาจแนบอยู่กับกลยุทธ์การเสนอราคาของบัญชีดูแลจัดการ และต่อมามีการยกเลิกการลิงก์บัญชีที่แสดงโฆษณาจากบัญชีดูแลจัดการ ในกรณีนี้ ระบบจะแยกแคมเปญออกจากกลยุทธ์การเสนอราคาของผู้จัดการที่เข้าถึงไม่ได้โดยอัตโนมัติและเปลี่ยนเป็นประเภทกลยุทธ์การเสนอราคา "ไม่ถูกต้อง"
MANUAL_CPA กลยุทธ์การเสนอราคาด้วยตนเองซึ่งช่วยให้ผู้ลงโฆษณากําหนดราคาเสนอตามการกระทําที่ผู้ลงโฆษณาระบุ
MANUAL_CPC การเสนอราคาตามคลิกด้วยตนเองที่ผู้ใช้ชำระเงินต่อคลิก
MANUAL_CPM การเสนอราคาตามการแสดงผลด้วยตนเองซึ่งผู้ใช้จ่ายต่อการแสดงผล 1,000 ครั้ง
MANUAL_CPV กลยุทธ์การเสนอราคาที่จ่ายตามจํานวนเงินที่กำหนดค่าได้ต่อการดูวิดีโอแต่ละครั้ง
MAXIMIZE_CONVERSIONS กลยุทธ์การเสนอราคาที่จะเพิ่มจํานวน Conversion สูงสุดโดยอัตโนมัติตามงบประมาณรายวัน
MAXIMIZE_CONVERSION_VALUE กลยุทธ์การเสนอราคาอัตโนมัติที่กำหนดราคาเสนอโดยอัตโนมัติเพื่อเพิ่มรายได้สูงสุดขณะใช้งบประมาณ
PAGE_ONE_PROMOTED รูปแบบการเสนอราคาที่โปรโมตในหน้าแรก ซึ่งตั้งค่าราคาเสนอ CPC สูงสุดเพื่อแสดงผลเป้าหมายในหน้าแรกหรือช่องที่โปรโมตในหน้าแรกบน google.com ระบบเลิกใช้งานค่า Enum นี้แล้ว
PERCENT_CPC CPC ที่เป็นเปอร์เซ็นต์คือกลยุทธ์การเสนอราคาที่ราคาเสนอคือเศษส่วนของราคาที่โฆษณาสำหรับสินค้าหรือบริการบางอย่าง
TARGET_CPA CPA เป้าหมายคือกลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อช่วยให้คุณได้รับ Conversion มากที่สุดที่ต้นทุนต่อการกระทำหนึ่งครั้งที่ตั้งไว้ (CPA)
TARGET_CPM CPM เป้าหมายคือกลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อช่วยให้ได้รับการแสดงผลมากที่สุดในต้นทุนต่อการแสดงผล 1,000 ครั้ง (CPM) เป้าหมายที่คุณตั้งไว้
TARGET_IMPRESSION_SHARE กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อให้โฆษณา Search เปอร์เซ็นต์หนึ่งแสดงที่ด้านบนของหน้าแรก (หรือตําแหน่งเป้าหมายอื่นๆ)
TARGET_OUTRANK_SHARE ส่วนแบ่งที่ชนะเป้าหมายเป็นกลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอตามเศษส่วนของราคาเสนอเป้าหมายในการประมูลที่ผู้ลงโฆษณาควรมีอันดับเหนือกว่าคู่แข่งที่เฉพาะเจาะจง ค่า enum นี้เลิกใช้งานแล้ว
TARGET_ROAS ROAS เป้าหมายคือกลยุทธ์การเสนอราคาอัตโนมัติที่ช่วยเพิ่มรายได้สูงสุดไปพร้อมกับเฉลี่ยผลตอบแทนจากค่าโฆษณา (ROAS) เป้าหมายที่ต้องการ
TARGET_SPEND การใช้จ่ายเป้าหมายเป็นกลยุทธ์การเสนอราคาอัตโนมัติซึ่งจะกำหนดราคาเสนอโดยอัตโนมัติเพื่อให้คุณได้รับคลิกมากที่สุดภายในงบประมาณที่ตั้งไว้

EnhancedCpc

ประเภทนี้ไม่มีช่อง

กลยุทธ์การเสนอราคาอัตโนมัติที่เพิ่มราคาเสนอสำหรับการคลิกที่มีแนวโน้มจะทําให้เกิด Conversion และลดราคาเสนอสําหรับคลิกที่ดูเหมือนจะมีโอกาสน้อย

เราเลิกใช้งานกลยุทธ์การเสนอราคานี้แล้วและสร้างไม่ได้อีกต่อไป ใช้ ManualCpc โดยตั้งค่า enhancedCpcEnabled เป็น "จริง" เพื่อฟังก์ชันการทำงานที่เทียบเท่า

MaximizeConversionValue

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้แคมเปญได้รับมูลค่า Conversion สูงสุดโดยอยู่ภายในงบประมาณที่กำหนดไว้

การแสดง JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
ช่อง
cpcBidCeilingMicros

string (int64 format)

ขีดจํากัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ เปลี่ยนแปลงได้สําหรับกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอเท่านั้น
cpcBidFloorMicros

string (int64 format)

ขีดจํากัดราคาเสนอต่ำสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ เปลี่ยนแปลงได้สําหรับกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอเท่านั้น
targetRoas

number

ตัวเลือกผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) หากตั้งค่าไว้ กลยุทธ์การเสนอราคาจะเพิ่มรายได้สูงสุดขณะที่เฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา หาก ROAS เป้าหมายสูง กลยุทธ์การเสนอราคาอาจใช้งบประมาณได้ไม่เต็มจำนวน หากไม่ได้กําหนด ROAS เป้าหมายไว้ กลยุทธ์การเสนอราคาจะมุ่งเพิ่ม ROAS ให้ได้สูงสุดตามงบประมาณ

MaximizeConversions

กลยุทธ์การเสนอราคาอัตโนมัติที่ช่วยให้แคมเปญได้รับ Conversion มากที่สุดภายในงบประมาณที่ตั้งไว้

การแสดง JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
ช่อง
cpcBidCeilingMicros

string (int64 format)

ขีดจํากัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ เปลี่ยนแปลงได้สําหรับกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอเท่านั้น
cpcBidFloorMicros

string (int64 format)

ขีดจํากัดราคาเสนอต่ำสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ เปลี่ยนแปลงได้สําหรับกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอเท่านั้น
targetCpaMicros

string (int64 format)

ตัวเลือกต้นทุนต่อการกระทำหนึ่งครั้ง (CPA) เป้าหมาย นี่เป็นจํานวนเงินโดยเฉลี่ยที่คุณต้องการจ่ายต่อหนึ่งการกระทำที่ถือเป็น Conversion ซึ่งระบุไว้ในหน่วยไมโครสกุลเงินของกลยุทธ์การเสนอราคา หากตั้งค่าไว้ กลยุทธ์การเสนอราคาจะได้รับ Conversion มากที่สุดเท่าที่จะเป็นไปได้โดยไม่เกินต้นทุนต่อการกระทำหนึ่งครั้งเป้าหมาย หากไม่ได้ตั้งค่า CPA เป้าหมายไว้ กลยุทธ์การเสนอราคาจะมุ่งทำ CPA ให้ต่ำที่สุดเท่าที่จะทำได้ภายในงบประมาณ

TargetCpa

กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อช่วยให้คุณได้ Conversion มากที่สุดจากต้นทุนต่อหนึ่งการกระทำ (CPA) ที่ตั้งไว้

การแสดง JSON 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
ช่อง
targetCpaMicros

string (int64 format)

เป้าหมาย CPA เฉลี่ย เป้าหมายนี้ควรมากกว่าหรือเท่ากับหน่วยที่เรียกเก็บเงินขั้นต่ำตามสกุลเงินของบัญชี
cpcBidCeilingMicros

string (int64 format)

ขีดจํากัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ การตั้งค่านี้ควรใช้กับกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอเท่านั้น
cpcBidFloorMicros

string (int64 format)

ขีดจํากัดราคาเสนอต่ำสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ การตั้งค่านี้ควรใช้กับกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอเท่านั้น

TargetImpressionShare

กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อให้โฆษณา Search เปอร์เซ็นต์หนึ่งแสดงที่ด้านบนของหน้าแรก (หรือตําแหน่งเป้าหมายอื่นๆ)

การแสดง JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
ช่อง
location

enum (TargetImpressionShareLocation)

ตําแหน่งเป้าหมายในหน้าผลการค้นหา
locationFractionMicros

string (int64 format)

ส่วนหนึ่งของโฆษณาที่เลือกให้แสดงในสถานที่เป้าหมายเป็นไมโคร เช่น 1% เท่ากับ 10,000
cpcBidCeilingMicros

string (int64 format)

ราคาเสนอ CPC สูงสุดที่ระบบการเสนอราคาอัตโนมัติได้รับอนุญาตให้ระบุ ช่องนี้เป็นช่องที่ต้องกรอกโดยผู้ลงโฆษณาซึ่งจะกำหนดเพดานและระบุในไมโครสตรีมในพื้นที่

TargetImpressionShareLocation

Enum ที่อธิบายเป้าหมายที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ANYWHERE_ON_PAGE ตําแหน่งใดก็ได้ในหน้าเว็บ
TOP_OF_PAGE กล่องโฆษณาด้านบน
ABSOLUTE_TOP_OF_PAGE ช่องด้านบนในช่องโฆษณาด้านบน

TargetOutrankShare

กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอตามเศษส่วนของราคาเสนอเป้าหมายในการประมูลที่ผู้ลงโฆษณาควรได้อันดับเหนือกว่าคู่แข่งที่เฉพาะเจาะจง กลยุทธ์นี้เลิกใช้งานแล้ว

การแสดง JSON 
{
  "cpcBidCeilingMicros": string
}
ช่อง
cpcBidCeilingMicros

string (Int64Value format)

ขีดจํากัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ

TargetRoas

กลยุทธ์การเสนอราคาอัตโนมัติที่ช่วยเพิ่มรายได้สูงสุดไปพร้อมกับเฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) ที่เฉพาะเจาะจง

การแสดง JSON 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
ช่อง
targetRoas

number

ต้องระบุ รายได้ที่เลือก (อิงตามข้อมูล Conversion) ต่อหน่วยการใช้จ่าย ค่าต้องอยู่ระหว่าง 0.01 ถึง 1, 000.0 (รวม)
cpcBidCeilingMicros

string (int64 format)

ขีดจํากัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ การตั้งค่านี้ควรใช้กับกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอเท่านั้น
cpcBidFloorMicros

string (int64 format)

ขีดจํากัดราคาเสนอต่ำสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ การตั้งค่านี้ควรใช้กับกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอเท่านั้น

TargetSpend

กลยุทธ์การเสนอราคาอัตโนมัติที่กำหนดราคาเสนอโดยอัตโนมัติเพื่อให้คุณได้รับคลิกมากที่สุดเท่าที่จะเป็นไปได้ภายในงบประมาณที่ตั้งไว้

การแสดง JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
ช่อง
targetSpendMicros
(deprecated)

string (int64 format)

เลิกใช้งานแล้ว: เป้าหมายการใช้จ่ายที่จะเพิ่มจํานวนคลิกสูงสุด ผู้เสนอราคา TargetSpend จะพยายามใช้จ่ายตามค่าที่น้อยกว่าระหว่างค่านี้หรือจำนวนเงินที่ใช้จ่ายตามการจำกัดตามปกติ หากไม่ได้ระบุ ระบบจะใช้งบประมาณเป็นเป้าหมายการใช้จ่าย ช่องนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้อีกต่อไป ดูรายละเอียดได้ที่ https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html
cpcBidCeilingMicros

string (int64 format)

ขีดจํากัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ

CampaignBudget

งบประมาณแคมเปญ

การแสดง JSON 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของงบประมาณแคมเปญ ชื่อทรัพยากรงบประมาณของแคมเปญอยู่ในรูปแบบต่อไปนี้

customers/{customerId}/campaignBudgets/{campaign_budget_id}
deliveryMethod

enum (BudgetDeliveryMethod)

วิธีการแสดงโฆษณาที่กําหนดอัตราการใช้งบประมาณแคมเปญ

ค่าเริ่มต้นจะเป็น STANDARD หากไม่ได้ระบุไว้ในการดำเนินการสร้าง
period

enum (BudgetPeriod)

ระยะเวลาที่จะใช้งบประมาณ ค่าเริ่มต้นจะเป็น DAILY หากไม่ได้ระบุไว้
amountMicros

string (int64 format)

จํานวนงบประมาณในสกุลเงินท้องถิ่นของบัญชี โดยระบบจะระบุจำนวนเงินเป็นไมโคร โดยที่ 1 ล้านเท่ากับ 1 หน่วยสกุลเงิน ค่าใช้จ่ายรายเดือนจะไม่เกิน 30.4 เท่าของจำนวนเงินนี้

BudgetDeliveryMethod

วิธีการนําส่งงบประมาณที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
STANDARD เซิร์ฟเวอร์งบประมาณจะควบคุมการแสดงโฆษณาอย่างสม่ำเสมอตลอดระยะเวลา
ACCELERATED เซิร์ฟเวอร์งบประมาณจะไม่จำกัดการแสดงโฆษณา และโฆษณาจะแสดงโดยเร็วที่สุด

BudgetPeriod

ระยะเวลาที่เป็นไปได้ของงบประมาณ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DAILY งบประมาณรายวัน
FIXED_DAILY งบประมาณรายวันแบบคงที่
CUSTOM_PERIOD คุณสามารถใช้งบประมาณที่กำหนดเองกับ total_amount เพื่อระบุขีดจำกัดงบประมาณตลอดอายุการใช้งานได้

แคมเปญ

แคมเปญ

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "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.
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของแคมเปญ ชื่อทรัพยากรแคมเปญอยู่ในรูปแบบต่อไปนี้

customers/{customerId}/campaigns/{campaign_id}
status

enum (CampaignStatus)

สถานะของแคมเปญ

เมื่อเพิ่มแคมเปญใหม่ สถานะเริ่มต้นจะเป็น "เปิดใช้"
servingStatus

enum (CampaignServingStatus)

สถานะการแสดงโฆษณาของแคมเปญ
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

สถานะระบบของกลยุทธ์การเสนอราคาของแคมเปญ
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

สถานะการเพิ่มประสิทธิภาพการแสดงโฆษณาของแคมเปญ
advertisingChannelType

enum (AdvertisingChannelType)

เป้าหมายการแสดงโฆษณาหลักสําหรับโฆษณาภายในแคมเปญ คุณปรับแต่งตัวเลือกการกําหนดเป้าหมายได้ในnetworkSettings

ฟิลด์นี้ต้องกรอกข้อมูลและไม่ควรว่างเปล่าเมื่อสร้างแคมเปญใหม่

ตั้งค่าได้เมื่อสร้างแคมเปญเท่านั้น หลังจากสร้างแคมเปญแล้ว คุณจะเปลี่ยนแปลงช่องนี้ไม่ได้
advertisingChannelSubType

enum (AdvertisingChannelSubType)

การปรับแต่ง advertisingChannelType ที่ไม่บังคับ ต้องเป็นประเภทย่อยที่ถูกต้องของประเภทช่องทางหลัก

ตั้งค่าได้เมื่อสร้างแคมเปญเท่านั้น หลังจากสร้างแคมเปญแล้ว คุณจะเปลี่ยนแปลงช่องนี้ไม่ได้
urlCustomParameters[]

object (CustomParameter)

รายการการแมปที่ใช้แทนที่แท็กพารามิเตอร์ที่กำหนดเองใน trackingUrlTemplate, finalUrls หรือ mobile_final_urls
realTimeBiddingSetting

object (RealTimeBiddingSetting)

การตั้งค่าสําหรับการเสนอราคาแบบเรียลไทม์ ซึ่งเป็นฟีเจอร์ที่ใช้ได้กับแคมเปญที่กําหนดเป้าหมายเป็นเครือข่าย Ad Exchange เท่านั้น
networkSettings

object (NetworkSettings)

การตั้งค่าเครือข่ายสําหรับแคมเปญ
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

การตั้งค่าสําหรับการควบคุมโฆษณา Search แบบไดนามิก (DSA)
shoppingSetting

object (ShoppingSetting)

การตั้งค่าสําหรับการควบคุมแคมเปญ Shopping
geoTargetTypeSetting

object (GeoTargetTypeSetting)

การตั้งค่าการกำหนดเป้าหมายตามภูมิศาสตร์ของโฆษณา
effectiveLabels[]

string

ชื่อทรัพยากรของป้ายกำกับที่มีประสิทธิภาพซึ่งแนบอยู่กับแคมเปญนี้ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับค่ามาหรือกำหนดให้กับแคมเปญนี้โดยตรง
labels[]

string

ชื่อทรัพยากรของป้ายกำกับที่แนบมากับแคมเปญนี้
biddingStrategyType

enum (BiddingStrategyType)

ประเภทกลยุทธ์การเสนอราคา

คุณสร้างกลยุทธ์การเสนอราคาได้โดยการตั้งค่ารูปแบบการเสนอราคาเพื่อสร้างกลยุทธ์การเสนอราคามาตรฐาน หรือสร้างในช่อง biddingStrategy เพื่อสร้างกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอ

ช่องนี้เป็นแบบอ่านอย่างเดียว
accessibleBiddingStrategy

string

ชื่อทรัพยากรของ AccessibleBiddingStrategy ซึ่งเป็นมุมมองแบบอ่านอย่างเดียวของแอตทริบิวต์ที่ไม่มีข้อจํากัดของกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอที่แนบมาซึ่งระบุโดย "biddingStrategy" ว่างเปล่า หากแคมเปญไม่ได้ใช้กลยุทธ์พอร์ตโฟลิโอ แอตทริบิวต์กลยุทธ์ที่ไม่มีข้อจํากัดพร้อมให้บริการแก่ลูกค้าทุกคนที่แชร์กลยุทธ์ด้วยและอ่านได้จากแหล่งข้อมูล AccessibleBiddingStrategy ในทางตรงกันข้าม แอตทริบิวต์ที่จํากัดจะมีให้เฉพาะลูกค้าเจ้าของกลยุทธ์และผู้จัดการของลูกค้าเท่านั้น คุณจะอ่านแอตทริบิวต์ที่จํากัดได้จากแหล่งข้อมูลกลยุทธ์การเสนอราคาเท่านั้น
frequencyCaps[]

object (FrequencyCapEntry)

รายการที่จำกัดความถี่ที่ผู้ใช้แต่ละรายจะเห็นโฆษณาของแคมเปญนี้
selectiveOptimization

object (SelectiveOptimization)

การตั้งค่าการเพิ่มประสิทธิภาพแบบเลือกสําหรับแคมเปญนี้ ซึ่งประกอบด้วยชุดการกระทําที่ถือเป็น Conversion เพื่อเพิ่มประสิทธิภาพแคมเปญนี้ ฟีเจอร์นี้ใช้ได้กับ App Campaign ที่ใช้ MULTI_CHANNEL เป็น AdvertisingChannelType และ APP_CAMPAIGN หรือ APP_CAMPAIGN_FOR_ENGAGEMENT เป็น AdvertisingChannelSubType เท่านั้น
optimizationGoalSetting

object (OptimizationGoalSetting)

การตั้งค่าเป้าหมายการเพิ่มประสิทธิภาพสําหรับแคมเปญนี้ ซึ่งประกอบด้วยชุดประเภทเป้าหมายการเพิ่มประสิทธิภาพ
trackingSetting

object (TrackingSetting)

การตั้งค่าระดับแคมเปญสําหรับข้อมูลการติดตาม
engineId

string

รหัสของแคมเปญในบัญชีเครื่องมือภายนอก ฟิลด์นี้มีไว้สําหรับบัญชีที่ไม่ใช่ Google Ads เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu ฯลฯ สําหรับเอนทิตี Google Ads ให้ใช้ "campaign.id" แทน
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

ประเภทช่องชิ้นงานที่จะยกเว้นจากแคมเปญนี้ แคมเปญนี้จะไม่รับลิงก์ชิ้นงานที่มีประเภทช่องเหล่านี้มาจากระดับบน
createTime

string

การประทับเวลาที่สร้างแคมเปญนี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss" เราจะเลิกใช้งาน createTime ใน v1 ให้ใช้ creationTime แทน
creationTime

string

การประทับเวลาที่สร้างแคมเปญนี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss"
lastModifiedTime

string

วันที่และเวลาที่แก้ไขแคมเปญนี้ครั้งล่าสุด โดยค่าวันที่และเวลาจะอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" และอยู่ตามเขตเวลาของลูกค้า
id

string (int64 format)

รหัสของแคมเปญ
name

string

ชื่อแคมเปญ

ฟิลด์นี้ต้องกรอกข้อมูลและไม่ควรว่างเปล่าเมื่อสร้างแคมเปญใหม่

โดยต้องไม่มีอักขระ Null (Code Point 0x0), NL (Code Point 0xA) หรือขึ้นบรรทัดใหม่ (Code Point 0xD)
trackingUrlTemplate

string

เทมเพลต URL สำหรับสร้าง URL ติดตาม
campaignBudget

string

ชื่อทรัพยากรของงบประมาณแคมเปญ
startDate

string

วันที่แคมเปญเริ่มแสดงตามเขตเวลาของลูกค้าในรูปแบบ YYYY-MM-DD
endDate

string

วันสุดท้ายของแคมเปญที่แสดงตามเขตเวลาของลูกค้าในรูปแบบ YYYY-MM-DD เมื่อสร้าง จะเป็นค่าเริ่มต้นเป็น 30-12-2037 ซึ่งหมายความว่าแคมเปญจะทํางานแบบไม่มีกําหนด หากต้องการตั้งค่าแคมเปญที่มีอยู่ให้ทํางานต่อไปเรื่อยๆ ให้ตั้งค่าช่องนี้เป็น 30-12-2037
finalUrlSuffix

string

คำต่อท้ายที่ใช้เพิ่มพารามิเตอร์การค้นหาต่อท้ายหน้า Landing Page ที่แสดงด้วยการติดตามพร้อมกัน
urlExpansionOptOut

boolean

แสดงถึงการไม่ใช้การขยาย URL ไปยัง URL ที่กําหนดเป้าหมายมากขึ้น หากเลือกไม่ใช้ (จริง) ระบบจะกําหนดเป้าหมายเฉพาะ URL สุดท้ายในกลุ่มชิ้นงานหรือ URL ที่ระบุไว้ใน Google Merchant Center หรือฟีดข้อมูลธุรกิจของผู้ลงโฆษณา หากเลือกใช้ (เท็จ) ระบบจะกําหนดเป้าหมายทั้งโดเมน ฟิลด์นี้ตั้งค่าได้สําหรับแคมเปญ Performance Max เท่านั้น โดยค่าเริ่มต้นจะเป็นเท็จ

ฟิลด์สหภาพ campaign_bidding_strategy กลยุทธ์การเสนอราคาของแคมเปญ

ต้องเป็นกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอ (สร้างผ่านบริการ BiddingStrategy) หรือแบบมาตรฐานที่ฝังอยู่ในแคมเปญ campaign_bidding_strategy ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
biddingStrategy

string

ชื่อทรัพยากรของกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอที่แคมเปญใช้
manualCpa

object (ManualCpa)

กลยุทธ์การเสนอราคา CPA ที่กำหนดเองแบบมาตรฐาน กลยุทธ์การเสนอราคาด้วยตนเองซึ่งช่วยให้ผู้ลงโฆษณากําหนดราคาเสนอตามการกระทําที่ผู้ลงโฆษณาระบุ ใช้ได้กับแคมเปญบริการในพื้นที่เท่านั้น
manualCpc

object (ManualCpc)

กลยุทธ์การเสนอราคา CPC ด้วยตนเองแบบมาตรฐาน การเสนอราคาตามคลิกด้วยตนเองที่ผู้ใช้ชำระเงินต่อคลิก
manualCpm

object (ManualCpm)

กลยุทธ์การเสนอราคา CPM ที่กำหนดเองแบบมาตรฐาน การเสนอราคาตามการแสดงผลด้วยตนเองซึ่งผู้ใช้จ่ายต่อการแสดงผล 1,000 ครั้ง
maximizeConversions

object (MaximizeConversions)

กลยุทธ์การเสนอราคาแบบเพิ่มจำนวน Conversion สูงสุดมาตรฐานที่เพิ่มจํานวน Conversion สูงสุดโดยอัตโนมัติขณะใช้งบประมาณ
maximizeConversionValue

object (MaximizeConversionValue)

กลยุทธ์การเสนอราคาแบบเพิ่มมูลค่า Conversion สูงสุดมาตรฐานที่จะตั้งราคาเสนอโดยอัตโนมัติเพื่อเพิ่มรายได้สูงสุดโดยใช้จ่ายไม่เกินงบประมาณที่ตั้งไว้
targetCpa

object (TargetCpa)

กลยุทธ์การเสนอราคา CPA เป้าหมายมาตรฐานที่ตั้งราคาเสนอโดยอัตโนมัติเพื่อช่วยให้ได้รับ Conversion มากที่สุดที่ต้นทุนต่อการกระทำหนึ่งครั้งที่ตั้งไว้ (CPA)
targetImpressionShare

object (TargetImpressionShare)

กลยุทธ์การเสนอราคาส่วนแบ่งการแสดงผลเป้าหมาย กลยุทธ์การเสนอราคาอัตโนมัติที่กำหนดราคาเสนอเพื่อให้ได้เปอร์เซ็นต์การแสดงผลที่เลือกไว้
targetRoas

object (TargetRoas)

กลยุทธ์การเสนอราคา ROAS เป้าหมายมาตรฐานที่เพิ่มรายได้สูงสุดโดยอัตโนมัติไปพร้อมกับเฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) ที่เฉพาะเจาะจง
targetSpend

object (TargetSpend)

กลยุทธ์การเสนอราคาตามการใช้จ่ายเป้าหมายแบบมาตรฐานที่กำหนดราคาเสนอโดยอัตโนมัติเพื่อให้คุณได้รับคลิกมากที่สุดภายในงบประมาณที่ตั้งไว้
percentCpc

object (PercentCpc)

กลยุทธ์การเสนอราคา CPC เปอร์เซ็นต์มาตรฐานที่ราคาเสนอคือเศษส่วนของราคาที่โฆษณาสำหรับสินค้าหรือบริการบางอย่าง
targetCpm

object (TargetCpm)

กลยุทธ์การเสนอราคาที่เพิ่มประสิทธิภาพต้นทุนต่อการแสดงผลพันครั้งโดยอัตโนมัติ

CampaignStatus

สถานะต่างๆ ที่เป็นไปได้ของแคมเปญ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED แคมเปญทํางานอยู่และแสดงโฆษณาได้
PAUSED ผู้ใช้หยุดแคมเปญชั่วคราว
REMOVED นําแคมเปญออกแล้ว

CampaignServingStatus

สถานะการแสดงผลที่เป็นไปได้ของแคมเปญ

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
SERVING กำลังแสดง
NONE ไม่มี
ENDED สิ้นสุดแล้ว
PENDING Pending.
SUSPENDED ถูกระงับ

BiddingStrategySystemStatus

สถานะระบบที่เป็นไปได้ของกลยุทธ์การเสนอราคา

Enum
UNSPECIFIED บ่งชี้ว่าเกิดข้อผิดพลาดที่ไม่คาดคิด เช่น ไม่พบประเภทกลยุทธ์การเสนอราคา หรือไม่พบข้อมูลสถานะ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED กลยุทธ์การเสนอราคานี้ใช้งานอยู่ AdWords ไม่พบปัญหาเฉพาะเจาะจงกับกลยุทธ์นี้
LEARNING_NEW กลยุทธ์การเสนอราคากําลังเรียนรู้เนื่องจากเพิ่งมีการสร้างหรือเปิดใช้กลยุทธ์นี้ขึ้นมาใหม่
LEARNING_SETTING_CHANGE กลยุทธ์การเสนอราคากําลังเรียนรู้เนื่องจากมีการเปลี่ยนแปลงการตั้งค่าเมื่อเร็วๆ นี้
LEARNING_BUDGET_CHANGE กลยุทธ์การเสนอราคากําลังเรียนรู้เนื่องจากมีการเปลี่ยนแปลงงบประมาณเมื่อเร็วๆ นี้
LEARNING_COMPOSITION_CHANGE กลยุทธ์การเสนอราคากําลังเรียนรู้เนื่องจากมีการเปลี่ยนแปลงจํานวนแคมเปญ กลุ่มโฆษณา หรือคีย์เวิร์ดที่แนบอยู่เมื่อเร็วๆ นี้
LEARNING_CONVERSION_TYPE_CHANGE กลยุทธ์การเสนอราคาขึ้นอยู่กับการรายงาน Conversion และประเภท Conversion ที่ลูกค้าแก้ไขล่าสุดซึ่งเกี่ยวข้องกับกลยุทธ์การเสนอราคา
LEARNING_CONVERSION_SETTING_CHANGE กลยุทธ์การเสนอราคาขึ้นอยู่กับการรายงาน Conversion และลูกค้าเพิ่งเปลี่ยนการตั้งค่า Conversion
LIMITED_BY_CPC_BID_CEILING กลยุทธ์การเสนอราคาถูกจํากัดโดยขีดจํากัดราคาเสนอ
LIMITED_BY_CPC_BID_FLOOR กลยุทธ์การเสนอราคาถูกจํากัดโดยราคาเสนอต่ำสุด
LIMITED_BY_DATA กลยุทธ์การเสนอราคาถูกจํากัดเนื่องจากมีการเข้าชม Conversion ไม่เพียงพอในช่วงหลายสัปดาห์ที่ผ่านมา
LIMITED_BY_BUDGET คีย์เวิร์ดจํานวนมากในกลยุทธ์การเสนอราคานี้ถูกจํากัดด้วยงบประมาณ
LIMITED_BY_LOW_PRIORITY_SPEND กลยุทธ์การเสนอราคาไม่สามารถใช้จ่ายตามเป้าหมายได้เนื่องจากมีการลดลําดับความสําคัญของการใช้จ่าย
LIMITED_BY_LOW_QUALITY คีย์เวิร์ดจํานวนมากในกลยุทธ์การเสนอราคานี้มีคะแนนคุณภาพต่ำ
LIMITED_BY_INVENTORY กลยุทธ์การเสนอราคาใช้งบประมาณได้ไม่เต็มจำนวนเนื่องจากการกําหนดเป้าหมายแคบ
MISCONFIGURED_ZERO_ELIGIBILITY ไม่มีเครื่องมือวัด Conversion (ไม่มีคําสั่ง ping) และ/หรือรายการรีมาร์เก็ตติ้งสําหรับ SSC
MISCONFIGURED_CONVERSION_TYPES กลยุทธ์การเสนอราคาขึ้นอยู่กับการรายงาน Conversion และลูกค้าไม่มีประเภท Conversion ที่อาจมีการรายงานกับกลยุทธ์นี้
MISCONFIGURED_CONVERSION_SETTINGS กลยุทธ์การเสนอราคาขึ้นอยู่กับการรายงาน Conversion และการตั้งค่า Conversion ของลูกค้าได้รับการกําหนดค่าไม่ถูกต้อง
MISCONFIGURED_SHARED_BUDGET มีแคมเปญที่อยู่นอกกลยุทธ์การเสนอราคาที่ใช้งบประมาณร่วมกับแคมเปญที่อยู่ในกลยุทธ์
MISCONFIGURED_STRATEGY_TYPE แคมเปญมีประเภทกลยุทธ์ไม่ถูกต้องและไม่ได้แสดง
PAUSED กลยุทธ์การเสนอราคาไม่ทำงาน ไม่มีแคมเปญ กลุ่มโฆษณา หรือคีย์เวิร์ดที่ใช้งานอยู่ซึ่งเชื่อมโยงกับกลยุทธ์การเสนอราคา หรือไม่มีงบประมาณที่ใช้งานอยู่ซึ่งเชื่อมต่อกับกลยุทธ์การเสนอราคา
UNAVAILABLE ปัจจุบันกลยุทธ์การเสนอราคานี้ยังไม่รองรับการรายงานสถานะ
MULTIPLE_LEARNING สถานะของระบบ LEARNING_* หลายรายการสําหรับกลยุทธ์การเสนอราคานี้ในช่วงเวลาที่เป็นปัญหา
MULTIPLE_LIMITED กลยุทธ์การเสนอราคานี้มีสถานะ LIMITED_* ของระบบหลายรายการในช่วงเวลาดังกล่าว
MULTIPLE_MISCONFIGURED สถานะ MISCONFIGURED_* ของระบบสําหรับกลยุทธ์การเสนอราคานี้มีอยู่หลายรายการในช่วงเวลาที่เป็นปัญหา
MULTIPLE กลยุทธ์การเสนอราคานี้มีสถานะของระบบหลายรายการในช่วงเวลาที่เป็นปัญหา

AdServingOptimizationStatus

Enum ที่อธิบายสถานะการแสดงผลที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
OPTIMIZE ระบบจะเพิ่มประสิทธิภาพการแสดงโฆษณาตาม CTR ของแคมเปญ
CONVERSION_OPTIMIZE ระบบจะเพิ่มประสิทธิภาพการแสดงโฆษณาตาม CTR * Conversion ของแคมเปญ หากแคมเปญไม่ได้อยู่ในกลยุทธ์การเสนอราคาของเครื่องมือเพิ่มประสิทธิภาพ Conversion สถานะจะเป็น "เพิ่มประสิทธิภาพแล้ว" โดยค่าเริ่มต้น
ROTATE ระบบจะหมุนเวียนโฆษณาอย่างเท่าๆ กันเป็นเวลา 90 วัน จากนั้นจึงเพิ่มประสิทธิภาพเพื่อการคลิก
ROTATE_INDEFINITELY แสดงโฆษณาที่มีประสิทธิภาพต่ำกว่าอย่างเท่าเทียมมากขึ้นกับโฆษณาที่มีประสิทธิภาพสูงกว่า และจะไม่เพิ่มประสิทธิภาพ
UNAVAILABLE สถานะการเพิ่มประสิทธิภาพการแสดงโฆษณาไม่พร้อมใช้งาน

AdvertisingChannelType

Enum ที่อธิบายประเภทช่องทางโฆษณาต่างๆ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SEARCH เครือข่าย Search รวมถึงแคมเปญ Display ที่รวมกลุ่มไว้ด้วยกันและแคมเปญ Search+
DISPLAY เครือข่าย Display ของ Google เท่านั้น
SHOPPING แคมเปญ Shopping จะแสดงในพร็อพเพอร์ตี้ Shopping และในผลการค้นหาของ google.com
HOTEL แคมเปญ Hotel Ads
VIDEO แคมเปญวิดีโอ
MULTI_CHANNEL App Campaign และ App Campaign เพื่อการมีส่วนร่วมที่ทํางานในหลายช่องทาง
LOCAL แคมเปญโฆษณาในพื้นที่
SMART Smart Campaign
PERFORMANCE_MAX แคมเปญ Performance Max
LOCAL_SERVICES แคมเปญบริการในพื้นที่
DISCOVERY แคมเปญ Discovery
TRAVEL แคมเปญการเดินทาง
SOCIAL แคมเปญโซเชียล

AdvertisingChannelSubType

Enum ที่อธิบายประเภทย่อยของแชแนลต่างๆ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้เป็นค่าผลลัพธ์เท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SEARCH_MOBILE_APP App Campaign บนอุปกรณ์เคลื่อนที่สําหรับ Search
DISPLAY_MOBILE_APP App Campaign บนอุปกรณ์เคลื่อนที่สําหรับ Display
SEARCH_EXPRESS แคมเปญ AdWords Express สําหรับ Search
DISPLAY_EXPRESS แคมเปญ AdWords Express สําหรับ Display
SHOPPING_SMART_ADS แคมเปญ Smart Shopping
DISPLAY_GMAIL_AD แคมเปญโฆษณา Gmail
DISPLAY_SMART_CAMPAIGN แคมเปญสมาร์ทดิสเพลย์ คุณไม่สามารถสร้างแคมเปญใหม่ของประเภทย่อยนี้ได้
VIDEO_OUTSTREAM แคมเปญโฆษณาวิดีโอนอกสตรีม
VIDEO_ACTION แคมเปญ TrueView for Action ของวิดีโอ
VIDEO_NON_SKIPPABLE แคมเปญวิดีโอที่มีโฆษณาวิดีโอแบบข้ามไม่ได้
APP_CAMPAIGN App Campaign ที่ช่วยให้คุณโปรโมตแอป Android หรือ iOS ได้อย่างง่ายดายในผลิตภัณฑ์และบริการยอดนิยมของ Google ซึ่งรวมถึง Search, Play, YouTube และเครือข่าย Display ของ Google
APP_CAMPAIGN_FOR_ENGAGEMENT App Campaign สําหรับการมีส่วนร่วม ซึ่งมุ่งเน้นที่การเพิ่มการมีส่วนร่วมกับแอปอีกครั้งในผลิตภัณฑ์และบริการยอดนิยมหลายรายการของ Google เช่น Search, YouTube และเครือข่าย Display ของ Google
LOCAL_CAMPAIGN แคมเปญที่ออกแบบมาเพื่อการโฆษณาในพื้นที่โดยเฉพาะ
SHOPPING_COMPARISON_LISTING_ADS แคมเปญข้อมูลการเปรียบเทียบของ Shopping
SMART_CAMPAIGN Smart Campaign มาตรฐาน
VIDEO_SEQUENCE แคมเปญวิดีโอที่มีโฆษณาวิดีโอต่อเนื่อง
APP_CAMPAIGN_FOR_PRE_REGISTRATION App Campaign สําหรับการลงทะเบียนล่วงหน้า ซึ่งออกแบบมาเพื่อโฆษณาการลงทะเบียนล่วงหน้าของแอปบนอุปกรณ์เคลื่อนที่โดยเฉพาะ โดยจะกําหนดเป้าหมายไปยังช่องทางโฆษณาหลายช่องทางใน Google Play, YouTube และเครือข่าย Display
VIDEO_REACH_TARGET_FREQUENCY แคมเปญเพื่อการเข้าถึงแบบวิดีโอที่มีกลยุทธ์การเสนอราคาตามความถี่เป้าหมายที่ต้องการ
TRAVEL_ACTIVITIES แคมเปญกิจกรรมการท่องเที่ยว
SOCIAL_FACEBOOK_TRACKING_ONLY การติดตามของ Facebook เฉพาะแคมเปญโซเชียล

CustomParameter

การแมปที่แท็กพารามิเตอร์ที่กำหนดเองใช้ใน trackingUrlTemplate, finalUrls หรือ mobile_final_urls ได้

การแสดง JSON 
{
  "key": string,
  "value": string
}
ช่อง
key

string

คีย์ที่ตรงกับชื่อแท็กพารามิเตอร์
value

string

ค่าที่จะแทนที่

RealTimeBiddingSetting

การตั้งค่าสําหรับการเสนอราคาแบบเรียลไทม์ ซึ่งเป็นฟีเจอร์ที่ใช้ได้กับแคมเปญที่กําหนดเป้าหมายเป็นเครือข่าย Ad Exchange เท่านั้น

การแสดง JSON 
{
  "optIn": boolean
}
ช่อง
optIn

boolean

แคมเปญเลือกใช้การเสนอราคาแบบเรียลไทม์หรือไม่

NetworkSettings

การตั้งค่าเครือข่ายสําหรับแคมเปญ

การแสดง JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
ช่อง
targetSearchNetwork

boolean

โฆษณาจะแสดงในเว็บไซต์พาร์ทเนอร์ในเครือข่าย Google Search หรือไม่ (กำหนดให้ targetGoogleSearch เป็น true ด้วย)
targetContentNetwork

boolean

โฆษณาจะแสดงในตําแหน่งที่กำหนดในเครือข่าย Display ของ Google หรือไม่ ตำแหน่งโฆษณาจะระบุโดยใช้เกณฑ์ตำแหน่งโฆษณา
targetPartnerSearchNetwork

boolean

โฆษณาจะแสดงในเครือข่ายพาร์ทเนอร์ของ Google หรือไม่ ฟีเจอร์นี้ใช้ได้กับบัญชีพาร์ทเนอร์ Google บางบัญชีเท่านั้น

DynamicSearchAdsSetting

การตั้งค่าสําหรับการควบคุมโฆษณา Search แบบไดนามิก (DSA)

การแสดง JSON 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
ช่อง
domainName

string

ต้องระบุ ชื่อโดเมนอินเทอร์เน็ตที่การตั้งค่านี้แสดง เช่น "google.com" หรือ "www.google.com"
languageCode

string

ต้องระบุ รหัสภาษาที่ระบุภาษาของโดเมน เช่น "en"
useSuppliedUrlsOnly

boolean

แคมเปญใช้ URL ที่ผู้ลงโฆษณาระบุแต่เพียงอย่างเดียวหรือไม่

ShoppingSetting

การตั้งค่าสําหรับแคมเปญ Shopping กําหนดขอบเขตผลิตภัณฑ์ที่แคมเปญสามารถโฆษณาได้ และวิธีที่แคมเปญนี้โต้ตอบกับแคมเปญ Shopping อื่นๆ

การแสดง JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
ช่อง
feedLabel

string

ป้ายกํากับฟีดของผลิตภัณฑ์ที่จะรวมไว้ในแคมเปญ ตั้งค่าได้เพียงรายการเดียวระหว่าง feedLabel หรือ salesCountry หากใช้แทน salesCountry ช่อง feedLabel จะยอมรับรหัสประเทศในรูปแบบเดียวกัน เช่น "XX" หรือจะเป็นสตริงใดก็ได้ที่ใช้เป็นป้ายกํากับฟีดใน Google Merchant Center
useVehicleInventory

boolean

กำหนดเป้าหมายพื้นที่โฆษณาข้อมูลยานพาหนะหรือไม่
merchantId

string (int64 format)

รหัสของบัญชี Merchant Center ต้องระบุข้อมูลในช่องนี้สำหรับการดำเนินการสร้าง ช่องนี้ไม่สามารถแก้ไขได้สำหรับแคมเปญ Shopping
salesCountry

string

ประเทศที่ขายผลิตภัณฑ์ที่จะรวมไว้ในแคมเปญ
campaignPriority

integer

ลําดับความสําคัญของแคมเปญ แคมเปญที่มีลําดับความสําคัญสูงกว่าจะมีความสำคัญมากกว่าแคมเปญที่มีลําดับความสําคัญต่ำกว่า ช่องนี้เป็นช่องที่ต้องกรอกสำหรับแคมเปญ Shopping โดยค่าอยู่ระหว่าง 0 ถึง 2 (รวม) ฟิลด์นี้เป็นฟิลด์ที่ไม่บังคับสําหรับแคมเปญ Smart Shopping แต่ต้องเท่ากับ 3 หากตั้งค่า
enableLocal

boolean

ระบุหรือไม่ว่าต้องการรวมผลิตภัณฑ์ในร้าน

GeoTargetTypeSetting

แสดงชุดการตั้งค่าที่เกี่ยวข้องกับการกำหนดเป้าหมายตามภูมิศาสตร์ของโฆษณา

การแสดง JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
ช่อง
positiveGeoTargetType

enum (PositiveGeoTargetType)

การตั้งค่าที่ใช้สําหรับการกำหนดเป้าหมายตามภูมิศาสตร์แบบบวกในแคมเปญนี้
negativeGeoTargetType

enum (NegativeGeoTargetType)

การตั้งค่าที่ใช้สําหรับการกําหนดเป้าหมายตามภูมิศาสตร์เชิงลบในแคมเปญนี้

PositiveGeoTargetType

ประเภทเป้าหมายทางภูมิศาสตร์เชิงบวกที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
PRESENCE_OR_INTEREST ระบุว่าระบบจะเรียกให้โฆษณาแสดงเมื่อผู้ใช้อยู่ในหรือแสดงความสนใจในสถานที่เป้าหมายของผู้ลงโฆษณา
SEARCH_INTEREST ระบุว่าระบบจะเรียกโฆษณาให้แสดงหากผู้ใช้ค้นหาสถานที่ตั้งเป้าหมายของผู้ลงโฆษณา ใช้ได้กับแคมเปญ Search และแคมเปญ Shopping มาตรฐานเท่านั้น
PRESENCE ระบุว่าระบบจะทริกเกอร์โฆษณาหากผู้ใช้อยู่ในสถานที่เป้าหมายของผู้ลงโฆษณาหรือไปที่สถานที่เป้าหมายเป็นประจำ

NegativeGeoTargetType

ประเภทเป้าหมายทางภูมิศาสตร์เชิงลบที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
PRESENCE_OR_INTEREST ระบุว่าผู้ใช้จะไม่เห็นโฆษณาหากอยู่ในหรือแสดงความสนใจในสถานที่ตั้งที่ยกเว้นของผู้ลงโฆษณา
PRESENCE ระบุว่าระบบจะยกเว้นไม่ให้ผู้ใช้เห็นโฆษณาหากผู้ใช้อยู่ในสถานที่ตั้งที่ผู้ลงโฆษณายกเว้น

FrequencyCapEntry

ประเภทนี้ไม่มีช่อง

กฎที่ระบุจํานวนครั้งที่สูงสุดที่โฆษณา (หรือชุดโฆษณาบางชุด) จะแสดงต่อผู้ใช้ได้ในระยะเวลาที่เจาะจง

SelectiveOptimization

การตั้งค่าการเพิ่มประสิทธิภาพแบบเลือกสําหรับแคมเปญนี้ ซึ่งประกอบด้วยชุดการกระทําที่ถือเป็น Conversion เพื่อเพิ่มประสิทธิภาพแคมเปญนี้ ฟีเจอร์นี้ใช้ได้กับ App Campaign ที่ใช้ MULTI_CHANNEL เป็น AdvertisingChannelType และ APP_CAMPAIGN หรือ APP_CAMPAIGN_FOR_ENGAGEMENT เป็น AdvertisingChannelSubType เท่านั้น

การแสดง JSON 
{
  "conversionActions": [
    string
  ]
}
ช่อง
conversionActions[]

string

ชุดชื่อแหล่งข้อมูลที่เลือกสําหรับการกระทําที่ถือเป็น Conversion เพื่อเพิ่มประสิทธิภาพแคมเปญนี้

OptimizationGoalSetting

การตั้งค่าเป้าหมายการเพิ่มประสิทธิภาพสําหรับแคมเปญนี้ ซึ่งประกอบด้วยชุดประเภทเป้าหมายการเพิ่มประสิทธิภาพ

การแสดง JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
ช่อง
optimizationGoalTypes[]

enum (OptimizationGoalType)

รายการประเภทเป้าหมายการเพิ่มประสิทธิภาพ

OptimizationGoalType

ประเภทเป้าหมายการเพิ่มประสิทธิภาพ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้เป็นค่าผลลัพธ์เท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CALL_CLICKS เพิ่มประสิทธิภาพเพื่อจำนวนคลิกการโทร Conversion การคลิกเพื่อโทรคือจํานวนครั้งที่ผู้ใช้เลือก "โทร" เพื่อติดต่อร้านค้าหลังจากดูโฆษณา
DRIVING_DIRECTIONS เพิ่มประสิทธิภาพสําหรับเส้นทางการขับรถ Conversion ของเส้นทางขับรถคือจํานวนครั้งที่ผู้ใช้เลือก "ขอเส้นทาง" เพื่อไปยังร้านค้าหลังจากดูโฆษณา
APP_PRE_REGISTRATION เพิ่มประสิทธิภาพเพื่อการลงทะเบียนล่วงหน้า Conversion ของการลงทะเบียนล่วงหน้าคือจํานวนการลงชื่อสมัครใช้การลงทะเบียนล่วงหน้าเพื่อรับการแจ้งเตือนเมื่อแอปเปิดตัว

TrackingSetting

การตั้งค่าระดับแคมเปญสําหรับข้อมูลการติดตาม

การแสดง JSON 
{
  "trackingUrl": string
}
ช่อง
trackingUrl

string

URL ที่ใช้สําหรับการติดตามแบบไดนามิก

ManualCpa

ประเภทนี้ไม่มีช่อง

กลยุทธ์การเสนอราคาด้วยตนเองซึ่งช่วยให้ผู้ลงโฆษณากําหนดราคาเสนอตามการกระทําที่ผู้ลงโฆษณาระบุ

ManualCpc

การเสนอราคาตามคลิกด้วยตนเองที่ผู้ใช้ชำระเงินต่อคลิก

การแสดง JSON 
{
  "enhancedCpcEnabled": boolean
}
ช่อง
enhancedCpcEnabled

boolean

ปรับปรุงราคาเสนอตามข้อมูลเครื่องมือเพิ่มประสิทธิภาพ Conversion หรือไม่

ManualCpm

ประเภทนี้ไม่มีช่อง

การเสนอราคาตามการแสดงผลด้วยตนเองซึ่งผู้ใช้จ่ายต่อการแสดงผล 1,000 ครั้ง

PercentCpc

กลยุทธ์การเสนอราคาที่ราคาเสนอคือเศษส่วนของราคาที่โฆษณาสำหรับสินค้าหรือบริการบางอย่าง

การแสดง JSON 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
ช่อง
cpcBidCeilingMicros

string (int64 format)

ขีดจํากัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากําหนดได้ ฟิลด์นี้เป็นฟิลด์ที่ไม่บังคับที่ผู้ลงโฆษณาป้อนและระบุไว้ในไมโครสตรีมในพื้นที่ หมายเหตุ: ระบบจะตีความค่า 0 ในลักษณะเดียวกับการไม่มีการกำหนด bid_ceiling
enhancedCpcEnabled

boolean

ปรับราคาเสนอสำหรับการประมูลแต่ละครั้งขึ้นหรือลง โดยขึ้นอยู่กับแนวโน้มที่จะได้รับ Conversion ราคาเสนอแต่ละรายการอาจสูงกว่า cpcBidCeilingMicros แต่ราคาเสนอเฉลี่ยของแคมเปญไม่ควรเกิน

TargetCpm

ประเภทนี้ไม่มีช่อง

CPM ที่ตั้งไว้ (ต้นทุนต่อการแสดงผลพันครั้ง) คือกลยุทธ์การเสนอราคาอัตโนมัติซึ่งกําหนดราคาเสนอเพื่อเพิ่มประสิทธิภาพตาม CPM เป้าหมายที่ตั้งไว้

CampaignAsset

ลิงก์ระหว่างแคมเปญกับชิ้นงาน

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของชิ้นงานแคมเปญ ชื่อทรัพยากร CampaignAsset อยู่ในรูปแบบต่อไปนี้

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}
status

enum (AssetLinkStatus)

สถานะของชิ้นงานแคมเปญ
campaign

string

แคมเปญที่ลิงก์กับชิ้นงาน
asset

string

ชิ้นงานที่ลิงก์กับแคมเปญ

CampaignAssetSet

CampaignAssetSet คือลิงก์ระหว่างแคมเปญกับชุดชิ้นงาน การเพิ่ม CampaignAssetSet จะลิงก์ชุดชิ้นงานกับแคมเปญ

การแสดง JSON 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
ช่อง
resourceName

string

ชื่อทรัพยากรของชุดชิ้นงานแคมเปญ ชื่อทรัพยากรชิ้นงานชุดมีรูปแบบดังนี้

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

แคมเปญที่ลิงก์กับชุดชิ้นงานนี้
assetSet

string

ชุดชิ้นงานที่ลิงก์กับแคมเปญ
status

enum (AssetSetLinkStatus)

สถานะของชิ้นงานชุดชิ้นงานของแคมเปญ อ่านอย่างเดียว

CampaignAudienceView

มุมมองกลุ่มเป้าหมายของแคมเปญ รวมถึงข้อมูลประสิทธิภาพจากความสนใจและรายการรีมาร์เก็ตติ้งสําหรับโฆษณาในเครือข่าย Display และเครือข่าย YouTube รวมถึงรายการรีมาร์เก็ตติ้งสําหรับโฆษณา Search (RLSA) ซึ่งรวบรวมตามเกณฑ์แคมเปญและกลุ่มเป้าหมาย มุมมองนี้จะมีเฉพาะกลุ่มเป้าหมายที่แนบไว้ในระดับแคมเปญเท่านั้น

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองกลุ่มเป้าหมายของแคมเปญ ชื่อทรัพยากรมุมมองกลุ่มเป้าหมายของแคมเปญมีรูปแบบดังนี้

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

เกณฑ์แคมเปญ

การแสดง JSON 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของเกณฑ์แคมเปญ ชื่อทรัพยากรเกณฑ์แคมเปญมีรูปแบบดังนี้

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}
displayName

string

ชื่อที่แสดงของเกณฑ์

ระบบจะไม่สนใจช่องนี้สำหรับการเปลี่ยน
type

enum (CriterionType)

ประเภทของเกณฑ์
status

enum (CampaignCriterionStatus)

สถานะของเกณฑ์
lastModifiedTime

string

วันที่และเวลาที่แก้ไขเกณฑ์แคมเปญนี้ครั้งล่าสุด โดยค่าวันที่และเวลาจะอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" และอยู่ตามเขตเวลาของลูกค้า
criterionId

string (int64 format)

รหัสของเกณฑ์

ระบบจะไม่สนใจช่องนี้ระหว่างการดัดแปลง
bidModifier

number

ตัวปรับราคาเสนอเมื่อเกณฑ์ตรงกัน ตัวแก้ไขต้องอยู่ในช่วง 0.1 - 10.0 เกณฑ์ประเภทต่างๆ ที่กําหนดเป้าหมายได้ส่วนใหญ่รองรับตัวแก้ไข ใช้ 0 เพื่อเลือกไม่ใช้ประเภทอุปกรณ์
negative

boolean

กำหนดว่าจะกําหนดเป้าหมาย (false) หรือยกเว้น (true) เกณฑ์

ฟิลด์สหภาพ criterion เกณฑ์แคมเปญ

ต้องตั้งค่าเพียงรายการเดียว criterion ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
keyword

object (KeywordInfo)

คีย์เวิร์ด
location

object (LocationInfo)

ตำแหน่ง
device

object (DeviceInfo)

อุปกรณ์
ageRange

object (AgeRangeInfo)

ช่วงอายุ
gender

object (GenderInfo)

เพศ
userList

object (UserListInfo)

รายชื่อผู้ใช้
language

object (LanguageInfo)

ภาษา
webpage

object (WebpageInfo)

หน้าเว็บ
locationGroup

object (LocationGroupInfo)

กลุ่มสถานที่ตั้ง

CampaignCriterionStatus

สถานะที่เป็นไปได้ของ CampaignCriterion

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED เกณฑ์แคมเปญเปิดใช้อยู่
PAUSED เกณฑ์แคมเปญหยุดชั่วคราว
REMOVED ระบบจะนำเกณฑ์แคมเปญออก

LanguageInfo

เกณฑ์ภาษา

การแสดง JSON 
{
  "languageConstant": string
}
ช่อง
languageConstant

string

ชื่อทรัพยากรค่าคงที่ภาษา

LocationGroupInfo

รัศมีรอบๆ รายการสถานที่ตั้งที่ระบุผ่านฟีด

การแสดง JSON 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
ช่อง
geoTargetConstants[]

string

ค่าคงที่ของเป้าหมายตามภูมิศาสตร์ที่จำกัดขอบเขตของพื้นที่ทางภูมิศาสตร์ภายในฟีด ปัจจุบันระบบอนุญาตให้ใช้ค่าคงที่เป้าหมายตามภูมิศาสตร์ได้เพียงค่าเดียว
radiusUnits

enum (LocationGroupRadiusUnits)

หน่วยของรัศมี ระบบรองรับไมล์และเมตรสำหรับค่าคงที่ของเป้าหมายตามภูมิศาสตร์ ระบบรองรับมิลลิไมล์และเมตรสำหรับชุดรายการฟีด จำเป็นต้องระบุค่านี้และตั้งค่าในการดำเนินการ CREATE
feedItemSets[]

string

ชุดรายการฟีดที่มีการกำหนดเป้าหมายรายการฟีด หากระบุรหัสหลายรายการ ระบบจะกำหนดเป้าหมายไปยังรายการทั้งหมดที่ปรากฏในชุดอย่างน้อย 1 ชุด ใช้ช่องนี้กับ geoTargetConstants ไม่ได้ ซึ่งไม่บังคับและตั้งค่าได้ในการดำเนินการ CREATE เท่านั้น
radius

string (int64 format)

ระยะทางในหน่วยที่ระบุรัศมีรอบสถานที่เป้าหมาย จำเป็นต้องระบุค่านี้และตั้งค่าในการดำเนินการ CREATE

LocationGroupRadiusUnits

หน่วยของระยะทางรัศมีในกลุ่มสถานที่ตั้ง (เช่น ไมล์)

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
METERS เมตร
MILES ไมล์
MILLI_MILES Milli Miles

CampaignEffectiveLabel

แสดงความสัมพันธ์ระหว่างแคมเปญกับป้ายกำกับที่มีประสิทธิภาพ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับค่ามาหรือกำหนดให้กับแคมเปญนี้โดยตรง

การแสดง JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูล ชื่อทรัพยากร CampaignEffectivelabel อยู่ในรูปแบบ customers/{customerId}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

แคมเปญที่แนบป้ายกํากับที่มีประสิทธิภาพอยู่
label

string

ป้ายกํากับที่มีประสิทธิภาพซึ่งกําหนดให้กับแคมเปญ
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับที่มีผล

CampaignLabel

แสดงความสัมพันธ์ระหว่างแคมเปญกับป้ายกำกับ

การแสดง JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูล ชื่อทรัพยากรป้ายกํากับแคมเปญอยู่ในรูปแบบ customers/{customerId}/campaignLabels/{campaign_id}~{label_id}
campaign

string

แคมเปญที่แนบป้ายกํากับ
label

string

ป้ายกํากับที่กําหนดให้กับแคมเปญ
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับ

CartDataSalesView

มุมมองการขายจากข้อมูลรถเข็นช็อปปิ้ง

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองการขายจากข้อมูลรถเข็นช็อปปิ้ง ชื่อทรัพยากรมุมมองข้อมูลยอดขายจากรถเข็นช็อปปิ้งอยู่ในรูปแบบ customers/{customerId}/cartDataSalesView

ผู้ชม

กลุ่มเป้าหมายเป็นตัวเลือกการกําหนดเป้าหมายที่มีประสิทธิภาพที่ช่วยให้คุณแบ่งแอตทริบิวต์กลุ่มเป้าหมายต่างๆ ได้ เช่น ข้อมูลประชากรและผู้สนใจโดยละเอียด เพื่อสร้างกลุ่มเป้าหมายที่แสดงถึงส่วนของกลุ่มเป้าหมาย

การแสดง JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของกลุ่มเป้าหมาย ชื่อกลุ่มเป้าหมายมีรูปแบบดังนี้

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

รหัสของกลุ่มเป้าหมาย
name

string

ต้องระบุ ชื่อกลุ่มเป้าหมาย โดยควรไม่ซ้ำกันในกลุ่มเป้าหมายทั้งหมด โดยต้องมีความยาวอย่างน้อย 1 และสูงสุด 255
description

string

คําอธิบายกลุ่มเป้าหมายนี้

ConversionAction

การกระทำที่ถือเป็น Conversion

การแสดง JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ชื่อทรัพยากรการกระทําที่ถือเป็น Conversion อยู่ในรูปแบบต่อไปนี้

customers/{customerId}/conversionActions/{conversion_action_id}
creationTime

string

การประทับเวลาของการสร้างกิจกรรม Floodlight ซึ่งจัดรูปแบบเป็น ISO 8601
status

enum (ConversionActionStatus)

สถานะของการกระทําที่ถือเป็น Conversion นี้สําหรับการสะสมเหตุการณ์ Conversion
type

enum (ConversionActionType)

ประเภทของการกระทําที่ถือเป็น Conversion นี้
category

enum (ConversionActionCategory)

หมวดหมู่ของ Conversion ที่รายงานสําหรับการกระทําที่ถือเป็น Conversion นี้
valueSettings

object (ValueSettings)

การตั้งค่าที่เกี่ยวข้องกับมูลค่าของเหตุการณ์ Conversion ที่เชื่อมโยงกับการกระทำที่ถือเป็น Conversion นี้
attributionModelSettings

object (AttributionModelSettings)

การตั้งค่าที่เกี่ยวข้องกับรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้
floodlightSettings

object (FloodlightSettings)

การตั้งค่า Floodlight สําหรับประเภท Conversion ของ Floodlight
id

string (int64 format)

รหัสของการกระทําที่ถือเป็น Conversion
name

string

ชื่อการกระทําที่ถือเป็น Conversion

ช่องนี้ต้องกรอกข้อมูลและไม่ควรเว้นว่างไว้เมื่อสร้างการกระทําที่ถือเป็น Conversion ใหม่
primaryForGoal

boolean

หากบิต primaryForGoal ของการกระทําที่ถือเป็น Conversion เป็นเท็จ การกระทําที่ถือเป็น Conversion จะเสนอราคาไม่ได้สําหรับแคมเปญทั้งหมด ไม่ว่าแคมเปญจะมีเป้าหมาย Conversion ของลูกค้าหรือเป้าหมาย Conversion ของแคมเปญก็ตาม อย่างไรก็ตาม เป้าหมาย Conversion ที่กําหนดเองจะไม่สนใจ primaryForGoal ดังนั้นหากแคมเปญมีเป้าหมาย Conversion ที่กําหนดเองซึ่งกําหนดค่าไว้ด้วยการกระทําที่ถือเป็น Conversion ที่มี primaryForGoal = false การกระทําที่ถือเป็น Conversion นั้นยังคงเสนอราคาได้ โดยค่าเริ่มต้น primaryForGoal จะมีค่าเป็น "จริง" หากไม่ได้ตั้งค่าไว้ ใน V9 คุณสามารถตั้งค่า primaryForGoal เป็นเท็จได้หลังจากสร้างผ่านการดำเนินการ "อัปเดต" เท่านั้น เนื่องจากไม่ได้ประกาศว่าเป็นค่าที่ไม่บังคับ
ownerCustomer

string

ชื่อทรัพยากรของลูกค้าเจ้าของการกระทำที่ถือเป็น Conversion หรือเป็นค่าว่างหากเป็นการกระทำที่ถือเป็น Conversion ที่ระบบกําหนด
includeInClientAccountConversionsMetric

boolean

การกระทำที่ถือเป็น Conversion นี้ควรรวมอยู่ในเมตริก "clientAccountConversions" หรือไม่
includeInConversionsMetric

boolean

การกระทำที่ถือเป็น Conversion นี้ควรรวมอยู่ในเมตริก "Conversion" หรือไม่
clickThroughLookbackWindowDays

string (int64 format)

จํานวนวันสูงสุดที่อาจผ่านไประหว่างการโต้ตอบ (เช่น การคลิก) กับเหตุการณ์ Conversion
appId

string

รหัสแอปสําหรับการกระทําที่ถือเป็น Conversion ของแอป

ConversionActionStatus

สถานะต่างๆ ที่เป็นไปได้ของการกระทำที่ถือเป็น Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED ระบบจะบันทึก Conversion
REMOVED ระบบจะไม่บันทึก Conversion
HIDDEN ระบบจะไม่บันทึก Conversion และการกระทําที่ถือเป็น Conversion จะไม่ปรากฏใน UI

ConversionActionType

ประเภทของการกระทําที่ถือเป็น Conversion ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AD_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้คลิกชิ้นงานการโทรของโฆษณา
CLICK_TO_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้ในอุปกรณ์เคลื่อนที่คลิกหมายเลขโทรศัพท์
GOOGLE_PLAY_DOWNLOAD Conversion ที่เกิดขึ้นเมื่อผู้ใช้ดาวน์โหลดแอปบนอุปกรณ์เคลื่อนที่จาก Google Play Store
GOOGLE_PLAY_IN_APP_PURCHASE Conversion ที่เกิดขึ้นเมื่อผู้ใช้ทําการซื้อในแอปผ่านการเรียกเก็บเงินของ Android
UPLOAD_CALLS Conversion การโทรที่ผู้ลงโฆษณาติดตามและอัปโหลด
UPLOAD_CLICKS Conversion ที่ผู้ลงโฆษณาติดตามและอัปโหลดด้วยการคลิกที่ระบุแหล่งที่มา
WEBPAGE Conversion ที่เกิดขึ้นในหน้าเว็บ
WEBSITE_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้โทรหาหมายเลขโทรศัพท์ที่สร้างขึ้นแบบไดนามิกจากเว็บไซต์ของผู้ลงโฆษณา
STORE_SALES_DIRECT_UPLOAD Conversion ยอดขายในร้านที่อิงตามการอัปโหลดข้อมูลผู้ขายบุคคลที่หนึ่งหรือบุคคลที่สาม เฉพาะลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะใช้ประเภทการอัปโหลดโดยตรงของยอดขายในร้านได้
STORE_SALES Conversion ยอดขายในร้านที่อิงตามการอัปโหลดข้อมูลผู้ขายจากบุคคลที่หนึ่งหรือบุคคลที่สาม และ/หรือการซื้อสินค้าในร้านค้าโดยใช้บัตรจากเครือข่ายการชําระเงิน เฉพาะลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะใช้ประเภทการขายในร้านค้าได้ อ่านอย่างเดียว
FIREBASE_ANDROID_FIRST_OPEN Conversion การเปิดแอป Android เป็นครั้งแรกที่ติดตามผ่าน Firebase
FIREBASE_ANDROID_IN_APP_PURCHASE Conversion การซื้อในแอปของแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_ANDROID_CUSTOM Conversion ที่กำหนดเองของแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_IOS_FIRST_OPEN Conversion การเปิดแอป iOS ครั้งแรกที่ติดตามผ่าน Firebase
FIREBASE_IOS_IN_APP_PURCHASE Conversion การซื้อในแอปของแอป iOS ที่ติดตามผ่าน Firebase
FIREBASE_IOS_CUSTOM Conversion ที่กำหนดเองของแอป iOS ที่ติดตามผ่าน Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversion การเปิดตัวแอป Android ครั้งแรกที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversion การซื้อในแอปของแอป Android ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversion ที่กำหนดเองของแอป Android ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversion การเปิดแอป iOS เป็นครั้งแรกที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversion การซื้อในแอปของแอป iOS ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversion ที่กำหนดเองของแอป iOS ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
ANDROID_APP_PRE_REGISTRATION Conversion ที่เกิดขึ้นเมื่อผู้ใช้ลงทะเบียนแอปบนอุปกรณ์เคลื่อนที่ล่วงหน้าจาก Google Play Store อ่านอย่างเดียว
ANDROID_INSTALLS_ALL_OTHER_APPS Conversion ที่ติดตามการดาวน์โหลดทั้งหมดใน Google Play ซึ่งไม่ได้ติดตามโดยประเภทที่เจาะจงแอป อ่านอย่างเดียว
FLOODLIGHT_ACTION กิจกรรม Floodlight ที่นับจํานวนครั้งที่ผู้ใช้เข้าชมหน้าเว็บหนึ่งๆ หลังจากเห็นหรือคลิกโฆษณาของผู้ลงโฆษณา อ่านอย่างเดียว
FLOODLIGHT_TRANSACTION กิจกรรม Floodlight ที่ติดตามยอดขายที่เกิดขึ้นหรือจำนวนสินค้าที่ขายไป รวมถึงตรวจสอบมูลค่ารวมของการขายแต่ละครั้งก็ได้ อ่านอย่างเดียว
GOOGLE_HOSTED Conversion ที่ติดตามการกระทําเกี่ยวกับสถานที่จากผลิตภัณฑ์และบริการของ Google หลังจากโต้ตอบกับโฆษณา อ่านอย่างเดียว
LEAD_FORM_SUBMIT Conversion ที่รายงานเมื่อผู้ใช้ส่งโฆษณาแบบกรอกฟอร์ม อ่านอย่างเดียว
SALESFORCE

เลิกใช้งานแล้ว: การผสานรวม Salesforce จะเริ่มหยุดให้บริการ และแทนที่ด้วยวิธีนําเข้า Conversion จาก Salesforce ที่ได้รับการปรับปรุงแล้ว - ดู https://support.google.com/google-ads/answer/14728349
SEARCH_ADS_360 Conversion ที่นําเข้าจากข้อมูล Floodlight ของ Search Ads 360 อ่านอย่างเดียว
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversion การโทรที่เกิดขึ้นในโฆษณา Smart Campaign ที่ไม่มีการตั้งค่าเครื่องมือวัดการโทร โดยใช้เกณฑ์ที่กำหนดเองของ Smart Campaign อ่านอย่างเดียว
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ผู้ใช้คลิกองค์ประกอบการโทรภายใน Google Maps Smart Campaign เท่านั้น อ่านอย่างเดียว
SMART_CAMPAIGN_MAP_DIRECTIONS ผู้ใช้ขอเส้นทางไปยังสถานที่ตั้งของธุรกิจภายใน Google Maps Smart Campaign เท่านั้น อ่านอย่างเดียว
SMART_CAMPAIGN_TRACKED_CALLS Conversion การโทรที่เกิดขึ้นในโฆษณา Smart Campaign ที่มีการตั้งค่าการติดตามการโทร โดยใช้เกณฑ์ที่กำหนดเองของ Smart Campaign อ่านอย่างเดียว
STORE_VISITS Conversion ที่เกิดขึ้นเมื่อผู้ใช้เข้าชมร้านค้าปลีกของผู้ลงโฆษณา อ่านอย่างเดียว
WEBPAGE_CODELESS Conversion ที่สร้างขึ้นจากเหตุการณ์ในเว็บไซต์ (เช่น การส่งแบบฟอร์มหรือการโหลดหน้าเว็บ) ที่ไม่ได้ใช้สnippet เหตุการณ์ที่โค้ดแยกต่างหาก อ่านอย่างเดียว
UNIVERSAL_ANALYTICS_GOAL Conversion ที่มาจากเป้าหมาย Universal Analytics ที่ลิงก์
UNIVERSAL_ANALYTICS_TRANSACTION Conversion ที่มาจากธุรกรรม Universal Analytics ที่ลิงก์
GOOGLE_ANALYTICS_4_CUSTOM Conversion ที่มาจาก Conversion เหตุการณ์ที่กําหนดเองของ Google Analytics 4 ที่ลิงก์
GOOGLE_ANALYTICS_4_PURCHASE Conversion ที่มาจาก Conversion การซื้อของ Google Analytics 4 ที่ลิงก์

ConversionActionCategory

หมวดหมู่ของ Conversion ที่เชื่อมโยงกับ ConversionAction

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DEFAULT หมวดหมู่เริ่มต้น
PAGE_VIEW ผู้ใช้เข้าชมหน้าเว็บ
PURCHASE เหตุการณ์การซื้อ การขาย หรือ "การสั่งซื้อ"
SIGNUP การดำเนินการของผู้ใช้ในการลงชื่อสมัครใช้
LEAD การดำเนินการที่ทำให้เกิดการสร้างลูกค้าเป้าหมาย
DOWNLOAD การดำเนินการดาวน์โหลดซอฟต์แวร์ (สำหรับแอป)
ADD_TO_CART การเพิ่มสินค้าลงในรถเข็นหรือถุงช็อปปิ้งในเว็บไซต์ของผู้ลงโฆษณา
BEGIN_CHECKOUT เมื่อมีผู้เข้าสู่ขั้นตอนการชําระเงินในเว็บไซต์ของผู้ลงโฆษณา
SUBSCRIBE_PAID การเริ่มการสมัครใช้บริการแบบชำระเงินสำหรับผลิตภัณฑ์หรือบริการ
PHONE_CALL_LEAD การโทรเพื่อแสดงความสนใจในข้อเสนอของผู้ลงโฆษณา
IMPORTED_LEAD Conversion โอกาสในการขายที่นําเข้าจากแหล่งที่มาภายนอกไปยัง Google Ads
SUBMIT_LEAD_FORM การส่งแบบฟอร์มในเว็บไซต์ของผู้ลงโฆษณาเพื่อแสดงความสนใจทางธุรกิจ
BOOK_APPOINTMENT การจองการนัดหมายกับธุรกิจของผู้ลงโฆษณา
REQUEST_QUOTE คำขอใบเสนอราคาหรือราคาโดยประมาณ
GET_DIRECTIONS การค้นหาที่ตั้งธุรกิจของผู้ลงโฆษณาโดยมีเจตนาที่จะเข้าชม
OUTBOUND_CLICK การคลิกไปยังเว็บไซต์ของพาร์ทเนอร์ผู้ลงโฆษณา
CONTACT การโทร, SMS, อีเมล, แชท หรือติดต่อประเภทอื่นๆ กับผู้ลงโฆษณา
ENGAGEMENT เหตุการณ์การมีส่วนร่วมในเว็บไซต์ เช่น เวลาที่ใช้ในการเข้าชมเว็บไซต์นานหรือเป้าหมายสมาร์ทของ Google Analytics (GA) มีไว้สําหรับนําเข้าเป้าหมาย GA, Firebase, GA Gold
STORE_VISIT การเข้าชมกิจการที่มีหน้าร้านจริง
STORE_SALE ยอดขายที่เกิดขึ้นในหน้าร้านจริง
QUALIFIED_LEAD Conversion โอกาสในการขายที่นําเข้าจากแหล่งที่มาภายนอกไปยัง Google Ads ซึ่งผู้ลงโฆษณา (ทีมการตลาด/ฝ่ายขาย) เป็นผู้พิจารณาว่าเข้าเกณฑ์เพิ่มเติม ในเส้นทางจากโอกาสในการขายไปสู่การขาย ผู้ลงโฆษณาจะได้รับโอกาสในการขาย จากนั้นจึงดําเนินการกับโอกาสเหล่านั้นด้วยการติดต่อผู้บริโภค หากผู้บริโภคสนใจและอาจซื้อผลิตภัณฑ์ ผู้ลงโฆษณาจะทําเครื่องหมายโอกาสในการขายดังกล่าวเป็น "โอกาสในการขายที่ตรงตามข้อกําหนด"
CONVERTED_LEAD Conversion ที่นำมาสู่โอกาสในการขายซึ่งนําเข้าจากแหล่งที่มาภายนอกไปยัง Google Ads ซึ่งได้ดําเนินการในขั้นตอนที่เลือกไว้จนเสร็จสมบูรณ์ตามที่ผู้ลงโฆษณาที่ต้องการสร้างลูกค้าเป้าหมายกําหนด

ValueSettings

การตั้งค่าที่เกี่ยวข้องกับมูลค่าของเหตุการณ์ Conversion ที่เชื่อมโยงกับการกระทำที่ถือเป็น Conversion นี้

การแสดง JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
ช่อง
defaultValue

number

ค่าที่จะใช้เมื่อมีการส่งเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้ด้วยค่าที่ไม่ถูกต้อง ไม่อนุญาต หรือขาดหายไป หรือเมื่อมีการกําหนดค่าการกระทําที่ถือเป็น Conversion นี้ให้ใช้ค่าเริ่มต้นเสมอ
defaultCurrencyCode

string

รหัสสกุลเงินที่จะใช้เมื่อมีการส่งเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้ด้วยรหัสสกุลเงินที่ไม่ถูกต้องหรือไม่มีรหัสสกุลเงิน หรือเมื่อมีการกําหนดค่าการกระทําที่ถือเป็น Conversion นี้ให้ใช้ค่าเริ่มต้นเสมอ
alwaysUseDefaultValue

boolean

ควบคุมว่าจะใช้ค่าเริ่มต้นและรหัสสกุลเงินเริ่มต้นแทนค่าและรหัสสกุลเงินที่ระบุในเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้หรือไม่

AttributionModelSettings

การตั้งค่าที่เกี่ยวข้องกับรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้

การแสดง JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
ช่อง
attributionModel

enum (AttributionModel)

ประเภทรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้
dataDrivenModelStatus

enum (DataDrivenModelStatus)

สถานะของรูปแบบการระบุแหล่งที่มาโดยอิงตามข้อมูลสําหรับการกระทําที่ถือเป็น Conversion

AttributionModel

รูปแบบการระบุแหล่งที่มาที่อธิบายวิธีกระจายเครดิตของ Conversion หนึ่งๆ ไปยังการโต้ตอบก่อนหน้าที่อาจเกิดขึ้นหลายครั้ง

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
EXTERNAL ใช้การระบุแหล่งที่มาภายนอก
GOOGLE_ADS_LAST_CLICK ให้เครดิตทั้งหมดของ Conversion แก่คลิกสุดท้าย
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK ให้เครดิตทั้งหมดของ Conversion แก่คลิกแรกโดยใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_LINEAR ให้เครดิตสําหรับ Conversion แก่คลิกทั้งหมดอย่างเท่าๆ กันโดยใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY ให้เครดิตมากขึ้นแบบทวีคูณสําหรับ Conversion แก่คลิกล่าสุดโดยใช้การระบุแหล่งที่มาของ Google Search (ครึ่งชีวิตของเครดิตคือ 1 สัปดาห์)
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED ให้เครดิต 40% ของ Conversion แก่คลิกแรกและคลิกสุดท้าย ส่วนที่เหลือ 20% จะกระจายอย่างเท่าเทียมกันไปยังคลิกอื่นๆ ทั้งหมด ข้อมูลนี้ใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN รูปแบบที่ยืดหยุ่นซึ่งใช้แมชชีนเลิร์นนิงเพื่อกําหนดการกระจายเครดิตที่เหมาะสมให้กับการคลิกโดยใช้การระบุแหล่งที่มาของ Google Search

DataDrivenModelStatus

แสดงสถานะของรูปแบบที่อิงตามข้อมูล

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AVAILABLE รูปแบบที่อิงตามข้อมูลพร้อมใช้งาน
STALE รูปแบบที่อิงตามข้อมูลล้าสมัย ไม่ได้อัปเดตอย่างน้อย 7 วัน ยังมีการใช้งานอยู่ แต่ระบบจะถือว่าหมดอายุหากไม่มีการอัปเดตเป็นเวลา 30 วัน
EXPIRED รูปแบบที่อิงตามข้อมูลหมดอายุแล้ว ไม่ได้อัปเดตอย่างน้อย 30 วันและใช้งานไม่ได้ สาเหตุที่พบบ่อยที่สุดคือมีเหตุการณ์ไม่ถึงจํานวนที่จําเป็นในช่วง 30 วันที่ผ่านมา
NEVER_GENERATED ไม่เคยสร้างรูปแบบที่อิงตามข้อมูล สาเหตุที่พบบ่อยที่สุดคือไม่มีเหตุการณ์ตามจํานวนที่จําเป็นในช่วง 30 วัน

FloodlightSettings

การตั้งค่าที่เกี่ยวข้องกับการกระทําที่ถือเป็น Conversion ของ Floodlight

การแสดง JSON 
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
ช่อง
activityGroupTag

string

สตริงที่ใช้ระบุกลุ่มกิจกรรม Floodlight เมื่อรายงาน Conversion
activityTag

string

สตริงที่ใช้ระบุกิจกรรม Floodlight เมื่อรายงาน Conversion
activityId

string (int64 format)

รหัสของกิจกรรม Floodlight ใน DoubleClick Campaign Manager (DCM)

ConversionCustomVariable

ตัวแปรที่กําหนดเองของ Conversion ดู "เกี่ยวกับเมตริกและมิติข้อมูล Floodlight ที่กำหนดเองใน Search Ads 360 เวอร์ชันใหม่" ที่ https://support.google.com/sa360/answer/13567857

การแสดง JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของตัวแปรที่กําหนดเองของ Conversion ชื่อทรัพยากรตัวแปรที่กําหนดเองของ Conversion อยู่ในรูปแบบต่อไปนี้

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

รหัสของตัวแปร Conversion ที่กําหนดเอง
name

string

ต้องระบุ ชื่อตัวแปรที่กําหนดเองของ Conversion ชื่อควรไม่ซ้ำกัน ชื่อมีความยาวได้สูงสุด 100 อักขระ โดยไม่ควรมีช่องว่างข้างหน้าและข้างหลัง
tag

string

ต้องระบุ แท็กของตัวแปร Conversion ที่กําหนดเอง แท็กควรไม่ซ้ำกันและประกอบด้วยอักขระ "u" ตามด้วยตัวเลขที่น้อยกว่าหรือเท่ากับ 100 เช่น "u4"
status

enum (ConversionCustomVariableStatus)

สถานะของตัวแปรที่กําหนดเองของ Conversion สําหรับการสะสมเหตุการณ์ Conversion
ownerCustomer

string

ชื่อแหล่งข้อมูลของลูกค้าที่เป็นเจ้าของตัวแปรที่กําหนดเองของ Conversion
family

enum (ConversionCustomVariableFamily)

ตระกูลของตัวแปรที่กําหนดเองของ Conversion
cardinality

enum (ConversionCustomVariableCardinality)

Cardinality ของตัวแปรที่กําหนดเองของ Conversion
floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

ช่องสําหรับตัวแปร Conversion ของ Floodlight ที่กําหนดเองของ Search Ads 360
customColumnIds[]

string (int64 format)

รหัสของคอลัมน์ที่กำหนดเองซึ่งใช้ตัวแปรที่กำหนดเองของ Conversion นี้

ConversionCustomVariableStatus

สถานะที่เป็นไปได้ของตัวแปรที่กําหนดเองสําหรับ Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ACTIVATION_NEEDED

ตัวแปรที่กําหนดเองสําหรับ Conversion รอการเปิดใช้งานและจะไม่สะสมสถิติจนกว่าจะตั้งค่าเป็น "เปิดใช้"

สถานะนี้ใช้ไม่ได้ในคำขอ CREATE และ UPDATE
ENABLED ตัวแปรที่กําหนดเองสําหรับ Conversion เปิดใช้แล้วและจะรวบรวมสถิติ
PAUSED ตัวแปรที่กําหนดเองสําหรับ Conversion จะหยุดชั่วคราวและจะไม่สะสมสถิติจนกว่าจะตั้งค่าเป็น "เปิดใช้" อีกครั้ง

ConversionCustomVariableFamily

ตระกูลของตัวแปรที่กําหนดเองสําหรับ Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
STANDARD ตัวแปร Conversion ที่กำหนดเองมาตรฐาน ลูกค้าต้องเปิดใช้งานก่อนใช้งาน
FLOODLIGHT ตัวแปร Conversion ที่กำหนดเองที่นําเข้าจากตัวแปร Floodlight ที่กำหนดเอง

ConversionCustomVariableCardinality

Cardinality ของตัวแปรที่กําหนดเองสําหรับ Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BELOW_ALL_LIMITS ตัวแปรที่กำหนดเองของ Conversion มี Cardinality ต่ำกว่าขีดจํากัดทั้งหมด คุณสามารถใช้ตัวแปรนี้ในการแบ่งกลุ่ม และระบบจะรวบรวมสถิติสําหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT ตัวแปรที่กำหนดเองสำหรับ Conversion มี Cardinality เกินขีดจํากัดการแบ่งกลุ่ม แต่ไม่เกินขีดจํากัดสถิติ ระบบจะปิดใช้การแบ่งกลุ่ม แต่สถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
APPROACHES_STATS_LIMIT ตัวแปรที่กำหนดเองของ Conversion เกินขีดจํากัดการแบ่งกลุ่ม และใกล้ถึงขีดจํากัดสถิติ (> 90%) ระบบจะปิดใช้การแบ่งกลุ่ม แต่สถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
EXCEEDS_STATS_LIMIT ตัวแปรที่กำหนดเองของ Conversion เกินทั้งขีดจํากัดการแบ่งกลุ่มและขีดจํากัดสถิติแล้ว ระบบจะปิดใช้การแบ่งกลุ่ม และสถิติสําหรับตัวแปรที่เปิดใช้จะเพิ่มขึ้นได้ก็ต่อเมื่อค่าที่มีอยู่ไม่ได้เพิ่ม Cardinality ของตัวแปรอีก

FloodlightConversionCustomVariableInfo

ข้อมูลสําหรับตัวแปร Conversion ของ Floodlight ที่กําหนดเองของ Search Ads 360

การแสดง JSON 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
ช่อง
floodlightVariableType

enum (FloodlightVariableType)

ประเภทตัวแปร Floodlight ที่กําหนดใน Search Ads 360
floodlightVariableDataType

enum (FloodlightVariableDataType)

ประเภทข้อมูลตัวแปร Floodlight ที่กําหนดใน Search Ads 360

FloodlightVariableType

ประเภทของตัวแปร Floodlight ตามที่กําหนดไว้ใน Search Ads 360 ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/searchads/answer/4397154?hl=en

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DIMENSION ประเภทตัวแปร Floodlight ของมิติข้อมูล
METRIC ประเภทตัวแปร Floodlight ของเมตริก
UNSET ไม่ได้ตั้งค่าประเภทตัวแปร Floodlight

FloodlightVariableDataType

ประเภทข้อมูลของตัวแปร Floodlight ตามที่กําหนดไว้ใน Search Ads 360 ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/searchads/answer/4397154?hl=en

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
NUMBER แสดงตัวแปร Floodlight ประเภท "ตัวเลข" ตัวแปรนี้อาจกำหนดให้กับตัวแปร Floodlight ประเภทมิติข้อมูลหรือเมตริก
STRING แสดงตัวแปร Floodlight ประเภท "สตริง" ตัวแปรนี้อาจกำหนดให้กับตัวแปร Floodlight ประเภทมิติข้อมูล

ลูกค้า

ลูกค้า

การแสดง JSON 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของลูกค้า ชื่อทรัพยากรของลูกค้ามีรูปแบบดังนี้

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

การตั้งค่าเครื่องมือวัด Conversion สําหรับลูกค้า
accountType

enum (AccountType)

ประเภทบัญชีเครื่องมือค้นหา เช่น Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track ฯลฯ
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

การตั้งค่า DoubleClick Campaign Manager (DCM) สําหรับลูกค้าบัญชีดูแลจัดการ
accountStatus

enum (AccountStatus)

สถานะบัญชี เช่น เปิดใช้ หยุดชั่วคราว นำออก ฯลฯ
lastModifiedTime

string

วันที่และเวลาที่แก้ไขลูกค้ารายนี้ครั้งล่าสุด โดยค่าวันที่และเวลาจะอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss" และอยู่ตามเขตเวลาของลูกค้า
engineId

string

รหัสของบัญชีในบัญชีเครื่องมือค้นหาภายนอก
status

enum (CustomerStatus)

สถานะของลูกค้า
creationTime

string

การประทับเวลาที่สร้างลูกค้ารายนี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss"
managerId

string (int64 format)

รหัสลูกค้าของผู้จัดการ ค่า 0 บ่งบอกว่าลูกค้าไม่มีผู้จัดการ SA360
managerDescriptiveName

string

ชื่อที่สื่อความหมายของผู้จัดการ
subManagerId

string (int64 format)

รหัสลูกค้าของบัญชีดูแลจัดการย่อย ค่า 0 บ่งบอกว่าลูกค้าไม่มีบัญชีดูแลจัดการ SA360 ย่อย
subManagerDescriptiveName

string

ชื่อที่สื่อความหมายของบัญชีดูแลจัดการย่อย
associateManagerId

string (int64 format)

รหัสลูกค้าของผู้จัดการร่วม ค่า 0 บ่งบอกว่าลูกค้าไม่มีบัญชีดูแลจัดการการเชื่อมโยง SA360
associateManagerDescriptiveName

string

ชื่อที่สื่อความหมายของผู้จัดการร่วม
accountLevel

enum (AccountLevelType)

ระดับบัญชีของลูกค้า ได้แก่ บัญชีดูแลจัดการ บัญชีดูแลจัดการย่อย บัญชีดูแลจัดการสำหรับพาร์ทเนอร์แบรนด์ บัญชีบริการ
id

string (int64 format)

รหัสของลูกค้า
descriptiveName

string

ชื่อที่สื่อความหมายของลูกค้า (ไม่บังคับ) ซึ่งซ้ำกันได้
currencyCode

string

สกุลเงินที่บัญชีใช้ ระบบรองรับชุดย่อยของรหัสสกุลเงินจากมาตรฐาน ISO 4217
timeZone

string

รหัสเขตเวลาท้องถิ่นของลูกค้า
trackingUrlTemplate

string

เทมเพลต URL สำหรับสร้าง URL ติดตามจากพารามิเตอร์
finalUrlSuffix

string

เทมเพลต URL สําหรับต่อท้ายพารามิเตอร์ไปยัง URL สุดท้าย
autoTaggingEnabled

boolean

ลูกค้าเปิดใช้การติดแท็กอัตโนมัติหรือไม่
manager

boolean

ลูกค้าเป็นผู้จัดการหรือไม่

ConversionTrackingSetting

ชุดการตั้งค่าระดับลูกค้าที่เกี่ยวข้องกับเครื่องมือวัด Conversion ของ Search Ads 360

การแสดง JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
ช่อง
acceptedCustomerDataTerms

boolean

ลูกค้ายอมรับข้อกําหนดสำหรับข้อมูลลูกค้าหรือไม่ หากใช้เครื่องมือวัด Conversion ข้ามบัญชี ระบบจะรับค่านี้มาจากบัญชีดูแลจัดการ ช่องนี้เป็นแบบอ่านอย่างเดียว ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/adspolicy/answer/7475709
conversionTrackingStatus

enum (ConversionTrackingStatus)

สถานะเครื่องมือวัด Conversion ข้อมูลนี้ระบุว่าลูกค้าใช้เครื่องมือวัด Conversion หรือไม่ และใครคือเจ้าของเครื่องมือวัด Conversion ของลูกค้ารายนี้ หากลูกค้ารายนี้ใช้เครื่องมือวัด Conversion ข้ามบัญชี ค่าที่แสดงจะแตกต่างกันไปตาม login-customer-id ของคําขอ
enhancedConversionsForLeadsEnabled

boolean

ลูกค้าเลือกใช้ Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขายหรือไม่ หากใช้เครื่องมือวัด Conversion ข้ามบัญชี ระบบจะรับค่านี้มาจากบัญชีดูแลจัดการ ช่องนี้เป็นแบบอ่านอย่างเดียว
googleAdsConversionCustomer

string

ชื่อแหล่งข้อมูลของลูกค้าที่สร้างและจัดการ Conversion ช่องนี้เป็นแบบอ่านอย่างเดียว
conversionTrackingId

string (int64 format)

รหัสเครื่องมือวัด Conversion ที่ใช้สําหรับบัญชีนี้ รหัสนี้ไม่ได้ระบุว่าลูกค้าใช้เครื่องมือวัด Conversion หรือไม่ (แต่ conversionTrackingStatus ระบุ) ช่องนี้เป็นแบบอ่านอย่างเดียว
googleAdsCrossAccountConversionTrackingId

string (int64 format)

รหัสเครื่องมือวัด Conversion ของผู้จัดการลูกค้า ระบบจะตั้งค่านี้เมื่อลูกค้าเลือกใช้เครื่องมือวัด Conversion และค่านี้จะลบล้าง conversionTrackingId จัดการช่องนี้ได้ผ่าน UI ของ Google Ads เท่านั้น ช่องนี้เป็นแบบอ่านอย่างเดียว
crossAccountConversionTrackingId

string (int64 format)

รหัสเครื่องมือวัด Conversion ของผู้จัดการลูกค้า ระบบจะตั้งค่านี้เมื่อลูกค้าเลือกใช้เครื่องมือวัด Conversion ข้ามบัญชี และค่านี้จะลบล้าง conversionTrackingId

ConversionTrackingStatus

สถานะเครื่องมือวัด Conversion ของลูกค้า

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
NOT_CONVERSION_TRACKED ลูกค้าไม่ได้ใช้เครื่องมือวัด Conversion
CONVERSION_TRACKING_MANAGED_BY_SELF การกระทำที่ถือเป็น Conversion สร้างขึ้นและจัดการโดยลูกค้ารายนี้
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER การกระทำที่ถือเป็น Conversion สร้างขึ้นและจัดการโดยผู้จัดการที่ระบุไว้ใน login-customer-id ของคําขอ
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER การกระทำที่ถือเป็น Conversion สร้างขึ้นและจัดการโดยผู้จัดการที่ไม่ใช่ลูกค้าหรือผู้จัดการที่ระบุไว้ในlogin-customer-idของคําขอ

AccountType

ประเภทบัญชีเครื่องมือที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BAIDU บัญชี Baidu
ENGINE_TRACK บัญชีการติดตามเครื่องมือค้นหา
FACEBOOK บัญชี Facebook
FACEBOOK_GATEWAY บัญชี Facebook ที่จัดการผ่านเกตเวย์
GOOGLE_ADS บัญชี Google Ads
MICROSOFT บัญชี Microsoft Advertising
SEARCH_ADS_360 บัญชีดูแลจัดการ Search Ads 360
YAHOO_JAPAN บัญชี Yahoo Japan

DoubleClickCampaignManagerSetting

การตั้งค่า DoubleClick Campaign Manager (DCM) สําหรับลูกค้าบัญชีดูแลจัดการ

การแสดง JSON 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
ช่อง
advertiserId

string (int64 format)

รหัสผู้ลงโฆษณา Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้
networkId

string (int64 format)

รหัสเครือข่าย Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้
timeZone

string

เขตเวลาของเครือข่าย Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้ในรูปแบบฐานข้อมูลเขตเวลา IANA เช่น America/New_York

AccountStatus

สถานะที่เป็นไปได้ของบัญชี

Enum
UNSPECIFIED ค่าเริ่มต้น
UNKNOWN ค่าที่ไม่รู้จัก
ENABLED บัญชีแสดงโฆษณาได้
PAUSED ผู้ใช้ปิดใช้งานบัญชี
SUSPENDED บัญชีถูกปิดใช้งานโดยกระบวนการภายใน
REMOVED บัญชีจะถูกปิดใช้งานอย่างถาวร
DRAFT บัญชียังอยู่ระหว่างการตั้งค่า ยังไม่ได้เปิดใช้

CustomerStatus

สถานะที่เป็นไปได้ของลูกค้า

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED บ่งบอกว่าบัญชีทํางานอยู่และแสดงโฆษณาได้
CANCELED บ่งบอกว่าบัญชีที่ถูกยกเลิกไม่สามารถแสดงโฆษณาได้ ผู้ใช้ที่ดูแลระบบสามารถเปิดใช้งานอีกครั้งได้
SUSPENDED บ่งบอกว่าบัญชีถูกระงับและแสดงโฆษณาไม่ได้ ทีมสนับสนุนของ Google เท่านั้นที่เปิดใช้งานได้
CLOSED บ่งบอกว่าบัญชีถูกปิดและแสดงโฆษณาไม่ได้ บัญชีทดสอบจะมีสถานะ "ปิด" ด้วย สถานะจะเป็นแบบถาวรและไม่สามารถเปิดใหม่ได้

AccountLevelType

Enum ที่อธิบายระดับบัญชีที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CLIENT_ACCOUNT_FACEBOOK บัญชีลูกค้า (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS บัญชีลูกค้า (Google Ads)
CLIENT_ACCOUNT_MICROSOFT บัญชีลูกค้า (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN บัญชีลูกค้า (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK บัญชีลูกค้า (การติดตามเครื่องมือค้นหา)
MANAGER ผู้จัดการระดับบนสุด
SUB_MANAGER บัญชีดูแลจัดการย่อย
ASSOCIATE_MANAGER ผู้ช่วยผู้จัดการ

CustomerAsset

ลิงก์ระหว่างลูกค้ากับเนื้อหา

การแสดง JSON 
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของเนื้อหาของลูกค้า ชื่อทรัพยากร CustomerAsset มีรูปแบบดังนี้

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

ต้องระบุ ชิ้นงานที่ลิงก์กับลูกค้า
status

enum (AssetLinkStatus)

สถานะของชิ้นงานของลูกค้า

CustomerAssetSet

CustomerAssetSet คือลิงก์ระหว่างลูกค้ากับชุดเนื้อหา การเพิ่ม CustomerAssetSet จะลิงก์ชุดชิ้นงานกับลูกค้า

การแสดง JSON 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
ช่อง
resourceName

string

ชื่อทรัพยากรของชุดเนื้อหาของลูกค้า ชื่อทรัพยากรชิ้นงานชุดมีรูปแบบดังนี้

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

ชุดชิ้นงานที่ลิงก์กับลูกค้า
customer

string

ลูกค้าที่มีการลิงก์ชุดชิ้นงานนี้
status

enum (AssetSetLinkStatus)

สถานะของชิ้นงานในชุดชิ้นงานของลูกค้า อ่านอย่างเดียว

AccessibleBiddingStrategy

แสดงมุมมองของ BiddingStrategies ที่ลูกค้าเป็นเจ้าของและแชร์กับลูกค้า

ซึ่งแตกต่างจาก BiddingStrategy ตรงที่แหล่งข้อมูลนี้รวมกลยุทธ์ที่ผู้จัดการของลูกค้าเป็นเจ้าของและแชร์กับลูกค้ารายนี้ไว้ด้วย นอกเหนือจากกลยุทธ์ที่ลูกค้ารายนี้เป็นเจ้าของ แหล่งข้อมูลนี้ไม่มีเมตริกและแสดงเฉพาะแอตทริบิวต์ BiddingStrategy ชุดย่อยที่จำกัดเท่านั้น

การแสดง JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
ช่อง
resourceName

string

ชื่อทรัพยากรของกลยุทธ์การเสนอราคาที่เข้าถึงได้ ชื่อทรัพยากร AccessibleBiddingStrategy มีรูปแบบดังนี้

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

รหัสของกลยุทธ์การเสนอราคา
name

string

ชื่อกลยุทธ์การเสนอราคา
type

enum (BiddingStrategyType)

ประเภทของกลยุทธ์การเสนอราคา
ownerCustomerId

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของกลยุทธ์การเสนอราคา
ownerDescriptiveName

string

descriptiveName ของลูกค้าที่เป็นเจ้าของกลยุทธ์การเสนอราคา

ฟิลด์สหภาพ scheme รูปแบบการเสนอราคา

ตั้งค่าได้เพียงรายการเดียว scheme ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
maximizeConversionValue

object (MaximizeConversionValue)

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้แคมเปญได้รับมูลค่า Conversion สูงสุดโดยอยู่ภายในงบประมาณที่กำหนดไว้
maximizeConversions

object (MaximizeConversions)

กลยุทธ์การเสนอราคาอัตโนมัติที่ช่วยให้แคมเปญได้รับ Conversion มากที่สุดภายในงบประมาณที่ตั้งไว้
targetCpa

object (TargetCpa)

กลยุทธ์การเสนอราคาที่กำหนดราคาเสนอเพื่อช่วยให้ได้รับ Conversion มากที่สุดที่ต้นทุนต่อการกระทำหนึ่งครั้ง (CPA) เป้าหมายที่ตั้งไว้
targetImpressionShare

object (TargetImpressionShare)

กลยุทธ์การเสนอราคาที่เพิ่มประสิทธิภาพโดยอัตโนมัติเพื่อการแสดงผลตามเปอร์เซ็นต์ที่เลือก
targetRoas

object (TargetRoas)

กลยุทธ์การเสนอราคาที่ช่วยเพิ่มรายได้สูงสุดไปพร้อมกับผลตอบแทนจากค่าโฆษณา (ROAS) เป้าหมายโดยเฉลี่ยที่ต้องการ
targetSpend

object (TargetSpend)

กลยุทธ์การเสนอราคาที่กำหนดราคาเสนอเพื่อให้คุณได้รับจำนวนคลิกมากที่สุดเท่าที่จะเป็นไปได้ภายในงบประมาณที่ตั้งไว้

MaximizeConversionValue

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้แคมเปญได้รับมูลค่า Conversion สูงสุดโดยอยู่ภายในงบประมาณที่กำหนดไว้

การแสดง JSON 
{
  "targetRoas": number
}
ช่อง
targetRoas

number

ตัวเลือกผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) หากตั้งค่าไว้ กลยุทธ์การเสนอราคาจะเพิ่มรายได้สูงสุดขณะที่เฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา หาก ROAS เป้าหมายสูง กลยุทธ์การเสนอราคาอาจใช้งบประมาณได้ไม่เต็มจำนวน หากไม่ได้กําหนด ROAS เป้าหมายไว้ กลยุทธ์การเสนอราคาจะมุ่งเพิ่ม ROAS ให้ได้สูงสุดตามงบประมาณ

MaximizeConversions

กลยุทธ์การเสนอราคาอัตโนมัติที่ช่วยให้แคมเปญได้รับ Conversion มากที่สุดภายในงบประมาณที่ตั้งไว้

การแสดง JSON 
{
  "targetCpa": string,
  "targetCpaMicros": string
}
ช่อง
targetCpa

string (int64 format)

ตัวเลือกต้นทุนต่อการกระทำหนึ่งครั้ง (CPA) เป้าหมาย ซึ่งเป็นจํานวนเงินเฉลี่ยที่คุณต้องการจ่ายต่อการได้ผู้ใช้ใหม่ 1 ราย
targetCpaMicros

string (int64 format)

ตัวเลือกต้นทุนต่อการกระทำหนึ่งครั้ง (CPA) เป้าหมาย ซึ่งเป็นจํานวนเงินเฉลี่ยที่คุณต้องการจ่ายต่อการได้ผู้ใช้ใหม่ 1 ราย

TargetCpa

กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อช่วยให้คุณได้ Conversion มากที่สุดจากต้นทุนต่อหนึ่งการกระทำ (CPA) ที่ตั้งไว้

การแสดง JSON 
{
  "targetCpaMicros": string
}
ช่อง
targetCpaMicros

string (int64 format)

เป้าหมาย CPA เฉลี่ย เป้าหมายนี้ควรมากกว่าหรือเท่ากับหน่วยที่เรียกเก็บเงินขั้นต่ำตามสกุลเงินของบัญชี

TargetImpressionShare

กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อให้โฆษณา Search เปอร์เซ็นต์หนึ่งแสดงที่ด้านบนของหน้าแรก (หรือตําแหน่งเป้าหมายอื่นๆ)

การแสดง JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
ช่อง
location

enum (TargetImpressionShareLocation)

ตําแหน่งเป้าหมายในหน้าผลการค้นหา
locationFractionMicros

string (int64 format)

ส่วนหนึ่งของโฆษณาที่เลือกให้แสดงในสถานที่เป้าหมายเป็นไมโคร เช่น 1% เท่ากับ 10,000
cpcBidCeilingMicros

string (int64 format)

ราคาเสนอ CPC สูงสุดที่ระบบการเสนอราคาอัตโนมัติได้รับอนุญาตให้ระบุ ช่องนี้เป็นช่องที่ต้องกรอกโดยผู้ลงโฆษณาซึ่งจะกำหนดเพดานและระบุในไมโครสตรีมในพื้นที่

TargetRoas

กลยุทธ์การเสนอราคาอัตโนมัติที่ช่วยเพิ่มรายได้สูงสุดไปพร้อมกับเฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) ที่เฉพาะเจาะจง

การแสดง JSON 
{
  "targetRoas": number
}
ช่อง
targetRoas

number

รายได้ที่เลือก (อิงตามข้อมูล Conversion) ต่อหน่วยการใช้จ่าย

TargetSpend

กลยุทธ์การเสนอราคาอัตโนมัติที่กำหนดราคาเสนอโดยอัตโนมัติเพื่อให้คุณได้รับคลิกมากที่สุดเท่าที่จะเป็นไปได้ภายในงบประมาณที่ตั้งไว้

การแสดง JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
ช่อง
targetSpendMicros
(deprecated)

string (int64 format)

เป้าหมายการใช้จ่ายที่จะเพิ่มจำนวนคลิกสูงสุด ผู้เสนอราคา TargetSpend จะพยายามใช้จ่ายตามค่าที่น้อยกว่าระหว่างค่านี้หรือจำนวนเงินที่ใช้จ่ายตามการจำกัดตามปกติ หากไม่ได้ระบุ ระบบจะใช้งบประมาณเป็นเป้าหมายการใช้จ่าย ช่องนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้อีกต่อไป ดูรายละเอียดได้ที่ https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html
cpcBidCeilingMicros

string (int64 format)

ขีดจํากัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากําหนดได้ ขีดจํากัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์จัดการ

ManagerLinkStatus

สถานะต่างๆ ที่เป็นไปได้ของลิงก์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ACTIVE ระบุความสัมพันธ์ที่มีผลในปัจจุบัน
INACTIVE บ่งบอกความสัมพันธ์ที่สิ้นสุดแล้ว
PENDING บ่งบอกว่าผู้จัดการได้ส่งคำขอความสัมพันธ์แล้ว แต่ลูกค้ายังไม่ได้ยอมรับ
REFUSED ผู้จัดการส่งคำขอความสัมพันธ์ แต่ลูกค้าปฏิเสธ
CANCELED บ่งบอกว่าผู้จัดการได้ส่งคำขอความสัมพันธ์ แต่ผู้จัดการยกเลิกคำขอแล้ว

CustomerClient

ลิงก์ระหว่างลูกค้ารายหนึ่งกับลูกค้าของลูกค้า CustomerClient มีอยู่สําหรับลูกค้าที่เป็นผู้จัดการเท่านั้น ซึ่งรวมถึงลูกค้าโดยตรงและโดยอ้อมทั้งหมดของบัญชีดูแลจัดการ รวมถึงตัวบัญชีดูแลจัดการเอง

การแสดง JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของลูกค้า ชื่อทรัพยากร CustomerClient อยู่ในรูปแบบ customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

ชื่อทรัพยากรของป้ายกำกับที่เป็นของลูกค้าที่ส่งคำขอซึ่งใช้กับลูกค้าของลูกค้า ชื่อทรัพยากรของป้ายกำกับมีรูปแบบดังนี้

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

สถานะของลูกค้าลูกค้า อ่านอย่างเดียว
clientCustomer

string

ชื่อทรัพยากรของลูกค้าที่ลิงก์กับลูกค้ารายดังกล่าว อ่านอย่างเดียว
hidden

boolean

ระบุว่าบัญชีนี้เป็นบัญชีที่ซ่อนอยู่หรือไม่

อ่านอย่างเดียว
level

string (int64 format)

ระยะทางระหว่างลูกค้ารายหนึ่งกับลูกค้ารายอื่น สำหรับลิงก์กับตนเอง ค่าระดับจะเป็น 0 อ่านอย่างเดียว
timeZone

string

การนําเสนอสตริงของที่เก็บข้อมูลภาษาที่พบบ่อย (CLDR) สําหรับเขตเวลาของลูกค้า เช่น America/Los_Angeles อ่านอย่างเดียว
testAccount

boolean

ระบุว่าลูกค้าเป็นบัญชีทดสอบหรือไม่ อ่านอย่างเดียว
manager

boolean

ระบุว่าลูกค้าเป็นผู้จัดการหรือไม่ อ่านอย่างเดียว
descriptiveName

string

ชื่อที่สื่อความหมายสำหรับไคลเอ็นต์ อ่านอย่างเดียว
currencyCode

string

รหัสสกุลเงิน (เช่น "USD", "EUR") สำหรับลูกค้า อ่านอย่างเดียว
id

string (int64 format)

รหัสของลูกค้า อ่านอย่างเดียว

DynamicSearchAdsSearchTermView

มุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิก

การแสดง JSON 
{
  "resourceName": string,
  "landingPage": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิก ชื่อทรัพยากรมุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิกมีรูปแบบดังนี้

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

URL หน้า Landing Page ที่เลือกแบบไดนามิกของการแสดงผล

ช่องนี้เป็นแบบอ่านอย่างเดียว

GenderView

มุมมองเพศ ทรัพยากร genderView จะแสดงสถานะการแสดงผลที่มีประสิทธิภาพ ไม่ใช่เกณฑ์ที่เพิ่ม กลุ่มโฆษณาที่ไม่มีเกณฑ์เพศจะแสดงต่อทุกเพศโดยค่าเริ่มต้น ดังนั้นทุกเพศจึงปรากฏในมุมมองเพศพร้อมสถิติ

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองเพศ ชื่อทรัพยากรของมุมมองเพศจะมีรูปแบบดังนี้

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

ค่าคงที่ของเป้าหมายตามภูมิศาสตร์

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์ ชื่อทรัพยากรคงที่สำหรับเป้าหมายตามภูมิศาสตร์มีรูปแบบดังนี้

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

สถานะค่าคงที่ของเป้าหมายตามภูมิศาสตร์
id

string (int64 format)

รหัสของค่าคงที่เป้าหมายตามภูมิศาสตร์
name

string

ชื่อภาษาอังกฤษของค่าคงที่เป้าหมายทางภูมิศาสตร์
countryCode

string

รหัสประเทศ ISO-3166-1 alpha-2 ที่เชื่อมโยงกับเป้าหมาย
targetType

string

ประเภทเป้าหมายคงที่ของเป้าหมายตามภูมิศาสตร์
canonicalName

string

ชื่อภาษาอังกฤษแบบเต็มที่ประกอบด้วยชื่อของเป้าหมาย ชื่อบริษัทแม่ และชื่อประเทศ
parentGeoTarget

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์หลัก ชื่อทรัพยากรคงที่สำหรับเป้าหมายตามภูมิศาสตร์มีรูปแบบดังนี้

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

สถานะที่เป็นไปได้ของค่าคงที่ของการกำหนดเป้าหมายตามภูมิศาสตร์

Enum
UNSPECIFIED ไม่ได้ระบุค่าไว้
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

ค่านี้เป็นค่าตอบกลับเท่านั้น
ENABLED ค่าคงที่ของเป้าหมายทางภูมิศาสตร์ถูกต้อง
REMOVAL_PLANNED ค่าคงที่เป้าหมายตามภูมิศาสตร์ล้าสมัยแล้วและจะถูกนําออก

KeywordView

มุมมองคีย์เวิร์ด

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองคีย์เวิร์ด ชื่อทรัพยากรของมุมมองคีย์เวิร์ดมีรูปแบบดังนี้

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

ป้ายกำกับ

ป้ายกำกับ

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูล ชื่อทรัพยากรป้ายกำกับอยู่ในรูปแบบ customers/{customerId}/labels/{label_id}
status

enum (LabelStatus)

สถานะของป้ายกำกับ อ่านอย่างเดียว
textLabel

object (TextLabel)

ป้ายกำกับประเภทหนึ่งที่แสดงข้อความบนพื้นหลังสี
id

string (int64 format)

รหัสของป้ายกำกับ อ่านอย่างเดียว
name

string

ชื่อของป้ายกำกับ

ฟิลด์นี้ต้องกรอกข้อมูลและไม่ควรเว้นว่างไว้เมื่อสร้างป้ายกำกับใหม่

ความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 80 อักขระ

LabelStatus

สถานะที่เป็นไปได้ของป้ายกำกับ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED เปิดใช้ป้ายกำกับแล้ว
REMOVED นำป้ายกำกับออกแล้ว

TextLabel

ป้ายกำกับประเภทหนึ่งที่แสดงข้อความบนพื้นหลังสี

การแสดง JSON 
{
  "backgroundColor": string,
  "description": string
}
ช่อง
backgroundColor

string

สีพื้นหลังของป้ายกำกับในรูปแบบ HEX สตริงนี้ต้องตรงกับนิพจน์ทั่วไป '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$' หมายเหตุ: บัญชีดูแลจัดการอาจไม่เห็นสีพื้นหลัง
description

string

คำอธิบายสั้นๆ ของป้ายกำกับ ความยาวต้องไม่เกิน 200 อักขระ

LanguageConstant

ภาษา

การแสดง JSON 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
ช่อง
resourceName

string

ชื่อทรัพยากรของค่าคงที่ภาษา ชื่อทรัพยากรค่าคงที่ของภาษามีรูปแบบดังนี้

languageConstants/{criterionId}
id

string (int64 format)

รหัสของค่าคงที่ภาษา
code

string

รหัสภาษา เช่น "en_US", "en_AU", "es", "fr" ฯลฯ
name

string

ชื่อเต็มของภาษาเป็นภาษาอังกฤษ เช่น "อังกฤษ (สหรัฐอเมริกา)" "สเปน" ฯลฯ
targetable

boolean

ภาษาที่กำหนดเป้าหมายได้หรือไม่

LocationView

มุมมองสถานที่ตั้งจะสรุปประสิทธิภาพของแคมเปญตามเกณฑ์สถานที่ตั้ง

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองสถานที่ตั้ง ชื่อทรัพยากรของมุมมองสถานที่ตั้งมีรูปแบบดังนี้

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

หมวดหมู่การเสนอราคาผลิตภัณฑ์

การแสดง JSON 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของหมวดหมู่การเสนอราคาผลิตภัณฑ์ ชื่อทรัพยากรหมวดหมู่การเสนอราคาผลิตภัณฑ์มีรูปแบบดังนี้

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

ระดับของหมวดหมู่การเสนอราคาผลิตภัณฑ์
status

enum (ProductBiddingCategoryStatus)

สถานะของหมวดหมู่การเสนอราคาผลิตภัณฑ์
id

string (int64 format)

รหัสของหมวดหมู่การเสนอราคาผลิตภัณฑ์

รหัสนี้เทียบเท่ากับรหัส google_product_category ตามที่อธิบายไว้ในบทความนี้ https://support.google.com/merchants/answer/6324436
countryCode

string

รหัสประเทศ 2 ตัวอักษรตัวพิมพ์ใหญ่ของหมวดหมู่การเสนอราคาผลิตภัณฑ์
productBiddingCategoryConstantParent

string

ชื่อทรัพยากรของหมวดหมู่การเสนอราคาผลิตภัณฑ์หลัก
languageCode

string

รหัสภาษาของหมวดหมู่การเสนอราคาผลิตภัณฑ์
localizedName

string

แสดงค่าของหมวดหมู่การเสนอราคาผลิตภัณฑ์ที่แปลแล้วตาม languageCode

ProductBiddingCategoryLevel

Enum ที่อธิบายระดับของหมวดหมู่การเสนอราคาผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
LEVEL1 ระดับ 1
LEVEL2 ระดับ 2
LEVEL3 ระดับ 3
LEVEL4 ระดับ 4
LEVEL5 ระดับ 5

ProductBiddingCategoryStatus

Enum ที่อธิบายสถานะของหมวดหมู่การเสนอราคาผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ACTIVE หมวดหมู่ทํางานอยู่และสามารถใช้สําหรับการเสนอราคาได้
OBSOLETE หมวดหมู่ล้าสมัย ใช้เพื่อการรายงานเท่านั้น

ProductGroupView

มุมมองกลุ่มผลิตภัณฑ์

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองกลุ่มผลิตภัณฑ์ ชื่อทรัพยากรของมุมมองกลุ่มผลิตภัณฑ์มีรูปแบบดังนี้

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

มุมมองประสิทธิภาพของ Shopping ให้สถิติแคมเปญ Shopping ที่รวบรวมในระดับมิติข้อมูลผลิตภัณฑ์หลายระดับ ค่ามิติข้อมูลผลิตภัณฑ์จาก Merchant Center เช่น แบรนด์ หมวดหมู่ แอตทริบิวต์ที่กำหนดเอง สภาพสินค้า และประเภทผลิตภัณฑ์ จะแสดงสถานะของมิติข้อมูลแต่ละรายการ ณ วันที่และเวลาที่บันทึกเหตุการณ์ที่เกี่ยวข้อง

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองประสิทธิภาพ Shopping ชื่อทรัพยากรของมุมมองประสิทธิภาพ Shopping อยู่ในรูปแบบ customers/{customerId}/shoppingPerformanceView

UserList

รายชื่อผู้ใช้ นี่คือรายชื่อผู้ใช้ที่ลูกค้าอาจกําหนดเป้าหมาย

การแสดง JSON 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของรายการผู้ใช้ ชื่อทรัพยากรรายการผู้ใช้อยู่ในรูปแบบต่อไปนี้

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

ประเภทของรายการนี้

ช่องนี้เป็นแบบอ่านอย่างเดียว
id

string (int64 format)

รหัสของรายชื่อผู้ใช้
name

string

ชื่อของรายการผู้ใช้นี้ ชื่อรายการผู้ใช้อาจไม่ซ้ำกันโดยขึ้นอยู่กับ access_reason (เช่น หาก access_reason=SHARED)

UserListType

Enum ที่มีประเภทรายการผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
REMARKETING UserList ที่แสดงเป็นคอลเล็กชันประเภท Conversion
LOGICAL UserList ที่แสดงเป็นรายการ/ความสนใจของผู้ใช้รายอื่นรวมกัน
EXTERNAL_REMARKETING UserList ที่สร้างขึ้นบนแพลตฟอร์ม Google Ad Manager
RULE_BASED UserList ที่เชื่อมโยงกับกฎ
SIMILAR UserList ที่มีผู้ใช้คล้ายกับผู้ใช้ของ UserList อื่น
CRM_BASED UserList ของข้อมูล CRM ของบุคคลที่หนึ่งที่ผู้ลงโฆษณาระบุในรูปแบบอีเมลหรือรูปแบบอื่นๆ

UserLocationView

มุมมองสถานที่ตั้งของผู้ใช้

มุมมองสถานที่ตั้งของผู้ใช้ประกอบด้วยเมตริกทั้งหมดที่รวบรวมในระดับประเทศ โดยจะมี 1 แถวต่อประเทศ โดยจะรายงานเมตริก ณ สถานที่ตั้งจริงของผู้ใช้ตามสถานที่ตั้งที่กำหนดกลุ่มเป้าหมายหรือไม่ได้กำหนดกลุ่มเป้าหมาย หากใช้ช่องกลุ่มอื่น คุณอาจได้รับแถวมากกว่า 1 แถวต่อประเทศ

การแสดง JSON 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของมุมมองตำแหน่งผู้ใช้ ชื่อทรัพยากรของมุมมอง UserLocation อยู่ในรูปแบบต่อไปนี้

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

รหัสเกณฑ์สําหรับประเทศ
targetingLocation

boolean

ระบุว่ามีการกําหนดเป้าหมายสถานที่หรือไม่

WebpageView

มุมมองหน้าเว็บ

การแสดง JSON 
{
  "resourceName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของมุมมองหน้าเว็บ ชื่อทรัพยากรการดูหน้าเว็บมีรูปแบบดังนี้

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

ไปที่

การเข้าชม

การแสดง JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
ช่อง
resourceName

string

ชื่อทรัพยากรของการเข้าชม ชื่อแหล่งข้อมูลของการเข้าชมมีรูปแบบดังนี้

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}
id

string (int64 format)

รหัสการเข้าชม
criterionId

string (int64 format)

รหัสคีย์เวิร์ด Search Ads 360 ค่า 0 บ่งบอกว่าคีย์เวิร์ดไม่มีแหล่งที่มา
merchantId

string (int64 format)

รหัสบัญชีสินค้าคงคลังของ Search Ads 360 ที่มีผลิตภัณฑ์ที่คลิก Search Ads 360 จะสร้างรหัสนี้เมื่อคุณลิงก์บัญชีสินค้าคงคลังใน Search Ads 360
adId

string (int64 format)

รหัสโฆษณา ค่า 0 บ่งบอกว่าโฆษณาไม่มีแหล่งที่มา
clickId

string

สตริงที่ไม่ซ้ำกันสําหรับการเข้าชมแต่ละครั้งที่ส่งไปยังหน้า Landing Page ในฐานะพารามิเตอร์ URL รหัสคลิก
visitDateTime

string

การประทับเวลาของเหตุการณ์การเข้าชม การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss"
productId

string

รหัสของผลิตภัณฑ์ที่คลิก
productChannel

enum (ProductChannel)

ช่องทางการขายของผลิตภัณฑ์ที่มีการคลิก: ออนไลน์หรือในพื้นที่
productLanguageCode

string

ภาษา (ISO-639-1) ที่ตั้งค่าไว้สำหรับฟีด Merchant Center ที่มีข้อมูลเกี่ยวกับผลิตภัณฑ์
productStoreId

string

ร้านค้าในโฆษณาสินค้าคงคลังในร้านที่มีการคลิก ซึ่งควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน
productCountryCode

string

ประเทศ (รูปแบบ ISO-3166) ที่จดทะเบียนสำหรับฟีดสินค้าคงคลังซึ่งมีผลิตภัณฑ์ที่คลิก
assetId

string (int64 format)

รหัสของชิ้นงานที่โต้ตอบระหว่างเหตุการณ์การเข้าชม
assetFieldType

enum (AssetFieldType)

ประเภทช่องชิ้นงานของเหตุการณ์การเข้าชม

ProductChannel

Enum ที่อธิบายสถานที่ตั้งของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ONLINE สินค้าขายทางออนไลน์
LOCAL สินค้ามีจำหน่ายในร้านค้าในพื้นที่

Conversion

Conversion

การแสดง JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของ Conversion ชื่อทรัพยากร Conversion อยู่ในรูปแบบต่อไปนี้

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}
id

string (int64 format)

รหัสของ Conversion
criterionId

string (int64 format)

รหัสเกณฑ์ Search Ads 360 ค่า 0 บ่งบอกว่าไม่มีแหล่งที่มาของเกณฑ์
merchantId

string (int64 format)

รหัสบัญชีสินค้าคงคลังของ Search Ads 360 ที่มีผลิตภัณฑ์ที่คลิก Search Ads 360 จะสร้างรหัสนี้เมื่อคุณลิงก์บัญชีสินค้าคงคลังใน Search Ads 360
adId

string (int64 format)

รหัสโฆษณา ค่า 0 บ่งบอกว่าโฆษณาไม่มีแหล่งที่มา
clickId

string

สตริงที่ไม่ซ้ำกันสําหรับการเข้าชมที่เป็นแหล่งที่มาของ Conversion ซึ่งส่งไปยังหน้า Landing Page ในฐานะพารามิเตอร์ของ URL รหัสคลิก
visitId

string (int64 format)

รหัสการเข้าชม Search Ads 360 ที่เป็นแหล่งที่มาของ Conversion
advertiserConversionId

string

สําหรับ Conversion ออฟไลน์ รหัสนี้คือรหัสที่ผู้ลงโฆษณาระบุ หากผู้ลงโฆษณาไม่ได้ระบุรหัสดังกล่าว Search Ads 360 จะสร้างรหัสให้ สําหรับ Conversion ออนไลน์ ค่านี้จะเท่ากับคอลัมน์รหัสหรือคอลัมน์ floodlightOrderId ทั้งนี้ขึ้นอยู่กับวิธีการของ Floodlight ที่ผู้ลงโฆษณาระบุ
productId

string

รหัสของผลิตภัณฑ์ที่คลิก
productChannel

enum (ProductChannel)

ช่องทางการขายของผลิตภัณฑ์ที่มีการคลิก: ออนไลน์หรือในพื้นที่
productLanguageCode

string

ภาษา (ISO-639-1) ที่ตั้งค่าไว้สำหรับฟีด Merchant Center ที่มีข้อมูลเกี่ยวกับผลิตภัณฑ์
productStoreId

string

ร้านค้าในโฆษณาสินค้าคงคลังในร้านที่มีการคลิก ซึ่งควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน
productCountryCode

string

ประเทศ (รูปแบบ ISO-3166) ที่จดทะเบียนสำหรับฟีดสินค้าคงคลังซึ่งมีผลิตภัณฑ์ที่คลิก
attributionType

enum (AttributionType)

แหล่งที่มาของ Conversion: การเข้าชมหรือคีย์เวิร์ด + โฆษณา
conversionDateTime

string

การประทับเวลาของเหตุการณ์ Conversion
conversionLastModifiedDateTime

string

การประทับเวลาที่แก้ไข Conversion ครั้งล่าสุด
conversionVisitDateTime

string

การประทับเวลาการเข้าชมที่เป็นแหล่งที่มาของ Conversion
conversionQuantity

string (int64 format)

จํานวนสินค้าที่บันทึกโดย Conversion ซึ่งพิจารณาจากพารามิเตอร์ qty url ผู้ลงโฆษณามีหน้าที่ป้อนข้อมูลพารามิเตอร์แบบไดนามิก (เช่น จํานวนสินค้าที่ขายใน Conversion) มิฉะนั้นค่าเริ่มต้นจะเป็น 1
conversionRevenueMicros

string (int64 format)

รายได้ที่ปรับแล้วในหน่วยไมโครสําหรับเหตุการณ์ Conversion ซึ่งจะแสดงเป็นสกุลเงินของบัญชีที่แสดงเสมอ
floodlightOriginalRevenue

string (int64 format)

รายได้เดิมที่ไม่มีการเปลี่ยนแปลงซึ่งเชื่อมโยงกับเหตุการณ์ Floodlight (ในสกุลเงินของรายงานปัจจุบัน) ก่อนการแก้ไขการตั้งค่าการรายงานสกุลเงินของ Floodlight
floodlightOrderId

string

รหัสคำสั่งซื้อ Floodlight ที่ผู้ลงโฆษณาระบุสำหรับ Conversion
status

enum (ConversionStatus)

สถานะของ Conversion ซึ่งก็คือ "เปิดใช้" หรือ "นําออก"
assetId

string (int64 format)

รหัสของชิ้นงานที่โต้ตอบระหว่างเหตุการณ์ Conversion
assetFieldType

enum (AssetFieldType)

ประเภทช่องชิ้นงานของเหตุการณ์ Conversion

AttributionType

ประเภทการระบุแหล่งที่มาของ Conversion ใน Search Ads 360

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
VISIT Conversion มีการระบุแหล่งที่มาเป็นการเข้าชม
CRITERION_AD Conversion นี้มาจากการระบุแหล่งที่มาของคู่เกณฑ์และโฆษณา

ConversionStatus

สถานะที่เป็นไปได้ของ Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED Conversion เปิดใช้งานแล้ว
REMOVED นํา Conversion ออกแล้ว

เมตริก

ข้อมูลเมตริก

การแสดง JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
ช่อง
allConversionsValueByConversionDate

number

มูลค่าของ Conversion ทั้งหมด เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
allConversionsByConversionDate

number

จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมด ไม่ว่าค่าของ includeInConversionsMetric จะเป็นอย่างไร เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
conversionCustomMetrics[]

object (Value)

เมตริก Conversion ที่กําหนดเอง
conversionsValueByConversionDate

number

ผลรวมของมูลค่า Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion
conversionsByConversionDate

number

ผลรวมของ Conversion ตามวันที่เกิด Conversion สําหรับประเภท Conversion ที่เสนอราคาได้ อาจมีเศษเนื่องจากรูปแบบการระบุแหล่งที่มา เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion
historicalCreativeQualityScore

enum (QualityScoreBucket)

คะแนนคุณภาพที่ผ่านมาของครีเอทีฟโฆษณา
historicalLandingPageQualityScore

enum (QualityScoreBucket)

คุณภาพของประสบการณ์หน้า Landing Page ที่ผ่านมา
historicalSearchPredictedCtr

enum (QualityScoreBucket)

อัตราการคลิกผ่าน (CTR) ที่คาดการณ์จากการค้นหาที่ผ่านมา
interactionEventTypes[]

enum (InteractionEventType)

ประเภทของการโต้ตอบแบบชำระเงินและไม่เสียค่าใช้จ่าย
rawEventConversionMetrics[]

object (Value)

เมตริก Conversion เหตุการณ์ดิบ
absoluteTopImpressionPercentage

number

ส่วนแบ่งการแสดงผลในตำแหน่งบนสุดแบบสัมบูรณ์ใน Search คือเปอร์เซ็นต์ของการแสดงโฆษณา Search ในตำแหน่งการค้นหาที่โดดเด่นที่สุด
allConversionsFromInteractionsRate

number

Conversion ทั้งหมดจากการโต้ตอบ (ไม่ใช่ Conversion การดูผ่าน) หารด้วยจํานวนการโต้ตอบกับโฆษณา
allConversionsValue

number

มูลค่าของ Conversion ทั้งหมด
allConversions

number

จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมด ไม่ว่าค่าของ includeInConversionsMetric จะเป็นอย่างไร
allConversionsValuePerCost

number

มูลค่าของ Conversion ทั้งหมดหารด้วยต้นทุนรวมของการโต้ตอบกับโฆษณา (เช่น การคลิกโฆษณาแบบข้อความหรือการดูโฆษณาวิดีโอ)
allConversionsFromClickToCall

number

จํานวนครั้งที่ผู้ใช้คลิกปุ่ม "โทร" เพื่อโทรหาร้านค้าในระหว่างหรือหลังจากที่คลิกโฆษณา ตัวเลขนี้จะไม่รวมข้อมูลว่าการโทรแต่ละครั้งมีผู้รับสายหรือไม่ และไม่รวมระยะเวลาของการโทรแต่ละครั้ง

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromDirections

number

จํานวนครั้งที่ผู้ใช้คลิกปุ่ม "ขอเส้นทาง" เพื่อนําทางไปยังร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromInteractionsValuePerInteraction

number

มูลค่าของ Conversion ทั้งหมดจากการโต้ตอบหารด้วยจํานวนการโต้ตอบทั้งหมด
allConversionsFromMenu

number

จํานวนครั้งที่ผู้ใช้คลิกลิงก์เพื่อดูเมนูของร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromOrder

number

จํานวนครั้งที่ผู้ใช้สั่งซื้อสินค้าที่ร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromOtherEngagement

number

จํานวน Conversion อื่นๆ (เช่น การโพสต์รีวิวหรือการบันทึกสถานที่ตั้งของร้านค้า) ซึ่งเกิดขึ้นหลังจากที่ผู้ใช้คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromStoreVisit

number

จํานวนครั้งที่มีผู้เข้าชมร้านค้าโดยประมาณหลังจากคลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
visits

number

การคลิกที่ Search Ads 360 บันทึกไว้และส่งต่อไปยังหน้า Landing Page ของผู้ลงโฆษณาสําเร็จ
allConversionsFromStoreWebsite

number

จํานวนครั้งที่ระบบนําผู้ใช้ไปยัง URL ของร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
averageCost

number

จํานวนเงินเฉลี่ยที่คุณจ่ายต่อการโต้ตอบ 1 ครั้ง จำนวนนี้คือค่าใช้จ่ายรวมของโฆษณาหารด้วยจำนวนการโต้ตอบทั้งหมด
averageCpc

number

ค่าใช้จ่ายรวมของคลิกทั้งหมดหารด้วยจํานวนคลิกทั้งหมดที่ได้รับ เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
averageCpm

number

ต้นทุนต่อการแสดงผลพันครั้ง (CPM) โดยเฉลี่ย เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clicks

string (int64 format)

จํานวนคลิก
contentBudgetLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของจำนวนครั้งที่โฆษณามีสิทธิ์แสดงในเครือข่าย Display แต่ไม่ได้แสดงเนื่องจากงบประมาณต่ำเกินไป หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลที่เสียไปเนื่องจากงบประมาณของเนื้อหาในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
contentImpressionShare

number

การแสดงผลที่คุณได้รับในเครือข่าย Display หารด้วยจํานวนโดยประมาณของการแสดงผลที่คุณมีสิทธิ์ได้รับ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลของเนื้อหาในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
contentRankLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของการแสดงผลในเครือข่าย Display ที่โฆษณาไม่ได้รับเนื่องจากลําดับโฆษณาต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลที่เสียไปในอันดับของเนื้อหาในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
conversionsFromInteractionsRate

number

Conversion ที่มีการเสนอราคาได้โดยเฉลี่ย (จากการโต้ตอบ) ต่อการโต้ตอบที่มีสิทธิ์เป็น Conversion แสดงความถี่โดยเฉลี่ยที่การโต้ตอบกับโฆษณาทําให้เกิด Conversion ที่เสนอราคาได้
clientAccountConversionsValue

number

มูลค่า Conversion ของบัญชีลูกค้า รวมเฉพาะการกระทําที่ถือเป็น Conversion ที่ตั้งค่าแอตทริบิวต์ includeInClientAccountConversionsMetric เป็น "จริง" หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพเพื่อ Conversion เหล่านี้
conversionsValuePerCost

number

มูลค่า Conversion ที่เสนอราคาได้หารด้วยต้นทุนรวมของการโต้ตอบที่มีสิทธิ์เป็น Conversion
conversionsFromInteractionsValuePerInteraction

number

มูลค่า Conversion จากการโต้ตอบหารด้วยจํานวนการโต้ตอบกับโฆษณา รวมเฉพาะการกระทําที่ถือเป็น Conversion ซึ่งตั้งค่าแอตทริบิวต์ includeInConversionsMetric เป็น "จริง" หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพเพื่อ Conversion เหล่านี้
clientAccountConversions

number

จํานวน Conversion ของบัญชีลูกค้า รวมเฉพาะการกระทําที่ถือเป็น Conversion ที่ตั้งค่าแอตทริบิวต์ includeInClientAccountConversionsMetric เป็น "จริง" หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพเพื่อ Conversion เหล่านี้
costMicros

string (int64 format)

ผลรวมของค่าใช้จ่ายจากราคาต่อหนึ่งคลิก (CPC) และราคาต่อการแสดงผลพันครั้ง (CPM) ในช่วงระยะเวลานี้ เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
costPerAllConversions

number

ต้นทุนของการโต้ตอบกับโฆษณาหารด้วย Conversion ทั้งหมด
costPerConversion

number

ต้นทุนที่มีสิทธิ์ของ Conversion เฉลี่ยต่อ Conversion ที่เสนอราคาได้
costPerCurrentModelAttributedConversion

number

ต้นทุนของการโต้ตอบกับโฆษณาหารด้วย Conversion ที่มีการระบุแหล่งที่มาตามโมเดลปัจจุบัน รวมเฉพาะการกระทําที่ถือเป็น Conversion ซึ่งตั้งค่าแอตทริบิวต์ includeInConversionsMetric เป็น "จริง" หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพเพื่อ Conversion เหล่านี้
crossDeviceConversions

number

Conversion ที่เกิดขึ้นเมื่อลูกค้าคลิกโฆษณาในอุปกรณ์หนึ่ง แล้วทํา Conversion ในอุปกรณ์หรือเบราว์เซอร์อื่น Conversion จากหลายอุปกรณ์รวมอยู่ใน allConversions อยู่แล้ว
crossDeviceConversionsByConversionDate

number

จํานวน Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
crossDeviceConversionsValue

number

ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์
crossDeviceConversionsValueByConversionDate

number

ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
ctr

number

จํานวนคลิกที่โฆษณาได้รับ (คลิก) หารด้วยจํานวนครั้งที่โฆษณาแสดง (การแสดงผล)
conversions

number

จำนวนของ Conversion รวมเฉพาะการกระทําที่ถือเป็น Conversion ซึ่งตั้งค่าแอตทริบิวต์ includeInConversionsMetric เป็น "จริง" หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพเพื่อ Conversion เหล่านี้
conversionsValue

number

ผลรวมของมูลค่า Conversion สำหรับ Conversion ที่รวมอยู่ในช่อง "Conversion" เมตริกนี้จะมีประโยชน์ก็ต่อเมื่อคุณได้ป้อนมูลค่าให้การกระทำที่ถือเป็น Conversion แล้ว
averageQualityScore

number

คะแนนคุณภาพเฉลี่ย
historicalQualityScore

string (int64 format)

คะแนนคุณภาพที่ผ่านมา
impressions

string (int64 format)

จํานวนความถี่ที่โฆษณาปรากฏในหน้าผลการค้นหาหรือเว็บไซต์ในเครือข่ายของ Google
interactionRate

number

ความถี่ที่ผู้ใช้โต้ตอบกับโฆษณาหลังจากที่เห็นโฆษณา ค่านี้คือจํานวนการโต้ตอบหารด้วยจํานวนครั้งที่โฆษณาแสดง
interactions

string (int64 format)

จํานวนการโต้ตอบ การโต้ตอบคือการกระทำหลักของผู้ใช้ที่เชื่อมโยงกับรูปแบบโฆษณา เช่น การคลิกสำหรับโฆษณาแบบข้อความและโฆษณา Shopping, การดูสำหรับโฆษณาวิดีโอ เป็นต้น
invalidClickRate

number

เปอร์เซ็นต์ของคลิกที่กรองออกจากจํานวนคลิกทั้งหมด (คลิกที่กรอง + คลิกที่ไม่ได้กรอง) ในช่วงระยะเวลาการรายงาน
invalidClicks

string (int64 format)

จํานวนการคลิกที่ Google ถือว่าผิดกฎและจะไม่เรียกเก็บเงินจากคุณ
generalInvalidClickRate

number

เปอร์เซ็นต์ของคลิกที่กรองออกจากจํานวนคลิกทั้งหมด (คลิกที่กรอง + คลิกที่ไม่ได้กรอง) เนื่องจากเป็นคลิกที่ไม่ถูกต้องทั่วไป ซึ่งเป็นคลิกที่ Google ถือว่าผิดหลักเกณฑ์โดยตรวจพบผ่านวิธีการกรองตามปกติ (เช่น การเข้าชมศูนย์ข้อมูลที่ทราบกันดีว่าไม่ถูกต้อง บ็อต และสไปเดอร์หรือ Crawler อื่นๆ รูปแบบที่ผิดปกติ ฯลฯ) ระบบจะไม่เรียกเก็บเงินสำหรับการคลิกดังกล่าว และการคลิกในลักษณะนี้จะไม่ส่งผลกระทบต่อสถิติในบัญชีของคุณ ดูรายละเอียดได้ที่หน้าความช่วยเหลือที่ https://support.google.com/campaignmanager/answer/6076504
generalInvalidClicks

string (int64 format)

จํานวนคลิกที่ไม่ถูกต้องทั่วไป คลิกเหล่านี้คือชุดย่อยของคลิกที่ไม่ถูกต้องซึ่งตรวจพบผ่านวิธีการกรองตามปกติ (เช่น การเข้าชมที่เกิดในศูนย์ข้อมูลซึ่งทราบว่าไม่ถูกต้อง, บ็อต, สไปเดอร์ หรือ Crawler อื่นๆ, รูปแบบที่ผิดปกติ เป็นต้น) ระบบจะไม่เรียกเก็บเงินสำหรับการคลิกดังกล่าว และการคลิกในลักษณะนี้จะไม่ส่งผลกระทบต่อสถิติในบัญชีของคุณ ดูรายละเอียดได้ที่หน้าความช่วยเหลือที่ https://support.google.com/campaignmanager/answer/6076504
mobileFriendlyClicksPercentage

number

เปอร์เซ็นต์การคลิกจากอุปกรณ์เคลื่อนที่ไปยังหน้าเว็บที่เหมาะกับอุปกรณ์เคลื่อนที่
searchAbsoluteTopImpressionShare

number

เปอร์เซ็นต์ของการแสดงโฆษณา Shopping หรือโฆษณา Search ของลูกค้าที่แสดงในตําแหน่ง Shopping ที่โดดเด่นที่สุด ดูรายละเอียดได้ที่ https://support.google.com/sa360/answer/9566729 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
searchBudgetLostAbsoluteTopImpressionShare

number

จํานวนโดยประมาณของความถี่ที่โฆษณาไม่ใช่โฆษณาแรกในกลุ่มโฆษณาที่ตำแหน่งบนสุดในผลการค้นหาเนื่องจากงบประมาณต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดแบบสัมบูรณ์ที่เสียไปใน Search ของงบประมาณในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchBudgetLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของจำนวนครั้งที่โฆษณามีสิทธิ์แสดงในเครือข่าย Search แต่ไม่ได้แสดงเนื่องจากงบประมาณต่ำเกินไป หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลที่เสียไปเนื่องจากงบประมาณ Search ในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchBudgetLostTopImpressionShare

number

จํานวนโดยประมาณของความถี่ที่โฆษณาไม่ได้แสดงถัดจากผลการค้นหาทั่วไปในตําแหน่งบนสุดเนื่องจากงบประมาณต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดที่เสียไปเนื่องจากงบประมาณ Search ในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchClickShare

number

จํานวนคลิกที่คุณได้รับในเครือข่าย Search หารด้วยจํานวนคลิกโดยประมาณที่คุณมีสิทธิ์ได้รับ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการคลิกจากการค้นหาในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
searchExactMatchImpressionShare

number

การแสดงผลที่คุณได้รับหารด้วยจํานวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับบนเครือข่าย Search สําหรับข้อความค้นหาที่ตรงกับคีย์เวิร์ดของคุณทั้งหมด (หรือเป็นรูปแบบใกล้เคียงของคีย์เวิร์ด) โดยไม่คํานึงถึงประเภทการทำงานของคีย์เวิร์ด หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลที่ทำงานแบบตรงทั้งหมดในการค้นหาในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
searchImpressionShare

number

การแสดงผลที่คุณได้รับในเครือข่าย Search หารด้วยจํานวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลบนการค้นหาในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
searchRankLostAbsoluteTopImpressionShare

number

จํานวนโดยประมาณของความถี่ที่โฆษณาไม่ใช่โฆษณาแรกในกลุ่มโฆษณาที่ตำแหน่งบนสุดในผลการค้นหาเนื่องจากลําดับโฆษณาต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดแบบสัมบูรณ์ที่เสียไปใน Search ตามลำดับในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchRankLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของการแสดงผลในเครือข่าย Search ที่โฆษณาไม่ได้รับเนื่องจากมีลําดับโฆษณาต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลที่เสียไปของอันดับ Search ในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchRankLostTopImpressionShare

number

จํานวนโดยประมาณของความถี่ที่โฆษณาไม่ได้แสดงถัดจากผลการค้นหาทั่วไปในตําแหน่งบนสุดเนื่องจากลําดับโฆษณาต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดที่เสียไปใน Search (อันดับ) ในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchTopImpressionShare

number

การแสดงผลที่คุณได้รับจากโฆษณาด้านบน เทียบกับจำนวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับในกลุ่มโฆษณาด้านบน หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดใน Search ในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999

โดยโฆษณามักจะแสดงเหนือผลการค้นหาทั่วไปในตำแหน่งบนสุด แต่ในบางกรณีก็อาจแสดงด้านล่างของผลการค้นหาทั่วไปในตำแหน่งบนสุดได้
topImpressionPercentage

number

เปอร์เซ็นต์ของการแสดงโฆษณาที่แสดงอยู่ติดกับผลการค้นหาทั่วไปในตำแหน่งบนสุด
valuePerAllConversions

number

มูลค่าของ Conversion ทั้งหมดหารด้วยจํานวน Conversion ทั้งหมด
valuePerAllConversionsByConversionDate

number

มูลค่าของ Conversion ทั้งหมดหารด้วยจํานวน Conversion ทั้งหมด เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
valuePerConversion

number

มูลค่าของ Conversion ที่เสนอราคาได้หารด้วยจํานวน Conversion ที่เสนอราคาได้ แสดงมูลค่าโดยเฉลี่ยของ Conversion ที่เสนอราคาได้แต่ละรายการ
valuePerConversionsByConversionDate

number

มูลค่า Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion หารด้วย Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion แสดงมูลค่าโดยเฉลี่ยของ Conversion ที่เสนอราคาได้แต่ละรายการ (ตามวันที่เกิด Conversion) เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion
clientAccountViewThroughConversions

string (int64 format)

จํานวน Conversion การดูผ่านทั้งหมด ประเภทนี้เกิดขึ้นเมื่อลูกค้าเห็นโฆษณาแบบรูปภาพหรือริชมีเดีย จากนั้นจึงเกิด Conversion เสร็จสมบูรณ์บนเว็บไซต์ในภายหลังโดยไม่ได้โต้ตอบกับ (เช่น คลิก) โฆษณาอื่น
clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากการขายครอสเซลของบัญชีลูกค้า (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล ต้นทุนสินค้าขายจากการขายครอสเซลคือต้นทุนรวมของผลิตภัณฑ์ที่ขายโดยไม่ได้โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากการขายครอสเซล (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล ต้นทุนสินค้าขายจากการขายครอสเซลคือต้นทุนรวมของผลิตภัณฑ์ที่ขายโดยไม่ได้โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากการขายครอสเซลของบัญชีลูกค้าคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่นลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในการขายจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล กําไรขั้นต้นจากการขายครอสเซลคือรายได้จากการขายครอสเซลที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว เสื้อราคา 600 บาทและมีมูลค่าต้นทุนสินค้าขาย 150 บาท กําไรขั้นต้นจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 450 บาท = 600 บาท - 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากการขายครอสเซลคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่นลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในการขายจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล กําไรขั้นต้นจากการขายครอสเซลคือรายได้จากการขายครอสเซลที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว เสื้อราคา 600 บาทและมีมูลค่าต้นทุนสินค้าขาย 150 บาท กําไรขั้นต้นจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 450 บาท = 600 บาท - 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellRevenueMicros

string (int64 format)

รายได้จากการขายครอสเซลของบัญชีลูกค้าคือจํานวนเงินทั้งหมดที่คุณได้มาจากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล รายได้จากการขายครอสเซลคือมูลค่าทั้งหมดที่คุณได้มาจากการขายครอสเซลที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากการขายครอสเซลสําหรับคําสั่งซื้อนี้เท่ากับ 600 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellRevenueMicros

string (int64 format)

รายได้จากการขายครอสเซลคือจํานวนเงินทั้งหมดที่คุณได้มาจากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล รายได้จากการขายครอสเซลคือมูลค่าทั้งหมดที่คุณได้มาจากการขายครอสเซลที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากการขายครอสเซลสําหรับคําสั่งซื้อนี้เท่ากับ 600 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellUnitsSold

number

จํานวนผลิตภัณฑ์ที่ขายได้จากการขายครอสเซลในบัญชีลูกค้าคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ทําให้เกิดการขายแบบครอสเซลจากคําสั่งซื้อทั้งหมดที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อเชิ้ตและแจ็คเก็ตอย่างละหนึ่งตัว จำนวนที่ขายได้จากการขายครอสเซลในคําสั่งซื้อนี้คือ 2 เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
crossSellUnitsSold

number

จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ทําให้เกิดการขายแบบครอสเซลจากคําสั่งซื้อทั้งหมดที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อเชิ้ตและแจ็คเก็ตอย่างละหนึ่งตัว จำนวนที่ขายได้จากการขายครอสเซลในคําสั่งซื้อนี้คือ 2 เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา (COGS) ของบัญชีลูกค้าคือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน ต้นทุนของสินค้าเหล่านี้จะนับภายใต้ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณาสําหรับคําสั่งซื้อนี้เท่ากับ 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน ต้นทุนของสินค้าเหล่านี้จะนับภายใต้ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณาสําหรับคําสั่งซื้อนี้เท่ากับ 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาในบัญชีลูกค้าคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกันลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาจะมาจากรายได้จากการขายเหล่านี้ลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท กำไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้เท่ากับ 210 บาท = 300 บาท - 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกันลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาจะมาจากรายได้จากการขายเหล่านี้ลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท กำไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้เท่ากับ 210 บาท = 300 บาท - 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadRevenueMicros

string (int64 format)

รายได้จากผลิตภัณฑ์ที่โฆษณาในบัญชีลูกค้าคือจํานวนเงินทั้งหมดที่ได้มาจากผลิตภัณฑ์ที่ขายได้เนื่องจากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน มูลค่ารวมจากการขายผลิตภัณฑ์เหล่านี้จะปรากฏใต้รายได้จากผลิตภัณฑ์ที่โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้คือ 300 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadRevenueMicros

string (int64 format)

รายได้จากผลิตภัณฑ์ที่โฆษณาคือจํานวนเงินทั้งหมดที่ได้มาจากผลิตภัณฑ์ที่ขายได้เนื่องจากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน มูลค่ารวมจากการขายผลิตภัณฑ์เหล่านี้จะปรากฏใต้รายได้จากผลิตภัณฑ์ที่โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้คือ 300 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadUnitsSold

number

จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ของบัญชีลูกค้าคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จะปรากฏในจํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อเชิ้ตและแจ็คเก็ตอย่างละหนึ่งตัว จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ในคําสั่งซื้อนี้คือ 1 ชิ้น เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
leadUnitsSold

number

จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้คือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จะปรากฏในจํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อเชิ้ตและแจ็คเก็ตอย่างละหนึ่งตัว จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ในคําสั่งซื้อนี้คือ 1 ชิ้น เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น

ค่า

คอนเทนเนอร์ข้อมูลทั่วไป

การแสดง JSON 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
ช่อง
ฟิลด์สหภาพ value ค่า value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
booleanValue

boolean

บูลีน
int64Value

string (int64 format)

int64
floatValue

number

ฟลอยท์
doubleValue

number

ห้องพักขนาดใหญ่
stringValue

string

สตริง

QualityScoreBucket

Enum ที่แสดงกลุ่มคะแนนคุณภาพที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BELOW_AVERAGE คุณภาพของครีเอทีฟโฆษณาต่ำกว่าค่าเฉลี่ย
AVERAGE คุณภาพของครีเอทีฟโฆษณาอยู่ในระดับปานกลาง
ABOVE_AVERAGE คุณภาพของครีเอทีฟโฆษณาสูงกว่าค่าเฉลี่ย

InteractionEventType

Enum ที่อธิบายประเภทของการโต้ตอบแบบชำระเงินและแบบไม่เสียค่าใช้จ่ายที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CLICK คลิกเพื่อเข้าชมเว็บไซต์ ในกรณีส่วนใหญ่ การโต้ตอบนี้จะไปยังตำแหน่งภายนอก ซึ่งมักจะเป็นหน้า Landing Page ของผู้ลงโฆษณา ซึ่งยังเป็น InteractionEventType เริ่มต้นสําหรับเหตุการณ์การคลิกด้วย
ENGAGEMENT ความตั้งใจที่ผู้ใช้แสดงออกเพื่อมีส่วนร่วมกับโฆษณาในตำแหน่งนั้นๆ
VIDEO_VIEW ผู้ใช้ดูโฆษณาวิดีโอ
NONE InteractionEventType เริ่มต้นสําหรับเหตุการณ์ Conversion ของโฆษณา รายการนี้ใช้เมื่อแถว Conversion ของโฆษณาไม่ได้ระบุว่าควร "โปรโมต" การโต้ตอบแบบไม่มีค่าใช้จ่าย (เช่น Conversion ของโฆษณา) และรายงานเป็นส่วนหนึ่งของเมตริกหลัก รายการเหล่านี้เป็นเพียง Conversion (โฆษณา) อื่นๆ

กลุ่ม

ฟิลด์กลุ่มเท่านั้น

การแสดง JSON 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
ช่อง
adNetworkType

enum (AdNetworkType)

ประเภทเครือข่ายโฆษณา
conversionActionCategory

enum (ConversionActionCategory)

หมวดหมู่การกระทำที่ถือเป็น Conversion
conversionCustomDimensions[]

object (Value)

มิติข้อมูลที่กำหนดเองของ Conversion
dayOfWeek

enum (DayOfWeek)

วันในสัปดาห์ เช่น วันจันทร์
device

enum (Device)

อุปกรณ์ที่ใช้เมตริก
keyword

object (Keyword)

เกณฑ์คีย์เวิร์ด
productChannel

enum (ProductChannel)

ช่องทางของผลิตภัณฑ์
productChannelExclusivity

enum (ProductChannelExclusivity)

ความมีเอกสิทธิ์ของช่องทางของผลิตภัณฑ์
productCondition

enum (ProductCondition)

สภาพของผลิตภัณฑ์
productSoldCondition

enum (ProductCondition)

สภาพของผลิตภัณฑ์ที่ขาย
rawEventConversionDimensions[]

object (Value)

มิติข้อมูล Conversion เหตุการณ์ดิบ
conversionAction

string

ชื่อทรัพยากรของการกระทําที่ถือเป็น Conversion
conversionActionName

string

ชื่อการกระทำที่ถือเป็น Conversion
date

string

วันที่ที่เมตริกมีผล รูปแบบ ปปปป-ดด-วว เช่น 2018-04-17
geoTargetCity

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์ที่แสดงถึงเมือง
geoTargetCountry

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์ที่แสดงถึงประเทศ
geoTargetMetro

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์ที่แสดงถึงเขตมหานคร
geoTargetRegion

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์ที่แสดงถึงภูมิภาค
hour

integer

ชั่วโมงของวันเป็นตัวเลขระหว่าง 0 ถึง 23
month

string

เดือนที่แสดงโดยวันที่ของวันแรกของเดือน มีรูปแบบเป็น yyyy-MM-dd
productBiddingCategoryLevel1

string

หมวดหมู่การเสนอราคา (ระดับ 1) ของผลิตภัณฑ์
productBiddingCategoryLevel2

string

หมวดหมู่การเสนอราคา (ระดับ 2) ของผลิตภัณฑ์
productBiddingCategoryLevel3

string

หมวดหมู่การเสนอราคา (ระดับ 3) ของผลิตภัณฑ์
productBiddingCategoryLevel4

string

หมวดหมู่การเสนอราคา (ระดับ 4) ของผลิตภัณฑ์
productBiddingCategoryLevel5

string

หมวดหมู่การเสนอราคา (ระดับ 5) ของผลิตภัณฑ์
productBrand

string

แบรนด์ของผลิตภัณฑ์
productCountry

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์สำหรับประเทศที่ขายผลิตภัณฑ์
productCustomAttribute0

string

แอตทริบิวต์ที่กำหนดเอง 0 ของผลิตภัณฑ์
productCustomAttribute1

string

แอตทริบิวต์ที่กำหนดเอง 1 ของผลิตภัณฑ์
productCustomAttribute2

string

แอตทริบิวต์ที่กำหนดเอง 2 ของผลิตภัณฑ์
productCustomAttribute3

string

แอตทริบิวต์ที่กำหนดเอง 3 ของผลิตภัณฑ์
productCustomAttribute4

string

แอตทริบิวต์ที่กำหนดเอง 4 ของผลิตภัณฑ์
productItemId

string

รหัสสินค้าของผลิตภัณฑ์
productLanguage

string

ชื่อทรัพยากรของค่าคงที่ภาษาสำหรับภาษาของผลิตภัณฑ์
productSoldBiddingCategoryLevel1

string

หมวดหมู่การเสนอราคา (ระดับ 1) ของผลิตภัณฑ์ที่ขาย
productSoldBiddingCategoryLevel2

string

หมวดหมู่การเสนอราคา (ระดับ 2) ของผลิตภัณฑ์ที่ขาย
productSoldBiddingCategoryLevel3

string

หมวดหมู่การเสนอราคา (ระดับ 3) ของผลิตภัณฑ์ที่ขาย
productSoldBiddingCategoryLevel4

string

หมวดหมู่การเสนอราคา (ระดับ 4) ของผลิตภัณฑ์ที่ขาย
productSoldBiddingCategoryLevel5

string

หมวดหมู่การเสนอราคา (ระดับ 5) ของผลิตภัณฑ์ที่ขาย
productSoldBrand

string

แบรนด์ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute0

string

แอตทริบิวต์ที่กำหนดเอง 0 ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute1

string

แอตทริบิวต์ที่กำหนดเอง 1 ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute2

string

แอตทริบิวต์ที่กำหนดเอง 2 ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute3

string

แอตทริบิวต์ที่กำหนดเอง 3 ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute4

string

แอตทริบิวต์ที่กำหนดเอง 4 ของผลิตภัณฑ์ที่ขาย
productSoldItemId

string

รหัสสินค้าของผลิตภัณฑ์ที่ขาย
productSoldTitle

string

ชื่อผลิตภัณฑ์ที่ขาย
productSoldTypeL1

string

ประเภท (ระดับ 1) ของผลิตภัณฑ์ที่ขาย
productSoldTypeL2

string

ประเภท (ระดับ 2) ของผลิตภัณฑ์ที่ขาย
productSoldTypeL3

string

ประเภท (ระดับ 3) ของผลิตภัณฑ์ที่ขาย
productSoldTypeL4

string

ประเภท (ระดับ 4) ของผลิตภัณฑ์ที่ขาย
productSoldTypeL5

string

ประเภท (ระดับ 5) ของผลิตภัณฑ์ที่ขาย
productStoreId

string

รหัสร้านค้าของผลิตภัณฑ์
productTitle

string

ชื่อผลิตภัณฑ์
productTypeL1

string

ประเภท (ระดับ 1) ของผลิตภัณฑ์
productTypeL2

string

ประเภท (ระดับ 2) ของผลิตภัณฑ์
productTypeL3

string

ประเภท (ระดับ 3) ของผลิตภัณฑ์
productTypeL4

string

ประเภท (ระดับ 4) ของผลิตภัณฑ์
productTypeL5

string

ประเภท (ระดับ 5) ของผลิตภัณฑ์
quarter

string

ไตรมาสที่แสดงโดยวันที่แรกของไตรมาส ใช้ปีปฏิทินสำหรับไตรมาส เช่น ไตรมาสที่ 2 ของปี 2018 จะเริ่มในวันที่ 01-04-2018 มีรูปแบบเป็น yyyy-MM-dd
week

string

สัปดาห์ที่หมายถึงวันจันทร์ถึงวันอาทิตย์ และแสดงด้วยวันที่ของวันจันทร์ มีรูปแบบเป็น yyyy-MM-dd
year

integer

ปีในรูปแบบ yyyy
assetInteractionTarget

object (AssetInteractionTarget)

ใช้กับเมตริก CustomerAsset, CampaignAsset และ AdGroupAsset เท่านั้น ระบุว่าเมตริกการโต้ตอบเกิดขึ้นในชิ้นงานเอง หรือในชิ้นงานหรือหน่วยโฆษณาอื่น ระบบจะนับการโต้ตอบ (เช่น การคลิก) ในส่วนต่างๆ ของโฆษณาที่แสดง (เช่น โฆษณาเองและคอมโพเนนต์อื่นๆ เช่น ไซต์ลิงก์) เมื่อโฆษณาแสดงร่วมกัน เมื่อ interactionOnThisAsset เป็นจริง หมายความว่าการโต้ตอบเกิดขึ้นในชิ้นงานนี้ และเมื่อ interactionOnThisAsset เป็นเท็จ หมายความว่าการโต้ตอบไม่ได้เกิดขึ้นในชิ้นงานนี้ แต่เกิดขึ้นในส่วนอื่นๆ ของโฆษณาที่แสดงพร้อมกับชิ้นงานนี้

AdNetworkType

แสดงรายการประเภทเครือข่าย Google Ads

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
SEARCH การค้นหาใน Google
SEARCH_PARTNERS พาร์ทเนอร์ Search
CONTENT เครือข่ายดิสเพลย์
YOUTUBE_WATCH วิดีโอ YouTube
MIXED ข้ามเครือข่าย

คีย์เวิร์ด

กลุ่มเกณฑ์คีย์เวิร์ด

การแสดง JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
ช่อง
info

object (KeywordInfo)

ข้อมูลคีย์เวิร์ด
adGroupCriterion

string

ชื่อทรัพยากร AdGroupCriterion

ProductChannelExclusivity

Enum ที่อธิบายความพร้อมจำหน่ายของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SINGLE_CHANNEL สินค้าขายผ่านช่องทางเดียวเท่านั้น ไม่ว่าจะเป็นร้านค้าในพื้นที่หรือทางออนไลน์ตามที่ ProductChannel ระบุ
MULTI_CHANNEL ระบบจะจับคู่สินค้ากับรายการที่ตรงกันในร้านค้าออนไลน์หรือร้านค้าในพื้นที่ ซึ่งบ่งบอกว่าสินค้าพร้อมจำหน่ายใน ShoppingProductChannels ทั้ง 2 รายการ

ProductCondition

Enum ที่อธิบายสภาพของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
OLD สภาพผลิตภัณฑ์เก่า
NEW สภาพผลิตภัณฑ์คือใหม่
REFURBISHED สภาพผลิตภัณฑ์ได้รับการซ่อมแซมใหม่
USED มีการใช้สภาพผลิตภัณฑ์

AssetInteractionTarget

กลุ่มเป้าหมายการโต้ตอบกับชิ้นงาน

การแสดง JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
ช่อง
asset

string

ชื่อทรัพยากรชิ้นงาน
interactionOnThisAsset

boolean

ใช้กับเมตริก CustomerAsset, CampaignAsset และ AdGroupAsset เท่านั้น ระบุว่าเมตริกการโต้ตอบเกิดขึ้นในชิ้นงานเอง หรือในชิ้นงานหรือหน่วยโฆษณาอื่น