ประเภทรายงาน: ผลิตภัณฑ์ที่โฆษณา

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

รายงานนี้สามารถส่งคืนได้โดยคำขอแบบอะซิงโครนัสเท่านั้น (นั่นคือผ่านทาง Reports.request())

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

ส่ง Reports.request() เนื้อหาของคำขอ แต่ระบุ "reportType": "productAdvertised"

{
...
  "reportType": "productAdvertised",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

สำหรับแต่ละคอลัมน์ที่คุณต้องการให้ส่งคืนหรือกรองในรายงาน ให้ระบุ columnName ที่แสดงในตารางด้านล่าง นอกจากนี้คุณยังสามารถเลือกระบุ headerText startDate, และ endDate โปรดทราบว่าบางคอลัมน์ไม่สามารถกรองได้ ดูที่ "กรองได้" ในตารางด้านล่าง

columnName	คำอธิบาย	ลักษณะการทำงาน	ประเภท	กรองได้
status	สถานะของผลิตภัณฑ์ตามที่ระบุไว้ในบัญชีสินค้าคงคลัง: Active หรือ Removed	แอตทริบิวต์	Status	ใช่
creationTimestamp	การประทับเวลาการสร้างผลิตภัณฑ์ตามที่ระบุไว้ในบัญชีสินค้าคงคลังซึ่งอยู่ในรูปแบบ ISO 8601	แอตทริบิวต์	Timestamp	ใช่
lastModifiedTimestamp	การประทับเวลาการแก้ไขล่าสุดของผลิตภัณฑ์ตามที่ระบุไว้ในบัญชีสินค้าคงคลัง การแก้ไขในรูปแบบ ISO 8601	แอตทริบิวต์	Timestamp	ใช่
agency	ชื่อเอเจนซี	แอตทริบิวต์	String	ใช่
agencyId	รหัสเอเจนซี DS	แอตทริบิวต์	ID	ใช่
advertiser	ชื่อผู้ลงโฆษณา	แอตทริบิวต์	String	ใช่
advertiserId	รหัสผู้ลงโฆษณา DS	แอตทริบิวต์	ID	ใช่
productId	รหัสสินค้าของผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productCountry	ประเทศที่ลงทะเบียนสำหรับฟีดสินค้าคงคลังของผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productLanguage	ภาษาที่ลงทะเบียนสำหรับฟีดสินค้าคงคลังของผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productMpn	แอตทริบิวต์ MPN (หมายเลขชิ้นส่วนของผู้ผลิต) ของสินค้า	แอตทริบิวต์	String	ใช่
productColor	แอตทริบิวต์ color ของรายการผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productSize	แอตทริบิวต์ size ของรายการผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productMaterial	แอตทริบิวต์ material [วัสดุ] ของสินค้า	แอตทริบิวต์	String	ใช่
productPattern	แอตทริบิวต์ pattern [ลาย] ของสินค้า	แอตทริบิวต์	String	ใช่
productAvailability	แอตทริบิวต์ความพร้อมจำหน่ายสินค้า [availability] ของสินค้า	แอตทริบิวต์	Product availability	ใช่
productGender	แอตทริบิวต์ gender [เพศ] ของสินค้า	แอตทริบิวต์	String	ใช่
productAgeGroup	แอตทริบิวต์ age group [กลุ่มอายุ] ของรายการผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productLandingPageUrl	แอตทริบิวต์หน้า Landing Page ของสินค้า	แอตทริบิวต์	String	ใช่
productCategory	แอตทริบิวต์ google product category [หมวดหมู่ผลิตภัณฑ์ Google] ของสินค้า	แอตทริบิวต์	String	ใช่
productCategoryLevel1	แอตทริบิวต์หมวดหมู่ผลิตภัณฑ์ Google ระดับ 1 ของสินค้า	แอตทริบิวต์	String	ใช่
productCategoryLevel2	แอตทริบิวต์หมวดหมู่ผลิตภัณฑ์ Google ระดับ 2 ของสินค้า	แอตทริบิวต์	String	ใช่
productCategoryLevel3	แอตทริบิวต์หมวดหมู่ผลิตภัณฑ์ Google ระดับ 3 ของสินค้า	แอตทริบิวต์	String	ใช่
productCategoryLevel4	แอตทริบิวต์หมวดหมู่ผลิตภัณฑ์ Google ระดับ 4 ของสินค้า	แอตทริบิวต์	String	ใช่
productCategoryLevel5	แอตทริบิวต์หมวดหมู่ผลิตภัณฑ์ Google ระดับ 5 ของสินค้า	แอตทริบิวต์	String	ใช่
productBrand	แอตทริบิวต์ยี่ห้อ [brand] ของสินค้า	แอตทริบิวต์	String	ใช่
productGtin	แอตทริบิวต์ GTIN (หมายเลขสินค้าการค้าสากล) ของสินค้า	แอตทริบิวต์	String	ใช่
productPrice	แอตทริบิวต์ราคา [price] ของสินค้า	แอตทริบิวต์	Money	ใช่
productSalePrice	แอตทริบิวต์ราคา [price] ของสินค้า	แอตทริบิวต์	Money	ใช่
productTypeLevel1	แอตทริบิวต์ product type leve 1 ของสินค้าของผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productTypeLevel2	แอตทริบิวต์ product type leve 2 ของสินค้าผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productTypeLevel3	แอตทริบิวต์ product type leve 3 ของสินค้าของผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productTypeLevel4	แอตทริบิวต์ product type leve 4 ของสินค้าของผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productTypeLevel5	แอตทริบิวต์ product type leve 5 ของสินค้าของผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productCondition	แอตทริบิวต์ condition ของสินค้า	แอตทริบิวต์	String	ใช่
productCustomLabel0	แอตทริบิวต์ custom label 0 ของสินค้าผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productCustomLabel1	แอตทริบิวต์ป้ายที่กำหนดเอง 1 ของสินค้า	แอตทริบิวต์	String	ใช่
productCustomLabel2	แอตทริบิวต์ custom label 2 ของสินค้าผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productCustomLabel3	แอตทริบิวต์ป้ายที่กำหนดเอง 3 ของสินค้า	แอตทริบิวต์	String	ใช่
productCustomLabel4	แอตทริบิวต์ป้ายที่กำหนดเอง 4 ของสินค้า	แอตทริบิวต์	String	ใช่
productCostOfGoodsSold	ต้นทุนรวมของการขายผลิตภัณฑ์ตามที่ระบุไว้ในฟีดสินค้าคงคลัง	แอตทริบิวต์	Money	ใช่
productStoreId	ร้านที่มีการโฆษณาผลิตภัณฑ์ในโฆษณาสินค้าคงคลังในร้าน ซึ่งควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน	แอตทริบิวต์	String	ใช่
productChannel	แอตทริบิวต์ช่องทางการขายของสินค้า: Online หรือ Local	แอตทริบิวต์	Product channel	ใช่
productChannelExclusivity	แอตทริบิวต์ความมีเอกสิทธิ์ของช่องทางของสินค้า	แอตทริบิวต์	Product channel exclusivity	ใช่
productItemGroupId	แอตทริบิวต์รหัสกลุ่มสินค้าของสินค้าของผลิตภัณฑ์	แอตทริบิวต์	String	ใช่
productTitle	แอตทริบิวต์ชื่อของสินค้า	แอตทริบิวต์	String	ใช่
dfaActions	จำนวนการดำเนินการทั้งหมดของ Campaign Manager	เมตริก	Integer	ใช่
dfaRevenue	รายได้รวมที่เกิดจากธุรกรรมของ Campaign Manager	เมตริก	Money	ใช่
dfaTransactions	จำนวนธุรกรรม Campaign Manager ทั้งหมด	เมตริก	Integer	ใช่
dfaWeightedActions	ผลรวมถ่วงน้ำหนักของการดำเนินการใน Campaign Manager	เมตริก	Number	ใช่
dfaActionsCrossEnv	จำนวนการกระทำทั้งหมดของ Campaign Manager ข้ามสภาพแวดล้อม	เมตริก	Number	ใช่
dfaRevenueCrossEnv	รายได้รวมที่เกิดจากธุรกรรม Campaign Manager ข้ามสภาพแวดล้อม	เมตริก	Money	ใช่
dfaTransactionsCrossEnv	จำนวนธุรกรรม Campaign Manager ข้ามสภาพแวดล้อมทั้งหมด	เมตริก	Number	ใช่
dfaWeightedActionsCrossEnv	ผลรวมถ่วงน้ำหนักของการดำเนินการ Campaign Manager ข้ามสภาพแวดล้อม	เมตริก	Number	ใช่
avgCpc	ต้นทุนต่อคลิกโดยเฉลี่ย	เมตริก	Money	ใช่
avgCpm	ต้นทุนต่อการแสดงผลพันครั้งโดยเฉลี่ย	เมตริก	Money	ใช่
avgPos	อันดับเฉลี่ย	เมตริก	Number	ใช่
clicks	จำนวนคลิกรวม	เมตริก	Integer	ใช่
cost	ค่าใช้จ่ายรวมที่ชำระให้กับบัญชีเครื่องมือค้นหา	เมตริก	Money	ใช่
ctr	อัตราการคลิกผ่านโดยเฉลี่ย	เมตริก	Number	ใช่
impr	จำนวนการแสดงผลทั้งหมด	เมตริก	Integer	ใช่
adWordsConversions	ข้อมูลที่ผู้ลงโฆษณาตั้งค่าให้รายงานในคอลัมน์ Conversion ของ Google Ads เมื่อมีการสร้างการกระทำที่ถือเป็น Conversion ของ Google Ads ผู้ลงโฆษณาจะเลือกว่าจะนับ Conversion เหล่านั้นในคอลัมน์การรายงาน Conversion หรือไม่	เมตริก	Number	ใช่
adWordsConversionValue	มูลค่ารวมของ Conversion ของ Google Ads	เมตริก	Number	ใช่
adWordsViewThroughConversions	จำนวน Conversion การดูผ่านของ Google Ads ทั้งหมด	เมตริก	Integer	ใช่
visits	จำนวนการเข้าชม DS ทั้งหมด	เมตริก	Integer	ใช่
date	แบ่งกลุ่มรายงานตามวัน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละวัน คอลัมน์นี้แสดงวันที่ของแต่ละแถว	กลุ่ม	Date	ใช่
monthStart	แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละเดือน คอลัมน์นี้แสดงผลวันแรกของเดือนของแต่ละแถว	กลุ่ม	Date	ใช่
monthEnd	แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละเดือน คอลัมน์นี้แสดงวันสุดท้ายของเดือนของแต่ละแถว	กลุ่ม	Date	ใช่
quarterStart	แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวต่อไตรมาส คอลัมน์นี้แสดงผลวันแรกของไตรมาสของแต่ละแถว	กลุ่ม	Date	ใช่
quarterEnd	แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวต่อไตรมาส คอลัมน์นี้แสดงวันสุดท้ายของไตรมาสของแต่ละแถว	กลุ่ม	Date	ใช่
weekStart	แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว แต่ละแถวสำหรับแต่ละสัปดาห์ คอลัมน์นี้แสดงผลวันแรก (วันอาทิตย์) ของแต่ละแถว	กลุ่ม	Date	ใช่
weekEnd	แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว แต่ละแถวสำหรับแต่ละสัปดาห์ คอลัมน์นี้แสดงวันสุดท้าย (วันเสาร์) ของแต่ละแถว	กลุ่ม	Date	ใช่
yearStart	แบ่งกลุ่มรายงานตามปี แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละปี คอลัมน์นี้แสดงวันแรกของปีของแต่ละแถว	กลุ่ม	Date	ใช่
yearEnd	แบ่งกลุ่มรายงานตามปี แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละปี คอลัมน์นี้แสดงวันสุดท้ายของปีของแต่ละแถว	กลุ่ม	Date	ใช่
deviceSegment	จัดกลุ่มรายงานตามอุปกรณ์ แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยไม่เกิน 1 แถวสําหรับกลุ่มอุปกรณ์แต่ละกลุ่ม คอลัมน์นี้แสดงกลุ่มอุปกรณ์ของแต่ละแถว	กลุ่ม	Device segment	ใช่
floodlightGroup	จัดกลุ่มรายงานตามกลุ่ม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยแบ่งเป็น 1 แถวต่อกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้จะแสดงชื่อกลุ่ม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่
floodlightGroupId	จัดกลุ่มรายงานตามกลุ่ม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยแบ่งเป็น 1 แถวต่อกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้จะแสดงรหัสกลุ่ม DS Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ใช่
floodlightGroupTag	จัดกลุ่มรายงานตามกลุ่ม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยแบ่งเป็น 1 แถวต่อกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้แสดงแท็กกลุ่ม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่
floodlightActivity	จัดกลุ่มรายงานตามกิจกรรม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยไม่เกิน 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้แสดงชื่อกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่
floodlightActivityId	จัดกลุ่มรายงานตามกิจกรรม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยไม่เกิน 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงรหัสกิจกรรม DS Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ใช่
floodlightActivityTag	จัดกลุ่มรายงานตามกิจกรรม Floodlight แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยไม่เกิน 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้แสดงแท็กกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ใช่
accountId	รหัสบัญชีเครื่องมือค้นหา DS	กลุ่ม	ID	ใช่
campaignId	จัดกลุ่มรายงานตามแคมเปญ แถวนี้แสดงรหัสแคมเปญ DS ที่เชื่อมโยงกับแถว	กลุ่ม	ID	ใช่
adGroupId	จัดกลุ่มรายงานตามกลุ่มโฆษณา แถวนี้จะแสดงรหัสกลุ่มโฆษณาที่เชื่อมโยงกับแถว	กลุ่ม	ID	ใช่