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,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
ช่อง
resourceName

string

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

customers/{customerId}/adGroups/{adGroupId}
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)
trackingUrlTemplate

string

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

string (int64 format)

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

enum (AdGroupEngineStatus)

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

string

เทมเพลต URL สำหรับการต่อท้ายพารามิเตอร์กับ URL สุดท้าย

AdGroupStatus

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

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

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

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

AdGroupType

การแจงนับรายการประเภทที่เป็นไปได้ของกลุ่มโฆษณา

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

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

ค่านี้ใช้สำหรับการตอบกลับเท่านั้น
SEARCH_STANDARD ประเภทกลุ่มโฆษณาเริ่มต้นสำหรับแคมเปญ Search
DISPLAY_STANDARD ประเภทกลุ่มโฆษณาเริ่มต้นสำหรับแคมเปญ Display
SHOPPING_PRODUCT_ADS ประเภทกลุ่มโฆษณาสำหรับแคมเปญ Shopping ที่แสดงโฆษณาผลิตภัณฑ์มาตรฐาน
HOTEL_ADS ประเภทกลุ่มโฆษณาเริ่มต้นสำหรับแคมเปญโรงแรม
SHOPPING_SMART_ADS ประเภทของกลุ่มโฆษณาในแคมเปญ Smart Shopping
VIDEO_BUMPER โฆษณาวิดีโอในสตรีมแบบข้ามไม่ได้ที่มีความยาวสั้น
VIDEO_TRUE_VIEW_IN_STREAM โฆษณาวิดีโอ TrueView (แบบข้ามได้) ในสตรีม
VIDEO_TRUE_VIEW_IN_DISPLAY โฆษณาวิดีโอ TrueView In-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

