AssetGroupListingGroupFilter

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

การแสดง JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "listingSource": enum (ListingGroupFilterListingSource),
  "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)

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

enum (ListingGroupFilterListingSource)

เปลี่ยนแปลงไม่ได้ แหล่งที่มาของข้อมูลที่กรองโดยตัวกรองกลุ่มรายชื่อนี้
caseValue

object (ListingGroupFilterDimension)

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

string

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

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

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

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

ListingGroupFilterListingSource

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

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
SHOPPING ข้อมูลจากแหล่งที่มาใน Shopping เช่น ผลิตภัณฑ์จาก Google Merchant Center
WEBPAGE ข้อมูลจากแหล่งที่มาของหน้าเว็บ เช่น URL จากฟีดหน้าเว็บหรือจากโดเมนเว็บของผู้ลงโฆษณา

ListingGroupFilterDimension

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

การแสดง JSON 
{

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

object (ProductCategory)

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

object (ProductBrand)

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

object (ProductChannel)

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

object (ProductCondition)

เงื่อนไขของข้อเสนอผลิตภัณฑ์
productCustomAttribute

object (ProductCustomAttribute)

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

object (ProductItemId)

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

object (ProductType)

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

object (Webpage)

ตัวกรองสำหรับ URL ในฟีดหน้าเว็บและ URL จากโดเมนเว็บของผู้ลงโฆษณา

ProductCategory

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

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

enum (ListingGroupFilterProductCategoryLevel)

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

string (int64 format)

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

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

ListingGroupFilterProductCategoryLevel

ระดับของหมวดหมู่ผลิตภัณฑ์ตัวกรองกลุ่มรายชื่อ

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

หน้าเว็บ

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

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

object (WebpageCondition)

เงื่อนไขของหน้าเว็บจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ รวมถึงจะรวมอยู่ด้วยกันเมื่อประเมินเพื่อกรอง เงื่อนไขทั้งหมดควรเป็นประเภทเดียวกัน ตัวอย่างที่ 1: สำหรับ URL1 = www.ads.google.com?ocid=1&euid=2 และ URL2 = www.ads.google.com?ocid=1 และมี "ocid" และ "euid" เป็น urlContains เงื่อนไข URL1 จะถูกจับคู่ แต่ URL2 ไม่ตรงกัน

Example2 : หาก URL1 มี Label1, Label2 และ URL2 มี Label2, Label3 และมี Label1 และ Label2 เป็นเงื่อนไขป้ายที่กำหนดเอง URL1 จะได้รับการจับคู่แต่ไม่จับคู่ URL2 เมื่อใช้ Label2 เป็นเงื่อนไข customLabel เดียว ระบบจะจับคู่ทั้ง URL1 และ URL2

WebpageCondition

เงื่อนไขการจับคู่สำหรับการกรอง URL

การแสดง JSON 
{

  // Union field condition can be only one of the following:
  "customLabel": string,
  "urlContains": string
  // End of list of possible types for union field condition.
}
ช่อง
ฟิลด์สหภาพ condition เงื่อนไขสำหรับการกรอง URL condition สามารถเป็นได้อย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
customLabel

string

กรอง URL ในฟีดหน้าเว็บที่มีป้ายกํากับที่กําหนดเองนี้ เพิ่มป้ายกำกับที่กำหนดเองลงในแคมเปญได้โดยการสร้างชุดชิ้นงานประเภท PAGE_FEED และลิงก์ป้ายกำกับนั้นกับแคมเปญโดยใช้ CampaignAssetSet
urlContains

string

กรอง URL ในฟีดหน้าเว็บและ URL จากโดเมนเว็บของผู้ลงโฆษณาที่มีสตริงนี้

ListingGroupFilterDimensionPath

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

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

object (ListingGroupFilterDimension)

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