SearchAds360Row

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

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

object (AdGroup)

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

object (AdGroupAd)

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

object (AdGroupAdEffectiveLabel)

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

object (AdGroupAdLabel)

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

object (AdGroupAsset)

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

object (AdGroupAssetSet)

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

object (AdGroupAudienceView)

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

object (AdGroupBidModifier)

ตัวแก้ไขราคาเสนอที่อ้างอิงในคําค้นหา
adGroupCriterion

object (AdGroupCriterion)

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

object (AdGroupCriterionEffectiveLabel)

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

object (AdGroupCriterionLabel)

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

object (AdGroupEffectiveLabel)

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

object (AdGroupLabel)

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

object (AgeRangeView)

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

object (Asset)

เนื้อหาที่อ้างอิงในคำค้นหา
assetGroupAsset

object (AssetGroupAsset)

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

object (AssetGroupSignal)

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

object (AssetGroupListingGroupFilter)

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

object (AssetGroupTopCombinationView)

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

object (AssetGroup)

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

object (AssetSetAsset)

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

object (AssetSet)

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

object (BiddingStrategy)

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

object (CampaignBudget)

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

object (Campaign)

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

object (CampaignAsset)

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

object (CampaignAssetSet)

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

object (CampaignAudienceView)

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

object (CampaignCriterion)

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

object (CampaignEffectiveLabel)

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

object (CampaignLabel)

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

object (CartDataSalesView)

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

object (Audience)

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

object (ConversionAction)

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

object (ConversionCustomVariable)

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

object (Customer)

ลูกค้าที่อ้างอิงในคำค้นหา
customerAsset

object (CustomerAsset)

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

object (CustomerAssetSet)

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

object (AccessibleBiddingStrategy)

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

object (CustomerClient)

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

object (DynamicSearchAdsSearchTermView)

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

object (GenderView)

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

object (GeoTargetConstant)

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

object (KeywordView)

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

object (Label)

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

object (LanguageConstant)

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

object (LocationView)

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

object (ProductBiddingCategoryConstant)

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

object (ProductGroupView)

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

object (ShoppingPerformanceView)

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

object (UserList)

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

object (UserLocationView)

มุมมองตำแหน่งของผู้ใช้ที่อ้างอิงในคำค้นหา
webpageView

object (WebpageView)

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

object (Visit)

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

object (Conversion)

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

object (Metrics)

เมตริก
segments

object (Segments)

กลุ่ม
customColumns[]

object (Value)

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

กลุ่มโฆษณา :

กลุ่มโฆษณา

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

string

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

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

string

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

string (int64 format)

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

enum (AdGroupEngineStatus)

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

string

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

AdGroupStatus

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

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

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

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

AdGroupType

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

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

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

ค่านี้ใช้สำหรับการตอบกลับเท่านั้น
SEARCH_STANDARD ประเภทกลุ่มโฆษณาเริ่มต้นสําหรับแคมเปญ Search
DISPLAY_STANDARD ประเภทกลุ่มโฆษณาเริ่มต้นสำหรับแคมเปญ Display
SHOPPING_PRODUCT_ADS ประเภทกลุ่มโฆษณาสำหรับแคมเปญ Shopping ที่แสดงโฆษณาผลิตภัณฑ์มาตรฐาน
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 In-Display
VIDEO_NON_SKIPPABLE_IN_STREAM โฆษณาวิดีโอในสตรีมแบบข้ามไม่ได้
VIDEO_OUTSTREAM โฆษณาวิดีโอนอกสตรีม
SEARCH_DYNAMIC_ADS ประเภทกลุ่มโฆษณาสำหรับกลุ่มโฆษณาโฆษณา Search แบบไดนามิก
SHOPPING_COMPARISON_LISTING_ADS ประเภทสำหรับกลุ่มโฆษณาในแคมเปญโฆษณาเปรียบเทียบ Shopping
PROMOTED_HOTEL_ADS ประเภทกลุ่มโฆษณาสำหรับกลุ่มโฆษณาโรงแรมที่โปรโมต
VIDEO_RESPONSIVE กลุ่มโฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณา
VIDEO_EFFICIENT_REACH กลุ่มโฆษณาการเข้าถึงที่มีประสิทธิภาพแบบวิดีโอ
SMART_CAMPAIGN_ADS ประเภทกลุ่มโฆษณาสำหรับ Smart Campaign
TRAVEL_ADS ประเภทกลุ่มโฆษณาสำหรับแคมเปญการเดินทาง

AdGroupAdRotationMode

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

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

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

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

AdGroupEngineStatus

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

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

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

TargetingSetting

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

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

object (TargetRestriction)

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

TargetRestriction

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

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

enum (TargetingDimension)

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

boolean

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

TargetingDimension

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

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

AdGroupAd

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

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

string

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

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

enum (AdGroupAdStatus)

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

object (Ad)

โฆษณา
creationTime

string

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

string

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

string

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

string

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

enum (AdGroupAdEngineStatus)

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

string

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

AdGroupAdStatus

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

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

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

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

FinalAppUrl

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

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

enum (AppUrlOperatingSystemType)

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

string

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

AppUrlOperatingSystemType

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

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

AdType

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

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

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

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

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

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

string

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

string

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

string (int64 format)

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

SearchAds360ResponsiveSearchAdInfo

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

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

object (AdTextAsset)

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

object (AdTextAsset)

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

string

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

string

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

string (int64 format)

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

AdTextAsset

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

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

string

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

SearchAds360ProductAdInfo

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

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

SearchAds360ExpandedDynamicSearchAdInfo

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

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

string

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

string

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

string (int64 format)

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

AdGroupAdEngineStatus

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

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

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

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

AdGroupAdEffectiveLabel

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

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

string

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

string

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

string

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

string (int64 format)

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

AdGroupAdLabel

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

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

string

ชื่อทรัพยากรของป้ายกำกับโฆษณาของกลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับโฆษณากลุ่มโฆษณามีรูปแบบ customers/{ownerCustomerId}/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
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED เปิดใช้ลิงก์ชิ้นงานแล้ว
REMOVED นำลิงก์ชิ้นงานออกแล้ว
PAUSED หยุดลิงก์ชิ้นงานชั่วคราว

AdGroupAssetSet

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

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

string

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

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

string

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

string

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

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

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

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

AdGroupAudienceView

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

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

string

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

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

AdGroupBidModifier

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

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

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

string

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

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

number

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

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

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

object (DeviceInfo)

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

DeviceInfo

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

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

enum (Device)

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

อุปกรณ์

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

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

AdGroupCriterion

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

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

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

string

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

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

string

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

enum (AdGroupCriterionStatus)

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

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

object (QualityInfo)

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

enum (CriterionType)

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

string

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

string

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

object (PositionEstimates)

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

string

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

string

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

object (CustomParameter)

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

string

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

string

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

string (int64 format)

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

string

กลุ่มโฆษณาที่เกณฑ์เป็นของ
negative

boolean

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

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

number

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

string (int64 format)

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

string (int64 format)

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

enum (AdGroupCriterionEngineStatus)

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

string

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

string

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

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

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

object (KeywordInfo)

คีย์เวิร์ด
listingGroup

object (ListingGroupInfo)

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

object (AgeRangeInfo)

ช่วงอายุ
gender

object (GenderInfo)

เพศ
userList

object (UserListInfo)

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

object (WebpageInfo)

หน้าเว็บ
location

object (LocationInfo)

ตำแหน่ง

AdGroupCriterionStatus

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

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

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

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

QualityInfo

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

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

integer

คะแนนคุณภาพ

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

CriterionType

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

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

PositionEstimates

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

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

string (int64 format)

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

AdGroupCriterionEngineStatus

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

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

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

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

CustomParameter

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

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

string

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

string

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

KeywordInfo

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

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

enum (KeywordMatchType)

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

string

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

KeywordMatchType

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

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

ListingGroupInfo

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

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

enum (ListingGroupType)

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

ListingGroupType

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

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

AgeRangeInfo

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

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

enum (AgeRangeType)

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

AgeRangeType

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

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

GenderInfo

เกณฑ์เพศ

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

enum (GenderType)

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

GenderType

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

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

UserListInfo

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

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

string

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

WebpageInfo

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

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

object (WebpageConditionInfo)

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

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

number

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

string

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

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

WebpageConditionInfo

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

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

enum (WebpageConditionOperand)

ตัวถูกดำเนินการของเงื่อนไขการกำหนดเป้าหมายหน้าเว็บ
operator

enum (WebpageConditionOperator)

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

string

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

WebpageConditionOperand

ตัวถูกดำเนินการของเงื่อนไขหน้าเว็บในเกณฑ์หน้าเว็บ

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

WebpageConditionOperator

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

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

LocationInfo

เกณฑ์ตำแหน่ง

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

string

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

AdGroupCriterionEffectiveLabel

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

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

string

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

string

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

string

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

string (int64 format)

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

AdGroupCriterionLabel

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

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

string

ชื่อทรัพยากรของป้ายกำกับเกณฑ์ของกลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับเกณฑ์ของกลุ่มโฆษณามีรูปแบบดังนี้ customers/{ownerCustomerId}/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/{ownerCustomerId}/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/{ownerCustomerId}/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
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "engineStatus": enum (AssetEngineStatus),

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

string

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

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

enum (AssetType)

ประเภทของเนื้อหา
finalUrls[]

string

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

string

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

object (CustomParameter)

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

enum (AssetStatus)

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

string

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

string

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

string (int64 format)

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

string

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

string

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

string

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

enum (AssetEngineStatus)

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

object (YoutubeVideoAsset)

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

object (ImageAsset)

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

object (TextAsset)

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

object (UnifiedCalloutAsset)

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

object (UnifiedPageFeedAsset)

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

object (MobileAppAsset)

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

object (UnifiedCallAsset)

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

object (CallToActionAsset)

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

object (UnifiedLocationAsset)

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

AssetType

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

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

AssetStatus

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

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

AssetEngineStatus

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

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

YoutubeVideoAsset

เนื้อหา YouTube

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

string

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

string

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

ImageAsset

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

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

enum (MimeType)

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

object (ImageDimension)

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

string (int64 format)

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

MimeType

ประเภท MIME

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

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

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

ImageDimension

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

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

string (int64 format)

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

string (int64 format)

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

string

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

TextAsset

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

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

string

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

UnifiedCalloutAsset

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

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

string

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

string

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

string

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

object (AdScheduleInfo)

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

boolean

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

AdScheduleInfo

แสดงเกณฑ์ AdSchedule

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

เพิ่มตารางเวลาโฆษณาได้ไม่เกิน 6 รายการในวันเดียวกัน

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

enum (MinuteOfHour)

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

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

enum (MinuteOfHour)

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

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

enum (DayOfWeek)

วันในสัปดาห์ที่ใช้กำหนดเวลา

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

integer

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

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

integer

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

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