ระบุว่าจะจำกัดโฆษณาให้แสดงเฉพาะเกณฑ์ที่คุณเลือกสำหรับ TargetingDimension นี้ หรือกำหนดเป้าหมายค่าทั้งหมดสำหรับ TargetingDimension นี้และแสดงโฆษณาตามการกำหนดเป้าหมายใน TargetingDimension อื่นๆ ค่า 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/{adGroupId}~{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 ระบบจะนำโฆษณาของกลุ่มโฆษณานั้นออก

FinalAppUrl

URL สำหรับ Deep Link ไปยังแอปสำหรับระบบปฏิบัติการที่ระบุ

การแสดง JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
ช่อง
osType

enum (AppUrlOperatingSystemType)

ระบบปฏิบัติการที่ URL นี้กำหนดเป้าหมาย ต้องระบุ
url

string

URL ของ Deep Link ของแอป Deep Link จะระบุตำแหน่งในแอปที่สอดคล้องกับเนื้อหาที่คุณต้องการแสดง และควรอยู่ในรูปแบบ {scheme}://{host_path} โดย Scheme จะระบุแอปที่จะเปิด สำหรับแอปของคุณ คุณสามารถใช้รูปแบบที่กำหนดเองซึ่งเริ่มต้นด้วยชื่อแอป โฮสต์และเส้นทางจะระบุตำแหน่งที่ไม่ซ้ำกันในแอปซึ่งมีเนื้อหาของคุณ เช่น "exampleapp://productid_1234" ต้องระบุ

AppUrlOperatingSystemType

ระบบปฏิบัติการ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
IOS ระบบปฏิบัติการ Apple iOS
ANDROID ระบบปฏิบัติการ Android

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
TRAVEL_AD โฆษณาท่องเที่ยว
MULTIMEDIA_AD โฆษณามัลติมีเดีย

SyntheticContentInfo

คอนเทนเนอร์สำหรับการรับรองเนื้อหาสังเคราะห์จากแหล่งที่มาต่างๆ เช่น ผู้ลงโฆษณาและระบบของ Google

การแสดง JSON 
{
  "advertiserAttestation": {
    object (SyntheticContentAttestation)
  },
  "systemAttestation": {
    object (SyntheticContentAttestation)
  }
}
ช่อง
advertiserAttestation

object (SyntheticContentAttestation)

ข้อมูลที่ผู้ลงโฆษณาระบุ
systemAttestation

object (SyntheticContentAttestation)

ข้อมูลเกี่ยวกับเนื้อหาสังเคราะห์ที่สร้างขึ้นโดยระบบของ Google

SyntheticContentAttestation

แสดงการรับรองเกี่ยวกับเนื้อหาสังเคราะห์จากแหล่งที่มาเดียว

การแสดง JSON 
{
  "status": enum (SyntheticContentAttestationStatus),
  "source": enum (SyntheticContentSource)
}
ช่อง
status

enum (SyntheticContentAttestationStatus)

ระบุว่าแหล่งที่มานี้ถือว่าเนื้อหาเป็นเนื้อหาสังเคราะห์หรือไม่
source

enum (SyntheticContentSource)

แหล่งที่มาของการรับรองเนื้อหาสังเคราะห์

SyntheticContentAttestationStatus

สถานะการรับรองเนื้อหาสังเคราะห์

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

SyntheticContentSource

แหล่งที่มาของการระบุเนื้อหาสังเคราะห์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ADVERTISER_ATTESTED การรับรองจากผู้ลงโฆษณา
GOOGLE_GENERATED_ADVERTISER_REVIEWED เนื้อหาที่ Google สร้างขึ้นโดยมีการตรวจสอบหรือข้อมูลจากผู้ลงโฆษณา
GOOGLE_GENERATED_FULLY_AUTOMATED เนื้อหาที่ Google สร้างขึ้นโดยอัตโนมัติโดยไม่มีการตรวจสอบจากผู้ลงโฆษณา

SearchAds360TextAdInfo

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

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

string

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

string

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

string

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

string

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

string

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

string (int64 format)

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

SearchAds360ExpandedTextAdInfo

โฆษณาแบบข้อความที่ขยายออกของ Search Ads 360 โฆษณาแบบข้อความที่ขยายออกถูกเลิกใช้งานแล้ว ให้ใช้ SearchAds360ResponsiveSearchAd แทน

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

string

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

string

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

string

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

string

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

string

บรรทัดที่ 2 ของคำอธิบายโฆษณา
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

บรรทัดที่ 2 ของคำอธิบายโฆษณา
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/{ownerCustomerId}/adGroupAdEffectiveLabels/{adGroupId}~{adId}~{label_id}
adGroupAd

string

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

string

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

string (int64 format)

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

AdGroupAdLabel

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

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

string

ชื่อทรัพยากรของป้ายกำกับโฆษณาของกลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับโฆษณากลุ่มโฆษณามีรูปแบบ customers/{ownerCustomerId}/adGroupAdLabels/{adGroupId}~{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/{adGroupId}~{assetId}~{fieldType}
adGroup

string

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

string

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

enum (AssetLinkStatus)

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

AssetLinkStatus

การแจงนับที่อธิบายสถานะของลิงก์ชิ้นงาน

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

AdGroupAssetSet

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

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

string

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

customers/{customerId}/adGroupAssetSets/{adGroupId}~{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/{adGroupId}~{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/{adGroupId}~{criterionId}
bidModifier

number

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

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

ต้องระบุในการดำเนินการสร้างตั้งแต่ V5 เป็นต้นไป 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
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "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/{adGroupId}~{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 สุดท้ายที่เป็นไปได้หลังจากเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสำหรับโฆษณา
finalMobileUrls[]

string

รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
urlCustomParameters[]

object (CustomParameter)

รายการการแมปที่ใช้แทนที่แท็กพารามิเตอร์ที่กำหนดเองใน trackingUrlTemplate, finalUrls หรือ mobile_final_urls
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 ติดตาม

ฟิลด์ Union 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 : Criterion pending review
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 ระบบหยุดเกณฑ์ชั่วคราวเนื่องจากบัญชีหยุดชั่วคราวอยู่

CustomParameter

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

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

string

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

string

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

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/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{adGroupId}~{criterionId}~{label_id}
adGroupCriterion

string

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

string

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

string (int64 format)

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

AdGroupCriterionLabel

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

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

string

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

string

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

string

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

string (int64 format)

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

AdGroupEffectiveLabel

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

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

string

ชื่อทรัพยากรของป้ายกำกับที่มีผลของกลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับที่มีผลของกลุ่มโฆษณามีรูปแบบดังนี้ customers/{ownerCustomerId}/adGroupEffectiveLabels/{adGroupId}~{label_id}
adGroup

string

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

string

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

string (int64 format)

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

AdGroupLabel

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

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

string

ชื่อทรัพยากรของป้ายกำกับกลุ่มโฆษณา ชื่อทรัพยากรของป้ายกำกับกลุ่มโฆษณามีรูปแบบดังนี้ customers/{ownerCustomerId}/adGroupLabels/{adGroupId}~{label_id}
adGroup

string

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

string

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

string (int64 format)

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

AgeRangeView

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

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

หมายเหตุ: แม้ว่าคุณจะแบ่งกลุ่มเมตริกตามช่วงอายุโดยใช้ ageRangeView หรือตามเพศโดยใช้ genderView ได้ แต่ Search Ads 360 API ไม่รองรับการแบ่งกลุ่มเมตริกตามทั้งช่วงอายุและเพศพร้อมกันในการค้นหาครั้งเดียว Search Ads 360 API ไม่รองรับการวิเคราะห์ประสิทธิภาพในมิติข้อมูลทั้ง 2 รายการรวมกัน

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

string

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

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

ชิ้นงาน

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

การแสดง JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "syntheticContentInfo": {
    object (SyntheticContentInfo)
  },
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": 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 สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
finalMobileUrls[]

string

รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
urlCustomParameters[]

object (CustomParameter)

รายการการแมปที่จะใช้แทนที่แท็กพารามิเตอร์ที่กำหนดเองของ URL ใน trackingUrlTemplate, finalUrls และ/หรือ finalMobileUrls
status

enum (AssetStatus)

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

string

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

string

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

object (SyntheticContentInfo)

ข้อมูลเนื้อหาสังเคราะห์สำหรับชิ้นงาน เฉพาะชิ้นงานที่มีประเภทชิ้นงานที่เฉพาะเจาะจงเท่านั้นที่จะมีสิทธิ์รับการอัปเดตโดยใช้ฟิลด์ syntheticContentInfo

ค่า AssetType ที่อนุญาต: * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO
id

string (int64 format)

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

string

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

string

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

string

เทมเพลต URL สำหรับการเพิ่มพารามิเตอร์ไปยัง URL ของหน้า Landing Page ที่แสดงด้วยการติดตามพร้อมกัน
engineStatus

enum (AssetEngineStatus)

สถานะเครื่องมือของชิ้นงาน
ฟิลด์ Union 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

Enum ที่อธิบายสถานะเครื่องมือของเนื้อหาที่เป็นไปได้

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 ของ image/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 ของเสียง/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

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

string

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

object (AdScheduleInfo)

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

boolean

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

AdScheduleInfo

แสดงเกณฑ์ 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

แสดงรายการของชั่วโมงในไตรมาส เช่น "FIFTEEN"

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่ทราบค่าในเวอร์ชันนี้
ZERO 0 นาทีหลังชั่วโมง
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

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

string

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

string

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

object (AdScheduleInfo)

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

string (int64 format)

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

boolean

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

boolean

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

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)

ต้องระบุ ร้านค้าแอปพลิเคชันที่จัดจำหน่ายแอปนี้

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 ตัวอักษรของหมายเลขโทรศัพท์ เช่น "TH"
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
callTrackingEnabled

boolean

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

boolean

จะแสดงส่วนขยายการโทรในเขตเวลาของผู้ใช้ที่ค้นหาหรือไม่ ใช้กับโฆษณา Microsoft
startDate

string

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

string

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

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
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 สำหรับเป้าหมายการท่องเที่ยว
LONG_DESCRIPTION ระบบจะลิงก์ชิ้นงานเพื่อใช้เป็นคำอธิบายแบบยาว
CALL_TO_ACTION ระบบจะลิงก์ชิ้นงานเพื่อให้ใช้เป็นคำกระตุ้นให้ดำเนินการ

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

กลุ่มชิ้นงานที่สัญญาณกลุ่มชิ้นงานนี้เป็นของ
ฟิลด์ Union 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.
}
ช่อง
ฟิลด์ Union 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 ชิ้นงานถูกใช้ในบรรทัดแรก ใช้เฉพาะในกรณีที่มีบรรทัดแรกเพียงรายการเดียวในโฆษณา หรือใช้ enum HEADLINE_1, HEADLINE_2 หรือ HEADLINE_3
HEADLINE_IN_PORTRAIT ชิ้นงานถูกใช้เป็นบรรทัดแรกในรูปภาพแนวตั้ง
LONG_HEADLINE ชิ้นงานถูกใช้ในบรรทัดแรกแบบยาว (ใช้ใน MultiAssetResponsiveAd)
DESCRIPTION มีการใช้ชิ้นงานในคำอธิบาย ใช้เฉพาะในกรณีที่มีคำอธิบายเพียงรายการเดียวในโฆษณา หากไม่ต้องการทำเช่นนั้น ให้ใช้ enum 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 ระบบจะใช้ชิ้นงานเป็นโฆษณาแบบกรอกฟอร์ม
DESCRIPTION_PREFIX ระบบจะใช้เนื้อหาเป็นคำนำหน้าคำอธิบาย

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
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/{biddingStrategyId}
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)

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

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

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

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

object (EnhancedCpc)

กลยุทธ์การเสนอราคาที่เพิ่มราคาเสนอสำหรับการคลิกที่น่าจะนำไปสู่ Conversion และลดราคาเสนอสำหรับการคลิกที่ไม่น่าจะนำไปสู่ 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

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

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

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

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

BiddingStrategyType

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
COMMISSION ค่าคอมมิชชันเป็นกลยุทธ์การเสนอราคาอัตโนมัติที่ผู้ลงโฆษณาจ่ายมูลค่า Conversion ในสัดส่วนที่กำหนด
ENHANCED_CPC CPC ที่ปรับปรุงแล้วเป็นกลยุทธ์การเสนอราคาที่เพิ่มราคาเสนอสำหรับคลิกที่น่าจะนำไปสู่ Conversion และลดราคาเสนอสำหรับคลิกที่ไม่น่าจะนำไปสู่ 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 ที่ตั้งไว้คือกลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อช่วยให้คุณได้รับการแสดงผลมากที่สุดจากต้นทุนที่ตั้งไว้ต่อการแสดงผลพันครั้ง (CPM) ที่ตั้งไว้
TARGET_IMPRESSION_SHARE กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อให้โฆษณา Search บางเปอร์เซ็นต์แสดงที่ด้านบนของหน้าแรก (หรือตำแหน่งอื่นๆ ที่กำหนดเป้าหมายไว้)
TARGET_OUTRANK_SHARE ส่วนแบ่งที่ชนะเป้าหมายเป็นกลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอตามสัดส่วนเป้าหมายของการประมูลที่ผู้ลงโฆษณาควรมีอันดับเหนือกว่าคู่แข่งที่เฉพาะเจาะจง ค่า enum นี้เลิกใช้งานแล้ว
TARGET_ROAS ROAS เป้าหมายคือกลยุทธ์การเสนอราคาอัตโนมัติที่ช่วยเพิ่มรายได้สูงสุดขณะที่เฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) ที่เฉพาะเจาะจง
TARGET_SPEND การใช้จ่ายเป้าหมายเป็นกลยุทธ์การเสนอราคาอัตโนมัติซึ่งจะกำหนดราคาเสนอโดยอัตโนมัติเพื่อให้คุณได้รับคลิกมากที่สุดเท่าที่จะเป็นไปได้ภายในงบประมาณของคุณ

