SearchAds360Row

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

การแสดง JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "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)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
ช่อง
adGroup

object (AdGroup)

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

adGroupAd

object (AdGroupAd)

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

adGroupAdLabel

object (AdGroupAdLabel)

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

adGroupAsset

object (AdGroupAsset)

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

adGroupAssetSet

object (AdGroupAssetSet)

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

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

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

adGroupCriterion

object (AdGroupCriterion)

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

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)

รายชื่อผู้ใช้ที่อ้างอิงในการค้นหา

webpageView

object (WebpageView)

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

visit

object (Visit)

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

conversion

object (Conversion)

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

metrics

object (Metrics)

เมตริก

segments

object (Segments)

กลุ่ม

customColumns[]

object (Value)

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

กลุ่มโฆษณา :

กลุ่มโฆษณา

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

string

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

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

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

type

enum (AdGroupType)

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

adRotationMode

enum (AdGroupAdRotationMode)

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

creationTime

string

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

targetingSetting

object (TargetingSetting)

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

labels[]

string

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

effectiveLabels[]

string

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

engineId

string

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

startDate

string

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

รูปแบบ: YYYY-MM-DD เช่น 2019-03-14

endDate

string

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

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

languageCode

string

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

lastModifiedTime

string

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

id

string (int64 format)

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

name

string

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

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

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

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

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

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

AdGroupStatus

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

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

AdGroupType

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

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

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

ค่านี้เป็นค่าสำหรับการตอบกลับเท่านั้น

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

AdGroupAdRotationMode

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

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

AdGroupEngineStatus

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

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

เลิกใช้งานแล้ว โปรดอย่าใช้

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

TargetingSetting

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

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

object (TargetRestriction)

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

TargetRestriction

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

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

enum (TargetingDimension)

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

bidOnly

boolean

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

TargetingDimension

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

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

AdGroupAd

โฆษณาระดับกลุ่มโฆษณา

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

string

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

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

status

enum (AdGroupAdStatus)

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

ad

object (Ad)

โฆษณา

creationTime

string

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

labels[]

string

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

engineId

string

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

engineStatus

enum (AdGroupAdEngineStatus)

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

lastModifiedTime

string

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

AdGroupAdStatus

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

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

AdType

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

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

SearchAds360TextAdInfo

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

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

string

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

description1

string

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

description2

string

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

displayUrl

string

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

displayMobileUrl

string

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

adTrackingId

string (int64 format)

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

SearchAds360ExpandedTextAdInfo

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

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

string

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

headline2

string

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

headline3

string

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

description1

string

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

description2

string

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

path1

string

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

path2

string

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

adTrackingId

string (int64 format)

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

SearchAds360ResponsiveSearchAdInfo

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

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

object (AdTextAsset)

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

descriptions[]

object (AdTextAsset)

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

path1

string

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

path2

string

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

adTrackingId

string (int64 format)

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

AdTextAsset

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

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

string

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

SearchAds360ProductAdInfo

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

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

SearchAds360ExpandedDynamicSearchAdInfo

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

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

string

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

description2

string

บรรทัดที่ 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 โฆษณาถูกหยุดชั่วคราวเนื่องจากกลุ่มโฆษณาถูกหยุดชั่วคราว

AdGroupAdLabel

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

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

string

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

adGroupAd

string

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

label

string

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

ownerCustomerId

string (int64 format)

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

AdGroupAsset

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

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

string

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

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

adGroup

string

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

asset

string

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

status

enum (AssetLinkStatus)

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

AssetLinkStatus

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

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

AdGroupAssetSet

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

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

string

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

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

adGroup

string

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

assetSet

string

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

status

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

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

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

AdGroupAudienceView

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

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

string

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

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

AdGroupBidModifier

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

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

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

string

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

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

bidModifier

number

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

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

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

device

object (DeviceInfo)

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

DeviceInfo

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

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

enum (Device)

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

อุปกรณ์

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

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

AdGroupCriterion

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

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

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

string

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

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

creationTime

string

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

status

enum (AdGroupCriterionStatus)

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

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

qualityInfo

object (QualityInfo)

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

type

enum (CriterionType)

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

labels[]

string

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

positionEstimates

object (PositionEstimates)

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

finalUrls[]

string

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

engineId

string

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

lastModifiedTime

string

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

criterionId

string (int64 format)

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

adGroup

string

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

negative

boolean

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

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

bidModifier

number

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

cpcBidMicros

string (int64 format)

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

effectiveCpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupCriterionEngineStatus)

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

finalUrlSuffix

string

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

trackingUrlTemplate

string

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

ช่องการรวม criterion เกณฑ์ของกลุ่มโฆษณา

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

keyword

object (KeywordInfo)

คีย์เวิร์ด

listingGroup

object (ListingGroupInfo)

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

ageRange

object (AgeRangeInfo)

ช่วงอายุ

gender

object (GenderInfo)

เพศ

userList

object (UserListInfo)

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

webpage

object (WebpageInfo)

หน้าเว็บ

location

object (LocationInfo)

ตำแหน่ง

AdGroupCriterionStatus

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

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

QualityInfo

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

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

integer

คะแนนคุณภาพ

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

CriterionType

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

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

PositionEstimates

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

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

string (int64 format)

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

AdGroupCriterionEngineStatus

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

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

เลิกใช้งานแล้ว โปรดอย่าใช้

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

เลิกใช้งานแล้ว โปรดอย่าใช้ เคยใช้โดย Gemini

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

KeywordInfo

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

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

enum (KeywordMatchType)

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

text

string

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

KeywordMatchType

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

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

ListingGroupInfo

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

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

enum (ListingGroupType)

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

ListingGroupType

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

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

AgeRangeInfo

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

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

enum (AgeRangeType)

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

AgeRangeType

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

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

GenderInfo

เกณฑ์เพศ

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

enum (GenderType)

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

GenderType

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

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

UserListInfo

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

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

string

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

WebpageInfo

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

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

object (WebpageConditionInfo)

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

ต้องระบุช่องนี้สำหรับการดำเนินการ CREATE และห้ามมิให้ดำเนินการอัปเดต

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 Operand แสดงเงื่อนไขการกำหนดเป้าหมายป้ายกำกับที่กำหนดเองของหน้าเว็บ

WebpageConditionOperator

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

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

LocationInfo

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

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

string

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

AdGroupCriterionLabel

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

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

string

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

adGroupCriterion

string

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

label

string

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

ownerCustomerId

string (int64 format)

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

AdGroupEffectiveLabel

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

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

string

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

adGroup

string

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

label

string

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

ownerCustomerId

string (int64 format)

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

AdGroupLabel

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

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

string

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

adGroup

string

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

label

string

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

ownerCustomerId

string (int64 format)

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

AgeRangeView

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

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

string

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

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

ชิ้นงาน

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

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

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

string

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

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

finalUrls[]

string

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

status

enum (AssetStatus)

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

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

รหัสเนื้อหา

name

string

ชื่อที่ไม่บังคับของเนื้อหา

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

สถานะเครื่องมือของชิ้นงาน

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

object (YoutubeVideoAsset)

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

imageAsset

object (ImageAsset)

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

textAsset

object (TextAsset)

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

calloutAsset

object (UnifiedCalloutAsset)

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

pageFeedAsset

object (UnifiedPageFeedAsset)

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

mobileAppAsset

object (MobileAppAsset)

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

callAsset

object (UnifiedCallAsset)

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

callToActionAsset

object (CallToActionAsset)

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

locationAsset

object (UnifiedLocationAsset)

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

AssetType

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

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

AssetStatus

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

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

AssetEngineStatus

รหัสถัดไป = 11

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

YoutubeVideoAsset

เนื้อหา YouTube

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

string

ชื่อวิดีโอ YouTube

youtubeVideoId

string

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

ImageAsset

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

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

enum (MimeType)

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

fullSize

object (ImageDimension)

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

fileSize

string (int64 format)

ขนาดไฟล์ของชิ้นงานรูปภาพในหน่วยไบต์

MimeType

ประเภท MIME

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

IMAGE_JPEG ประเภท MIME ของ image/jpeg
IMAGE_GIF ประเภท MIME ของ image/gif
IMAGE_PNG ประเภท MIME ของ 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 ของแอปพลิเคชัน/RTf
AUDIO_WAV ประเภท MIME ของเสียง/wav
AUDIO_MP3 ประเภท MIME ของ audio/mp3
HTML5_AD_ZIP ประเภท MIME ของ application/x-html5-ad-zip

ImageDimension

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

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

string (int64 format)

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

widthPixels

string (int64 format)

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

url

string

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

TextAsset

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

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

string

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

UnifiedCalloutAsset

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

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

string

ข้อความไฮไลต์ สตริงนี้ควรมีความยาวอยู่ระหว่าง 1 ถึง 25 (รวมค่าแรกและค่าสุดท้าย)

startDate

string

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

endDate

string

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

adScheduleTargets[]

object (AdScheduleInfo)

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

useSearcherTimeZone

boolean

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

AdScheduleInfo

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

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

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

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

enum (MinuteOfHour)

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

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

endMinute

enum (MinuteOfHour)

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

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

dayOfWeek

enum (DayOfWeek)

วันของสัปดาห์ที่กำหนดเวลา

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

startHour

integer

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

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

endHour

integer

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

ต้องระบุช่องนี้สำหรับการดำเนินการ CREATE และห้ามมิให้ดำเนินการอัปเดต

MinuteOfHour

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

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

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

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

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

UnifiedSitelinkAsset

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

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

string

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

description2

string

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

startDate

string

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

endDate

string

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

adScheduleTargets[]

object (AdScheduleInfo)

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

trackingId

string (int64 format)

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

useSearcherTimeZone

boolean

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

mobilePreferred

boolean

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

UnifiedPageFeedAsset

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

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

string

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

labels[]

string

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

MobileAppAsset

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

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

string

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

appStore

enum (MobileAppVendor)

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

MobileAppVendor

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

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

UnifiedCallAsset

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

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

string

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

phoneNumber

string

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

callConversionReportingState

enum (CallConversionReportingState)

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

callConversionAction

string

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

adScheduleTargets[]

object (AdScheduleInfo)

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

callOnly

boolean

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

callTrackingEnabled

boolean

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

useSearcherTimeZone

boolean

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

startDate

string

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

endDate

string

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

CallConversionReportingState

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

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

CallToActionAsset

ชิ้นงานคำกระตุ้นให้ดำเนินการ (Call-To-Action)

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

enum (CallToActionType)

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

CallToActionType

Enum ที่อธิบายถึงประเภทคำกระตุ้นให้ดำเนินการ (Call-To-Action) ที่เป็นไปได้

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

UnifiedLocationAsset

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

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

string

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

businessProfileLocations[]

object (BusinessProfileLocation)

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

locationOwnershipType

enum (LocationOwnershipType)

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

BusinessProfileLocation

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

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

string

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

storeCode

string

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

listingId

string (int64 format)

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

LocationOwnershipType

ประเภทของความเป็นเจ้าของสถานที่ที่เป็นไปได้

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

AssetGroupAsset

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

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

string

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

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

assetGroup

string

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

asset

string

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

fieldType

enum (AssetFieldType)

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

status

enum (AssetLinkStatus)

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

AssetFieldType

Enum ที่อธิบายถึงตำแหน่งที่เป็นไปได้ของเนื้อหา

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

AssetGroupSignal

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

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

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

string

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

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

assetGroup

string

กลุ่มชิ้นงานที่สัญญาณของกลุ่มชิ้นงานนี้อยู่

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

object (AudienceInfo)

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

AudienceInfo

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

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

string

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

AssetGroupListingGroupFilter

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

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

string

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

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

assetGroup

string

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

id

string (int64 format)

รหัสของ ListingGroupFilter

type

enum (ListingGroupFilterType)

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

vertical

enum (ListingGroupFilterVertical)

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

caseValue

object (ListingGroupFilterDimension)

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

parentListingGroupFilter

string

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

path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

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

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

ListingGroupFilterVertical

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

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

ListingGroupFilterDimension

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