MinuteOfHour

แสดงรายการของชั่วโมงละ 4 ครั้ง เช่น "FIFTEEN"

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

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

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

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

UnifiedSitelinkAsset

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

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

string

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

string

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

string

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

string

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

string

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

object (AdScheduleInfo)

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

string (int64 format)

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

boolean

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

boolean

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

UnifiedPageFeedAsset

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

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

string

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

string

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

MobileAppAsset

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

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

string

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

enum (MobileAppVendor)

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

MobileAppVendor

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

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

UnifiedCallAsset

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

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

string

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

boolean

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

boolean

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

string

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

string

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

CallConversionReportingState

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

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

CallToActionAsset

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

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

enum (CallToActionType)

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

CallToActionType

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

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

UnifiedLocationAsset

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

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

string

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

object (BusinessProfileLocation)

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

enum (LocationOwnershipType)

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

BusinessProfileLocation

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

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

string

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

string

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

string (int64 format)

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

LocationOwnershipType

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

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

AssetGroupAsset

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

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

string

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

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

string

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

string

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

enum (AssetFieldType)

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

enum (AssetLinkStatus)

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

AssetFieldType

การแจงนับที่อธิบายตำแหน่งที่เป็นไปได้ของชิ้นงาน

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

AssetGroupSignal

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

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

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

string

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

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

string

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

object (AudienceInfo)

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

AudienceInfo

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

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

string

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

AssetGroupListingGroupFilter

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

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

string

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

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

string

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

string (int64 format)

รหัสของ ListingGroupFilter
type

enum (ListingGroupFilterType)

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

enum (ListingGroupFilterVertical)

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

object (ListingGroupFilterDimension)

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

string

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

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

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

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

ListingGroupFilterVertical

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

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

ListingGroupFilterDimension

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