EnhancedCpc

ประเภทนี้ไม่มีฟิลด์

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

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

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 ถึง 1000.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)

จํานวนเงินเฉลี่ยรายวันที่แคมเปญจะใช้จ่าย ฟิลด์นี้ใช้เมื่อตั้งค่า CampaignBudget period เป็น DAILY ซึ่งเป็นค่าเริ่มต้น

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

ฟิลด์นี้จะใช้กับ "totalAmountMicros" ไม่ได้ ควรตั้งค่า "amountMicros" หรือ "totalAmountMicros" อย่างใดอย่างหนึ่งเท่านั้น

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,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "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/{campaignId}
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 ในทางตรงกันข้าม แอตทริบิวต์ที่จำกัดจะใช้ได้เฉพาะลูกค้าที่เป็นเจ้าของกลยุทธ์และผู้จัดการของลูกค้าเท่านั้น แอตทริบิวต์ที่ถูกจำกัดจะอ่านได้จากทรัพยากร BiddingStrategy เท่านั้น
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"
feedTypes[]

enum (AssetSetType)

ประเภทฟีดที่แนบมากับแคมเปญนี้โดยตรง
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 เมื่อสร้าง ค่าเริ่มต้นจะเป็น 2037-12-30 ซึ่งหมายความว่าแคมเปญจะทํางานต่อไปเรื่อยๆ หากต้องการตั้งค่าแคมเปญที่มีอยู่ให้ทํางานต่อไปเรื่อยๆ ให้ตั้งค่าฟิลด์นี้เป็น 2037-12-30
finalUrlSuffix

string

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

boolean

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

ฟิลด์ Union 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

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

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
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SEARCH เครือข่าย Search รวมแคมเปญ Display แบบแพ็กเกจ และแคมเปญ Search+
DISPLAY เครือข่าย Display ของ Google เท่านั้น
SHOPPING แคมเปญ Shopping จะแสดงในพร็อพเพอร์ตี้ Shopping และในผลการค้นหาของ google.com
HOTEL แคมเปญโฆษณาโรงแรม
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 แคมเปญแอปบนอุปกรณ์เคลื่อนที่สำหรับ 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 ติดตามเฉพาะแคมเปญโซเชียล

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

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

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

ป้ายกำกับฟีดของผลิตภัณฑ์ที่จะรวมไว้ในแคมเปญ ป้ายกำกับฟีดที่ถูกต้องมีอักขระได้สูงสุด 20 ตัว ซึ่งรวมถึงตัวอักษรพิมพ์ใหญ่ ตัวเลข ขีดกลาง และขีดล่าง หากก่อนหน้านี้คุณใช้ salesCountry ที่เลิกใช้งานแล้วในรูปแบบรหัสประเทศ 2 ตัวอักษร (XX) คุณควรใช้ช่อง feedLabel แทน ดูข้อมูลเพิ่มเติมได้ที่บทความสนับสนุนเกี่ยวกับป้ายกำกับฟีด
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 ที่ใช้สำหรับการติดตามแบบไดนามิก