การแสดง JSON
{

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

object (ProductBiddingCategory)

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

productBrand

object (ProductBrand)

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

productChannel

object (ProductChannel)

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

productCondition

object (ProductCondition)

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

productCustomAttribute

object (ProductCustomAttribute)

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

productItemId

object (ProductItemId)

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

productType

object (ProductType)

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

ProductBiddingCategory

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

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

enum (ListingGroupFilterBiddingCategoryLevel)

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

id

string (int64 format)

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

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

ListingGroupFilterBiddingCategoryLevel

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

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

ProductBrand

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

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

string

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

ProductChannel

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

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

enum (ListingGroupFilterProductChannel)

ค่าของย่าน

ListingGroupFilterProductChannel

คำอธิบายย่านของข้อเสนอผลิตภัณฑ์

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

AssetGroup

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

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

string

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

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

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

campaign

string

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

name

string

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

finalUrls[]

string

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

finalMobileUrls[]

string

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

status

enum (AssetGroupStatus)

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

path1

string

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

path2

string

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

adStrength

enum (AdStrength)

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

AssetGroupStatus

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

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

AdStrength

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

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

AssetSetAsset

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

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

string

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

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

assetSet

string

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

asset

string

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

status

enum (AssetSetAssetStatus)

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

AssetSetAssetStatus

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

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

AssetSet

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

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

string (int64 format)

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

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

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

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

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

string

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

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

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

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

type

enum (BiddingStrategyType)

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

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

currencyCode

string

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

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

id

string (int64 format)

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

name

string

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

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

effectiveCurrencyCode

string

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

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

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

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

campaignCount

string (int64 format)

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

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

nonRemovedCampaignCount

string (int64 format)

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

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

ช่องการรวม scheme รูปแบบการเสนอราคา

ตั้งค่าได้เพียงรายการเดียว 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

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

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

BiddingStrategyType

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
COMMISSION ค่าคอมมิชชันเป็นกลยุทธ์การเสนอราคาอัตโนมัติที่ผู้ลงโฆษณาจ่ายมูลค่า Conversion บางส่วน
ENHANCED_CPC CPC ที่ปรับปรุงแล้วเป็นกลยุทธ์การเสนอราคาที่เพิ่มราคาเสนอสําหรับคลิกที่ดูเหมือนจะมีแนวโน้มที่จะทําให้เกิด Conversion และลดราคาเสนอสําหรับคลิกที่ดูเหมือนจะไม่มีแนวโน้ม
INVALID ใช้สำหรับค่าที่แสดงผลเท่านั้น บ่งบอกว่าแคมเปญไม่มีกลยุทธ์การเสนอราคา ซึ่งทำให้แคมเปญไม่แสดง เช่น แคมเปญอาจแนบอยู่กับกลยุทธ์การเสนอราคาของบัญชีดูแลจัดการ และต่อมามีการยกเลิกการลิงก์บัญชีที่แสดงโฆษณาจากบัญชีดูแลจัดการ ในกรณีนี้ ระบบจะแยกแคมเปญออกจากกลยุทธ์การเสนอราคาของผู้จัดการที่เข้าถึงไม่ได้โดยอัตโนมัติและเปลี่ยนเป็นประเภทกลยุทธ์การเสนอราคา "ไม่ถูกต้อง"
MANUAL_CPA กลยุทธ์การเสนอราคาด้วยตนเองซึ่งช่วยให้ผู้ลงโฆษณากําหนดราคาเสนอตามการกระทําที่ผู้ลงโฆษณาระบุ
MANUAL_CPC การเสนอราคาตามคลิกด้วยตนเองที่ผู้ใช้ชำระเงินต่อคลิก
MANUAL_CPM การเสนอราคาตามการแสดงผลด้วยตนเองซึ่งผู้ใช้จ่ายต่อการแสดงผล 1,000 ครั้ง
MANUAL_CPV กลยุทธ์การเสนอราคาที่ชำระเงินตามจำนวนที่กำหนดค่าได้ต่อการดูวิดีโอ 1 ครั้ง
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 และลดราคาเสนอสำหรับคลิกที่มีแนวโน้มต่ำ

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

MaximizeConversionValue

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

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

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

targetRoas

number

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

MaximizeConversions

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

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

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

targetCpaMicros

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

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

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

TargetOutrankShare

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

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

string (Int64Value format)

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

TargetRoas

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

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

number

ต้องระบุ รายได้ที่เลือก (ตามข้อมูล Conversion) ต่อหน่วยการใช้จ่าย ค่าต้องอยู่ระหว่าง 0.01 ถึง 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)

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

BudgetDeliveryMethod

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

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

BudgetPeriod

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

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

แคมเปญ

แคมเปญ

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

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

string

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

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

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

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

servingStatus

enum (CampaignServingStatus)

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

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

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

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

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

advertisingChannelType

enum (AdvertisingChannelType)

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

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

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

advertisingChannelSubType

enum (AdvertisingChannelSubType)

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

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

urlCustomParameters[]

object (CustomParameter)

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

realTimeBiddingSetting

object (RealTimeBiddingSetting)

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

networkSettings

object (NetworkSettings)

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

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

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

shoppingSetting

object (ShoppingSetting)

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

geoTargetTypeSetting

object (GeoTargetTypeSetting)

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

effectiveLabels[]

string

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

labels[]

string

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

biddingStrategyType

enum (BiddingStrategyType)

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

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

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

accessibleBiddingStrategy

string

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

frequencyCaps[]

object (FrequencyCapEntry)

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

selectiveOptimization

object (SelectiveOptimization)

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

optimizationGoalSetting

object (OptimizationGoalSetting)

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

trackingSetting

object (TrackingSetting)

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

engineId

string

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

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

createTime

string

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

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

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

name

string

ชื่อแคมเปญ

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

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

trackingUrlTemplate

string

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

campaignBudget

string

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

startDate

string

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

endDate

string

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

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

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

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

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

biddingStrategy

string

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

manualCpa

object (ManualCpa)

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

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

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

maximizeConversions

object (MaximizeConversions)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

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

targetCpm

object (TargetCpm)

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

CampaignStatus

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

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

CampaignServingStatus

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

SERVING กำลังแสดง
NONE ไม่มี
ENDED สิ้นสุดแล้ว
PENDING Pending.
SUSPENDED ถูกระงับ

BiddingStrategySystemStatus

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

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

AdServingOptimizationStatus

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

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

AdvertisingChannelType

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

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

AdvertisingChannelSubType

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

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

CustomParameter

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

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

string

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

value

string

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

RealTimeBiddingSetting

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

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

boolean

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

NetworkSettings

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

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

boolean

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

targetContentNetwork

boolean

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

targetPartnerSearchNetwork

boolean

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

DynamicSearchAdsSetting

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

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

string

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

languageCode

string

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

useSuppliedUrlsOnly

boolean

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

ShoppingSetting

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

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

string

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

useVehicleInventory

boolean

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

merchantId

string (int64 format)

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

salesCountry

string

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

campaignPriority

integer

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

enableLocal

boolean

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

GeoTargetTypeSetting

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

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

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

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

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

NegativeGeoTargetType

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

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

FrequencyCapEntry

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

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

SelectiveOptimization

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

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

string

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

OptimizationGoalSetting

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

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

enum (OptimizationGoalType)

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

OptimizationGoalType

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

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

TrackingSetting

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

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

string

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

ManualCpa

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

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

ManualCpc

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

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

boolean

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

ManualCpm

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

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

PercentCpc

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

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

string (int64 format)

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

enhancedCpcEnabled

boolean

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

TargetCpm

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

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

CampaignAsset

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

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

string

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

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

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

campaign

string

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

asset

string

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

CampaignAssetSet

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

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

string

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

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

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

assetSet

string

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

status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

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

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

string

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

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

เกณฑ์แคมเปญ

การแสดง JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

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

string

ชื่อทรัพยากรของเกณฑ์แคมเปญ ชื่อทรัพยากรเกณฑ์ของแคมเปญจะมีรูปแบบดังนี้

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

ชื่อที่แสดงของเกณฑ์

ระบบจะไม่สนใจช่องนี้สำหรับการเปลี่ยน

type

enum (CriterionType)

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

status

enum (CampaignCriterionStatus)

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

lastModifiedTime

string

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

criterionId

string (int64 format)

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

ระบบจะไม่สนใจช่องนี้ในระหว่างการเปลี่ยน

bidModifier

number

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

negative

boolean

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

ฟิลด์สหภาพ criterion เกณฑ์แคมเปญ

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

keyword

object (KeywordInfo)

คีย์เวิร์ด

location

object (LocationInfo)

ตำแหน่ง

device

object (DeviceInfo)

อุปกรณ์

ageRange

object (AgeRangeInfo)

ช่วงอายุ

gender

object (GenderInfo)

เพศ

userList

object (UserListInfo)

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

language

object (LanguageInfo)

ภาษา

webpage

object (WebpageInfo)

หน้าเว็บ

locationGroup

object (LocationGroupInfo)

กลุ่มสถานที่ตั้ง

CampaignCriterionStatus

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

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

ENABLED เกณฑ์แคมเปญเปิดใช้อยู่
PAUSED เกณฑ์แคมเปญหยุดชั่วคราว
REMOVED นำเกณฑ์แคมเปญออกแล้ว

LanguageInfo

เกณฑ์ภาษา

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

string

ชื่อทรัพยากรแบบคงที่ของภาษา

LocationGroupInfo

รัศมีรอบๆ รายการสถานที่ตั้งที่ระบุผ่านฟีด

การแสดง JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
ช่อง
geoTargetConstants[]

string

ค่าคงที่เป้าหมายทางภูมิศาสตร์ที่จำกัดขอบเขตของพื้นที่ทางภูมิศาสตร์ภายในฟีด ปัจจุบันอนุญาตให้มีค่าคงที่เป้าหมายทางภูมิศาสตร์เพียง 1 รายการเท่านั้น

radiusUnits

enum (LocationGroupRadiusUnits)

หน่วยของรัศมี ระบบรองรับไมล์และเมตรสำหรับค่าคงที่ของเป้าหมายตามภูมิศาสตร์ ชุดรายการฟีดรองรับมิลลิไมล์และเมตร จำเป็นต้องมีและจะต้องตั้งค่าในการดำเนินการ CREATE

feedItemSets[]

string

ชุดรายการฟีดที่มีการกำหนดเป้าหมายรายการฟีด หากระบุรหัสหลายรายการ ระบบจะกำหนดเป้าหมายไปยังรายการทั้งหมดที่ปรากฏในชุดอย่างน้อย 1 ชุด ใช้ช่องนี้กับ geoTargetConstants ไม่ได้ การตั้งค่านี้เป็นขั้นตอนที่ไม่บังคับและสามารถตั้งค่าได้ในการดำเนินการ CREATE เท่านั้น

radius

string (int64 format)

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

LocationGroupRadiusUnits

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

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

CampaignEffectiveLabel

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

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

string

ชื่อทรัพยากร ชื่อทรัพยากร CampaignEffectivelabel อยู่ในรูปแบบ customers/{customerId}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

แคมเปญที่มีป้ายกำกับที่มีประสิทธิภาพแนบอยู่

label

string

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

ownerCustomerId

string (int64 format)

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

CampaignLabel

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

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

string