การแสดง JSON 
{

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

object (ProductBiddingCategory)

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

object (ProductBrand)

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

object (ProductChannel)

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

object (ProductCondition)

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

object (ProductCustomAttribute)

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

object (ProductItemId)

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

object (ProductType)

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

ProductBiddingCategory

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

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

enum (ListingGroupFilterBiddingCategoryLevel)

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

string (int64 format)

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

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

ListingGroupFilterBiddingCategoryLevel

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

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

ProductBrand

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

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

string

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

ProductChannel

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

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

enum (ListingGroupFilterProductChannel)

ค่าของสถานที่

ListingGroupFilterProductChannel

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

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

ProductCondition

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

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

enum (ListingGroupFilterProductCondition)

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

ListingGroupFilterProductCondition

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

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

ProductCustomAttribute

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

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

enum (ListingGroupFilterCustomAttributeIndex)

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

string

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

ListingGroupFilterCustomAttributeIndex

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

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

ProductItemId

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

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

string

ค่าของรหัส

ProductType

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

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

enum (ListingGroupFilterProductTypeLevel)

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

string

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

ListingGroupFilterProductTypeLevel

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

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

ListingGroupFilterDimensionPath

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

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

object (ListingGroupFilterDimension)

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

AssetGroupTopCombinationView

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

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

string

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

object (AssetGroupAssetCombinationData)

ชุดค่าผสมของชิ้นงานที่ทำงานร่วมกันได้ดีที่สุด

AssetGroupAssetCombinationData

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

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

object (AssetUsage)

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

AssetUsage

มีข้อมูลการใช้งานของชิ้นงาน

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

string

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

enum (ServedAssetFieldType)

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

ServedAssetFieldType

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

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

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

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

AssetGroup

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

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

string

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

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

string (int64 format)

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

string

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

string

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

string

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

string

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

enum (AssetGroupStatus)

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

string

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

string

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

enum (AdStrength)

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

AssetGroupStatus

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

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

AdStrength

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

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

AssetSetAsset

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

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

string

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

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

string

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

string

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

enum (AssetSetAssetStatus)

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

AssetSetAssetStatus

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

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

AssetSet

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

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

string (int64 format)

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

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

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

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

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

string

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

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

enum (BiddingStrategyStatus)

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

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

enum (BiddingStrategyType)

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

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

string

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

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

string (int64 format)

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

string

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

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

string

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

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

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

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

string (int64 format)

จำนวนแคมเปญที่เชื่อมโยงกับกลยุทธ์การเสนอราคานี้

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

string (int64 format)

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

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

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

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

object (EnhancedCpc)

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

object (MaximizeConversionValue)

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

object (MaximizeConversions)

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

object (TargetCpa)

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

object (TargetImpressionShare)

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

object (TargetOutrankShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

BiddingStrategyStatus

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

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

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

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

BiddingStrategyType

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

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

EnhancedCpc

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

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

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

MaximizeConversionValue

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

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

string (int64 format)

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

string (int64 format)

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

string (int64 format)

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

string (int64 format)

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

TargetImpressionShareLocation

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

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

TargetOutrankShare

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

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

string (Int64Value format)

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

TargetRoas

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

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

number

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

string (int64 format)

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

string (int64 format)

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

TargetSpend

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

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

string (int64 format)

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

string (int64 format)

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

CampaignBudget

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

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

string

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

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

enum (BudgetDeliveryMethod)

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

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

enum (BudgetPeriod)

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

string (int64 format)

จำนวนงบประมาณในสกุลเงินท้องถิ่นของบัญชี ระบุจํานวนเงินเป็นหน่วยไมโคร โดย 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,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

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

string

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

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

object (FrequencyCapEntry)

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

object (SelectiveOptimization)

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

object (OptimizationGoalSetting)

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

object (TrackingSetting)

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

string

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

enum (AssetFieldType)

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

string

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

string

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

string

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

enum (AssetSetType)

ประเภทฟีดที่แนบมากับแคมเปญนี้โดยตรง
id

string (int64 format)

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

string

ชื่อแคมเปญ

ฟิลด์นี้จำเป็นและไม่ควรว่างเปล่าเมื่อสร้างแคมเปญใหม่

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

string

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

string

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

string

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

string

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

string

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

boolean

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

ฟิลด์ Union campaign_bidding_strategy กลยุทธ์การเสนอราคาสำหรับแคมเปญ

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

string

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

object (ManualCpa)

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

object (ManualCpc)

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

object (ManualCpm)

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

object (MaximizeConversions)

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

object (MaximizeConversionValue)

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

object (TargetCpa)

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

object (TargetImpressionShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

object (PercentCpc)

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

object (TargetCpm)

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

CampaignStatus

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

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

CampaignServingStatus

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

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

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

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

BiddingStrategySystemStatus

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

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

AdServingOptimizationStatus

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

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

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

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

AdvertisingChannelType

การแจงนับที่อธิบายประเภทช่องทางโฆษณาต่างๆ

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

AdvertisingChannelSubType

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

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

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 ที่ใช้สำหรับการติดตามแบบไดนามิก

AssetSetType

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

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

ManualCpa

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

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

ManualCpc

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

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

boolean

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

ManualCpm

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

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

PercentCpc

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

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

string (int64 format)

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

boolean

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

TargetCpm

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

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

CampaignAsset

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

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

string

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

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

ฟิลด์ Union criterion เกณฑ์แคมเปญ

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

object (KeywordInfo)

คีย์เวิร์ด
location

object (LocationInfo)

ตำแหน่ง
device

object (DeviceInfo)

อุปกรณ์
ageRange

object (AgeRangeInfo)

ช่วงอายุ
gender

object (GenderInfo)

เพศ
userList

object (UserListInfo)

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

object (LanguageInfo)

ภาษา
webpage

object (WebpageInfo)

หน้าเว็บ
locationGroup

object (LocationGroupInfo)

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

CampaignCriterionStatus

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

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

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

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

LanguageInfo

เกณฑ์ภาษา

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

string

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

LocationGroupInfo

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

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

string

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

enum (LocationGroupRadiusUnits)

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

string

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

string (int64 format)

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

LocationGroupRadiusUnits

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

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

CampaignEffectiveLabel

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

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

string

ชื่อของทรัพยากร ชื่อทรัพยากร CampaignEffectivelabel มีรูปแบบดังนี้ customers/{ownerCustomerId}/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/{ownerCustomerId}/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 เป็น false ได้หลังจากสร้างผ่านการดำเนินการ "อัปเดต" เท่านั้น เนื่องจากไม่ได้ประกาศเป็นตัวเลือก
ownerCustomer

string

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

boolean

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

boolean

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

string (int64 format)

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

string

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

ConversionActionStatus

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

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

ConversionActionType

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AD_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้คลิกชิ้นงานโทรของโฆษณา
CLICK_TO_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้ในอุปกรณ์เคลื่อนที่คลิกหมายเลขโทรศัพท์
GOOGLE_PLAY_DOWNLOAD Conversion ที่เกิดขึ้นเมื่อผู้ใช้ดาวน์โหลดแอปบนอุปกรณ์เคลื่อนที่จาก Google Play Store
GOOGLE_PLAY_IN_APP_PURCHASE Conversion ที่เกิดขึ้นเมื่อผู้ใช้ทำการซื้อในแอปผ่านการเรียกเก็บเงินของ Android
UPLOAD_CALLS Conversion จากการโทรที่ผู้ลงโฆษณาวัดผลและอัปโหลด
UPLOAD_CLICKS Conversion ที่ผู้ลงโฆษณาทําการติดตามและอัปโหลดพร้อมกับการคลิกที่มีการระบุแหล่งที่มา
WEBPAGE Conversion ที่เกิดขึ้นในหน้าเว็บ
WEBSITE_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้โทรหาหมายเลขโทรศัพท์ที่สร้างขึ้นแบบไดนามิกจากเว็บไซต์ของผู้ลงโฆษณา
STORE_SALES_DIRECT_UPLOAD Conversion ยอดขายในร้านตามการอัปโหลดข้อมูลผู้ขายจากบุคคลที่หนึ่งหรือบุคคลที่สาม เฉพาะลูกค้าในรายการที่อนุญาตเท่านั้นที่ใช้ประเภทการอัปโหลดโดยตรงของยอดขายในร้านได้
STORE_SALES Conversion ยอดขายในร้านค้าที่อิงตามการอัปโหลดข้อมูลผู้ขายจากบุคคลที่หนึ่งหรือบุคคลที่สาม และ/หรือจากการซื้อในร้านค้าโดยใช้บัตรจากเครือข่ายการชำระเงิน เฉพาะลูกค้าในรายการที่อนุญาตเท่านั้นที่ใช้ประเภทการขายในร้านค้าได้ อ่านอย่างเดียว
FIREBASE_ANDROID_FIRST_OPEN Conversion การเปิดแอป Android เป็นครั้งแรกที่ติดตามผ่าน Firebase
FIREBASE_ANDROID_IN_APP_PURCHASE Conversion ของการซื้อในแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_ANDROID_CUSTOM Conversion ที่กําหนดเองของแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_IOS_FIRST_OPEN Conversion การเปิดแอป iOS ครั้งแรกที่ติดตามผ่าน Firebase
FIREBASE_IOS_IN_APP_PURCHASE Conversion ของการซื้อในแอป iOS ที่ติดตามผ่าน Firebase
FIREBASE_IOS_CUSTOM Conversion ที่กําหนดเองของแอป iOS ที่ติดตามผ่าน Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversion การเปิดแอป Android เป็นครั้งแรกที่ติดตามผ่านการวิเคราะห์แอปจากบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversion ของการซื้อในแอป Android ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversion ที่กําหนดเองของแอป Android ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversion การเปิดแอป iOS ครั้งแรกที่ติดตามผ่านการวิเคราะห์แอปจากบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversion ของการซื้อในแอป iOS ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversion ที่กําหนดเองของแอป iOS ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
ANDROID_APP_PRE_REGISTRATION Conversion ที่เกิดขึ้นเมื่อผู้ใช้ลงทะเบียนแอปบนอุปกรณ์เคลื่อนที่ล่วงหน้าจาก Google Play Store อ่านอย่างเดียว
ANDROID_INSTALLS_ALL_OTHER_APPS Conversion ที่ติดตามการดาวน์โหลดทั้งหมดจาก Google Play ซึ่งไม่ได้ติดตามโดยประเภทที่เฉพาะเจาะจงของแอป อ่านอย่างเดียว
FLOODLIGHT_ACTION กิจกรรม Floodlight ที่นับจำนวนครั้งที่ผู้ใช้เข้าชมหน้าเว็บใดหน้าหนึ่งหลังจากดูหรือคลิกโฆษณาของผู้ลงโฆษณารายใดรายหนึ่ง อ่านอย่างเดียว
FLOODLIGHT_TRANSACTION กิจกรรม Floodlight ที่ติดตามยอดขายที่เกิดขึ้นหรือจำนวนสินค้าที่ขายไป รวมถึงตรวจสอบมูลค่ารวมของการขายแต่ละครั้งก็ได้ อ่านอย่างเดียว
GOOGLE_HOSTED Conversion ที่ติดตามการกระทำเกี่ยวกับสถานที่จากผลิตภัณฑ์และบริการของ Google หลังจากโต้ตอบกับโฆษณา อ่านอย่างเดียว
LEAD_FORM_SUBMIT Conversion ที่รายงานเมื่อผู้ใช้ส่งฟอร์มโอกาสในการขาย อ่านอย่างเดียว
SALESFORCE

เลิกใช้งานแล้ว: การผสานรวม Salesforce จะเริ่มหยุดให้บริการ และแทนที่ด้วยวิธีนำเข้า Conversion จาก Salesforce ที่ได้รับการปรับปรุงแล้ว - ดู https://support.google.com/google-ads/answer/14728349
SEARCH_ADS_360 Conversion ที่นําเข้าจากข้อมูล Floodlight ของ Search Ads 360 อ่านอย่างเดียว
SMART_CAMPAIGN_AD_CLICKS_TO_CALL วัด Conversion จากการโทรที่เกิดขึ้นในโฆษณาของ Smart Campaign โดยไม่ต้องตั้งค่าการติดตามการโทร โดยใช้เกณฑ์ที่กําหนดเองของ Smart Campaign อ่านอย่างเดียว
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ผู้ใช้คลิกองค์ประกอบการโทรภายใน Google Maps Smart Campaign เท่านั้น อ่านอย่างเดียว
SMART_CAMPAIGN_MAP_DIRECTIONS ผู้ใช้ขอเส้นทางไปยังสถานที่ตั้งของธุรกิจภายใน Google Maps Smart Campaign เท่านั้น อ่านอย่างเดียว
SMART_CAMPAIGN_TRACKED_CALLS โทร Conversion ที่เกิดขึ้นในโฆษณา Smart Campaign ที่มีการตั้งค่าการติดตามการโทร โดยใช้เกณฑ์ที่กำหนดเองของ Smart Campaign อ่านอย่างเดียว
STORE_VISITS Conversion ที่เกิดขึ้นเมื่อผู้ใช้เข้าชมร้านค้าปลีกของผู้ลงโฆษณา อ่านอย่างเดียว
WEBPAGE_CODELESS Conversion ที่สร้างจากเหตุการณ์ในเว็บไซต์ (เช่น การส่งแบบฟอร์มหรือการโหลดหน้าเว็บ) ซึ่งไม่ได้ใช้ข้อมูลโค้ดเหตุการณ์ที่เขียนโค้ดแยกกัน อ่านอย่างเดียว
UNIVERSAL_ANALYTICS_GOAL Conversion ที่มาจากเป้าหมาย Universal Analytics ที่ลิงก์
UNIVERSAL_ANALYTICS_TRANSACTION Conversion ที่มาจากธุรกรรม Universal Analytics ที่ลิงก์ไว้
GOOGLE_ANALYTICS_4_CUSTOM Conversion ที่มาจาก Conversion เหตุการณ์ที่กําหนดเองของ Google Analytics 4 ที่ลิงก์
GOOGLE_ANALYTICS_4_PURCHASE Conversion ที่มาจาก Conversion การซื้อของ Google Analytics 4 ที่ลิงก์

ConversionActionCategory

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

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

ValueSettings

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

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

number

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

string

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

boolean

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

AttributionModelSettings

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

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

enum (AttributionModel)

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

enum (DataDrivenModelStatus)

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

AttributionModel

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

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

DataDrivenModelStatus

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

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

FloodlightSettings

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

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

string

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

string

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

string (int64 format)

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

ConversionCustomVariable

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

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

string

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

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

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

string

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

string

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

enum (ConversionCustomVariableStatus)

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

string

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

enum (ConversionCustomVariableFamily)

กลุ่มตัวแปรที่กำหนดเองของ Conversion
cardinality

enum (ConversionCustomVariableCardinality)

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

object (FloodlightConversionCustomVariableInfo)

ฟิลด์สําหรับตัวแปรที่กําหนดเองของ Conversion ของ Floodlight ใน Search Ads 360
customColumnIds[]

string (int64 format)

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

ConversionCustomVariableStatus

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

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

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

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

ConversionCustomVariableFamily

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
STANDARD ตัวแปรที่กำหนดเองสำหรับ Conversion มาตรฐาน ลูกค้าต้องเปิดใช้งานก่อนใช้งาน
FLOODLIGHT ตัวแปรที่กําหนดเองของ Conversion ที่นําเข้าจากตัวแปร Floodlight ที่กําหนดเอง

ConversionCustomVariableCardinality

Cardinality ของตัวแปรที่กำหนดเองสำหรับ Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BELOW_ALL_LIMITS ตัวแปรที่กำหนดเองของ Conversion มีจำนวนสมาชิกในเซ็ตต่ำกว่าขีดจำกัดทั้งหมด คุณสามารถใช้ตัวแปรสำหรับการแบ่งกลุ่ม และสถิติจะสะสมสำหรับค่าใหม่หากเปิดใช้ตัวแปร
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT ตัวแปรที่กำหนดเองสำหรับ Conversion มีจำนวนสมาชิกในเซ็ตเกินขีดจำกัดการแบ่งกลุ่ม แต่ไม่เกินขีดจำกัดสถิติ ระบบจะปิดใช้การแบ่งกลุ่ม แต่สถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
APPROACHES_STATS_LIMIT ตัวแปรที่กำหนดเองของ Conversion เกินขีดจํากัดการแบ่งกลุ่ม และใกล้ถึงขีดจํากัดสถิติ (> 90%) ระบบจะปิดใช้การแบ่งกลุ่ม แต่สถิติจะสะสมสำหรับค่าใหม่ได้หากเปิดใช้ตัวแปร
EXCEEDS_STATS_LIMIT ตัวแปรที่กำหนดเองของ Conversion เกินทั้งขีดจํากัดการแบ่งกลุ่มและขีดจํากัดสถิติ ระบบจะปิดใช้การแบ่งกลุ่ม และสถิติของตัวแปรที่เปิดใช้จะเพิ่มขึ้นได้ก็ต่อเมื่อค่าที่มีอยู่ไม่เพิ่มจำนวนค่าที่ไม่ซ้ำกันของตัวแปรอีกต่อไป

FloodlightConversionCustomVariableInfo

ข้อมูลสำหรับตัวแปรที่กำหนดเองของ Conversion ของ Floodlight ใน Search Ads 360

การแสดง JSON 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
ช่อง
floodlightVariableType

enum (FloodlightVariableType)

ประเภทตัวแปร Floodlight ที่กำหนดไว้ใน Search Ads 360
floodlightVariableDataType

enum (FloodlightVariableDataType)

ประเภทข้อมูลตัวแปร Floodlight ที่กำหนดไว้ใน Search Ads 360

FloodlightVariableType

ประเภทของตัวแปร Floodlight ตามที่กำหนดไว้ใน Search Ads 360 ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/searchads/answer/4397154?hl=en

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DIMENSION ประเภทตัวแปร Floodlight ของมิติข้อมูล
METRIC ประเภทตัวแปร Floodlight ของเมตริก
UNSET ไม่ได้ตั้งค่าประเภทตัวแปร Floodlight

FloodlightVariableDataType

ประเภทข้อมูลของตัวแปร Floodlight ตามที่กำหนดไว้ใน Search Ads 360 ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/searchads/answer/4397154?hl=en

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
NUMBER แสดงตัวแปร Floodlight ประเภท "Number" ตัวแปรนี้อาจกำหนดให้กับตัวแปร Floodlight ประเภท DIMENSION หรือ METRIC
STRING แสดงตัวแปร Floodlight ประเภท "String" ตัวแปรนี้อาจกำหนดให้กับตัวแปร Floodlight ประเภท DIMENSION

ลูกค้า

ลูกค้า

การแสดง JSON 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
ช่อง
resourceName

string

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

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

การตั้งค่าเครื่องมือวัด Conversion สำหรับลูกค้า
accountType

enum (AccountType)

ประเภทบัญชีเครื่องมือค้นหา เช่น Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track เป็นต้น
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

การตั้งค่า DoubleClick Campaign Manager (DCM) สำหรับลูกค้าที่เป็นผู้จัดการ
accountStatus

enum (AccountStatus)

สถานะบัญชี เช่น เปิดใช้ หยุดชั่วคราว นำออก ฯลฯ
lastModifiedTime

string

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

string

รหัสของบัญชีในบัญชีเครื่องมือค้นหาภายนอก
status

enum (CustomerStatus)

สถานะของลูกค้า
creationTime

string

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

string (int64 format)

รหัสลูกค้าของผู้จัดการ ค่า 0 หมายความว่าลูกค้าไม่มีผู้จัดการ SA360
managerDescriptiveName

string

ชื่อที่สื่อความหมายของผู้จัดการ
subManagerId

string (int64 format)

รหัสลูกค้าของบัญชีดูแลจัดการย่อย ค่า 0 หมายความว่าลูกค้าไม่มีบัญชีดูแลจัดการ SA360 ย่อย
subManagerDescriptiveName

string

ชื่อที่สื่อความหมายของบัญชีดูแลจัดการย่อย
associateManagerId

string (int64 format)

รหัสลูกค้าของผู้จัดการที่เชื่อมโยง ค่า 0 หมายความว่าลูกค้าไม่มีบัญชีดูแลจัดการการเชื่อมโยง SA360
associateManagerDescriptiveName

string

ชื่อที่สื่อความหมายของผู้จัดการที่เชื่อมโยง
accountLevel

enum (AccountLevelType)

ระดับบัญชีของลูกค้า: บัญชีดูแลจัดการ บัญชีดูแลจัดการย่อย บัญชีดูแลจัดการสำหรับพาร์ทเนอร์แบรนด์ บัญชีบริการ
id

string (int64 format)

รหัสของลูกค้า
descriptiveName

string

ชื่อลูกค้าแบบอธิบายที่ไม่ซ้ำกัน (ไม่บังคับ)
currencyCode

string

สกุลเงินที่บัญชีใช้ ระบบรองรับชุดย่อยของรหัสสกุลเงินจากมาตรฐาน ISO 4217
timeZone

string

รหัสเขตเวลาท้องถิ่นของลูกค้า
trackingUrlTemplate

string

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

string

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

boolean

เปิดใช้การติดแท็กอัตโนมัติสําหรับลูกค้าหรือไม่
manager

boolean

ลูกค้าเป็นผู้จัดการหรือไม่

ConversionTrackingSetting

ชุดการตั้งค่าระดับลูกค้าที่เกี่ยวข้องกับการติดตาม Conversion ของ Search Ads 360

การแสดง JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
ช่อง
acceptedCustomerDataTerms

boolean

ลูกค้าได้ยอมรับข้อกำหนดสำหรับข้อมูลลูกค้าหรือไม่ หากใช้เครื่องมือวัด Conversion ข้ามบัญชี ค่านี้จะรับค่ามาจากบัญชีดูแลจัดการ ช่องนี้เป็นแบบอ่านอย่างเดียว ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/adspolicy/answer/7475709
conversionTrackingStatus

enum (ConversionTrackingStatus)

สถานะเครื่องมือวัด Conversion ซึ่งจะระบุว่าลูกค้าใช้เครื่องมือวัด Conversion หรือไม่ และใครเป็นเจ้าของเครื่องมือวัด Conversion ของลูกค้ารายนี้ หากลูกค้ารายนี้ใช้เครื่องมือวัด Conversion ข้ามบัญชี ค่าที่แสดงจะแตกต่างกันตาม login-customer-id ของคำขอ
enhancedConversionsForLeadsEnabled

boolean

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

string

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

string (int64 format)

รหัสเครื่องมือวัด Conversion ที่ใช้สําหรับบัญชีนี้ รหัสนี้ไม่ได้ระบุว่าลูกค้าใช้เครื่องมือวัด Conversion หรือไม่ (conversionTrackingStatus ระบุ) ช่องนี้เป็นแบบอ่านอย่างเดียว
googleAdsCrossAccountConversionTrackingId

string (int64 format)

รหัสเครื่องมือวัด Conversion ของบัญชีดูแลจัดการของลูกค้า ระบบจะตั้งค่านี้เมื่อลูกค้าเลือกใช้เครื่องมือวัด Conversion และจะลบล้าง conversionTrackingId จัดการฟิลด์นี้ได้ผ่าน UI ของ Google Ads เท่านั้น ช่องนี้เป็นแบบอ่านอย่างเดียว
crossAccountConversionTrackingId

string (int64 format)

รหัสเครื่องมือวัด Conversion ของบัญชีดูแลจัดการของลูกค้า ระบบจะตั้งค่านี้เมื่อลูกค้าเลือกใช้เครื่องมือวัด Conversion ข้ามบัญชี และจะลบล้าง conversionTrackingId

ConversionTrackingStatus

สถานะเครื่องมือวัด Conversion ของลูกค้า

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
NOT_CONVERSION_TRACKED ลูกค้าไม่ได้ใช้เครื่องมือวัด Conversion ใดๆ
CONVERSION_TRACKING_MANAGED_BY_SELF การกระทำที่ถือเป็น Conversion สร้างและจัดการโดยลูกค้ารายนี้
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER การกระทำที่ถือเป็น Conversion สร้างและจัดการโดยผู้จัดการที่ระบุใน login-customer-id ของคำขอ
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER การกระทำที่ถือเป็น Conversion สร้างและจัดการโดยผู้จัดการที่แตกต่างจากลูกค้าหรือผู้จัดการที่ระบุไว้ในlogin-customer-idของคำขอ

AccountType

ประเภทบัญชีเครื่องมือที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BAIDU บัญชี Baidu
ENGINE_TRACK บัญชีการติดตามเครื่องมือค้นหา
FACEBOOK บัญชี Facebook
FACEBOOK_GATEWAY บัญชี Facebook ที่จัดการผ่านเกตเวย์
GOOGLE_ADS บัญชี Google Ads
MICROSOFT บัญชี Microsoft Advertising
SEARCH_ADS_360 บัญชีดูแลจัดการ Search Ads 360
YAHOO_JAPAN บัญชี Yahoo Japan

DoubleClickCampaignManagerSetting

การตั้งค่า DoubleClick Campaign Manager (DCM) สำหรับลูกค้าที่เป็นผู้จัดการ

การแสดง JSON 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
ช่อง
advertiserId

string (int64 format)

รหัสผู้ลงโฆษณา Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้
networkId

string (int64 format)

รหัสเครือข่าย Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้
timeZone

string

เขตเวลาของเครือข่าย Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้ในรูปแบบฐานข้อมูลเขตเวลาของ IANA เช่น America/New_York

AccountStatus

สถานะที่เป็นไปได้ของบัญชี

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

CustomerStatus

สถานะที่เป็นไปได้ของลูกค้า

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED แสดงบัญชีที่ใช้งานอยู่ซึ่งแสดงโฆษณาได้
CANCELED ระบุบัญชีที่ถูกยกเลิกซึ่งแสดงโฆษณาไม่ได้ ผู้ใช้ที่ดูแลระบบสามารถเปิดใช้งานอีกครั้งได้
SUSPENDED ระบุบัญชีที่ถูกระงับซึ่งแสดงโฆษณาไม่ได้ เปิดใช้งานได้โดยการสนับสนุนของ Google เท่านั้น
CLOSED ระบุบัญชีที่ปิดแล้วซึ่งแสดงโฆษณาไม่ได้ บัญชีทดสอบจะมีสถานะเป็น "ปิด" ด้วย สถานะนี้มีผลถาวรและอาจเปิดอีกครั้งไม่ได้

AccountLevelType

Enum ที่อธิบายระดับบัญชีที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CLIENT_ACCOUNT_FACEBOOK บัญชีลูกค้า (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS บัญชีลูกค้า (Google Ads)
CLIENT_ACCOUNT_MICROSOFT บัญชีลูกค้า (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN บัญชีลูกค้า (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK บัญชีลูกค้า (การติดตามเครื่องมือค้นหา)
MANAGER บัญชีดูแลจัดการระดับบนสุด
SUB_MANAGER บัญชีดูแลจัดการย่อย
ASSOCIATE_MANAGER บัญชีดูแลจัดการสำหรับพาร์ทเนอร์แบรนด์

CustomerAsset

ลิงก์ระหว่างลูกค้ากับเนื้อหา

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

string

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

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

ต้องระบุ ชิ้นงานที่ลิงก์กับลูกค้า
status

enum (AssetLinkStatus)

สถานะของชิ้นงานของลูกค้า

CustomerAssetSet

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

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

string

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

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

ชุดชิ้นงานที่ลิงก์กับลูกค้า
customer

string

ลูกค้าที่เชื่อมโยงชุดชิ้นงานนี้
status

enum (AssetSetLinkStatus)

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

AccessibleBiddingStrategy

แสดงมุมมองของ BiddingStrategies ที่ลูกค้าเป็นเจ้าของและแชร์ด้วย

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

การแสดง JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

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

string

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

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

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

string

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

enum (BiddingStrategyType)

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

string (int64 format)

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

string

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

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

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

object (MaximizeConversionValue)

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

object (MaximizeConversions)

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

object (TargetCpa)

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

object (TargetImpressionShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

MaximizeConversionValue

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

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

number

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

MaximizeConversions

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

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

string (int64 format)

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

string (int64 format)

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

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

string (int64 format)

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

string (int64 format)

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

TargetRoas

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

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

number

รายได้ที่เลือก (อิงตามข้อมูล Conversion) ต่อหน่วยการใช้จ่าย

TargetSpend

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

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

string (int64 format)

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

string (int64 format)

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

ManagerLinkStatus

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ACTIVE ระบุความสัมพันธ์ที่มีผลบังคับใช้ในปัจจุบัน
INACTIVE ระบุความสัมพันธ์ที่สิ้นสุดแล้ว
PENDING ระบุว่าผู้จัดการได้ขอความสัมพันธ์แล้ว แต่ลูกค้ายังไม่ได้ยอมรับ
REFUSED บัญชีดูแลจัดการขอความสัมพันธ์ แต่ลูกค้าปฏิเสธ
CANCELED ระบุว่าบัญชีดูแลจัดการได้ขอความสัมพันธ์แล้ว แต่บัญชีดูแลจัดการยกเลิกความสัมพันธ์

CustomerClient

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

การแสดง JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
ช่อง
resourceName

string

ชื่อทรัพยากรของไคลเอ็นต์ลูกค้า ชื่อทรัพยากร CustomerClient มีรูปแบบดังนี้ customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

ชื่อทรัพยากรของป้ายกำกับที่เป็นของลูกค้าที่ขอซึ่งใช้กับลูกค้าของลูกค้า ชื่อทรัพยากรของป้ายกำกับจะมีรูปแบบดังนี้

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

สถานะของลูกค้าของลูกค้า อ่านอย่างเดียว
clientCustomer

string

ชื่อทรัพยากรของลูกค้าที่เป็นไคลเอ็นต์ซึ่งลิงก์กับลูกค้าที่ระบุ อ่านอย่างเดียว
hidden

boolean

ระบุว่าบัญชีนี้เป็นบัญชีที่ซ่อนอยู่หรือไม่

อ่านอย่างเดียว
level

string (int64 format)

ระยะทางระหว่างลูกค้าและไคลเอ็นต์ สำหรับลิงก์ด้วยตนเอง ค่าระดับจะเป็น 0 อ่านอย่างเดียว
timeZone

string

การแสดงสตริง Common Locale Data Repository (CLDR) ของเขตเวลาของไคลเอ็นต์ เช่น America/Los_Angeles อ่านอย่างเดียว
testAccount

boolean

ระบุว่าไคลเอ็นต์เป็นบัญชีทดสอบหรือไม่ อ่านอย่างเดียว
manager

boolean

ระบุว่าไคลเอ็นต์เป็นผู้จัดการหรือไม่ อ่านอย่างเดียว
descriptiveName

string

ชื่อที่สื่อความหมายสำหรับไคลเอ็นต์ อ่านอย่างเดียว
currencyCode

string

รหัสสกุลเงิน (เช่น "USD", "EUR") สำหรับลูกค้า อ่านอย่างเดียว
id

string (int64 format)

รหัสของลูกค้าไคลเอ็นต์ อ่านอย่างเดียว

DynamicSearchAdsSearchTermView

มุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิก

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

string

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

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

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

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

GenderView

มุมมองเพศ แหล่งข้อมูล 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/{ownerCustomerId}/labels/{label_id}
status

enum (LabelStatus)

สถานะของป้ายกำกับ อ่านอย่างเดียว
textLabel

object (TextLabel)

ป้ายกำกับประเภทหนึ่งที่แสดงข้อความบนพื้นหลังสี
id

string (int64 format)

รหัสของป้ายกำกับ อ่านอย่างเดียว
name

string

ชื่อป้ายกำกับ

ต้องกรอกข้อมูลในช่องนี้และไม่ควรปล่อยว่างเมื่อสร้างป้ายกำกับใหม่

สตริงนี้ควรมีความยาวระหว่าง 1 ถึง 80 อักขระ

LabelStatus

สถานะที่เป็นไปได้ของป้ายกำกับ

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

TextLabel

ป้ายกำกับประเภทหนึ่งที่แสดงข้อความบนพื้นหลังสี

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

string

สีพื้นหลังของป้ายกำกับในรูปแบบเลขฐานสิบหก สตริงนี้ต้องตรงกับนิพจน์ทั่วไป '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$' หมายเหตุ: บัญชีดูแลจัดการอาจไม่เห็นสีพื้นหลัง
description

string

คำอธิบายสั้นๆ ของป้ายกำกับ ความยาวต้องไม่เกิน 200 อักขระ

LanguageConstant

ภาษา

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

string

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

languageConstants/{criterionId}
id

string (int64 format)

รหัสของค่าคงที่ภาษา
code

string

รหัสภาษา เช่น "en_US", "en_AU", "es", "fr" เป็นต้น
name

string

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

boolean

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

LocationView

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

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

string

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

customers/{customerId}/locationViews/{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=SHARED) ทั้งนี้ขึ้นอยู่กับ access_reason

UserListType

Enum ที่มีประเภทรายการผู้ใช้ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
REMARKETING UserList ที่แสดงเป็นคอลเล็กชันของประเภท Conversion
LOGICAL UserList ที่แสดงเป็นชุดค่าผสมของ UserList/ความสนใจอื่นๆ
EXTERNAL_REMARKETING UserList ที่สร้างในแพลตฟอร์ม Google Ad Manager
RULE_BASED UserList ที่เชื่อมโยงกับกฎ
SIMILAR UserList ที่มีผู้ใช้ซึ่งคล้ายกับผู้ใช้ของ UserList อื่น
CRM_BASED UserList of first-party CRM data provided by advertiser in the form of emails or other formats.

UserLocationView

มุมมองตําแหน่งของผู้ใช้

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

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

string

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

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

รหัสเกณฑ์สำหรับประเทศ
targetingLocation

boolean

ระบุว่ามีการกำหนดเป้าหมายสถานที่หรือไม่

WebpageView

มุมมองหน้าเว็บ

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

string

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

customers/{customerId}/webpageViews/{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 ซึ่งอาจเป็น ENABLED หรือ REMOVED
assetId

string (int64 format)

รหัสของชิ้นงานที่มีการโต้ตอบระหว่างเหตุการณ์ Conversion
assetFieldType

enum (AssetFieldType)

ประเภทช่องชิ้นงานของเหตุการณ์ Conversion

AttributionType

ประเภทการระบุแหล่งที่มาของ Conversion ใน Search Ads 360

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
VISIT Conversion มีการระบุแหล่งที่มาเป็นการเข้าชม
CRITERION_AD ระบบจะระบุแหล่งที่มาของ Conversion เป็นคู่เกณฑ์และโฆษณา

ConversionStatus

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

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

เมตริก

ข้อมูลเมตริก

การแสดง JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
ช่อง
allConversionsValueByConversionDate

number

มูลค่าของ Conversion ทั้งหมด เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
allConversionsByConversionDate

number

จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมดโดยไม่คำนึงถึงค่าของ includeInConversionsMetric เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
conversionCustomMetrics[]

object (Value)

เมตริกที่กำหนดเองของ Conversion
conversionsValueByConversionDate

number

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

number

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

enum (QualityScoreBucket)

คะแนนคุณภาพที่ผ่านมาของครีเอทีฟโฆษณา
historicalLandingPageQualityScore

enum (QualityScoreBucket)

คุณภาพของประสบการณ์หน้า Landing Page ที่ผ่านมา
historicalSearchPredictedCtr

enum (QualityScoreBucket)

อัตราการคลิกผ่าน (CTR) ที่คาดการณ์ไว้ในการค้นหาที่ผ่านมา
interactionEventTypes[]

enum (InteractionEventType)

ประเภทของการโต้ตอบที่เรียกเก็บเงินได้และการโต้ตอบที่ไม่เสียค่าใช้จ่าย
rawEventConversionMetrics[]

object (Value)

เมตริก Conversion ของเหตุการณ์ดิบ
absoluteTopImpressionPercentage

number

ส่วนแบ่งการแสดงผลในตำแหน่งบนสุดแบบสัมบูรณ์ใน Search คือเปอร์เซ็นต์ของการแสดงโฆษณา Search ในตำแหน่งการค้นหาที่โดดเด่นที่สุด
allConversionsFromInteractionsRate

number

Conversion ทั้งหมดจากการโต้ตอบ (เทียบกับ Conversion การดูผ่าน) หารด้วยจํานวนการโต้ตอบกับโฆษณา
allConversionsValue

number

มูลค่าของ Conversion ทั้งหมด
allConversions

number

จำนวน Conversion ทั้งหมด ซึ่งรวมถึง Conversion ทั้งหมดโดยไม่คำนึงถึงค่าของ includeInConversionsMetric
allConversionsValuePerCost

number

มูลค่าของ Conversion ทั้งหมดหารด้วยต้นทุนรวมของการโต้ตอบกับโฆษณา (เช่น การคลิกโฆษณาแบบข้อความหรือการดูโฆษณาวิดีโอ)
allConversionsFromClickToCall

number

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

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromDirections

number

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

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromInteractionsValuePerInteraction

number

มูลค่าของ Conversion ทั้งหมดจากการโต้ตอบ หารด้วยจำนวนการโต้ตอบทั้งหมด
allConversionsFromMenu

number

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

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromOrder

number

จำนวนครั้งที่ผู้ใช้สั่งซื้อสินค้าที่ร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromOtherEngagement

number

จำนวน Conversion อื่นๆ (เช่น การโพสต์รีวิวหรือการบันทึกสถานที่ตั้งของร้านค้า) ซึ่งเกิดขึ้นหลังจากที่ผู้ใช้คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
allConversionsFromStoreVisit

number

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

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
visits

number

คลิกที่ Search Ads 360 บันทึกและส่งต่อไปยังหน้า Landing Page ของผู้ลงโฆษณาได้สำเร็จ
allConversionsFromStoreWebsite

number

จำนวนครั้งที่ระบบนำผู้ใช้ไปยัง URL ของร้านค้าหลังจากที่คลิกโฆษณา

เมตริกนี้ใช้กับรายการฟีดเท่านั้น
averageCost

number

จำนวนเงินเฉลี่ยที่คุณจ่ายต่อการโต้ตอบ 1 ครั้ง จำนวนนี้คือค่าใช้จ่ายรวมของโฆษณาหารด้วยจำนวนการโต้ตอบทั้งหมด
averageCpc

number

ค่าใช้จ่ายรวมของการคลิกทั้งหมดหารด้วยจำนวนคลิกทั้งหมดที่ได้รับ เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
averageCpm

number

ต้นทุนต่อการแสดงผลพันครั้ง (CPM) โดยเฉลี่ย เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clicks

string (int64 format)

จำนวนคลิก
contentBudgetLostImpressionShare

number

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

number

การแสดงผลที่คุณได้รับในเครือข่าย Display หารด้วยจํานวนโดยประมาณของการแสดงผลที่คุณมีสิทธิ์ได้รับ หมายเหตุ: ส่วนแบ่งการแสดงผลเนื้อหาจะรายงานในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
contentRankLostImpressionShare

number

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

number

Conversion ที่เสนอราคาได้โดยเฉลี่ย (จากการโต้ตอบ) ต่อการโต้ตอบที่มีสิทธิ์สำหรับ Conversion แสดงความถี่โดยเฉลี่ยที่การโต้ตอบกับโฆษณาทำให้เกิด Conversion ที่เสนอราคาได้
clientAccountConversionsValue

number

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

number

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

number

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

number

จํานวน Conversion ของบัญชีลูกค้า รวมเฉพาะการกระทำที่ถือเป็น Conversion ที่ตั้งค่าแอตทริบิวต์ includeInClientAccountConversionsMetric เป็นจริง หากคุณใช้การเสนอราคาตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพสำหรับ Conversion เหล่านี้
costMicros

string (int64 format)

ผลรวมของค่าใช้จ่ายจากราคาต่อหนึ่งคลิก (CPC) และราคาต่อการแสดงผลพันครั้ง (CPM) ในช่วงเวลานี้ เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
costPerAllConversions

number

ต้นทุนของการโต้ตอบกับโฆษณาหารด้วย Conversion ทั้งหมด
costPerConversion

number

ต้นทุนเฉลี่ยต่อ Conversion ที่เสนอราคาได้ซึ่งมีสิทธิ์สำหรับ Conversion
costPerCurrentModelAttributedConversion

number

ต้นทุนของการโต้ตอบกับโฆษณาหารด้วย Conversion ที่เกิดจากโมเดลปัจจุบัน รวมเฉพาะการกระทำที่ถือเป็น Conversion ซึ่งตั้งค่าแอตทริบิวต์ includeInConversionsMetric เป็นจริง หากคุณใช้การเสนอราคาตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพสำหรับ Conversion เหล่านี้
crossDeviceConversions

number

Conversion ที่เกิดขึ้นเมื่อลูกค้าคลิกโฆษณาในอุปกรณ์หนึ่ง แล้วทำ Conversion ในอุปกรณ์หรือเบราว์เซอร์อื่น Conversion จากหลายอุปกรณ์รวมอยู่ใน allConversions อยู่แล้ว
crossDeviceConversionsByConversionDate

number

จํานวน Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
crossDeviceConversionsValue

number

ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์
crossDeviceConversionsValueByConversionDate

number

ผลรวมของมูลค่า Conversion จากหลายอุปกรณ์ตามวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
ctr

number

จำนวนคลิกที่โฆษณาได้รับ (คลิก) หารด้วยจำนวนครั้งที่โฆษณาแสดง (การแสดงผล)
conversions

number

จำนวนของ Conversion รวมเฉพาะการกระทำที่ถือเป็น Conversion ซึ่งตั้งค่าแอตทริบิวต์ includeInConversionsMetric เป็นจริง หากคุณใช้การเสนอราคาตาม Conversion กลยุทธ์การเสนอราคาจะเพิ่มประสิทธิภาพสำหรับ Conversion เหล่านี้
conversionsValue

number

ผลรวมของมูลค่า Conversion สำหรับ Conversion ที่รวมอยู่ในช่อง "Conversion" เมตริกนี้จะมีประโยชน์ก็ต่อเมื่อคุณได้ป้อนมูลค่าให้การกระทำที่ถือเป็น Conversion แล้ว
averageQualityScore

number

คะแนนคุณภาพเฉลี่ย
historicalQualityScore

string (int64 format)

คะแนนคุณภาพที่ผ่านมา
impressions

string (int64 format)

จำนวนครั้งที่โฆษณาของคุณปรากฏในหน้าผลการค้นหาหรือเว็บไซต์ในเครือข่ายของ Google
interactionRate

number

ความถี่ที่ผู้ใช้โต้ตอบกับโฆษณาหลังจากที่ได้เห็นโฆษณา อัตราการโต้ตอบคือจำนวนการโต้ตอบหารด้วยจำนวนครั้งที่โฆษณาแสดง
interactions

string (int64 format)

จำนวนการโต้ตอบ การโต้ตอบคือการกระทำหลักของผู้ใช้ที่เชื่อมโยงกับรูปแบบโฆษณา เช่น การคลิกสำหรับโฆษณาแบบข้อความและโฆษณา Shopping, การดูสำหรับโฆษณาวิดีโอ เป็นต้น
invalidClickRate

number

เปอร์เซ็นต์ของคลิกที่กรองออกจากจํานวนคลิกทั้งหมด (คลิกที่กรองแล้ว + คลิกที่ไม่ได้กรอง) ในช่วงระยะเวลาการรายงาน
invalidClicks

string (int64 format)

จำนวนคลิกที่ Google ถือว่าผิดกฎและจะไม่เรียกเก็บเงินจากคุณ
generalInvalidClickRate

number

เปอร์เซ็นต์ของคลิกที่กรองออกจากจํานวนคลิกทั้งหมด (คลิกที่กรองแล้ว + คลิกที่ไม่ได้กรอง) เนื่องจากเป็นคลิกที่ไม่ถูกต้องทั่วไป ซึ่งเป็นคลิกที่ Google ถือว่าผิดหลักเกณฑ์โดยตรวจพบผ่านวิธีการกรองตามปกติ (เช่น การเข้าชมศูนย์ข้อมูลที่ทราบกันดีว่าไม่ถูกต้อง บ็อต และสไปเดอร์หรือ Crawler อื่นๆ รูปแบบที่ผิดปกติ ฯลฯ) ระบบจะไม่เรียกเก็บเงินสำหรับการคลิกดังกล่าว และการคลิกในลักษณะนี้จะไม่ส่งผลกระทบต่อสถิติในบัญชีของคุณ ดูรายละเอียดได้ที่หน้าความช่วยเหลือ https://support.google.com/campaignmanager/answer/6076504
generalInvalidClicks

string (int64 format)

จํานวนคลิกที่ไม่ถูกต้องทั่วไป ซึ่งเป็นชุดย่อยของคลิกที่ไม่ถูกต้องซึ่งตรวจพบผ่านวิธีการกรองตามปกติ (เช่น การเข้าชมที่เกิดในศูนย์ข้อมูลซึ่งทราบว่าไม่ถูกต้อง, บ็อต, สไปเดอร์ หรือ Crawler อื่นๆ, รูปแบบที่ผิดปกติ เป็นต้น) ระบบจะไม่เรียกเก็บเงินสำหรับการคลิกดังกล่าว และการคลิกในลักษณะนี้จะไม่ส่งผลกระทบต่อสถิติในบัญชีของคุณ ดูรายละเอียดได้ที่หน้าความช่วยเหลือ https://support.google.com/campaignmanager/answer/6076504
mobileFriendlyClicksPercentage

number

เปอร์เซ็นต์ของการคลิกจากอุปกรณ์เคลื่อนที่ไปยังหน้าที่เหมาะกับอุปกรณ์เคลื่อนที่
searchAbsoluteTopImpressionShare

number

เปอร์เซ็นต์ของการแสดงโฆษณา Shopping หรือโฆษณา Search ของลูกค้าที่แสดงในตำแหน่ง Shopping ที่โดดเด่นที่สุด ดูรายละเอียดได้ที่ https://support.google.com/sa360/answer/9566729 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
searchBudgetLostAbsoluteTopImpressionShare

number

ตัวเลขที่ประมาณความถี่ที่โฆษณาไม่ได้เป็นโฆษณาแรกในกลุ่มโฆษณาที่ตำแหน่งบนสุดในผลการค้นหาเนื่องจากงบประมาณต่ำ หมายเหตุ: ส่วนแบ่งการแสดงผลในตำแหน่งบนสุดแบบสัมบูรณ์ที่เสียไปใน Search (งบประมาณ) จะรายงานในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchBudgetLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของจำนวนครั้งที่โฆษณามีสิทธิ์แสดงในเครือข่าย Search แต่ไม่ได้แสดงเนื่องจากงบประมาณต่ำเกินไป หมายเหตุ: ส่วนแบ่งการแสดงผลที่เสียไปใน Search เนื่องจากงบประมาณจะรายงานในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchBudgetLostTopImpressionShare

number

ตัวเลขที่ประมาณความถี่ที่โฆษณาไม่ได้แสดงถัดจากผลการค้นหาทั่วไปในตำแหน่งบนสุดเนื่องจากงบประมาณต่ำ หมายเหตุ: ส่วนแบ่งการแสดงผลในตำแหน่งบนสุดที่เสียไปเนื่องจากงบประมาณใน Search จะรายงานในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchClickShare

number

จำนวนคลิกที่คุณได้รับในเครือข่าย Search หารด้วยจำนวนคลิกโดยประมาณที่คุณมีสิทธิ์ได้รับ หมายเหตุ: ส่วนแบ่งการคลิกในการค้นหาจะรายงานในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
searchExactMatchImpressionShare

number

การแสดงผลที่คุณได้รับหารด้วยจำนวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับบนเครือข่ายการค้นหา สำหรับข้อความค้นหาที่ตรงทั้งหมดกับคีย์เวิร์ดของคุณ (หรือเป็นรูปแบบใกล้เคียงของคีย์เวิร์ด) โดยไม่คำนึงถึงประเภทการทำงานของคีย์เวิร์ด หมายเหตุ: ส่วนแบ่งการแสดงผลที่ทำงานแบบตรงทั้งหมดในการค้นหาจะรายงานในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
searchImpressionShare

number

การแสดงผลที่คุณได้รับในเครือข่าย Search หารด้วยจํานวนโดยประมาณของการแสดงผลที่คุณมีสิทธิ์ได้รับ หมายเหตุ: ส่วนแบ่งการแสดงผลบน Search จะรายงานในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999
searchRankLostAbsoluteTopImpressionShare

number

ตัวเลขที่ประมาณความถี่ที่โฆษณาไม่ใช่โฆษณาแรกในกลุ่มโฆษณาที่ตำแหน่งบนสุดในผลการค้นหาเนื่องจากลำดับโฆษณาต่ำ หมายเหตุ: ส่วนแบ่งการแสดงผลในตำแหน่งบนสุดแบบสัมบูรณ์ที่เสียไปในอันดับของ Search จะรายงานในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchRankLostImpressionShare

number

เปอร์เซ็นต์โดยประมาณของการแสดงผลในเครือข่าย Search ที่โฆษณาของคุณไม่ได้รับเนื่องจากลำดับโฆษณาต่ำ หมายเหตุ: ส่วนแบ่งการแสดงผลที่เสียไปเนื่องจากอันดับใน Search จะรายงานในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchRankLostTopImpressionShare

number

ตัวเลขที่ประมาณความถี่ที่โฆษณาไม่ได้แสดงถัดจากผลการค้นหาทั่วไปในตำแหน่งบนสุดเนื่องจากลำดับโฆษณาต่ำ หมายเหตุ: ส่วนแบ่งการแสดงผลในตำแหน่งบนสุดที่เสียไปใน Search จะรายงานในช่วง 0 ถึง 0.9 ค่าที่สูงกว่า 0.9 จะรายงานเป็น 0.9001
searchTopImpressionShare

number

การแสดงผลที่คุณได้รับจากโฆษณาด้านบน เทียบกับจำนวนการแสดงผลโดยประมาณที่คุณมีสิทธิ์ได้รับในกลุ่มโฆษณาตำแหน่งบนสุด หมายเหตุ: ส่วนแบ่งการแสดงผลในตำแหน่งบนสุดใน Search จะรายงานในช่วง 0.1 ถึง 1 ค่าที่ต่ำกว่า 0.1 จะรายงานเป็น 0.0999

โดยโฆษณามักจะแสดงเหนือผลการค้นหาทั่วไปในตำแหน่งบนสุด แต่ในบางกรณีก็อาจแสดงด้านล่างของผลการค้นหาทั่วไปในตำแหน่งบนสุดได้
topImpressionPercentage

number

เปอร์เซ็นต์ของการแสดงโฆษณาที่แสดงติดกับผลการค้นหาทั่วไปในตำแหน่งบนสุด
valuePerAllConversions

number

มูลค่าของ Conversion ทั้งหมดหารด้วยจํานวน Conversion ทั้งหมด
valuePerAllConversionsByConversionDate

number

มูลค่าของ Conversion ทั้งหมดหารด้วยจํานวน Conversion ทั้งหมด เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion ดูรายละเอียดสำหรับคอลัมน์ by_conversion_date ได้ที่ https://support.google.com/sa360/answer/9250611
valuePerConversion

number

มูลค่าของ Conversion ที่เสนอราคาได้หารด้วยจำนวน Conversion ที่เสนอราคาได้ แสดงมูลค่าโดยเฉลี่ยของ Conversion ที่เสนอราคาได้แต่ละรายการ
valuePerConversionsByConversionDate

number

มูลค่า Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion หารด้วย Conversion ที่เสนอราคาได้ตามวันที่เกิด Conversion แสดงมูลค่าเฉลี่ยของ Conversion ที่เสนอราคาได้แต่ละรายการ (ตามวันที่เกิด Conversion) เมื่อเลือกคอลัมน์นี้พร้อมกับวันที่ ค่าในคอลัมน์วันที่หมายถึงวันที่เกิด Conversion
clientAccountViewThroughConversions

string (int64 format)

จำนวน Conversion การดูผ่านทั้งหมด Conversion ประเภทนี้เกิดขึ้นเมื่อลูกค้าเห็นโฆษณาแบบรูปภาพหรือริชมีเดีย แล้วทำ Conversion ในเว็บไซต์ภายหลังโดยไม่ได้โต้ตอบ (เช่น คลิก) กับโฆษณาอื่น
clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากการขายครอสเซล (COGS) ของบัญชีลูกค้าคือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล ต้นทุนสินค้าขายจากการขายครอสเซลคือต้นทุนรวมของผลิตภัณฑ์ที่ขายโดยไม่ได้โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากการขายครอสเซล (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล ต้นทุนสินค้าขายจากการขายครอสเซลคือต้นทุนรวมของผลิตภัณฑ์ที่ขายโดยไม่ได้โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากการขายครอสเซลในบัญชีลูกค้าคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่นลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในการขายจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล กําไรขั้นต้นจากการขายครอสเซลคือรายได้จากการขายครอสเซลที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว เสื้อราคา 600 บาทและมีมูลค่าต้นทุนสินค้าขาย 150 บาท กําไรขั้นต้นจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 450 บาท = 600 บาท - 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากการขายครอสเซลคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่นลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในการขายจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล กําไรขั้นต้นจากการขายครอสเซลคือรายได้จากการขายครอสเซลที่มาจากโฆษณาลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว เสื้อราคา 600 บาทและมีมูลค่าต้นทุนสินค้าขาย 150 บาท กําไรขั้นต้นจากการขายครอสเซลสําหรับคําสั่งซื้อนี้คือ 450 บาท = 600 บาท - 150 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellRevenueMicros

string (int64 format)

รายได้จากการขายครอสเซลในบัญชีลูกค้าคือจํานวนเงินทั้งหมดที่คุณได้มาจากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล รายได้จากการขายครอสเซลคือมูลค่าทั้งหมดที่คุณได้มาจากการขายครอสเซลที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากการขายครอสเซลสําหรับคําสั่งซื้อนี้เท่ากับ 600 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellRevenueMicros

string (int64 format)

รายได้จากการขายครอสเซลคือจํานวนเงินทั้งหมดที่คุณได้มาจากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล รายได้จากการขายครอสเซลคือมูลค่าทั้งหมดที่คุณได้มาจากการขายครอสเซลที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากการขายครอสเซลสําหรับคําสั่งซื้อนี้เท่ากับ 600 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellUnitsSold

number

จำนวนที่ขายได้จากการขายครอสเซลในบัญชีลูกค้าคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ทําให้เกิดการขายแบบครอสเซลจากคําสั่งซื้อทั้งหมดที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จำนวนที่ขายได้จากการขายครอสเซลในคําสั่งซื้อนี้คือ 2 เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
crossSellUnitsSold

number

จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์อื่น วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์เหล่านี้ไม่ตรงกันก็จะถือว่าเป็นการขายครอสเซล จำนวนที่ขายได้จากการขายครอสเซลคือจํานวนรวมของผลิตภัณฑ์ที่ทําให้เกิดการขายแบบครอสเซลจากคําสั่งซื้อทั้งหมดที่มาจากโฆษณาของคุณ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จำนวนที่ขายได้จากการขายครอสเซลในคําสั่งซื้อนี้คือ 2 เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา (COGS) ของบัญชีลูกค้าคือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน ต้นทุนของสินค้าเหล่านี้จะนับภายใต้ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณาสําหรับคําสั่งซื้อนี้เท่ากับ 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadCostOfGoodsSoldMicros

string (int64 format)

ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา (COGS) คือต้นทุนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกัน วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน ต้นทุนของสินค้าเหล่านี้จะนับภายใต้ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกมีมูลค่าต้นทุนสินค้าขายที่ 90 บาท เสื้อมีมูลค่าต้นทุนสินค้าขายที่ 150 บาท ต้นทุนสินค้าขายจากผลิตภัณฑ์ที่โฆษณาสําหรับคําสั่งซื้อนี้เท่ากับ 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาในบัญชีลูกค้าคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกันลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาจะมาจากรายได้จากการขายเหล่านี้ลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท กำไรขั้นต้นจากสินค้าที่โฆษณาของคำสั่งซื้อนี้เท่ากับ 210 บาท = 300 บาท - 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadGrossProfitMicros

string (int64 format)

กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาคือกําไรที่คุณได้จากผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์เดียวกันลบด้วยต้นทุนสินค้าขาย (COGS) วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ใดๆ ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน กําไรขั้นต้นจากผลิตภัณฑ์ที่โฆษณาจะมาจากรายได้จากการขายเหล่านี้ลบด้วยต้นทุนสินค้าขาย ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและต้นทุนสินค้าขายอยู่ที่ 90 บาท กำไรขั้นต้นจากสินค้าที่โฆษณาของคำสั่งซื้อนี้เท่ากับ 210 บาท = 300 บาท - 90 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadRevenueMicros

string (int64 format)

รายได้จากผลิตภัณฑ์ที่โฆษณาในบัญชีลูกค้าคือจํานวนเงินทั้งหมดที่ได้มาจากผลิตภัณฑ์ที่ขายได้เนื่องจากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน มูลค่ารวมจากการขายผลิตภัณฑ์เหล่านี้จะปรากฏใต้รายได้จากผลิตภัณฑ์ที่โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้คือ 300 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadRevenueMicros

string (int64 format)

รายได้จากผลิตภัณฑ์ที่โฆษณาคือจํานวนเงินทั้งหมดที่ได้มาจากผลิตภัณฑ์ที่ขายได้เนื่องจากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน มูลค่ารวมจากการขายผลิตภัณฑ์เหล่านี้จะปรากฏใต้รายได้จากผลิตภัณฑ์ที่โฆษณา ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้นและเสื้ออีก 1 ตัว หมวกราคา 300 บาทและเสื้อราคา 600 บาท รายได้จากผลิตภัณฑ์ที่โฆษณาของคำสั่งซื้อนี้คือ 300 บาท เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น เมตริกนี้เป็นมูลค่าทางการเงินและจะแสดงในสกุลเงินของลูกค้าโดยค่าเริ่มต้น ดูพารามิเตอร์ metrics_currency ได้ที่ https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadUnitsSold

number

จำนวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ของบัญชีลูกค้าคือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จะปรากฏในจํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ในคําสั่งซื้อนี้คือ 1 ชิ้น เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
leadUnitsSold

number

จำนวนสินค้าที่โฆษณาขายได้คือจํานวนรวมของผลิตภัณฑ์ที่ขายได้จากการโฆษณาผลิตภัณฑ์นั้นๆ วิธีการทํางาน: คุณสามารถรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งสําหรับการซื้อที่เสร็จสมบูรณ์บนเว็บไซต์ได้ หากโฆษณาที่มีการโต้ตอบก่อนการซื้อมีผลิตภัณฑ์ที่เกี่ยวข้อง (ดูโฆษณา Shopping) ระบบจะถือว่าผลิตภัณฑ์นี้เป็นผลิตภัณฑ์ที่โฆษณา ผลิตภัณฑ์ที่อยู่ในคําสั่งซื้อของลูกค้าจะถือเป็นผลิตภัณฑ์ที่ขายได้ หากผลิตภัณฑ์ที่โฆษณาและผลิตภัณฑ์ที่ขายได้ตรงกัน จํานวนผลิตภัณฑ์ทั้งหมดที่ขายได้จะปรากฏในจํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ ตัวอย่าง: มีผู้คลิกโฆษณา Shopping สําหรับหมวก จากนั้นซื้อหมวกใบนั้น พร้อมกับเสื้อและแจ็คเก็ตอย่างละ 1 ตัว จํานวนผลิตภัณฑ์ที่โฆษณาซึ่งขายได้ในคําสั่งซื้อนี้คือ 1 ชิ้น เมตริกนี้จะใช้ได้ก็ต่อเมื่อคุณรายงาน Conversion จากข้อมูลรถเข็นช็อปปิ้งเท่านั้น
uniqueUsers

string (int64 format)

จำนวนผู้ใช้ที่ไม่ซ้ำที่เห็นโฆษณาของคุณในช่วงเวลาที่ขอ เมตริกนี้รวบรวมไม่ได้ และขอได้เฉพาะช่วงวันที่ไม่เกิน 92 วันเท่านั้น เมตริกนี้ใช้ได้กับแคมเปญประเภทต่อไปนี้ ได้แก่ Display, วิดีโอ, Discovery และ App
averageImpressionFrequencyPerUser

number

จำนวนครั้งโดยเฉลี่ยที่ผู้ใช้ที่ไม่ซ้ำเห็นโฆษณาของคุณในช่วงเวลาที่ขอ เมตริกนี้รวบรวมไม่ได้ และขอได้เฉพาะช่วงวันที่ไม่เกิน 92 วันเท่านั้น เมตริกนี้ใช้ได้กับแคมเปญประเภทต่อไปนี้ ได้แก่ Display, วิดีโอ, Discovery และ App

ค่า

คอนเทนเนอร์ข้อมูลทั่วไป

การแสดง JSON 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
ช่อง
ฟิลด์ Union value ค่า value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
booleanValue

boolean

บูลีน
int64Value

string (int64 format)

int64
floatValue

number

ฟลอต
doubleValue

number

ดับเบิล
stringValue

string

สตริง

QualityScoreBucket

Enum ที่แสดงกลุ่มคะแนนคุณภาพที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
BELOW_AVERAGE คุณภาพของครีเอทีฟโฆษณาต่ำกว่าค่าเฉลี่ย
AVERAGE คุณภาพของครีเอทีฟโฆษณาอยู่ในระดับปานกลาง
ABOVE_AVERAGE คุณภาพของครีเอทีฟโฆษณาสูงกว่าค่าเฉลี่ย

InteractionEventType

Enum ที่อธิบายประเภทที่เป็นไปได้ของการโต้ตอบที่ต้องชำระเงินและไม่เสียค่าใช้จ่าย

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
CLICK คลิกเพื่อไปที่เว็บไซต์ ในกรณีส่วนใหญ่ การโต้ตอบนี้จะนำไปยังตำแหน่งภายนอก ซึ่งมักจะเป็นหน้า Landing Page ของผู้ลงโฆษณา นอกจากนี้ยังเป็น InteractionEventType เริ่มต้นสําหรับเหตุการณ์คลิกด้วย
ENGAGEMENT ความตั้งใจที่ผู้ใช้แสดงออกเพื่อมีส่วนร่วมกับโฆษณาในที่นั้น
VIDEO_VIEW ผู้ใช้ดูโฆษณาวิดีโอ
NONE InteractionEventType เริ่มต้นสําหรับเหตุการณ์ Conversion ของโฆษณา ใช้ในกรณีที่แถว Conversion ของโฆษณาไม่ได้ระบุว่าควร "โปรโมต" การโต้ตอบฟรี (เช่น Conversion ของโฆษณา) และรายงานเป็นส่วนหนึ่งของเมตริกหลัก ซึ่งเป็นเพียง Conversion อื่นๆ (โฆษณา)

กลุ่ม

ฟิลด์กลุ่มเท่านั้น

การแสดง JSON 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
ช่อง
adNetworkType

enum (AdNetworkType)

ประเภทเครือข่ายโฆษณา
conversionActionCategory

enum (ConversionActionCategory)

หมวดหมู่การกระทำที่ถือเป็น Conversion
conversionCustomDimensions[]

object (Value)

มิติข้อมูลที่กําหนดเองของ Conversion
dayOfWeek

enum (DayOfWeek)

วันในสัปดาห์ เช่น วันจันทร์
device

enum (Device)

อุปกรณ์ที่ใช้เมตริก
keyword

object (Keyword)

เกณฑ์คีย์เวิร์ด
productChannel

enum (ProductChannel)

ช่องทางของผลิตภัณฑ์
productChannelExclusivity

enum (ProductChannelExclusivity)

การจำกัดสิทธิ์ช่องทางของผลิตภัณฑ์
productCondition

enum (ProductCondition)

สภาพของผลิตภัณฑ์
productSoldCondition

enum (ProductCondition)

สภาพของผลิตภัณฑ์ที่ขาย
rawEventConversionDimensions[]

object (Value)

มิติข้อมูล Conversion เหตุการณ์ดิบ
conversionAction

string

ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion
conversionActionName

string

ชื่อการกระทำที่ถือเป็น Conversion
date

string

วันที่ที่ใช้เมตริก รูปแบบ ปปปป-ดด-วว เช่น 2018-04-17
geoTargetCity

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์ที่แสดงถึงเมือง
geoTargetCountry

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์ที่แสดงถึงประเทศ
geoTargetMetro

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์ที่แสดงถึงเขตเมือง
geoTargetRegion

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์ที่แสดงถึงภูมิภาค
hour

integer

ชั่วโมงของวันเป็นตัวเลขระหว่าง 0 ถึง 23
month

string

เดือนที่แสดงโดยวันที่ของวันแรกของเดือน จัดรูปแบบเป็น ปปปป-ดด-วว
productBiddingCategoryLevel1

string

หมวดหมู่การเสนอราคา (ระดับ 1) ของผลิตภัณฑ์
productBiddingCategoryLevel2

string

หมวดหมู่การเสนอราคา (ระดับ 2) ของผลิตภัณฑ์
productBiddingCategoryLevel3

string

หมวดหมู่การเสนอราคา (ระดับ 3) ของผลิตภัณฑ์
productBiddingCategoryLevel4

string

หมวดหมู่การเสนอราคา (ระดับ 4) ของผลิตภัณฑ์
productBiddingCategoryLevel5

string

หมวดหมู่การเสนอราคา (ระดับ 5) ของผลิตภัณฑ์
productBrand

string

แบรนด์ของผลิตภัณฑ์
productCountry

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์สำหรับประเทศที่ขายผลิตภัณฑ์
productCustomAttribute0

string

แอตทริบิวต์ที่กำหนดเอง 0 ของผลิตภัณฑ์
productCustomAttribute1

string

แอตทริบิวต์ที่กำหนดเอง 1 ของผลิตภัณฑ์
productCustomAttribute2

string

แอตทริบิวต์ที่กำหนดเอง 2 ของผลิตภัณฑ์
productCustomAttribute3

string

แอตทริบิวต์ที่กำหนดเอง 3 ของผลิตภัณฑ์
productCustomAttribute4

string

แอตทริบิวต์ที่กำหนดเอง 4 ของผลิตภัณฑ์
productItemId

string

รหัสสินค้าของผลิตภัณฑ์
productLanguage

string

ชื่อทรัพยากรของค่าคงที่ภาษาสำหรับภาษาของผลิตภัณฑ์
productSoldBiddingCategoryLevel1

string

หมวดหมู่การเสนอราคา (ระดับ 1) ของผลิตภัณฑ์ที่ขาย
productSoldBiddingCategoryLevel2

string

หมวดหมู่การเสนอราคา (ระดับ 2) ของผลิตภัณฑ์ที่ขาย
productSoldBiddingCategoryLevel3

string

หมวดหมู่การเสนอราคา (ระดับ 3) ของผลิตภัณฑ์ที่ขาย
productSoldBiddingCategoryLevel4

string

หมวดหมู่การเสนอราคา (ระดับ 4) ของผลิตภัณฑ์ที่ขาย
productSoldBiddingCategoryLevel5

string

หมวดหมู่การเสนอราคา (ระดับ 5) ของผลิตภัณฑ์ที่ขาย
productSoldBrand

string

แบรนด์ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute0

string

แอตทริบิวต์ที่กำหนดเอง 0 ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute1

string

แอตทริบิวต์ที่กำหนดเอง 1 ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute2

string

แอตทริบิวต์ที่กำหนดเอง 2 ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute3

string

แอตทริบิวต์ที่กำหนดเอง 3 ของผลิตภัณฑ์ที่ขาย
productSoldCustomAttribute4

string

แอตทริบิวต์ที่กำหนดเอง 4 ของผลิตภัณฑ์ที่ขาย
productSoldItemId

string

รหัสสินค้าของผลิตภัณฑ์ที่ขาย
productSoldTitle

string

ชื่อผลิตภัณฑ์ที่ขาย
productSoldTypeL1

string

ประเภท (ระดับ 1) ของผลิตภัณฑ์ที่ขาย
productSoldTypeL2

string

ประเภท (ระดับ 2) ของผลิตภัณฑ์ที่ขาย
productSoldTypeL3

string

ประเภท (ระดับ 3) ของผลิตภัณฑ์ที่ขาย
productSoldTypeL4

string

ประเภท (ระดับ 4) ของผลิตภัณฑ์ที่ขาย
productSoldTypeL5

string

ประเภท (ระดับ 5) ของผลิตภัณฑ์ที่ขาย
productStoreId

string

รหัสร้านค้าของผลิตภัณฑ์
productTitle

string

ชื่อผลิตภัณฑ์
productTypeL1

string

ประเภท (ระดับ 1) ของผลิตภัณฑ์
productTypeL2

string

ประเภท (ระดับ 2) ของผลิตภัณฑ์
productTypeL3

string

ประเภท (ระดับ 3) ของผลิตภัณฑ์
productTypeL4

string

ประเภท (ระดับ 4) ของผลิตภัณฑ์
productTypeL5

string

ประเภท (ระดับ 5) ของผลิตภัณฑ์
quarter

string

ไตรมาสตามที่แสดงโดยวันที่ของวันแรกของไตรมาส ใช้ปีปฏิทินสำหรับไตรมาส เช่น ไตรมาสที่ 2 ของปี 2018 จะเริ่มในวันที่ 2018-04-01 จัดรูปแบบเป็น ปปปป-ดด-วว
week

string

สัปดาห์หมายถึงวันจันทร์ถึงวันอาทิตย์ และแสดงด้วยวันที่ของวันจันทร์ จัดรูปแบบเป็น ปปปป-ดด-วว
year

integer

ปีในรูปแบบ yyyy
assetInteractionTarget

object (AssetInteractionTarget)

ใช้กับเมตริก CustomerAsset, CampaignAsset และ AdGroupAsset เท่านั้น ระบุว่าเมตริกการโต้ตอบเกิดขึ้นในชิ้นงานนั้นๆ หรือชิ้นงานอื่น หรือหน่วยโฆษณาอื่น ระบบจะนับการโต้ตอบ (เช่น การคลิก) ในทุกส่วนของโฆษณาที่แสดง (เช่น ตัวโฆษณาและคอมโพเนนต์อื่นๆ เช่น ไซต์ลิงก์) เมื่อแสดงร่วมกัน เมื่อ interactionOnThisAsset เป็นจริง หมายความว่าการโต้ตอบเกิดขึ้นในชิ้นงานนี้โดยเฉพาะ และเมื่อ interactionOnThisAsset เป็นเท็จ หมายความว่าการโต้ตอบไม่ได้เกิดขึ้นในชิ้นงานนี้โดยเฉพาะ แต่เกิดขึ้นในส่วนอื่นๆ ของโฆษณาที่แสดงซึ่งชิ้นงานนี้แสดงด้วย

AdNetworkType

แสดงประเภทเครือข่าย Google Ads

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
SEARCH การค้นหาใน Google
SEARCH_PARTNERS พาร์ทเนอร์ Search
CONTENT เครือข่ายดิสเพลย์
YOUTUBE_WATCH วิดีโอ YouTube
MIXED ข้ามเครือข่าย

คีย์เวิร์ด

กลุ่มเกณฑ์คีย์เวิร์ด

การแสดง JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
ช่อง
info

object (KeywordInfo)

ข้อมูลคีย์เวิร์ด
adGroupCriterion

string

ชื่อทรัพยากร AdGroupCriterion

ProductChannelExclusivity

Enum ที่อธิบายความพร้อมจำหน่ายของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SINGLE_CHANNEL สินค้าขายผ่านช่องทางเดียวเท่านั้น ไม่ว่าจะเป็นร้านค้าในพื้นที่หรือออนไลน์ตามที่ระบุโดย ProductChannel
MULTI_CHANNEL ระบบจะจับคู่สินค้ากับสินค้าที่คล้ายกันในร้านค้าออนไลน์หรือร้านค้าในพื้นที่ ซึ่งบ่งบอกว่าสินค้าพร้อมจำหน่ายใน ShoppingProductChannels ทั้ง 2 ช่องทาง

ProductCondition

Enum ที่อธิบายสภาพของข้อเสนอผลิตภัณฑ์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งคืนเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
OLD สภาพผลิตภัณฑ์เก่า
NEW ผลิตภัณฑ์มีสภาพเป็นของใหม่
REFURBISHED สภาพสินค้าคือซ่อมแซมใหม่
USED มีการใช้สภาพผลิตภัณฑ์

AssetInteractionTarget

กลุ่ม AssetInteractionTarget

การแสดง JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
ช่อง
asset

string

ชื่อทรัพยากรของชิ้นงาน
interactionOnThisAsset

boolean

ใช้กับเมตริก CustomerAsset, CampaignAsset และ AdGroupAsset เท่านั้น ระบุว่าเมตริกการโต้ตอบเกิดขึ้นในชิ้นงานนั้นๆ หรือชิ้นงานอื่น หรือหน่วยโฆษณาอื่น