AssetSetType

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
PAGE_FEED ชุดชิ้นงานหน้าเว็บ
DYNAMIC_EDUCATION ชุดชิ้นงานการศึกษาแบบไดนามิก
MERCHANT_CENTER_FEED ชุดชิ้นงานของ Google Merchant Center
DYNAMIC_REAL_ESTATE ชุดชิ้นงานอสังหาริมทรัพย์แบบไดนามิก
DYNAMIC_CUSTOM ชุดชิ้นงานที่กำหนดเองแบบไดนามิก
DYNAMIC_HOTELS_AND_RENTALS ชุดชิ้นงานแบบไดนามิกเกี่ยวกับโรงแรมและที่พักให้เช่า
DYNAMIC_FLIGHTS ชุดชิ้นงานเที่ยวบินแบบไดนามิก
DYNAMIC_TRAVEL ชุดชิ้นงานการเดินทางแบบไดนามิก
DYNAMIC_LOCAL ชุดชิ้นงานในเครื่องแบบไดนามิก
DYNAMIC_JOBS ชุดชิ้นงานสำหรับงานแบบไดนามิก
LOCATION_SYNC ชุดชิ้นงานระดับการซิงค์สถานที่ตั้ง
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP ชุดชิ้นงานกลุ่มสถานที่ตั้งของ Business Profile
CHAIN_DYNAMIC_LOCATION_GROUP ชุดชิ้นงานกลุ่มสถานที่ตั้งของเชนที่ใช้ได้ทั้งกับสถานที่ตั้งที่เป็นเจ้าของและสถานที่ตั้งของแอฟฟิลิเอต
STATIC_LOCATION_GROUP ชุดชิ้นงานกลุ่มสถานที่ตั้งแบบคงที่ซึ่งใช้ได้ทั้งกับสถานที่ตั้งที่เป็นเจ้าของและสถานที่ตั้งของแอฟฟิลิเอต
HOTEL_PROPERTY ชุดชิ้นงานที่พักซึ่งใช้เพื่อลิงก์ฟีดที่พักกับแคมเปญ Performance Max สำหรับเป้าหมายการท่องเที่ยว
TRAVEL_FEED ประเภทชุดชิ้นงานฟีดการท่องเที่ยว แสดงได้ทั้งฟีดโรงแรมหรือฟีดสิ่งที่น่าสนใจ (กิจกรรม)

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/{campaignId}~{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/{campaignId}~{asset_set_id}
campaign

string

แคมเปญที่ชุดชิ้นงานนี้ลิงก์อยู่
assetSet

string

ชุดชิ้นงานที่ลิงก์กับแคมเปญ
status

enum (AssetSetLinkStatus)

สถานะของชิ้นงานในชุดชิ้นงานของแคมเปญ อ่านอย่างเดียว

CampaignAudienceView

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

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

string

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

customers/{customerId}/campaignAudienceViews/{campaignId}~{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/{campaignId}~{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) เกณฑ์

ฟิลด์ Union 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

FeedItemSets ที่กำหนดเป้าหมาย FeedItems หากระบุรหัสหลายรายการ ระบบจะกำหนดเป้าหมายไปยังรายการทั้งหมดที่ปรากฏในชุดอย่างน้อย 1 ชุด ใช้ฟิลด์นี้กับ GeoTargetConstants ไม่ได้ ซึ่งไม่บังคับและตั้งค่าได้ในการดำเนินการ CREATE เท่านั้น
radius

string (int64 format)

ระยะทางในหน่วยที่ระบุรัศมีรอบสถานที่เป้าหมาย ต้องระบุและต้องตั้งค่าในการดำเนินการ CREATE

LocationGroupRadiusUnits

หน่วยของระยะทางรัศมีในกลุ่มสถานที่ตั้ง (เช่น MILES)

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

CampaignEffectiveLabel

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

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

string

ชื่อของทรัพยากร ชื่อทรัพยากร CampaignEffectivelabel มีรูปแบบดังนี้ customers/{ownerCustomerId}/campaignEffectiveLabels/{campaignId}~{label_id}
campaign

string

แคมเปญที่ติดป้ายกำกับที่มีผล
label

string

ป้ายกำกับที่มีผลซึ่งกำหนดให้กับแคมเปญ
ownerCustomerId

string (int64 format)

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

CampaignLabel

แสดงความสัมพันธ์ระหว่างแคมเปญกับป้ายกำกับ

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

string

ชื่อของทรัพยากร ชื่อทรัพยากรของป้ายกำกับแคมเปญมีรูปแบบดังนี้ customers/{ownerCustomerId}/campaignLabels/{campaignId}~{label_id}
campaign

string

แคมเปญที่ติดป้ายกำกับ
label

string

ป้ายกำกับที่กำหนดให้กับแคมเปญ
ownerCustomerId

string (int64 format)

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

CartDataSalesView

มุมมองยอดขายจากข้อมูลรถเข็นช็อปปิ้ง

ให้ข้อมูลเกี่ยวกับผลิตภัณฑ์ที่ซื้อหากมีการติดตั้งใช้งาน Conversion จากข้อมูลรถเข็นช็อปปิ้ง เมตริกประสิทธิภาพ เช่น รายได้ กำไรขั้นต้น เมตริกโอกาสในการขาย/การขายครอสเซล ฯลฯ และแอตทริบิวต์ Merchant Center เช่น แบรนด์ หมวดหมู่ ฯลฯ จะพร้อมใช้งานสำหรับผลิตภัณฑ์ที่กำหนดไว้ในฟีดสินค้าคงคลังและขายได้จากโฆษณา Google สำหรับการซื้อที่มีการระบุแหล่งที่มาเป็นการคลิกโฆษณา Shopping คุณจะดูมิติข้อมูลของทั้งผลิตภัณฑ์ที่คลิกและผลิตภัณฑ์ที่ขายได้พร้อมกัน

การแสดง 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/{conversionActionId}
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 เป็น false ได้หลังจากสร้างผ่านการดำเนินการ "อัปเดต" เท่านั้น เนื่องจากไม่ได้ประกาศเป็นตัวเลือก
ownerCustomer

string

ชื่อทรัพยากรของลูกค้าที่เป็นเจ้าของการกระทำที่ถือเป็น Conversion หรือ null หากเป็นการกระทำที่ถือเป็น 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 สิ้นสุดลงในวันที่ 31 พฤษภาคม 2025 ดูคำถามที่พบบ่อยเกี่ยวกับการอัปเกรดการผสานรวมเดิมกับ Salesforce สำหรับ Conversion
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 ที่สร้างจากเหตุการณ์ในเว็บไซต์ (เช่น การส่งแบบฟอร์มหรือการโหลดหน้าเว็บ) ซึ่งไม่ได้ใช้ข้อมูลโค้ดเหตุการณ์ที่เขียนโค้ดแยกกัน อ่านอย่างเดียว
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 (Half Life คือ 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 มีจำนวนสมาชิกในเซ็ตต่ำกว่าขีดจำกัดทั้งหมด คุณสามารถใช้ตัวแปรเพื่อการแบ่งกลุ่ม และสถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT ตัวแปรที่กำหนดเองสำหรับ Conversion มีจำนวนสมาชิกในเซ็ตเกินขีดจำกัดการแบ่งกลุ่ม แต่ไม่เกินขีดจำกัดสถิติ ระบบจะปิดใช้การแบ่งกลุ่ม แต่สถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
APPROACHES_STATS_LIMIT ตัวแปรที่กำหนดเองของ Conversion เกินขีดจํากัดการแบ่งกลุ่ม และใกล้ถึงขีดจํากัดสถิติ (> 90%) ระบบจะปิดใช้การแบ่งกลุ่ม แต่สถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
EXCEEDS_STATS_LIMIT ตัวแปรที่กำหนดเองของ Conversion เกินทั้งขีดจํากัดการแบ่งกลุ่มและขีดจํากัดสถิติ ระบบจะปิดใช้การแบ่งกลุ่ม และสถิติของตัวแปรที่เปิดใช้จะเพิ่มขึ้นได้ก็ต่อเมื่อค่าที่มีอยู่ไม่ได้เพิ่มจำนวนค่าที่ไม่ซ้ำกันของตัวแปรอีกต่อไป

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 ประเภท "Number" ตัวแปรนี้อาจกำหนดให้กับตัวแปร Floodlight ประเภท DIMENSION หรือ METRIC
STRING แสดงตัวแปร Floodlight ประเภท "String" ตัวแปรนี้อาจกำหนดให้กับตัวแปร Floodlight ประเภท DIMENSION

ลูกค้า

ลูกค้า

การแสดง 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, การติดตามเครื่องมือค้นหา ฯลฯ
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/{biddingStrategyId}
id

string (int64 format)

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

string

ชื่อกลยุทธ์การเสนอราคา
type

enum (BiddingStrategyType)

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

string (int64 format)

รหัสของลูกค้าที่เป็นเจ้าของกลยุทธ์การเสนอราคา
ownerDescriptiveName

string

descriptiveName ของลูกค้าที่เป็นเจ้าของกลยุทธ์การเสนอราคา

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

ตั้งค่าได้เพียง 1 รายการ 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) เป้าหมาย นี่คือจํานวนเงินเฉลี่ยที่คุณต้องการใช้จ่ายต่อการได้ผู้ใช้ใหม่
targetCpaMicros

string (int64 format)

ตัวเลือกต้นทุนต่อหนึ่งการกระทำ (CPA) เป้าหมาย นี่คือจํานวนเงินเฉลี่ยที่คุณต้องการใช้จ่ายต่อการได้ผู้ใช้ใหม่

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

การแสดงสตริง Common Locale Data Repository (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/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

URL ของหน้า Landing Page ของการแสดงผลที่เลือกแบบไดนามิก

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

GenderView

แหล่งข้อมูลมุมมองเพศ แสดงมุมมองของเมตริกประสิทธิภาพของลูกค้าที่รวบรวมตามเพศ สถิติทั้งหมดจะรวบรวมที่ระดับกลุ่มโฆษณา

หมายเหตุ: แม้ว่าคุณจะแบ่งกลุ่มเมตริกตามช่วงอายุโดยใช้ ageRangeView หรือตามเพศโดยใช้ genderView ได้ แต่ Search Ads 360 API ไม่รองรับการแบ่งกลุ่มเมตริกตามทั้งช่วงอายุและเพศพร้อมกันในการค้นหาครั้งเดียว Search Ads 360 API ไม่รองรับการวิเคราะห์ประสิทธิภาพในมิติข้อมูลทั้ง 2 รายการรวมกัน

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

string

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

customers/{customerId}/genderViews/{adGroupId}~{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/{adGroupId}~{criterionId}

ป้ายกำกับ

ป้ายกำกับ

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
ช่อง
resourceName

string

ชื่อของทรัพยากร ชื่อทรัพยากรของป้ายกำกับมีรูปแบบดังนี้ customers/{ownerCustomerId}/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

สีพื้นหลังของป้ายกำกับในรูปแบบเลขฐานสิบหก สตริงนี้ต้องตรงกับนิพจน์ทั่วไป '^#([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

ชื่อเต็มของภาษาเป็นภาษาอังกฤษ เช่น "English (US)", "Spanish" ฯลฯ
targetable

boolean

กำหนดเป้าหมายภาษาได้หรือไม่

LocationView

มุมมองสถานที่ตั้งจะสรุปประสิทธิภาพของแคมเปญตามเกณฑ์สถานที่ตั้ง

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

string

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

customers/{customerId}/locationViews/{campaignId}~{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/{adGroupId}~{criterionId}

ShoppingPerformanceView

มุมมองประสิทธิภาพของ Shopping

แสดงสถิติแคมเปญ Shopping และแคมเปญ Performance Max ที่รวบรวมไว้ที่ระดับมิติข้อมูลผลิตภัณฑ์หลายระดับ ค่ามิติข้อมูลผลิตภัณฑ์จาก Merchant Center เช่น แบรนด์ หมวดหมู่ แอตทริบิวต์ที่กำหนดเอง สภาพผลิตภัณฑ์ และประเภทสินค้า จะแสดงสถานะของมิติข้อมูลแต่ละรายการ ณ วันที่และเวลาที่บันทึกเหตุการณ์ที่เกี่ยวข้อง

จำนวนการแสดงผลและคลิกที่ shoppingPerformanceView แสดงสถิติอาจแตกต่างจากรายงานแคมเปญ shoppingPerformanceView แสดงการแสดงผลและการคลิกผลิตภัณฑ์ที่ปรากฏในโฆษณา ขณะที่รายงานแคมเปญแสดงการแสดงผลและการคลิกโฆษณาเอง โฆษณาอาจแสดงผลิตภัณฑ์ตั้งแต่ 0 รายการจนถึงหลายรายการ ทั้งนี้ขึ้นอยู่กับรูปแบบ ดังนั้นตัวเลขจึงอาจไม่ตรงกัน

ใน UI ของ Search Ads 360 คุณสามารถค้นหาการแสดงผลและการคลิกของผลิตภัณฑ์ที่ปรากฏในโฆษณาได้โดยเลือกคอลัมน์จาก "แอตทริบิวต์ผลิตภัณฑ์" ในเครื่องมือแก้ไขรายงาน เช่น การเลือกคอลัมน์ "แบรนด์" จะเหมือนกับการเลือก segments.product_brand

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

string

ชื่อทรัพยากรของมุมมองประสิทธิภาพของ Shopping ชื่อทรัพยากรของมุมมองประสิทธิภาพของ Shopping จะมีรูปแบบ customers/{customerId}/shoppingPerformanceView

UserList

รายชื่อผู้ใช้ นี่คือรายชื่อผู้ใช้ที่ลูกค้าอาจกำหนดเป้าหมาย คีย์ที่ไม่ซ้ำของกลุ่มเป้าหมายตามรายการผู้ใช้ประกอบด้วยช่องต่อไปนี้ id โปรดทราบว่า name ต้องไม่ซ้ำกันสำหรับกลุ่มเป้าหมายตามข้อมูลผู้ใช้ที่เป็นของลูกค้าที่กำหนดด้วย ยกเว้นในบางกรณีที่ตั้งค่า accessReason เป็น SHARED การละเมิดข้อจำกัดชื่อที่ไม่ซ้ำกันจะทำให้เกิดข้อผิดพลาด: UserListError.INVALID_NAME

การแสดง JSON 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
ช่อง
resourceName

string

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

customers/{customerId}/userLists/{userListId}
type

enum (UserListType)

ประเภทของรายการนี้

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

string (int64 format)

รหัสของรายชื่อผู้ใช้
name

string

ชื่อของกลุ่มเป้าหมายตามรายชื่อผู้ใช้นี้ ไม่ซ้ำกันต่อรายการผู้ใช้ ยกเว้นในบางกรณีที่รายการผู้ใช้ที่มีชื่อเดียวกันaccessReasonตั้งค่าเป็น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 of first-party CRM data provided by advertiser in the form of emails or other formats.

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/{adGroupId}~{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/{adGroupId}~{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/{adGroupId}~{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 ตามที่กําหนดโดยพารามิเตอร์ URL ของจํานวน ผู้ลงโฆษณามีหน้าที่ป้อนข้อมูลพารามิเตอร์แบบไดนามิก (เช่น จำนวนสินค้าที่ขายใน Conversion) มิฉะนั้นค่าเริ่มต้นจะเป็น 1
conversionRevenueMicros

string (int64 format)

รายได้ที่ปรับแล้วในหน่วยไมโครสําหรับเหตุการณ์ Conversion ซึ่งจะเป็นสกุลเงินของบัญชีที่ใช้แสดงโฆษณาเสมอ
floodlightOriginalRevenue

string (int64 format)

รายได้เดิมที่ไม่มีการเปลี่ยนแปลงซึ่งเชื่อมโยงกับเหตุการณ์ Floodlight (ในสกุลเงินของรายงานปัจจุบัน) ก่อนการแก้ไขการตั้งค่าสกุลเงินของ Floodlight
floodlightOrderId

string

รหัสคำสั่งซื้อ Floodlight ที่ผู้ลงโฆษณาระบุสำหรับ Conversion
status

enum (ConversionStatus)

สถานะของ Conversion ซึ่งอาจเป็น ENABLED หรือ REMOVED
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,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "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,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
ช่อง
allConversionsValueByConversionDate

number

มูลค่าของ Conversion ทั้งหมด เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่ Conversion ดูรายละเอียดสำหรับby_conversion_dateคอลัมน์ได้ที่เกี่ยวกับคอลัมน์ "Conversion ทั้งหมด"
allConversionsByConversionDate

number

จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมดโดยไม่คำนึงถึงค่าของ includeInConversionsMetric เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่ Conversion ดูรายละเอียดสำหรับby_conversion_dateคอลัมน์ได้ที่เกี่ยวกับคอลัมน์ "Conversion ทั้งหมด"
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 ที่ข้อกำหนด PARAMETERS
averageCpm

number

ต้นทุนต่อการแสดงผลพันครั้ง (CPM) โดยเฉลี่ย เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
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 เป็น true หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพสำหรับ Conversion เหล่านี้
conversionsValuePerCost

number

มูลค่าของ Conversion ที่เสนอราคาได้หารด้วยต้นทุนรวมของการโต้ตอบที่มีสิทธิ์สำหรับ Conversion
conversionsFromInteractionsValuePerInteraction

number

มูลค่าของ Conversion จากการโต้ตอบหารด้วยจํานวนการโต้ตอบกับโฆษณา รวมเฉพาะการกระทำที่ถือเป็น Conversion ซึ่งตั้งค่าแอตทริบิวต์ includeInConversionsMetric เป็น true หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพสำหรับ Conversion เหล่านี้
clientAccountConversions

number

จํานวน Conversion ของบัญชีลูกค้า รวมเฉพาะการกระทำที่ถือเป็น Conversion ซึ่งตั้งค่าแอตทริบิวต์ includeInClientAccountConversionsMetric เป็น true หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพสำหรับ Conversion เหล่านี้
costMicros

string (int64 format)

ผลรวมของค่าใช้จ่ายจากราคาต่อหนึ่งคลิก (CPC) และต้นทุนต่อการแสดงผลพันครั้ง (CPM) ในช่วงเวลานี้ เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูรายละเอียดเพิ่มเติมได้ที่พารามิเตอร์ metrics_currency ในข้อกำหนด PARAMETERS
costPerAllConversions

number

ต้นทุนของการโต้ตอบกับโฆษณาหารด้วย Conversion ทั้งหมด
costPerConversion

number

ต้นทุนเฉลี่ยต่อ Conversion ที่เสนอราคาได้ซึ่งมีสิทธิ์ได้รับ Conversion
costPerCurrentModelAttributedConversion

number

ต้นทุนของการโต้ตอบกับโฆษณาหารด้วย Conversion ที่เกิดจากโมเดลปัจจุบัน รวมเฉพาะการกระทำที่ถือเป็น Conversion ซึ่งตั้งค่าแอตทริบิวต์ includeInConversionsMetric เป็น true หากคุณใช้การเสนอราคาที่อิงตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพสำหรับ Conversion เหล่านี้
crossDeviceConversions

number

Conversion ที่เกิดขึ้นเมื่อลูกค้าคลิกโฆษณาในอุปกรณ์หนึ่ง แล้วทำ Conversion ในอุปกรณ์หรือเบราว์เซอร์อื่น Conversion จากหลายอุปกรณ์รวมอยู่ใน allConversions อยู่แล้ว
crossDeviceConversionsByConversionDate

number

จํานวน Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่เกี่ยวกับคอลัมน์ "Conversion ทั้งหมด"
crossDeviceConversionsValue

number

ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์
crossDeviceConversionsValueByConversionDate

number

ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่เกี่ยวกับคอลัมน์ "Conversion ทั้งหมด"
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 อื่นๆ รูปแบบที่ผิดปกติ ฯลฯ) ระบบจะไม่เรียกเก็บเงินคุณสำหรับการคลิกดังกล่าว และกิจกรรมนี้จะไม่ส่งผลกระทบต่อสถิติบัญชีของคุณ ดูการกรองการเข้าชมที่ไม่ถูกต้องเพื่อให้มั่นใจในคุณภาพ
generalInvalidClicks

string (int64 format)

จํานวนคลิกที่ไม่ถูกต้องทั่วไป ซึ่งเป็นชุดย่อยของคลิกที่ไม่ถูกต้องซึ่งตรวจพบผ่านวิธีการกรองตามปกติ (เช่น การเข้าชมที่เกิดในศูนย์ข้อมูลซึ่งทราบว่าไม่ถูกต้อง, บ็อต, สไปเดอร์ หรือ Crawler อื่นๆ, รูปแบบที่ผิดปกติ เป็นต้น) ระบบจะไม่เรียกเก็บเงินคุณสำหรับการคลิกดังกล่าว และกิจกรรมนี้จะไม่ส่งผลกระทบต่อสถิติบัญชีของคุณ ดูการกรองการเข้าชมที่ไม่ถูกต้องเพื่อให้มั่นใจในคุณภาพ
mobileFriendlyClicksPercentage

number

เปอร์เซ็นต์ของการคลิกจากอุปกรณ์เคลื่อนที่ไปยังหน้าที่เหมาะกับมือถือ
searchAbsoluteTopImpressionShare

number

เปอร์เซ็นต์ของการแสดงโฆษณา Shopping หรือโฆษณา Search ของลูกค้าที่แสดงในตำแหน่ง Shopping ที่โดดเด่นที่สุด ดูรายละเอียดได้ที่เกี่ยวกับเมตริกตำแหน่งบนสุดและตำแหน่งบนสุดแบบสัมบูรณ์ ค่าที่ต่ำกว่า 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คอลัมน์ได้ที่เกี่ยวกับคอลัมน์ "Conversion ทั้งหมด"
valuePerConversion

number

มูลค่าของ Conversion ที่เสนอราคาได้หารด้วยจํานวน Conversion ที่เสนอราคาได้ แสดงมูลค่าโดยเฉลี่ยของ Conversion ที่เสนอราคาได้แต่ละรายการ
valuePerConversionsByConversionDate

number

มูลค่า Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion หารด้วย Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion แสดงมูลค่าเฉลี่ยของ Conversion ที่เสนอราคาได้แต่ละรายการ (ตามวันที่เกิด Conversion) เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่ Conversion
clientAccountViewThroughConversions

string (int64 format)

จำนวน Conversion การดูผ่านทั้งหมด Conversion เหล่านี้เกิดขึ้นเมื่อลูกค้าเห็นโฆษณาแบบรูปภาพหรือริชมีเดีย แล้วทำ Conversion ในเว็บไซต์ภายหลังโดยไม่ได้โต้ตอบ (เช่น คลิก) กับโฆษณาอื่น
orders

number

คําสั่งซื้อคือจํานวน Conversion การซื้อทั้งหมดที่คุณได้รับ ซึ่งระบุว่ามาจากโฆษณาของคุณ

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หาก Conversion ที่มาจากการโต้ตอบกับโฆษณาก่อนหน้านี้ (การคลิกโฆษณาแบบข้อความหรือ Shopping การดูโฆษณาวิดีโอ เป็นต้น) ระบบจะนับเป็นคําสั่งซื้อ

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้อในคําสั่งซื้อบนเว็บไซต์ แม้จะซื้อผลิตภัณฑ์ 2 ชิ้น แต่จะนับเป็นคําสั่งซื้อ 1 รายการ

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
averageOrderValueMicros

string (int64 format)

มูลค่าการสั่งซื้อเฉลี่ยคือรายได้เฉลี่ยที่คุณสร้างขึ้นต่อคําสั่งซื้อที่มาจากโฆษณาของคุณ

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ มูลค่าการสั่งซื้อเฉลี่ยคือรายได้ทั้งหมดจากคําสั่งซื้อหารด้วยจํานวนคําสั่งซื้อทั้งหมด

ตัวอย่าง: คุณได้รับคําสั่งซื้อ 3 รายการซึ่งทําให้มีรายได้ 300 บาท 450 บาท และ 600 บาท มีมูลค่าการสั่งซื้อเฉลี่ยจะเท่ากับ 450 บาท (300 บาท + 450 บาท + 600 บาท)/3

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
averageCartSize

number

ขนาดรถเข็นโดยเฉลี่ยคือจํานวนผลิตภัณฑ์โดยเฉลี่ยในคําสั่งซื้อแต่ละรายการที่เกิดจากโฆษณาของคุณ

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ ขนาดรถเข็นโดยเฉลี่ยคือจํานวนผลิตภัณฑ์ทั้งหมดที่ขายหารด้วยจํานวนคําสั่งซื้อทั้งหมดที่คุณได้รับ

ตัวอย่าง: คุณได้รับคําสั่งซื้อ 2 รายการ คำสั่งซื้อแรกมีผลิตภัณฑ์ 3 รายการ และคำสั่งซื้อที่สองมี 2 รายการ ขนาดรถเข็นโดยเฉลี่ยคือ 2.5 รายการ = (3+2)/2

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
costOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขาย (COGS) คือยอดรวมของต้นทุนผลิตภัณฑ์ที่คุณขายในคําสั่งซื้อที่มาจากโฆษณา

วิธีการทํางาน: คุณสามารถเพิ่มมูลค่าต้นทุนสินค้าขายไปยังผลิตภัณฑ์ทั้งหมดใน Merchant Center ได้ หากคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้ง ระบบจะจับคู่ผลิตภัณฑ์ที่ขายกับมูลค่าต้นทุนสินค้าขาย ซึ่งสามารถใช้เพื่อคํานวณกําไรขั้นต้นจากคําสั่งซื้อแต่ละรายการได้

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายสําหรับคําสั่งซื้อนี้คือ 240 บาท = 90 บาท + 150 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
grossProfitMicros

string (int64 format)

กําไรขั้นต้นคือกําไรที่เกิดจากคําสั่งซื้อที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย (COGS)

วิธีการทํางาน: กําไรขั้นต้นคือรายได้จากการขายที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย การคํานวณกําไรขั้นต้นจะรวมเฉพาะผลิตภัณฑ์ที่มีมูลค่าต้นทุนสินค้าขายใน Merchant Center เท่านั้น

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัวในคําสั่งซื้อจากเว็บไซต์ หมวกราคา 300 บาทและเสื้อราคา 600 บาท หมวกมีมูลค่าต้นทุนสินค้าขาย 90 บาท แต่เสื้อไม่มีมูลค่าต้นทุนสินค้าขาย กําไรขั้นต้นสําหรับคําสั่งซื้อนี้จะพิจารณาเฉพาะหมวก ซึ่งคือ 210 บาท = 300 บาท - 90 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
grossProfitMargin

number

ส่วนต่างกําไรขั้นต้นคือเปอร์เซ็นต์กําไรขั้นต้นที่เกิดจากคำสั่งซื้อที่ได้จากโฆษณา หลังหักต้นทุนสินค้าขาย (COGS)

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ ส่วนต่างกําไรขั้นต้นมาจากกําไรขั้นต้นที่คุณสร้างขึ้นหารด้วยรายได้รวม แล้วคูณด้วย 100% การคํานวณส่วนต่างกำไรขั้นต้นจะรวมเฉพาะผลิตภัณฑ์ที่มีมูลค่าต้นทุนสินค้าขายใน Merchant Center เท่านั้น

ตัวอย่าง: มีผู้ซื้อหมวกและเสื้อในคำสั่งซื้อในเว็บไซต์ของคุณ หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท เสื้อราคา 600 บาท แต่ไม่มีมูลค่าต้นทุนสินค้าขาย ส่วนต่างกำไรขั้นต้นสําหรับคําสั่งซื้อนี้คำนวณเฉพาะหมวกเนื่องจากมีมูลค่าต้นทุนสินค้าขาย จึงเท่ากับ 70% = (300 - 90 บาท)/300 บาท x 100%

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
revenueMicros

string (int64 format)

รายได้คือจำนวนเงินทั้งหมดที่เกิดจากคําสั่งซื้อที่มาจากโฆษณา

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

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัวในคําสั่งซื้อจากเว็บไซต์ หมวกราคา 300 บาทและเสื้อราคา 600 บาท คําสั่งซื้อทั้งหมดมีส่วนลด 150 บาท รายได้จากคําสั่งซื้อนี้เท่ากับ 750 บาท = (300 บาท + 600 บาท) - 150 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
unitsSold

number

จํานวนที่ขายได้คือจํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จากคําสั่งซื้อที่มาจากโฆษณา

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ จํานวนที่ขายคือได้จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จากคําสั่งซื้อที่มาจากโฆษณา

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จํานวนที่ขายได้ในคําสั่งซื้อนี้คือ 3 ชิ้น

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากการขายครอสเซล (COGS) ของบัญชีลูกค้าคือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล ต้นทุนสินค้าขายจากการขายครอสเซลคือต้นทุนรวมของผลิตภัณฑ์ที่ขายโดยไม่ได้โฆษณา

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 150 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
crossSellCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากการขายครอสเซล (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล ต้นทุนสินค้าขายจากการขายครอสเซลคือต้นทุนรวมของผลิตภัณฑ์ที่ขายโดยไม่ได้โฆษณา

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 150 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
clientAccountCrossSellGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากการขายครอสเซลในบัญชีลูกค้าคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่นลบด้วยต้นทุนสินค้าขาย (COGS)

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในการขายจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล กําไรขั้นต้นจากการขายครอสเซลคือรายได้จากการขายครอสเซลที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว เสื้อราคา 600 บาทและมีมูลค่าต้นทุนสินค้าขาย 150 บาท กําไรขั้นต้นจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 450 บาท = 600 บาท - 150 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
crossSellGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากการขายครอสเซลคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่นลบด้วยต้นทุนสินค้าขาย (COGS)

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในการขายจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล กําไรขั้นต้นจากการขายครอสเซลคือรายได้จากการขายครอสเซลที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว เสื้อราคา 600 บาทและมีมูลค่าต้นทุนสินค้าขาย 150 บาท กําไรขั้นต้นจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 450 บาท = 600 บาท - 150 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น

เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
clientAccountCrossSellRevenueMicros

string (int64 format)

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

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล รายได้จากการขายครอสเซลคือมูลค่าทั้งหมดที่คุณได้มาจากการขายครอสเซลที่มาจากโฆษณาของคุณ

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากการขายครอสเซลสําหรับคําสั่งซื้อนี้เท่ากับ 600 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
crossSellRevenueMicros

string (int64 format)

รายได้จากการขายครอสเซลคือจํานวนเงินทั้งหมดที่คุณได้มาจากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล รายได้จากการขายครอสเซลคือมูลค่าทั้งหมดที่คุณได้มาจากการขายครอสเซลที่มาจากโฆษณาของคุณ

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากการขายครอสเซลสําหรับคําสั่งซื้อนี้เท่ากับ 600 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
clientAccountCrossSellUnitsSold

number

จำนวนที่ขายได้จากการขายครอสเซลในบัญชีลูกค้าคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น

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

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จำนวนที่ขายได้จากการขายครอสเซลในคําสั่งซื้อนี้คือ 2

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
crossSellUnitsSold

number

จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น

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

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จำนวนที่ขายได้จากการขายครอสเซลในคําสั่งซื้อนี้คือ 2

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา (COGS) ของบัญชีลูกค้าคือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน ต้นทุนของสินค้าเหล่านี้จะนับภายใต้ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณาสําหรับคําสั่งซื้อนี้เท่ากับ 90 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
leadCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน ต้นทุนของสินค้าเหล่านี้จะนับภายใต้ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณาสําหรับคําสั่งซื้อนี้เท่ากับ 90 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
clientAccountLeadGrossProfitMicros

string (int64 format)

กำไรขั้นต้นจากสินค้าที่โฆษณาของบัญชีลูกค้าคือกําไรที่คุณได้จากสินค้าที่ขายได้จากการโฆษณาสินค้าเดียวกันลบด้วยต้นทุนสินค้าขาย (COGS)

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาจะมาจากรายได้จากการขายเหล่านี้ลบด้วยต้นทุนสินค้าขาย

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท กำไรขั้นต้นจากสินค้าที่โฆษณาของคำสั่งซื้อนี้เท่ากับ 210 บาท = 300 บาท - 90 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
leadGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกันลบด้วยต้นทุนสินค้าขาย (COGS)

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาจะมาจากรายได้จากการขายเหล่านี้ลบด้วยต้นทุนสินค้าขาย

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท กำไรขั้นต้นจากสินค้าที่โฆษณาของคำสั่งซื้อนี้เท่ากับ 210 บาท = 300 บาท - 90 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
clientAccountLeadRevenueMicros

string (int64 format)

รายได้จากสินค้าที่โฆษณาของบัญชีลูกค้าคือจํานวนเงินทั้งหมดที่ได้มาจากสินค้าที่ขายได้เนื่องจากการโฆษณาสินค้านั้นๆ

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากสินค้าที่โฆษณาและสินค้าที่ขายได้ตรงกัน มูลค่ารวมจากการขายสินค้าเหล่านี้จะปรากฏใต้รายได้จากสินค้าที่โฆษณา

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากสินค้าที่โฆษณาของคำสั่งซื้อนี้คือ 300 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
leadRevenueMicros

string (int64 format)

รายได้จากสินค้าที่โฆษณาคือจํานวนเงินทั้งหมดที่ได้มาจากสินค้าที่ขายได้เนื่องจากการโฆษณาสินค้านั้นๆ

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากสินค้าที่โฆษณาและสินค้าที่ขายได้ตรงกัน มูลค่ารวมจากการขายสินค้าเหล่านี้จะปรากฏใต้รายได้จากสินค้าที่โฆษณา

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากสินค้าที่โฆษณาของคำสั่งซื้อนี้คือ 300 บาท

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ข้อกำหนด PARAMETERS
clientAccountLeadUnitsSold

number

จำนวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ของบัญชีลูกค้าคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์นั้นๆ

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จะปรากฏในจํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ในคําสั่งซื้อนี้คือ 1 ชิ้น

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
leadUnitsSold

number

จำนวนสินค้าที่โฆษณาขายได้คือจํานวนรวมของสินค้าที่ขายได้จากการโฆษณาสินค้านั้นๆ

วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีสินค้าที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าสินค้านี้เป็นสินค้าที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จะปรากฏในจํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้

ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ในคําสั่งซื้อนี้คือ 1 ชิ้น

เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
uniqueUsers

string (int64 format)

จำนวนผู้ใช้ที่ไม่ซ้ำที่เห็นโฆษณาของคุณในช่วงระยะเวลาที่ขอ เมตริกนี้รวบรวมไม่ได้ และขอได้เฉพาะช่วงวันที่ไม่เกิน 92 วันเท่านั้น เมตริกนี้ใช้ได้กับแคมเปญประเภทต่อไปนี้ ได้แก่ Display, วิดีโอ, Discovery และ App
averageImpressionFrequencyPerUser

number

จำนวนครั้งโดยเฉลี่ยที่ผู้ใช้ที่ไม่ซ้ำเห็นโฆษณาของคุณในช่วงเวลาที่ขอ เมตริกนี้รวบรวมไม่ได้ และขอได้เฉพาะช่วงวันที่ไม่เกิน 92 วันเท่านั้น เมตริกนี้ใช้ได้กับแคมเปญประเภทต่อไปนี้ ได้แก่ Display, วิดีโอ, Discovery และ App

ค่า

คอนเทนเนอร์ข้อมูลทั่วไป

การแสดง 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.
}
ช่อง
ฟิลด์ Union 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 
{
  "adFormatType": enum (AdFormatType),
  "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,
  "geoTargetPostalCode": 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,
  "verticalAdsEventParticipantDisplayNames": string,
  "verticalAdsHotelClass": string,
  "verticalAdsListing": string,
  "verticalAdsListingBrand": string,
  "verticalAdsListingCity": string,
  "verticalAdsListingCountry": string,
  "verticalAdsListingRegion": string,
  "verticalAdsPartnerAccount": string,
  "verticalAdsVertical": enum (VerticalAdsItemVerticalType),
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
ช่อง
adFormatType

enum (AdFormatType)

ประเภทรูปแบบโฆษณา
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

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

string

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

string

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

integer

ชั่วโมงของวันเป็นตัวเลขระหว่าง 0 ถึง 23
month

string

เดือนที่แสดงโดยวันที่ของวันแรกของเดือน จัดรูปแบบเป็น ปปปป-ดด-วว
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 จะเริ่มในวันที่ 2018-04-01 จัดรูปแบบเป็น ปปปป-ดด-วว
verticalAdsEventParticipantDisplayNames

string

ชื่อที่แสดงของผู้เข้าร่วมในข้อมูลกิจกรรม เช่น ผู้แสดง ผู้พูด หรือทีม
verticalAdsHotelClass

string (int64 format)

ระดับของโรงแรม โดยทั่วไปจะอยู่ในช่วง 1-5 ดาว แต่ปรับแต่งได้ทั้งหมดในฟีดโรงแรม
verticalAdsListing

string

ข้อมูลที่เชื่อมโยงกับการแสดงผล การคลิก หรือ Conversion ของข้อมูล
verticalAdsListingBrand

string

แบรนด์ที่เชื่อมโยงกับข้อมูลที่เฉพาะเจาะจงภายในบริบทโฆษณาตามแนวดิ่ง เช่น แบรนด์ของบริการเช่ารถ บ้านพักตากอากาศ หรือกิจกรรม
verticalAdsListingCity

string

เมืองที่ข้อมูลโฆษณาแนวตั้งตั้งอยู่
verticalAdsListingCountry

string

ประเทศที่ข้อมูลโฆษณาแนวตั้งตั้งอยู่
verticalAdsListingRegion

string

ภูมิภาคที่ข้อมูลโฆษณาประเภทธุรกิจตั้งอยู่
verticalAdsPartnerAccount

string (int64 format)

บัญชีพาร์ทเนอร์ที่เฉพาะเจาะจงภายในศูนย์พาร์ทเนอร์ (เช่น Hotel Center) ที่จัดหาข้อมูลฟีดพื้นที่โฆษณาสำหรับโฆษณาตามหมวดหมู่
verticalAdsVertical

enum (VerticalAdsItemVerticalType)

ประเภทโฆษณาเฉพาะ เช่น ที่พักให้เช่า รถเช่า หรือกิจกรรม ซึ่งใช้จัดหมวดหมู่และแบ่งกลุ่มข้อมูลในบริบทของโฆษณาเฉพาะ
week

string

สัปดาห์หมายถึงวันจันทร์ถึงวันอาทิตย์ และแสดงด้วยวันที่ของวันจันทร์ จัดรูปแบบเป็น ปปปป-ดด-วว
year

integer

ปีในรูปแบบ yyyy
assetInteractionTarget

object (AssetInteractionTarget)

ใช้กับเมตริก CustomerAsset, CampaignAsset และ AdGroupAsset เท่านั้น ระบุว่าเมตริกการโต้ตอบเกิดขึ้นในชิ้นงานนั้นเองหรือชิ้นงานอื่น หรือหน่วยโฆษณาอื่น ระบบจะนับการโต้ตอบ (เช่น การคลิก) ในทุกส่วนของโฆษณาที่แสดง (เช่น ตัวโฆษณาเองและคอมโพเนนต์อื่นๆ เช่น ไซต์ลิงก์) เมื่อแสดงร่วมกัน เมื่อ interactionOnThisAsset เป็นจริง หมายความว่าการโต้ตอบเกิดขึ้นในชิ้นงานนี้โดยเฉพาะ และเมื่อ interactionOnThisAsset เป็นเท็จ หมายความว่าการโต้ตอบไม่ได้เกิดขึ้นในชิ้นงานนี้โดยเฉพาะ แต่เกิดขึ้นในส่วนอื่นๆ ของโฆษณาที่แสดงซึ่งชิ้นงานนี้แสดงด้วย

AdFormatType

แสดงรายการประเภทรูปแบบ Google Ads

โปรดทราบว่าการแบ่งกลุ่มนี้ใช้ได้กับแคมเปญวิดีโอและ Demand Gen เท่านั้น สำหรับชิ้นงาน ระบบรองรับเฉพาะชิ้นงานวิดีโอ

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
VERTICAL_ADS_PROMOTION รูปแบบโฆษณาที่โปรโมตเอนทิตีที่เฉพาะเจาะจงภายในหมวดหมู่ เช่น โฆษณาโรงแรมในหมวดหมู่การท่องเที่ยวบน Search
TEXT รูปแบบโฆษณาแบบข้อความมาตรฐาน ปัจจุบันใช้สําหรับโฆษณาในเครือข่าย Search เท่านั้น

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 มีการใช้สภาพสินค้า

VerticalAdsItemVerticalType

Enum ที่อธิบายประเภทแนวตั้งของรายการโฆษณาแนวตั้งสำหรับ SharedSet ของประเภท VERTICAL_ADS_ITEM_GROUP_RULE_LIST

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
HOTELS หมวดหมู่การเดินทางและโรงแรม
VACATION_RENTALS ที่พักให้เช่าในหมวดหมู่การท่องเที่ยว
RENTAL_CARS ธุรกิจรถเช่าท่องเที่ยว
EVENTS เหตุการณ์จะเดินทางในแนวตั้ง
THINGS_TO_DO Things to do travel vertical.
FLIGHTS เที่ยวบินเดินทางในแนวตั้ง

AssetInteractionTarget

กลุ่ม AssetInteractionTarget

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

string

ชื่อทรัพยากรของชิ้นงาน
interactionOnThisAsset

boolean

ใช้กับเมตริก CustomerAsset, CampaignAsset และ AdGroupAsset เท่านั้น ระบุว่าเมตริกการโต้ตอบเกิดขึ้นในชิ้นงานนั้นเองหรือชิ้นงานอื่น หรือหน่วยโฆษณาอื่น