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 [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 จากโดเมนเว็บของผู้ลงโฆษณา อนุญาตให้ใช้โหนดระดับรูทหลายโหนดในกลุ่มชิ้นงานหนึ่งและจะพิจารณาเงื่อนไขของโหนดใน "หรือ"

การแสดง 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 เป็นเงื่อนไข customLabel ระบบจะจับคู่ 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)

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