ชื่อแหล่งข้อมูล ชื่อทรัพยากรป้ายกํากับแคมเปญอยู่ในรูปแบบ customers/{customerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

แคมเปญที่แนบป้ายกํากับ

label

string

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

ownerCustomerId

string (int64 format)

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

CartDataSalesView

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

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

string

ชื่อทรัพยากรของมุมมองข้อมูลยอดขายจากข้อมูลรถเข็นช็อปปิ้ง ชื่อทรัพยากรมุมมองข้อมูลยอดขายจากรถเข็นช็อปปิ้งอยู่ในรูปแบบ customers/{customerId}/cartDataSalesView

ผู้ชม

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

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

string

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

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

รหัสของกลุ่มเป้าหมาย

name

string

ต้องระบุ ชื่อกลุ่มเป้าหมาย กลุ่มเป้าหมายทั้งหมดควรไม่ซ้ำกัน โดยต้องมีความยาวอย่างน้อย 1 และสูงสุด 255

description

string

คําอธิบายกลุ่มเป้าหมายนี้

ConversionAction

การกระทําที่ถือเป็น Conversion

การแสดง JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ชื่อทรัพยากรการกระทําที่ถือเป็น Conversion อยู่ในรูปแบบต่อไปนี้

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

การประทับเวลาของการสร้างกิจกรรม Floodlight ซึ่งจัดรูปแบบเป็น ISO 8601

status

enum (ConversionActionStatus)

สถานะของการกระทําที่ถือเป็น Conversion นี้สําหรับเหตุการณ์ Conversion ที่เกิดขึ้น

type

enum (ConversionActionType)

ประเภทของการกระทําที่ถือเป็น Conversion นี้

category

enum (ConversionActionCategory)

หมวดหมู่ของ Conversion ที่รายงานสําหรับการกระทําที่ถือเป็น Conversion นี้

valueSettings

object (ValueSettings)

การตั้งค่าที่เกี่ยวข้องกับมูลค่าของเหตุการณ์ Conversion ที่เชื่อมโยงกับการกระทำที่ถือเป็น Conversion นี้

attributionModelSettings

object (AttributionModelSettings)

การตั้งค่าที่เกี่ยวข้องกับรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้

floodlightSettings

object (FloodlightSettings)

การตั้งค่า Floodlight สําหรับประเภท Conversion ของ Floodlight

id

string (int64 format)

รหัสของการกระทําที่ถือเป็น Conversion

name

string

ชื่อการกระทําที่ถือเป็น Conversion

ต้องระบุข้อมูลในช่องนี้ และต้องไม่ว่างเปล่าเมื่อสร้างการกระทำที่ถือเป็น Conversion ใหม่

primaryForGoal

boolean

หากบิต primaryForGoal ของการกระทําที่ถือเป็น Conversion เป็นเท็จ การกระทําที่ถือเป็น Conversion จะเสนอราคาไม่ได้สําหรับแคมเปญทั้งหมด ไม่ว่าแคมเปญจะมีเป้าหมาย Conversion ของลูกค้าหรือเป้าหมาย Conversion ของแคมเปญก็ตาม อย่างไรก็ตาม เป้าหมาย Conversion ที่กําหนดเองจะไม่สนใจ primaryForGoal ดังนั้นหากแคมเปญมีเป้าหมาย Conversion ที่กําหนดเองซึ่งกําหนดค่าไว้ด้วยการกระทําที่ถือเป็น Conversion ที่มี primaryForGoal = false การกระทําที่ถือเป็น Conversion นั้นยังคงเสนอราคาได้ โดยค่าเริ่มต้น primaryForGoal จะมีค่าเป็น "จริง" หากไม่ได้ตั้งค่าไว้ ใน V9 คุณสามารถตั้งค่า primaryForGoal เป็นเท็จได้หลังจากสร้างผ่านการดำเนินการ "อัปเดต" เท่านั้น เนื่องจากไม่ได้ประกาศว่าไม่บังคับ

ownerCustomer

string

ชื่อทรัพยากรของลูกค้าที่เป็นเจ้าของการกระทำที่ถือเป็น Conversion หรือเป็นค่าว่างหากเป็นการกระทำที่ถือเป็น Conversion ที่ระบบกำหนด

includeInClientAccountConversionsMetric

boolean

การกระทำที่ถือเป็น Conversion นี้ควรรวมอยู่ในเมตริก "clientAccountConversions" หรือไม่

includeInConversionsMetric

boolean

การกระทำที่ถือเป็น Conversion นี้ควรรวมอยู่ในเมตริก "Conversion" หรือไม่

clickThroughLookbackWindowDays

string (int64 format)

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

appId

string

รหัสแอปสําหรับการกระทําที่ถือเป็น Conversion ของแอป

ConversionActionStatus

สถานะที่เป็นไปได้ของการกระทําที่ถือเป็น Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED ระบบจะบันทึก Conversion
REMOVED ระบบจะไม่บันทึก Conversion
HIDDEN ระบบจะไม่บันทึก Conversion และการกระทําที่ถือเป็น Conversion จะไม่ปรากฏใน UI

ConversionActionType

ประเภทการกระทําที่ถือเป็น Conversion ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AD_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้คลิกส่วนขยายการโทรของโฆษณา
CLICK_TO_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้อุปกรณ์เคลื่อนที่คลิกหมายเลขโทรศัพท์
GOOGLE_PLAY_DOWNLOAD Conversion ที่เกิดขึ้นเมื่อผู้ใช้ดาวน์โหลดแอปบนอุปกรณ์เคลื่อนที่จาก Google Play Store
GOOGLE_PLAY_IN_APP_PURCHASE Conversion ที่เกิดขึ้นเมื่อผู้ใช้ทําการซื้อในแอปผ่านการเรียกเก็บเงินของ Android
UPLOAD_CALLS Conversion การโทรที่ผู้ลงโฆษณาติดตามและอัปโหลด
UPLOAD_CLICKS Conversion ที่ผู้ลงโฆษณาติดตามและอัปโหลดด้วยการคลิกที่ระบุแหล่งที่มา
WEBPAGE Conversion ที่เกิดขึ้นในหน้าเว็บ
WEBSITE_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้โทรหาหมายเลขโทรศัพท์ที่สร้างขึ้นแบบไดนามิกจากเว็บไซต์ของผู้ลงโฆษณา
STORE_SALES_DIRECT_UPLOAD Conversion การขายในร้านที่อิงตามการอัปโหลดข้อมูลผู้ขายบุคคลที่หนึ่งหรือบุคคลที่สาม เฉพาะลูกค้าในรายการที่อนุญาตเท่านั้นที่จะใช้ประเภทการอัปโหลดยอดขายในร้านโดยตรงได้
STORE_SALES Conversion ยอดขายในร้านที่อิงตามการอัปโหลดข้อมูลผู้ขายบุคคลที่หนึ่งหรือบุคคลที่สาม และ/หรือการซื้อสินค้าในร้านค้าโดยใช้บัตรจากเครือข่ายการชําระเงิน เฉพาะลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะใช้ประเภทการขายในร้านค้าได้ อ่านอย่างเดียว
FIREBASE_ANDROID_FIRST_OPEN Conversion การเปิดแอป Android เป็นครั้งแรกที่ติดตามผ่าน Firebase
FIREBASE_ANDROID_IN_APP_PURCHASE Conversion การซื้อในแอปของแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_ANDROID_CUSTOM Conversion ที่กําหนดเองของแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_IOS_FIRST_OPEN Conversion การเปิดครั้งแรกของแอป iOS ที่ติดตามผ่าน Firebase
FIREBASE_IOS_IN_APP_PURCHASE Conversion การซื้อในแอปของแอป iOS ที่ติดตามผ่าน Firebase
FIREBASE_IOS_CUSTOM Conversion ที่กำหนดเองของแอป iOS ที่ติดตามผ่าน Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversion การเปิดตัวแอป Android ครั้งแรกที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversion การซื้อในแอปของแอป Android ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversion ที่กำหนดเองของแอป Android ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversion การเปิดแอป iOS เป็นครั้งแรกที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE แอป iOS ในแอปสำหรับ Conversion การซื้อแอปที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
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 Conversion ที่มาจาก Salesforce อ่านอย่างเดียว
SEARCH_ADS_360 Conversion ที่นําเข้าจากข้อมูล Floodlight ของ Search Ads 360 อ่านอย่างเดียว
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversion การโทรที่เกิดขึ้นในโฆษณา Smart Campaign ที่ไม่มีการตั้งค่าเครื่องมือวัดการโทร โดยใช้เกณฑ์ที่กำหนดเองของ Smart Campaign อ่านอย่างเดียว
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ผู้ใช้คลิกองค์ประกอบการโทรภายใน Google Maps Smart Campaign เท่านั้น อ่านอย่างเดียว
SMART_CAMPAIGN_MAP_DIRECTIONS ผู้ใช้ขอเส้นทางไปยังสถานที่ตั้งธุรกิจภายใน Google Maps Smart Campaign เท่านั้น อ่านอย่างเดียว
SMART_CAMPAIGN_TRACKED_CALLS Conversion การโทรที่เกิดขึ้นในโฆษณา Smart Campaign ที่มีการตั้งค่าการติดตามการโทร โดยใช้เกณฑ์ที่กำหนดเองของ Smart Campaign อ่านอย่างเดียว
STORE_VISITS Conversion ที่เกิดขึ้นเมื่อผู้ใช้เข้าชมร้านค้าปลีกของผู้ลงโฆษณา อ่านอย่างเดียว
WEBPAGE_CODELESS Conversion ที่สร้างขึ้นจากเหตุการณ์ในเว็บไซต์ (เช่น การส่งแบบฟอร์มหรือการโหลดหน้าเว็บ) ที่ไม่ได้ใช้สnippet เหตุการณ์ที่โค้ดแยกต่างหาก อ่านอย่างเดียว
UNIVERSAL_ANALYTICS_GOAL Conversion ที่มาจากเป้าหมาย Universal Analytics ที่ลิงก์
UNIVERSAL_ANALYTICS_TRANSACTION Conversion ที่มาจากธุรกรรม Universal Analytics ที่ลิงก์
GOOGLE_ANALYTICS_4_CUSTOM Conversion ที่มาจาก Conversion เหตุการณ์ที่กําหนดเองของ Google Analytics 4 ที่ลิงก์
GOOGLE_ANALYTICS_4_PURCHASE Conversion ที่มาจาก Conversion การซื้อของ Google Analytics 4 ที่ลิงก์

ConversionActionCategory

หมวดหมู่ของ Conversion ที่เชื่อมโยงกับ ConversionAction

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DEFAULT หมวดหมู่เริ่มต้น
PAGE_VIEW ผู้ใช้เข้าชมหน้าเว็บ
PURCHASE กิจกรรมการซื้อ การขาย หรือ "สั่งซื้อแล้ว"
SIGNUP การดำเนินการของผู้ใช้ในการลงชื่อสมัครใช้
LEAD การดำเนินการที่ทำให้เกิดการสร้างลูกค้าเป้าหมาย
DOWNLOAD การดำเนินการดาวน์โหลดซอฟต์แวร์ (สำหรับแอป)
ADD_TO_CART การเพิ่มสินค้าลงในรถเข็นหรือถุงช็อปปิ้งในเว็บไซต์ของผู้ลงโฆษณา
BEGIN_CHECKOUT เมื่อมีผู้เข้าสู่ขั้นตอนการชําระเงินในเว็บไซต์ของผู้ลงโฆษณา
SUBSCRIBE_PAID การเริ่มการสมัครใช้บริการแบบชำระเงินสำหรับผลิตภัณฑ์หรือบริการ
PHONE_CALL_LEAD การโทรเพื่อระบุความสนใจในข้อเสนอของผู้ลงโฆษณา
IMPORTED_LEAD Conversion ที่นำมาสู่โอกาสในการขายซึ่งนําเข้าจากแหล่งที่มาภายนอกไปยัง Google Ads
SUBMIT_LEAD_FORM การส่งแบบฟอร์มบนเว็บไซต์ของผู้ลงโฆษณาที่แสดงถึงความสนใจทางธุรกิจ
BOOK_APPOINTMENT การจองการนัดหมายกับธุรกิจของผู้ลงโฆษณา
REQUEST_QUOTE คำขอการเสนอราคาหรือการประเมินราคา
GET_DIRECTIONS การค้นหาที่ตั้งธุรกิจของผู้ลงโฆษณาโดยมีเจตนาที่จะเข้าชม
OUTBOUND_CLICK การคลิกไปยังเว็บไซต์ของพาร์ทเนอร์ผู้ลงโฆษณา
CONTACT การโทร, SMS, อีเมล, แชท หรือติดต่อประเภทอื่นๆ กับผู้ลงโฆษณา
ENGAGEMENT เหตุการณ์การมีส่วนร่วมกับเว็บไซต์ เช่น ระยะเวลาการใช้เว็บไซต์เป็นเวลานานหรือเป้าหมายสมาร์ทของ Google Analytics (GA) มีไว้สําหรับนําเข้าเป้าหมาย GA, Firebase, GA Gold
STORE_VISIT การเข้าชมสถานที่ตั้งกิจการที่มีหน้าร้านจริง
STORE_SALE ยอดขายที่เกิดขึ้นในหน้าร้านจริง
QUALIFIED_LEAD Conversion โอกาสในการขายที่นําเข้าจากแหล่งที่มาภายนอกไปยัง Google Ads ซึ่งผู้ลงโฆษณา (ทีมการตลาด/ฝ่ายขาย) เป็นผู้พิจารณาว่าเข้าเกณฑ์เพิ่มเติม ในเส้นทางจากโอกาสในการขายไปสู่การขาย ผู้ลงโฆษณาจะได้รับโอกาสในการขาย จากนั้นจึงดําเนินการกับโอกาสเหล่านั้นด้วยการติดต่อผู้บริโภค หากผู้บริโภคสนใจและจบลงด้วยการซื้อผลิตภัณฑ์ ผู้ลงโฆษณาจะทำเครื่องหมายโอกาสในการขายดังกล่าวว่า "โอกาสในการขายที่เข้าเกณฑ์"
CONVERTED_LEAD Conversion ที่มาจากโอกาสในการขายซึ่งนําเข้าจากแหล่งที่มาภายนอกไปยัง Google Ads และดำเนินการตามขั้นตอนที่เลือกไว้จนเสร็จสมบูรณ์ตามที่ผู้ลงโฆษณาที่ต้องการสร้างลูกค้าเป้าหมายกําหนด

ValueSettings

การตั้งค่าที่เกี่ยวข้องกับมูลค่าของเหตุการณ์ Conversion ที่เชื่อมโยงกับการกระทำที่ถือเป็น Conversion นี้

การแสดง JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
ช่อง
defaultValue

number

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

defaultCurrencyCode

string

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

alwaysUseDefaultValue

boolean

ควบคุมว่าจะใช้มูลค่าเริ่มต้นและรหัสสกุลเงินเริ่มต้นแทนมูลค่าและรหัสสกุลเงินที่ระบุไว้ในเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้หรือไม่

AttributionModelSettings

การตั้งค่าที่เกี่ยวข้องกับรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้

การแสดง JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
ช่อง
attributionModel

enum (AttributionModel)

ประเภทรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้

dataDrivenModelStatus

enum (DataDrivenModelStatus)

สถานะของรูปแบบการระบุแหล่งที่มาโดยอิงตามข้อมูลสําหรับการกระทําที่ถือเป็น Conversion

AttributionModel

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
EXTERNAL ใช้การระบุแหล่งที่มาภายนอก
GOOGLE_ADS_LAST_CLICK ให้เครดิตทั้งหมดสำหรับ Conversion หนึ่งๆ แก่คลิกสุดท้าย
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK ให้เครดิตทั้งหมดของ Conversion แก่คลิกแรกโดยใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_LINEAR ให้เครดิตสําหรับ Conversion แก่คลิกทั้งหมดอย่างเท่าๆ กันโดยใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY ให้เครดิตมากขึ้นเป็นทวีคูณสำหรับ Conversion ให้กับคลิกล่าสุดโดยใช้การระบุแหล่งที่มาของ Google Search (ครึ่งชีวิตคือ 1 สัปดาห์)
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED ให้เครดิต 40% ของ Conversion แก่คลิกแรกและคลิกสุดท้าย ส่วนอีก 20% ที่เหลือจะกระจายอย่างเท่าๆ กันสำหรับคลิกอื่นๆ ทั้งหมด การดำเนินการนี้ใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN รูปแบบที่ยืดหยุ่นซึ่งใช้แมชชีนเลิร์นนิงเพื่อกําหนดการกระจายเครดิตที่เหมาะสมระหว่างการคลิกโดยใช้การระบุแหล่งที่มาของ Google Search

DataDrivenModelStatus

แสดงสถานะของรูปแบบที่อิงตามข้อมูล

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AVAILABLE รูปแบบที่อิงตามข้อมูลพร้อมใช้งาน
STALE รูปแบบที่อิงตามข้อมูลล้าสมัย ยังไม่มีการอัปเดตมาอย่างน้อย 7 วันแล้ว ยังมีการใช้งานอยู่ แต่ระบบจะถือว่าหมดอายุหากไม่มีการอัปเดตเป็นเวลา 30 วัน
EXPIRED รูปแบบการระบุแหล่งที่มาจากข้อมูลหมดอายุแล้ว ไม่ได้อัปเดตอย่างน้อย 30 วันและใช้งานไม่ได้ สาเหตุที่พบบ่อยที่สุดคือเนื่องจากเหตุการณ์ในช่วง 30 วันที่ผ่านมาไม่เกินจำนวนที่กำหนด
NEVER_GENERATED ไม่เคยสร้างรูปแบบการระบุแหล่งที่มาโดยอิงตามข้อมูล สาเหตุที่พบบ่อยที่สุดคือเนื่องจากไม่เคยมีเหตุการณ์ถึงจำนวนที่กำหนดในช่วง 30 วันใดๆ เลย

FloodlightSettings

การตั้งค่าที่เกี่ยวข้องกับการกระทําที่ถือเป็น Conversion ของ Floodlight

การแสดง JSON
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
ช่อง
activityGroupTag

string

สตริงที่ใช้ระบุกลุ่มกิจกรรม Floodlight เมื่อรายงาน Conversion

activityTag

string

สตริงที่ใช้ระบุกิจกรรม Floodlight เมื่อรายงาน Conversion

activityId

string (int64 format)

รหัสของกิจกรรม Floodlight ใน DoubleClick Campaign Manager (DCM)

ConversionCustomVariable

ตัวแปรที่กําหนดเองของ Conversion ดู "เกี่ยวกับเมตริกและมิติข้อมูล Floodlight ที่กำหนดเองใน Search Ads 360 เวอร์ชันใหม่" ที่ https://support.google.com/sa360/answer/13567857

การแสดง JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
ช่อง
resourceName

string

ชื่อแหล่งข้อมูลของตัวแปรที่กําหนดเองของ Conversion ชื่อทรัพยากรตัวแปรที่กำหนดเองของ Conversion จะมีรูปแบบดังนี้

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

รหัสของตัวแปร Conversion ที่กําหนดเอง

name

string

ต้องระบุ ชื่อของตัวแปรที่กำหนดเองของ Conversion ชื่อต้องไม่ซ้ำกัน ชื่อมีความยาวได้สูงสุด 100 อักขระ โดยไม่ควรมีช่องว่างข้างหน้าและข้างหลัง

tag

string

ต้องระบุ แท็กของตัวแปร Conversion ที่กําหนดเอง แท็กควรไม่ซ้ำกันและประกอบด้วยอักขระ "u" ตามด้วยตัวเลขที่น้อยกว่าหรือเท่ากับ 100 เช่น "u4"

status

enum (ConversionCustomVariableStatus)

สถานะของตัวแปรที่กําหนดเองของ Conversion สําหรับการสะสมเหตุการณ์ Conversion

ownerCustomer

string

ชื่อแหล่งข้อมูลของลูกค้าที่เป็นเจ้าของตัวแปรที่กําหนดเองของ Conversion

family

enum (ConversionCustomVariableFamily)

ตระกูลของตัวแปรที่กําหนดเองของ Conversion

cardinality

enum (ConversionCustomVariableCardinality)

Cardinality ของตัวแปรที่กําหนดเองของ Conversion

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

ช่องสําหรับตัวแปรที่กําหนดเองของ Conversion ใน Floodlight ของ Search Ads 360 ของ Search Ads 360

customColumnIds[]

string (int64 format)

รหัสของคอลัมน์ที่กำหนดเองซึ่งใช้ตัวแปรที่กำหนดเองของ Conversion นี้

ConversionCustomVariableStatus

สถานะที่เป็นไปได้ของตัวแปรที่กําหนดเองสําหรับ Conversion

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

ตัวแปรที่กําหนดเองสําหรับ Conversion รอการเปิดใช้งานและจะไม่สะสมสถิติจนกว่าจะตั้งค่าเป็น "เปิดใช้"

สถานะนี้ใช้ไม่ได้กับคำขอ CREATE และ UPDATE

ENABLED ระบบเปิดใช้ตัวแปรที่กําหนดเองสําหรับ Conversion แล้ว และจะรวบรวมสถิติ
PAUSED ตัวแปรที่กําหนดเองสําหรับ Conversion จะหยุดชั่วคราวและจะไม่สะสมสถิติจนกว่าจะตั้งค่าเป็น "เปิดใช้" อีกครั้ง

ConversionCustomVariableFamily

ตระกูลของตัวแปรที่กําหนดเองสําหรับ Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
STANDARD ตัวแปร Conversion ที่กำหนดเองมาตรฐาน ลูกค้าต้องเปิดใช้งานก่อนใช้งาน
FLOODLIGHT ตัวแปร Conversion ที่กำหนดเองที่นําเข้าจากตัวแปร Floodlight ที่กำหนดเอง

ConversionCustomVariableCardinality

Cardinality ของตัวแปรที่กําหนดเองสําหรับ Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BELOW_ALL_LIMITS ตัวแปรที่กำหนดเองของ Conversion มี Cardinality ต่ำกว่าขีดจํากัดทั้งหมด คุณสามารถใช้ตัวแปรนี้ในการแบ่งกลุ่ม และระบบจะรวบรวมสถิติสําหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT ตัวแปรที่กำหนดเองสำหรับ Conversion มี Cardinality เกินขีดจํากัดการแบ่งกลุ่ม แต่ไม่เกินขีดจํากัดสถิติ ระบบจะปิดใช้การแบ่งกลุ่ม แต่สถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
APPROACHES_STATS_LIMIT ตัวแปรที่กำหนดเองของ Conversion เกินขีดจํากัดการแบ่งกลุ่ม และใกล้ถึงขีดจํากัดสถิติ (> 90%) ระบบจะปิดใช้การแบ่งกลุ่ม แต่สถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
EXCEEDS_STATS_LIMIT ตัวแปรที่กำหนดเองของ Conversion เกินขีดจำกัดการแบ่งกลุ่มลูกค้าและสถิติสูงสุด ระบบจะปิดใช้การแบ่งกลุ่ม และสถิติสําหรับตัวแปรที่เปิดใช้จะเพิ่มขึ้นได้ก็ต่อเมื่อค่าที่มีอยู่ไม่ได้เพิ่มจํานวนสมาชิกของตัวแปรอีก

FloodlightConversionCustomVariableInfo

ข้อมูลสําหรับตัวแปร Conversion ของ Floodlight ที่กําหนดเองของ Search Ads 360

การแสดง JSON
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
ช่อง
floodlightVariableType

enum (FloodlightVariableType)

ประเภทตัวแปร Floodlight ที่กําหนดใน Search Ads 360

floodlightVariableDataType

enum (FloodlightVariableDataType)

ประเภทข้อมูลตัวแปร Floodlight ที่กําหนดไว้ใน Search Ads 360

FloodlightVariableType

ประเภทของตัวแปร Floodlight ตามที่กําหนดไว้ใน Search Ads 360 ดู https://support.google.com/searchads/answer/4397154?hl=en เพื่อเรียนรู้เพิ่มเติม

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DIMENSION ประเภทตัวแปร Floodlight ของมิติข้อมูล
METRIC ประเภทตัวแปร Floodlight ของเมตริก
UNSET ไม่ได้ตั้งค่าประเภทตัวแปร Floodlight

FloodlightVariableDataType

ประเภทข้อมูลของตัวแปร Floodlight ตามที่กําหนดไว้ใน Search Ads 360 ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/searchads/answer/4397154?hl=en

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
NUMBER แสดงตัวแปร Floodlight ประเภท "ตัวเลข" ระบบอาจกำหนดตัวแปรนี้ให้กับตัวแปร Floodlight ประเภท DIMENSION หรือ METRIC
STRING แสดงตัวแปร Floodlight ประเภท "สตริง" ตัวแปรนี้อาจกำหนดให้กับตัวแปร Floodlight ประเภทมิติข้อมูล

ลูกค้า

ลูกค้า

การแสดง JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
ช่อง
resourceName

string

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

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

การตั้งค่าเครื่องมือวัด Conversion สําหรับลูกค้า

accountType

enum (AccountType)

ประเภทบัญชีเครื่องมือค้นหา เช่น Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track ฯลฯ

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

การตั้งค่า DoubleClick Campaign Manager (DCM) สําหรับลูกค้าบัญชีดูแลจัดการ

accountStatus

enum (AccountStatus)

สถานะบัญชี เช่น เปิดใช้ หยุดชั่วคราว นำออก ฯลฯ

lastModifiedTime

string

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

engineId

string

รหัสบัญชีในบัญชีเครื่องมือค้นหาภายนอก

status

enum (CustomerStatus)

สถานะของลูกค้า

creationTime

string

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

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 บ่งบอกว่าบัญชีถูกปิดและแสดงโฆษณาไม่ได้ บัญชีทดสอบจะมีสถานะ "ปิด" ด้วย สถานะจะเป็นแบบถาวรและไม่สามารถเปิดใหม่ได้

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

แสดงมุมมองกลยุทธ์การเสนอราคาที่ลูกค้าเป็นเจ้าของและแชร์

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

การแสดง JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

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

string

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

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

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

name

string

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

type

enum (BiddingStrategyType)

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

ownerCustomerId

string (int64 format)

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

ownerDescriptiveName

string

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

ช่องการรวม scheme รูปแบบการเสนอราคา

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

targetCpaMicros

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

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

number

รายได้ที่เลือก (อิงตามข้อมูล Conversion) ต่อหน่วยการใช้จ่าย

TargetSpend

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

ManagerLinkStatus

สถานะต่างๆ ที่เป็นไปได้ของลิงก์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ACTIVE ระบุความสัมพันธ์ที่มีผลในปัจจุบัน
INACTIVE บ่งชี้ถึงความสัมพันธ์ที่สิ้นสุดลงแล้ว
PENDING บ่งบอกว่าผู้จัดการได้ส่งคำขอความสัมพันธ์แล้ว แต่ลูกค้ายังไม่ได้ยอมรับ
REFUSED ผู้จัดการส่งคำขอความสัมพันธ์ แต่ลูกค้าปฏิเสธ
CANCELED บ่งบอกว่าผู้จัดการได้ส่งคำขอความสัมพันธ์แล้ว แต่ผู้จัดการยกเลิกคำขอ

CustomerClient

ลิงก์ระหว่างลูกค้ารายหนึ่งกับลูกค้าของลูกค้า CustomerClient มีอยู่สําหรับลูกค้าที่เป็นผู้จัดการเท่านั้น ซึ่งรวมถึงลูกค้าโดยตรงและโดยอ้อมทั้งหมดของบัญชีดูแลจัดการ รวมถึงตัวผู้จัดการเอง

การแสดง JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของไคลเอ็นต์ของลูกค้า ชื่อทรัพยากร CustomerClient อยู่ในรูปแบบ customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

ชื่อทรัพยากรของป้ายกำกับที่เป็นของลูกค้าที่ส่งคำขอซึ่งใช้กับลูกค้าของลูกค้า ชื่อทรัพยากรป้ายกำกับจะมีรูปแบบดังนี้

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

สถานะของลูกค้า อ่านอย่างเดียว

clientCustomer

string

ชื่อทรัพยากรของลูกค้าที่ลิงก์กับลูกค้ารายดังกล่าว อ่านอย่างเดียว

hidden

boolean

ระบุว่าบัญชีนี้เป็นบัญชีที่ซ่อนอยู่หรือไม่

อ่านอย่างเดียว

level

string (int64 format)

ระยะทางระหว่างลูกค้ารายหนึ่งกับลูกค้ารายอื่น สำหรับลิงก์เข้าเว็บเดิม ค่าระดับจะเป็น 0 อ่านอย่างเดียว

timeZone

string

การนําเสนอสตริงของที่เก็บข้อมูลภาษาที่พบบ่อย (CLDR) ของเขตเวลาของลูกค้า เช่น America/Los_Angeles อ่านอย่างเดียว

testAccount

boolean

ระบุว่าลูกค้าเป็นบัญชีทดสอบหรือไม่ อ่านอย่างเดียว

manager

boolean

ระบุว่าลูกค้าเป็นผู้จัดการหรือไม่ อ่านอย่างเดียว

descriptiveName

string

ชื่อที่สื่อความหมายสำหรับไคลเอ็นต์ อ่านอย่างเดียว

currencyCode

string

รหัสสกุลเงิน (เช่น "USD", "EUR") สำหรับลูกค้า อ่านอย่างเดียว

id

string (int64 format)

รหัสของลูกค้าของลูกค้า อ่านอย่างเดียว

DynamicSearchAdsSearchTermView

มุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิก

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

string

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

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

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

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

GenderView

มุมมองตามเพศ ทรัพยากร genderView จะแสดงสถานะการแสดงผลที่มีประสิทธิภาพ ไม่ใช่เกณฑ์ที่เพิ่ม กลุ่มโฆษณาที่ไม่มีเกณฑ์เพศจะแสดงต่อทุกเพศโดยค่าเริ่มต้น ดังนั้นทุกเพศจึงปรากฏในมุมมองเพศพร้อมสถิติ

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

string

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

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

GeoTargetConstant

ค่าคงที่เป้าหมายทางภูมิศาสตร์

การแสดง JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
ช่อง
resourceName

string

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

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

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

id

string (int64 format)

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

name

string

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

countryCode

string

รหัสประเทศ ISO-3166-1 alpha-2 ที่เชื่อมโยงกับเป้าหมาย

targetType

string

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

canonicalName

string

ชื่อภาษาอังกฤษแบบเต็มที่ประกอบด้วยชื่อของเป้าหมาย ชื่อบริษัทแม่ และชื่อประเทศ

parentGeoTarget

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์หลัก ชื่อทรัพยากรคงที่เป้าหมายทางภูมิศาสตร์จะมีรูปแบบดังนี้

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

สถานะที่เป็นไปได้ของค่าคงที่ของเป้าหมายตามภูมิศาสตร์

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

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

ค่านี้เป็นค่าตอบกลับเท่านั้น

ENABLED ค่าคงที่ของเป้าหมายทางภูมิศาสตร์ถูกต้อง
REMOVAL_PLANNED ค่าคงที่เป้าหมายตามภูมิศาสตร์ล้าสมัยแล้วและจะถูกนําออก

KeywordView

มุมมองคีย์เวิร์ด

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

string

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

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

ป้ายกำกับ

ป้ายกำกับ

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

string

ชื่อแหล่งข้อมูล ชื่อทรัพยากรป้ายกำกับอยู่ในรูปแบบ customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

สถานะของป้ายกำกับ อ่านอย่างเดียว

textLabel

object (TextLabel)

ประเภทของป้ายกำกับที่แสดงข้อความบนพื้นหลังที่มีสี

id

string (int64 format)

รหัสของป้ายกำกับ อ่านอย่างเดียว

name

string

ชื่อของป้ายกำกับ

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

ความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 80 อักขระ

LabelStatus

สถานะที่เป็นไปได้ของป้ายกำกับ

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

TextLabel

ประเภทของป้ายกำกับที่แสดงข้อความบนพื้นหลังที่มีสี

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

string

สีพื้นหลังของป้ายกำกับในรูปแบบ HEX สตริงนี้ต้องตรงกับนิพจน์ทั่วไป "^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$" โปรดทราบว่าบัญชีดูแลจัดการอาจไม่เห็นสีพื้นหลัง

description

string

คำอธิบายสั้นๆ ของป้ายกำกับ ความยาวต้องไม่เกิน 200 อักขระ

LanguageConstant

ภาษา

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

string

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

languageConstants/{criterionId}

id

string (int64 format)

รหัสของค่าคงที่ของภาษา

code

string

รหัสภาษา เช่น "en_US", "en_AU", "es", "fr" ฯลฯ

name

string

ชื่อเต็มของภาษานั้นเป็นภาษาอังกฤษ เช่น "อังกฤษ (สหรัฐอเมริกา)" "สเปน" เป็นต้น

targetable

boolean

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

LocationView

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

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

string

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

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

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

การแสดง JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของหมวดหมู่การเสนอราคาผลิตภัณฑ์ ชื่อทรัพยากรหมวดหมู่การเสนอราคาผลิตภัณฑ์มีรูปแบบดังนี้

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

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

status

enum (ProductBiddingCategoryStatus)

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

id

string (int64 format)

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

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

countryCode

string

รหัสประเทศเป็นอักษรตัวพิมพ์ใหญ่ 2 ตัวของหมวดหมู่การเสนอราคาผลิตภัณฑ์

productBiddingCategoryConstantParent

string

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

languageCode

string

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

localizedName

string

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

ProductBiddingCategoryLevel

Enum ที่อธิบายระดับของหมวดหมู่การเสนอราคาผลิตภัณฑ์

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

ProductBiddingCategoryStatus

Enum ที่อธิบายสถานะของหมวดหมู่การเสนอราคาผลิตภัณฑ์

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

ProductGroupView

มุมมองกลุ่มผลิตภัณฑ์

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

string

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

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

ShoppingPerformanceView

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

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

string

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

UserList

รายการผู้ใช้ รายการนี้คือรายชื่อผู้ใช้ที่ลูกค้าอาจกําหนดเป้าหมาย

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

string

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

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

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

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

id

string (int64 format)

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

name

string

ชื่อของรายการผู้ใช้นี้ ชื่อรายการผู้ใช้อาจไม่ซ้ำกันโดยขึ้นอยู่กับ access_reason (เช่น หาก access_reason=SHARED)

UserListType

Enum ที่มีประเภทรายการผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
REMARKETING UserList ที่แสดงเป็นคอลเล็กชันประเภท Conversion
LOGICAL รายชื่อผู้ใช้ที่แสดงเป็นกลุ่มของรายการ/ความสนใจอื่นๆ ของผู้ใช้
EXTERNAL_REMARKETING UserList ที่สร้างขึ้นบนแพลตฟอร์ม Google Ad Manager
RULE_BASED UserList ที่เชื่อมโยงกับกฎ
SIMILAR UserList ที่มีผู้ใช้ที่คล้ายกับผู้ใช้ของ UserList อื่น
CRM_BASED UserList ของข้อมูล CRM ของบุคคลที่หนึ่งที่ผู้ลงโฆษณาระบุในรูปแบบอีเมลหรือรูปแบบอื่นๆ

WebpageView

มุมมองหน้าเว็บ

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

string

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

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

ไปที่

การเยี่ยมชม

การแสดง JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
ช่อง
resourceName

string

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

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

รหัสของการเข้าชม

criterionId

string (int64 format)

รหัสคีย์เวิร์ด Search Ads 360 ค่า 0 บ่งบอกว่าคีย์เวิร์ดไม่มีแหล่งที่มา

merchantId

string (int64 format)

รหัสบัญชีสินค้าคงคลังของ Search Ads 360 ที่มีผลิตภัณฑ์ที่คลิก Search Ads 360 จะสร้างรหัสนี้เมื่อคุณลิงก์บัญชีสินค้าคงคลังใน Search Ads 360

adId

string (int64 format)

รหัสโฆษณา ค่า 0 หมายความว่าโฆษณาไม่มีการระบุแหล่งที่มา

clickId

string

สตริงที่ไม่ซ้ำกันสำหรับการเข้าชมแต่ละครั้งที่ส่งไปยังหน้า Landing Page เป็นพารามิเตอร์ของ URL รหัสคลิก

visitDateTime

string

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

productId

string

รหัสของผลิตภัณฑ์ที่คลิก

productChannel

enum (ProductChannel)

ช่องทางการขายของผลิตภัณฑ์ที่มีการคลิก ได้แก่ ออนไลน์หรือท้องถิ่น

productLanguageCode

string

ภาษา (ISO-639-1) ที่ตั้งค่าไว้สำหรับฟีด Merchant Center ที่มีข้อมูลเกี่ยวกับผลิตภัณฑ์

productStoreId

string

ร้านค้าในโฆษณาสินค้าคงคลังในร้านที่มีการคลิก ซึ่งควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน

productCountryCode

string

ประเทศ (รูปแบบ ISO-3166) ที่จดทะเบียนสำหรับฟีดสินค้าคงคลังที่ผลิตภัณฑ์ที่มีการคลิก

assetId

string (int64 format)

รหัสของเนื้อหาที่มีการโต้ตอบระหว่างเหตุการณ์การเข้าชม

assetFieldType

enum (AssetFieldType)

ประเภทช่องชิ้นงานของเหตุการณ์การเข้าชม

ProductChannel

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

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

Conversion

Conversion

การแสดง JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
ช่อง
resourceName

string

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

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

รหัสของ Conversion

criterionId

string (int64 format)

รหัสเกณฑ์ Search Ads 360 ค่า 0 หมายความว่าเกณฑ์ไม่มีการระบุแหล่งที่มา

merchantId

string (int64 format)

รหัสบัญชีสินค้าคงคลังของ Search Ads 360 ที่มีผลิตภัณฑ์ที่มีการคลิก Search Ads 360 จะสร้างรหัสนี้เมื่อคุณลิงก์บัญชีสินค้าคงคลังใน Search Ads 360

adId

string (int64 format)

รหัสโฆษณา ค่า 0 หมายความว่าโฆษณาไม่มีการระบุแหล่งที่มา

clickId

string

สตริงที่ไม่ซ้ำกันสำหรับการเข้าชมซึ่งมีที่มาจาก Conversion และส่งไปยังหน้า Landing Page เป็นพารามิเตอร์ของ URL รหัสคลิก

visitId

string (int64 format)

รหัสการเข้าชม Search Ads 360 ที่เป็นแหล่งที่มาของ Conversion

advertiserConversionId

string

สําหรับ Conversion ออฟไลน์ รหัสนี้คือรหัสที่ผู้ลงโฆษณาระบุ หากผู้ลงโฆษณาไม่ได้ระบุรหัสดังกล่าว Search Ads 360 จะสร้างรหัสให้ สําหรับ Conversion ออนไลน์ ค่านี้จะเท่ากับคอลัมน์รหัสหรือคอลัมน์ floodlightOrderId ทั้งนี้ขึ้นอยู่กับวิธีการของ Floodlight ที่ผู้ลงโฆษณาระบุ

productId

string

รหัสของผลิตภัณฑ์ที่คลิก

productChannel

enum (ProductChannel)

ช่องทางการขายของผลิตภัณฑ์ที่มีการคลิก ได้แก่ ออนไลน์หรือท้องถิ่น

productLanguageCode

string

ภาษา (ISO-639-1) ที่ตั้งค่าไว้สำหรับฟีด Merchant Center ที่มีข้อมูลเกี่ยวกับผลิตภัณฑ์

productStoreId

string

ร้านค้าในโฆษณาสินค้าคงคลังในร้านที่มีการคลิก ซึ่งควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน

productCountryCode

string

ประเทศ (รูปแบบ ISO-3166) ที่จดทะเบียนสำหรับฟีดสินค้าคงคลังซึ่งมีผลิตภัณฑ์ที่คลิก

attributionType

enum (AttributionType)

แหล่งที่มาของ Conversion: การเข้าชมหรือคีย์เวิร์ด + โฆษณา

conversionDateTime

string

การประทับเวลาของเหตุการณ์ Conversion

conversionLastModifiedDateTime

string

การประทับเวลาที่แก้ไข Conversion ครั้งล่าสุด

conversionVisitDateTime

string

การประทับเวลาการเข้าชมที่เป็นแหล่งที่มาของ Conversion

conversionQuantity

string (int64 format)

จำนวนรายการที่ Conversion บันทึกไว้ตามที่ระบุโดยพารามิเตอร์ URL จำนวน qty ผู้ลงโฆษณาเป็นผู้รับผิดชอบในการใส่พารามิเตอร์แบบไดนามิก (เช่น จำนวนสินค้าที่ขายใน Conversion) มิเช่นนั้น จะมีค่าเริ่มต้นเป็น 1

conversionRevenueMicros

string (int64 format)

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

floodlightOriginalRevenue

string (int64 format)

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

floodlightOrderId

string

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

status

enum (ConversionStatus)

สถานะของ Conversion ไม่ว่าจะเป็น "เปิดใช้งาน" หรือ "นำออกแล้ว"

assetId

string (int64 format)

รหัสของชิ้นงานที่โต้ตอบระหว่างเหตุการณ์ Conversion

assetFieldType

enum (AssetFieldType)

ประเภทช่องชิ้นงานของเหตุการณ์ Conversion

AttributionType

ประเภทการระบุแหล่งที่มาของ Conversion ใน Search Ads 360

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
VISIT Conversion มีการระบุแหล่งที่มาเป็นการเข้าชม
CRITERION_AD Conversion นี้มาจากการระบุแหล่งที่มาของคู่เกณฑ์และโฆษณา

ConversionStatus

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

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

เมตริก

ข้อมูลเมตริก

การแสดง JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
ช่อง
allConversionsValueByConversionDate

number

มูลค่าของ Conversion ทั้งหมด เมื่อเลือกคอลัมน์นี้ด้วยวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611

allConversionsByConversionDate

number

จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมด ไม่ว่าค่าของ includeInConversionsMetric จะเป็นอย่างไร เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611

conversionCustomMetrics[]

object (Value)

เมตริก Conversion ที่กําหนดเอง

conversionsValueByConversionDate

number

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

conversionsByConversionDate

number

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

historicalCreativeQualityScore

enum (QualityScoreBucket)

คะแนนคุณภาพที่ผ่านมาของครีเอทีฟโฆษณา

historicalLandingPageQualityScore

enum (QualityScoreBucket)

คุณภาพของประสบการณ์หน้า Landing Page ที่ผ่านมา

historicalSearchPredictedCtr

enum (QualityScoreBucket)

อัตราการคลิกผ่าน (CTR) ที่คาดการณ์ไว้ของการค้นหาที่ผ่านมา

interactionEventTypes[]

enum (InteractionEventType)

ประเภทของการโต้ตอบแบบชำระเงินและไม่เสียค่าใช้จ่าย

rawEventConversionMetrics[]

object (Value)

เมตริก Conversion เหตุการณ์ดิบ

absoluteTopImpressionPercentage

number

ส่วนแบ่งการแสดงผลในตำแหน่งบนสุดแบบสัมบูรณ์ใน Search คือเปอร์เซ็นต์ของการแสดงโฆษณา Search ในตำแหน่งการค้นหาที่โดดเด่นที่สุด

allConversionsFromInteractionsRate

number

Conversion ทั้งหมดจากการโต้ตอบ (ไม่ใช่ Conversion การดูผ่าน) หารด้วยจํานวนการโต้ตอบกับโฆษณา

allConversionsValue

number

มูลค่าของ Conversion ทั้งหมด

allConversions

number

จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมด ไม่ว่าค่าของ includeInConversionsMetric จะเป็นอย่างไร

allConversionsValuePerCost

number

มูลค่าของ Conversion ทั้งหมดหารด้วยต้นทุนรวมของการโต้ตอบกับโฆษณา (เช่น การคลิกโฆษณาแบบข้อความหรือการดูโฆษณาวิดีโอ)

allConversionsFromClickToCall

number

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

เมตริกนี้ใช้กับรายการฟีดเท่านั้น

allConversionsFromDirections

number

จํานวนครั้งที่ผู้ใช้คลิกปุ่ม "ขอเส้นทาง" เพื่อนําทางไปยังร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น

allConversionsFromInteractionsValuePerInteraction

number

มูลค่าของ Conversion ทั้งหมดจากการโต้ตอบหารด้วยจํานวนการโต้ตอบทั้งหมด

allConversionsFromMenu

number

จํานวนครั้งที่ผู้ใช้คลิกลิงก์เพื่อดูเมนูของร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น

allConversionsFromOrder

number

จํานวนครั้งที่ผู้ใช้สั่งซื้อสินค้าที่ร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น

allConversionsFromOtherEngagement

number

จำนวน Conversion อื่นๆ (เช่น การโพสต์รีวิวหรือการบันทึกสถานที่ตั้งของร้านค้า) ซึ่งเกิดขึ้นหลังจากที่ผู้ใช้คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น

allConversionsFromStoreVisit

number

จํานวนครั้งที่มีผู้เข้าชมร้านค้าโดยประมาณหลังจากคลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น

visits

number

การคลิกที่ Search Ads 360 บันทึกและส่งต่อไปยังหน้า Landing Page ของผู้ลงโฆษณาได้สำเร็จ

allConversionsFromStoreWebsite

number

จํานวนครั้งที่ระบบนําผู้ใช้ไปยัง URL ของร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น

averageCost

number

จํานวนเงินเฉลี่ยที่คุณจ่ายต่อการโต้ตอบ 1 ครั้ง จำนวนนี้คือค่าใช้จ่ายรวมของโฆษณาหารด้วยจำนวนการโต้ตอบทั้งหมด

averageCpc

number

ค่าใช้จ่ายรวมของคลิกทั้งหมดหารด้วยจํานวนคลิกทั้งหมดที่ได้รับ เมตริกนี้เป็นมูลค่าทางการเงินและแสดงผลในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์Metric_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

averageCpm

number

ต้นทุนต่อการแสดงผลพันครั้ง (CPM) โดยเฉลี่ย เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

string (int64 format)

จํานวนคลิก

contentBudgetLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของจำนวนครั้งที่โฆษณามีสิทธิ์แสดงในเครือข่าย Display แต่ไม่ได้แสดงเนื่องจากงบประมาณต่ำเกินไป หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลที่เสียไปเนื่องจากงบประมาณของเนื้อหาในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001

contentImpressionShare

number

การแสดงผลที่คุณได้รับในเครือข่าย Display หารด้วยจํานวนโดยประมาณของการแสดงผลที่คุณมีสิทธิ์ได้รับ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลของเนื้อหาในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999

contentRankLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของการแสดงผลในเครือข่าย Display ที่โฆษณาไม่ได้รับเนื่องจากลําดับโฆษณาต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลที่เสียไปในอันดับของเนื้อหาในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001

conversionsFromInteractionsRate

number

Conversion ที่มีการเสนอราคาได้โดยเฉลี่ย (จากการโต้ตอบ) ต่อการโต้ตอบที่มีสิทธิ์เป็น Conversion แสดงความถี่โดยเฉลี่ยที่การโต้ตอบกับโฆษณาทําให้เกิด Conversion ที่เสนอราคาได้

clientAccountConversionsValue

number

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

conversionsValuePerCost

number

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

conversionsFromInteractionsValuePerInteraction

number

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

clientAccountConversions

number

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

costMicros

string (int64 format)

ผลรวมของค่าใช้จ่ายจากราคาต่อหนึ่งคลิก (CPC) และราคาต่อการแสดงผลพันครั้ง (CPM) ในช่วงระยะเวลานี้ เมตริกนี้เป็นมูลค่าทางการเงินและแสดงผลในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์Metric_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

costPerAllConversions

number

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

costPerConversion

number

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

costPerCurrentModelAttributedConversion

number

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

crossDeviceConversions

number

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

crossDeviceConversionsByConversionDate

number

จํานวน Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611

crossDeviceConversionsValue

number

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

crossDeviceConversionsValueByConversionDate

number

ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611

ctr

number

จํานวนคลิกที่โฆษณาได้รับ (คลิก) หารด้วยจํานวนครั้งที่โฆษณาแสดง (การแสดงผล)

conversions

number

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

conversionsValue

number

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

averageQualityScore

number

คะแนนคุณภาพเฉลี่ย

historicalQualityScore

string (int64 format)

คะแนนคุณภาพที่ผ่านมา

impressions

string (int64 format)

จํานวนความถี่ที่โฆษณาปรากฏในหน้าผลการค้นหาหรือเว็บไซต์ในเครือข่ายของ Google

interactionRate

number

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

interactions

string (int64 format)

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

invalidClickRate

number

เปอร์เซ็นต์ของคลิกที่กรองออกจากจํานวนคลิกทั้งหมด (คลิกที่กรอง + คลิกที่ไม่ได้กรอง) ในช่วงระยะเวลาการรายงาน

invalidClicks

string (int64 format)

จํานวนการคลิกที่ Google ถือว่าผิดกฎและจะไม่เรียกเก็บเงินจากคุณ

generalInvalidClickRate

number

เปอร์เซ็นต์ของคลิกที่กรองออกจากจํานวนคลิกทั้งหมด (คลิกที่กรอง + คลิกที่ไม่ได้กรอง) เนื่องจากเป็นคลิกที่ไม่ถูกต้องทั่วไป ซึ่งเป็นคลิกที่ Google ถือว่าผิดหลักเกณฑ์โดยตรวจพบผ่านวิธีการกรองตามปกติ (เช่น การเข้าชมศูนย์ข้อมูลที่ทราบกันดีว่าไม่ถูกต้อง บ็อต และสไปเดอร์หรือ Crawler อื่นๆ รูปแบบที่ผิดปกติ ฯลฯ) ระบบจะไม่เรียกเก็บเงินสำหรับการคลิกดังกล่าว และการคลิกในลักษณะนี้จะไม่ส่งผลกระทบต่อสถิติในบัญชีของคุณ ดูรายละเอียดได้ที่หน้าความช่วยเหลือที่ https://support.google.com/campaignmanager/answer/6076504

generalInvalidClicks

string (int64 format)

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

mobileFriendlyClicksPercentage

number

เปอร์เซ็นต์การคลิกจากอุปกรณ์เคลื่อนที่ไปยังหน้าเว็บที่เหมาะกับอุปกรณ์เคลื่อนที่

searchAbsoluteTopImpressionShare

number

เปอร์เซ็นต์ของการแสดงโฆษณา Shopping หรือโฆษณา Search ของลูกค้าที่แสดงในตําแหน่ง Shopping ที่โดดเด่นที่สุด ดูรายละเอียดได้ที่ https://support.google.com/sa360/answer/9566729 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999

searchBudgetLostAbsoluteTopImpressionShare

number

จํานวนโดยประมาณของความถี่ที่โฆษณาไม่ได้เป็นโฆษณาแรกของกลุ่มโฆษณาในตําแหน่งบนสุดของผลการค้นหาเนื่องจากงบประมาณต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดแบบสัมบูรณ์ที่เสียไปใน Search ของงบประมาณในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001

searchBudgetLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของจำนวนครั้งที่โฆษณามีสิทธิ์แสดงในเครือข่าย Search แต่ไม่ได้แสดงเนื่องจากงบประมาณต่ำเกินไป หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลที่เสียไปเนื่องจากงบประมาณ Search ในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001

searchBudgetLostTopImpressionShare

number

จํานวนโดยประมาณของความถี่ที่โฆษณาไม่ได้แสดงถัดจากผลการค้นหาทั่วไปในตําแหน่งบนสุดเนื่องจากงบประมาณต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดที่เสียไปใน Search ของงบประมาณในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001

searchClickShare

number

จํานวนคลิกที่คุณได้รับในเครือข่าย Search หารด้วยจํานวนคลิกโดยประมาณที่คุณมีสิทธิ์ได้รับ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการคลิกใน 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 ที่โฆษณาไม่ได้รับเนื่องจากมีลําดับโฆษณาต่ำ หมายเหตุ: ส่วนแบ่งการแสดงผลที่เสียไปในอันดับการค้นหาจะรายงานอยู่ในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001

searchRankLostTopImpressionShare

number

จํานวนโดยประมาณของความถี่ที่โฆษณาไม่ได้แสดงถัดจากผลการค้นหาทั่วไปในตําแหน่งบนสุดเนื่องจากลําดับโฆษณาต่ำ หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดที่เสียไปใน Search (อันดับ) ในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001

searchTopImpressionShare

number

การแสดงผลที่คุณได้รับจากโฆษณาด้านบน เทียบกับจำนวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับในกลุ่มโฆษณาด้านบน หมายเหตุ: ระบบจะรายงานส่วนแบ่งการแสดงผลในตำแหน่งบนสุดใน Search ในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999

โดยโฆษณามักจะแสดงเหนือผลการค้นหาทั่วไปในตำแหน่งบนสุด แต่ในบางกรณีก็อาจแสดงด้านล่างของผลการค้นหาทั่วไปในตำแหน่งบนสุดได้

topImpressionPercentage

number

เปอร์เซ็นต์ของการแสดงโฆษณาที่แสดงอยู่ติดกับผลการค้นหาทั่วไปในตำแหน่งบนสุด

valuePerAllConversions

number

มูลค่าของ Conversion ทั้งหมดหารด้วยจำนวน Conversion ทั้งหมด

valuePerAllConversionsByConversionDate

number

มูลค่าของ Conversion ทั้งหมดหารด้วยจํานวน Conversion ทั้งหมด เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดของคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611

valuePerConversion

number

มูลค่าของ Conversion ที่เสนอราคาได้หารด้วยจํานวน Conversion ที่เสนอราคาได้ แสดงมูลค่าโดยเฉลี่ยของ Conversion ที่เสนอราคาได้แต่ละรายการ

valuePerConversionsByConversionDate

number

มูลค่า Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion หารด้วย Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion แสดงมูลค่าโดยเฉลี่ยของ Conversion ที่เสนอราคาได้แต่ละรายการ (ตามวันที่เกิด Conversion) เมื่อเลือกคอลัมน์นี้ด้วยวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion

clientAccountViewThroughConversions

string (int64 format)

จำนวน Conversion การดูผ่านทั้งหมด ประเภทนี้เกิดขึ้นเมื่อลูกค้าเห็นโฆษณาแบบรูปภาพหรือริชมีเดีย จากนั้นจึงเกิด Conversion เสร็จสมบูรณ์บนเว็บไซต์ในภายหลังโดยไม่ได้โต้ตอบกับ (เช่น คลิก) โฆษณาอื่น

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากการขายครอสเซล (COGS) ของบัญชีลูกค้าคือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล ต้นทุนสินค้าขายจากการขายครอสเซลคือต้นทุนรวมของผลิตภัณฑ์ที่ขายโดยไม่ได้โฆษณา เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและแสดงผลในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากการขายครอสเซล (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล ต้นทุนสินค้าขายจากการขายครอสเซลคือต้นทุนรวมของผลิตภัณฑ์ที่ขายโดยไม่ได้โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากการขายครอสเซลของบัญชีลูกค้าคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่นลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในการขายจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล กําไรขั้นต้นจากการขายครอสเซลคือรายได้จากการขายครอสเซลที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว เสื้อราคา 600 บาทและมีมูลค่าต้นทุนสินค้าขาย 150 บาท กําไรขั้นต้นจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 450 บาท = 600 บาท - 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์Metric_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากการขายครอสเซลคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่นลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในการขายจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล กําไรขั้นต้นจากการขายครอสเซลคือรายได้จากการขายครอสเซลที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว เสื้อราคา 600 บาทและมีมูลค่าต้นทุนสินค้าขาย 150 บาท กําไรขั้นต้นจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 450 บาท = 600 บาท - 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellRevenueMicros

string (int64 format)

รายได้จากการขายครอสเซลของบัญชีลูกค้าคือจํานวนเงินทั้งหมดที่คุณได้มาจากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล รายได้จากการขายครอสเซลคือมูลค่าทั้งหมดที่คุณได้มาจากการขายครอสเซลที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากการขายครอสเซลสําหรับคําสั่งซื้อนี้เท่ากับ 600 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellRevenueMicros

string (int64 format)

รายได้จากการขายครอสเซลคือจํานวนเงินทั้งหมดที่คุณได้มาจากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล รายได้จากการขายครอสเซลคือมูลค่าทั้งหมดที่คุณได้มาจากการขายครอสเซลที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากการขายครอสเซลสําหรับคําสั่งซื้อนี้เท่ากับ 600 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและแสดงผลในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellUnitsSold

number

จํานวนผลิตภัณฑ์ที่ขายได้จากการขายครอสเซลในบัญชีลูกค้าคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ทําให้เกิดการขายแบบครอสเซลจากคําสั่งซื้อทั้งหมดที่มาจากโฆษณาของคุณ เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น รวมถึงเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จำนวนที่ขายได้จากการขายครอสเซลในคําสั่งซื้อนี้คือ 2 เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น

crossSellUnitsSold

number

จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ทําให้เกิดการขายแบบครอสเซลจากคําสั่งซื้อทั้งหมดที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละหนึ่งตัว จำนวนที่ขายได้จากการขายครอสเซลในคําสั่งซื้อนี้คือ 2 เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา (COGS) ของบัญชีลูกค้าคือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน ต้นทุนของสินค้าเหล่านี้จะนับภายใต้ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณาสําหรับคําสั่งซื้อนี้เท่ากับ 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและแสดงผลในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน ต้นทุนของสินค้าเหล่านี้จะนับภายใต้ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณาสําหรับคําสั่งซื้อนี้เท่ากับ 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์Metric_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาของบัญชีลูกค้าคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกันลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาจะมาจากรายได้จากการขายเหล่านี้ลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท กำไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้เท่ากับ 210 บาท = 300 บาท - 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกันลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาจะมาจากรายได้จากการขายเหล่านี้ลบด้วยต้นทุนสินค้าขาย เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท กำไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้เท่ากับ 210 บาท = 300 บาท - 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadRevenueMicros

string (int64 format)

รายได้จากผลิตภัณฑ์ที่โฆษณาในบัญชีลูกค้าคือจํานวนเงินทั้งหมดที่ได้มาจากผลิตภัณฑ์ที่ขายได้เนื่องจากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน มูลค่ารวมจากการขายผลิตภัณฑ์เหล่านี้จะปรากฏใต้รายได้จากผลิตภัณฑ์ที่โฆษณา เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้คือ 300 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadRevenueMicros

string (int64 format)

รายได้จากผลิตภัณฑ์ที่โฆษณาคือจํานวนเงินทั้งหมดที่ได้มาจากผลิตภัณฑ์ที่ขายได้เนื่องจากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน มูลค่ารวมจากการขายผลิตภัณฑ์เหล่านี้จะปรากฏใต้รายได้จากผลิตภัณฑ์ที่โฆษณา เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้คือ 300 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงเป็นสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadUnitsSold

number

จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ของบัญชีลูกค้าคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จะปรากฏในจํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น รวมถึงเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ในคําสั่งซื้อนี้คือ 1 ชิ้น เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น

leadUnitsSold

number

จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้คือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จะปรากฏในจํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ เช่น มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น รวมถึงเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ในคําสั่งซื้อนี้คือ 1 ชิ้น เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น

ค่า

คอนเทนเนอร์ข้อมูลทั่วไป

การแสดง JSON
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
ช่อง
ช่องการรวม value ค่า value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
booleanValue

boolean

บูลีน

int64Value

string (int64 format)

int64

floatValue

number

ฟลอยท์

doubleValue

number

ห้องพักขนาดใหญ่

stringValue

string

สตริง

QualityScoreBucket

Enum ที่แสดงกลุ่มคะแนนคุณภาพที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BELOW_AVERAGE คุณภาพของครีเอทีฟโฆษณาต่ำกว่าค่าเฉลี่ย
AVERAGE คุณภาพของครีเอทีฟโฆษณาอยู่ในระดับปานกลาง
ABOVE_AVERAGE คุณภาพของครีเอทีฟโฆษณาสูงกว่าค่าเฉลี่ย

InteractionEventType

Enum ที่อธิบายประเภทของการโต้ตอบแบบชำระเงินและแบบไม่เสียค่าใช้จ่ายที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CLICK คลิกเพื่อเข้าชมเว็บไซต์ ในกรณีส่วนใหญ่ การโต้ตอบนี้จะไปยังตำแหน่งภายนอก ซึ่งมักจะเป็นหน้า Landing Page ของผู้ลงโฆษณา ซึ่งยังเป็น InteractionEventType เริ่มต้นสําหรับเหตุการณ์การคลิกด้วย
ENGAGEMENT ความตั้งใจที่ผู้ใช้แสดงออกเพื่อมีส่วนร่วมกับโฆษณาในตำแหน่งนั้นๆ
VIDEO_VIEW ผู้ใช้ดูโฆษณาวิดีโอ
NONE InteractionEventType เริ่มต้นสําหรับเหตุการณ์ Conversion ของโฆษณา รายการนี้ใช้เมื่อแถว Conversion ของโฆษณาไม่ได้ระบุว่าควร "โปรโมต" การโต้ตอบแบบไม่มีค่าใช้จ่าย (เช่น Conversion ของโฆษณา) และรายงานเป็นส่วนหนึ่งของเมตริกหลัก รายการเหล่านี้เป็นเพียง Conversion (โฆษณา) อื่นๆ

กลุ่ม

ช่องเฉพาะกลุ่ม

การแสดง JSON
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
ช่อง
adNetworkType

enum (AdNetworkType)

ประเภทเครือข่ายโฆษณา

conversionActionCategory

enum (ConversionActionCategory)

หมวดหมู่การกระทำที่ถือเป็น Conversion

conversionCustomDimensions[]

object (Value)

มิติข้อมูลที่กำหนดเองของ Conversion

dayOfWeek

enum (DayOfWeek)

วันของสัปดาห์ เช่น MONDAY

device

enum (Device)

อุปกรณ์ที่ใช้เมตริก

keyword

object (Keyword)

เกณฑ์คีย์เวิร์ด

productChannel

enum (ProductChannel)

ช่องทางของผลิตภัณฑ์

productChannelExclusivity

enum (ProductChannelExclusivity)

ความมีเอกสิทธิ์ของช่องทางของผลิตภัณฑ์

productCondition

enum (ProductCondition)

สภาพของผลิตภัณฑ์

productSoldCondition

enum (ProductCondition)

สภาพของผลิตภัณฑ์ที่ขาย

rawEventConversionDimensions[]

object (Value)

มิติข้อมูล Conversion เหตุการณ์ดิบ

conversionAction

string

ชื่อทรัพยากรของการกระทําที่ถือเป็น Conversion

conversionActionName

string

ชื่อการกระทำที่ถือเป็น Conversion

date

string

วันที่ที่ใช้เมตริก รูปแบบ ปปปป-ดด-วว เช่น 2018-04-17

geoTargetCity

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์ที่แสดงถึงเมือง

geoTargetCountry

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์ที่แสดงถึงประเทศ

geoTargetMetro

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์ที่แสดงถึงเมืองใหญ่

geoTargetRegion

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์ที่แสดงถึงภูมิภาค

hour

integer

ชั่วโมงของวันเป็นตัวเลขระหว่าง 0 ถึง 23

month

string

เดือนที่แสดงโดยวันที่ของวันแรกของเดือน มีรูปแบบเป็น yyyy-MM-dd

productBiddingCategoryLevel1

string

หมวดหมู่การเสนอราคา (ระดับ 1) ของผลิตภัณฑ์

productBiddingCategoryLevel2

string

หมวดหมู่การเสนอราคา (ระดับ 2) ของผลิตภัณฑ์

productBiddingCategoryLevel3

string

หมวดหมู่การเสนอราคา (ระดับ 3) ของผลิตภัณฑ์

productBiddingCategoryLevel4

string

หมวดหมู่การเสนอราคา (ระดับ 4) ของผลิตภัณฑ์

productBiddingCategoryLevel5

string

หมวดหมู่การเสนอราคา (ระดับ 5) ของผลิตภัณฑ์

productBrand

string

แบรนด์ของผลิตภัณฑ์

productCountry

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายตามภูมิศาสตร์สำหรับประเทศที่ขายผลิตภัณฑ์

productCustomAttribute0

string

แอตทริบิวต์ที่กำหนดเอง 0 ของผลิตภัณฑ์

productCustomAttribute1

string

แอตทริบิวต์ที่กำหนดเอง 1 ของผลิตภัณฑ์

productCustomAttribute2

string

แอตทริบิวต์ที่กำหนดเอง 2 ของผลิตภัณฑ์

productCustomAttribute3

string

แอตทริบิวต์ที่กำหนดเอง 3 ของผลิตภัณฑ์

productCustomAttribute4

string

แอตทริบิวต์ที่กำหนดเอง 4 ของผลิตภัณฑ์

productItemId

string

รหัสสินค้าของผลิตภัณฑ์

productLanguage

string

ชื่อทรัพยากรของค่าคงที่ภาษาสำหรับภาษาของผลิตภัณฑ์

productSoldBiddingCategoryLevel1

string

หมวดหมู่การเสนอราคา (ระดับ 1) ของผลิตภัณฑ์ที่ขาย

productSoldBiddingCategoryLevel2

string

หมวดหมู่การเสนอราคา (ระดับ 2) ของผลิตภัณฑ์ที่ขาย

productSoldBiddingCategoryLevel3

string

หมวดหมู่การเสนอราคา (ระดับ 3) ของผลิตภัณฑ์ที่ขาย

productSoldBiddingCategoryLevel4

string

หมวดหมู่การเสนอราคา (ระดับ 4) ของผลิตภัณฑ์ที่ขาย

productSoldBiddingCategoryLevel5

string

หมวดหมู่การเสนอราคา (ระดับ 5) ของผลิตภัณฑ์ที่ขาย

productSoldBrand

string

แบรนด์ของผลิตภัณฑ์ที่ขาย

productSoldCustomAttribute0

string

แอตทริบิวต์ที่กำหนดเอง 0 ของผลิตภัณฑ์ที่ขาย

productSoldCustomAttribute1

string

แอตทริบิวต์ที่กำหนดเอง 1 ของผลิตภัณฑ์ที่ขาย

productSoldCustomAttribute2

string

แอตทริบิวต์ที่กำหนดเอง 2 ของผลิตภัณฑ์ที่ขาย

productSoldCustomAttribute3

string

แอตทริบิวต์ที่กำหนดเอง 3 ของผลิตภัณฑ์ที่ขาย

productSoldCustomAttribute4

string

แอตทริบิวต์ที่กำหนดเอง 4 ของผลิตภัณฑ์ที่ขาย

productSoldItemId

string

รหัสสินค้าของผลิตภัณฑ์ที่ขาย

productSoldTitle

string

ชื่อผลิตภัณฑ์ที่ขาย

productSoldTypeL1

string

ประเภท (ระดับ 1) ของผลิตภัณฑ์ที่ขาย

productSoldTypeL2

string

ประเภท (ระดับ 2) ของผลิตภัณฑ์ที่ขาย

productSoldTypeL3

string

ประเภท (ระดับ 3) ของผลิตภัณฑ์ที่ขาย

productSoldTypeL4

string

ประเภท (ระดับ 4) ของผลิตภัณฑ์ที่ขาย

productSoldTypeL5

string

ประเภท (ระดับ 5) ของผลิตภัณฑ์ที่ขาย

productStoreId

string

รหัสร้านค้าของผลิตภัณฑ์

productTitle

string

ชื่อผลิตภัณฑ์

productTypeL1

string

ประเภท (ระดับ 1) ของผลิตภัณฑ์

productTypeL2

string

ประเภท (ระดับ 2) ของผลิตภัณฑ์

productTypeL3

string

ประเภท (ระดับ 3) ของผลิตภัณฑ์

productTypeL4

string

ประเภท (ระดับ 4) ของผลิตภัณฑ์

productTypeL5

string

ประเภท (ระดับ 5) ของผลิตภัณฑ์

quarter

string

ไตรมาสที่แสดงโดยวันที่แรกของไตรมาส ใช้ปีปฏิทินสำหรับไตรมาส เช่น ไตรมาสที่ 2 ของปี 2018 จะเริ่มในวันที่ 01-04-2018 โดยจัดรูปแบบเป็น yyyy-MM-dd

week

string

สัปดาห์ที่หมายถึงวันจันทร์ถึงวันอาทิตย์ และแสดงด้วยวันที่ของวันจันทร์ มีรูปแบบเป็น yyyy-MM-dd

year

integer

ปีในรูปแบบ yyyy

assetInteractionTarget

object (AssetInteractionTarget)

ใช้กับเมตริก CustomerAsset, CampaignAsset และ AdGroupAsset เท่านั้น ระบุว่าเมตริกการโต้ตอบเกิดขึ้นในชิ้นงานเอง หรือในชิ้นงานหรือหน่วยโฆษณาอื่น ระบบจะนับการโต้ตอบ (เช่น การคลิก) ในส่วนต่างๆ ของโฆษณาที่แสดง (เช่น โฆษณาเองและคอมโพเนนต์อื่นๆ เช่น ไซต์ลิงก์) เมื่อโฆษณาแสดงร่วมกัน เมื่อ interactionOnThisAsset เป็นจริง หมายความว่าการโต้ตอบเกิดขึ้นในชิ้นงานนี้ และเมื่อ interactionOnThisAsset เป็นเท็จ หมายความว่าการโต้ตอบไม่ได้เกิดขึ้นในชิ้นงานนี้ แต่เกิดขึ้นในส่วนอื่นๆ ของโฆษณาที่แสดงพร้อมกับชิ้นงานนี้

AdNetworkType

แสดงรายการประเภทเครือข่าย Google Ads

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
SEARCH การค้นหาใน Google
SEARCH_PARTNERS พาร์ทเนอร์ Search
CONTENT เครือข่ายดิสเพลย์
YOUTUBE_WATCH วิดีโอ YouTube
MIXED ข้ามเครือข่าย

คีย์เวิร์ด

กลุ่มเกณฑ์คีย์เวิร์ด

การแสดง JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
ช่อง
info

object (KeywordInfo)

ข้อมูลคีย์เวิร์ด

adGroupCriterion

string

ชื่อทรัพยากร AdGroupCriterion

ProductChannelExclusivity

Enum ที่อธิบายความพร้อมจำหน่ายของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SINGLE_CHANNEL สินค้าจำหน่ายผ่านช่องทางเดียวเท่านั้น ไม่ว่าจะเป็นร้านค้าในพื้นที่หรือทางออนไลน์ตามที่ระบุไว้ในช่องทางผลิตภัณฑ์
MULTI_CHANNEL สินค้าตรงกับคู่ของร้านค้าออนไลน์หรือร้านค้าในพื้นที่ เพื่อระบุว่าสินค้าพร้อมจำหน่ายใน ShoppingProductChannels ทั้ง 2 ช่องทาง

ProductCondition

Enum ที่อธิบายเงื่อนไขของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
OLD สภาพผลิตภัณฑ์เก่า
NEW สภาพผลิตภัณฑ์คือใหม่
REFURBISHED สภาพผลิตภัณฑ์ได้รับการซ่อมแซมใหม่
USED สภาพผลิตภัณฑ์มีการใช้งาน

AssetInteractionTarget

กลุ่มเป้าหมายการโต้ตอบกับชิ้นงาน

การแสดง JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
ช่อง
asset

string

ชื่อทรัพยากรชิ้นงาน

interactionOnThisAsset

boolean

ใช้กับเมตริก CustomerAsset, CampaignAsset และชิ้นงานโฆษณาเท่านั้น ระบุว่าเมตริกการโต้ตอบเกิดขึ้นในเนื้อหา หรือเนื้อหาหรือหน่วยโฆษณาอื่น