Package google.shopping.merchant.reports.v1beta

ดัชนี

ReportService

บริการดึงข้อมูลรายงานและข้อมูลเชิงลึกเกี่ยวกับผลิตภัณฑ์ ประสิทธิภาพ และสภาพแวดล้อมการแข่งขันบน Google

ค้นหา

rpc Search(SearchRequest) returns (SearchResponse)

ดึงข้อมูลรายงานที่กําหนดโดยคําค้นหา การตอบกลับอาจมีแถวน้อยกว่าที่ page_size ระบุ ใช้ next_page_token เพื่อดูว่ามีแถวอื่นที่จะขอหรือไม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

BestSellersBrandView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง best_sellers_brand_view

รายงานสินค้าขายดีที่มีแบรนด์ยอดนิยม

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
report_date

Date

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

  • วันแรกของสัปดาห์ (วันจันทร์) สำหรับรายงานรายสัปดาห์
  • วันแรกของเดือนสำหรับรายงานรายเดือน

ต้องระบุในประโยค SELECT หากไม่ได้ระบุเงื่อนไข WHERE ใน report_date ในข้อความค้นหา ระบบจะแสดงรายงานรายสัปดาห์หรือรายเดือนล่าสุดที่มี

report_granularity

ReportGranularityEnum

รายละเอียดของรายงาน การจัดอันดับอาจใช้เวลา 1 สัปดาห์หรือ 1 เดือน

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_granularity ในประโยค WHERE

report_country_code

string

ประเทศที่คำนวณการจัดอันดับ แสดงในรูปแบบ ISO 3166

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_country_code ในประโยค WHERE

report_category_id

int64

รหัสหมวดหมู่ผลิตภัณฑ์ Google สำหรับคำนวณการจัดอันดับ ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในประโยค SELECT หากไม่ได้ระบุเงื่อนไข WHERE ใน report_category_id ในข้อความค้นหา ระบบจะแสดงผลการจัดอันดับสำหรับหมวดหมู่ระดับบนสุดทั้งหมด

brand

string

ชื่อแบรนด์

rank

int64

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

previous_rank

int64

อันดับความนิยมในสัปดาห์หรือเดือนก่อนหน้า

relative_demand

RelativeDemandEnum

ความต้องการโดยประมาณเมื่อเปรียบเทียบกับแบรนด์ที่มีอันดับความนิยมสูงสุดในหมวดหมู่และประเทศเดียวกัน

previous_relative_demand

RelativeDemandEnum

ความต้องการโดยประมาณเมื่อเปรียบเทียบกับแบรนด์ที่มีอันดับความนิยมสูงสุดในหมวดหมู่และประเทศเดียวกันในสัปดาห์หรือเดือนก่อนหน้า

relative_demand_change

RelativeDemandChangeTypeEnum

การเปลี่ยนแปลงของดีมานด์โดยประมาณ เพิ่มขึ้น ลดลง หรือคงที่

BestSellersProductClusterView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง best_sellers_product_cluster_view

รายงานสินค้าขายดีที่มีคลัสเตอร์ผลิตภัณฑ์ยอดนิยม กลุ่มผลิตภัณฑ์คือการจัดกลุ่มข้อเสนอและผลิตภัณฑ์ย่อยต่างๆ ที่แสดงถึงผลิตภัณฑ์เดียวกัน เช่น Google Pixel 7

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
report_date

Date

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

  • วันแรกของสัปดาห์ (วันจันทร์) สำหรับรายงานรายสัปดาห์
  • วันแรกของเดือนสำหรับรายงานรายเดือน

ต้องระบุในประโยค SELECT หากไม่ได้ระบุเงื่อนไข WHERE ใน report_date ในข้อความค้นหา ระบบจะแสดงรายงานรายสัปดาห์หรือรายเดือนล่าสุดที่มี

variant_gtins[]

string

GTIN ของตัวอย่างผลิตภัณฑ์ย่อยของคลัสเตอร์ผลิตภัณฑ์

report_granularity

ReportGranularityEnum

ความละเอียดของรายงาน การจัดอันดับอาจใช้เวลา 1 สัปดาห์หรือ 1 เดือน

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_granularity ในประโยค WHERE

report_country_code

string

ประเทศที่คำนวณการจัดอันดับ แสดงในรูปแบบ ISO 3166

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_country_code ในประโยค WHERE

report_category_id

int64

รหัสหมวดหมู่ผลิตภัณฑ์ Google สำหรับคำนวณการจัดอันดับ ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในประโยค SELECT หากไม่ได้ระบุเงื่อนไข WHERE ใน report_category_id ในข้อความค้นหา ระบบจะแสดงผลการจัดอันดับสำหรับหมวดหมู่ระดับบนสุดทั้งหมด

title

string

ชื่อของคลัสเตอร์ผลิตภัณฑ์

brand

string

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

category_l1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 1) ของคลัสเตอร์ผลิตภัณฑ์ที่แสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 2) ของคลัสเตอร์ผลิตภัณฑ์ ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 3) ของคลัสเตอร์ผลิตภัณฑ์ ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 4) ของคลัสเตอร์ผลิตภัณฑ์ ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 5) ของคลัสเตอร์ผลิตภัณฑ์ ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

inventory_status

InventoryStatus

คลัสเตอร์ผลิตภัณฑ์เป็น IN_STOCK ในแหล่งข้อมูลผลิตภัณฑ์ของคุณอย่างน้อย 1 ประเทศ OUT_OF_STOCK ในแหล่งข้อมูลผลิตภัณฑ์ของคุณในทุกประเทศ หรือ NOT_IN_INVENTORY เลยหรือไม่

ช่องนี้ไม่ได้พิจารณาตัวกรองประเทศของรายงานสินค้าขายดีด้วย

brand_inventory_status

InventoryStatus

ผลิตภัณฑ์อย่างน้อย 1 รายการของแบรนด์เป็น IN_STOCK ในแหล่งข้อมูลผลิตภัณฑ์ของคุณอย่างน้อย 1 ประเทศ ผลิตภัณฑ์ทั้งหมดเป็น OUT_OF_STOCK ในแหล่งข้อมูลผลิตภัณฑ์ของคุณในทุกประเทศ หรือ NOT_IN_INVENTORY

ช่องนี้ไม่ได้พิจารณาตัวกรองประเทศของรายงานสินค้าขายดีด้วย

rank

int64

ความนิยมของกลุ่มผลิตภัณฑ์ในโฆษณาและแพลตฟอร์มทั่วไปตามหมวดหมู่และประเทศที่เลือกโดยอิงตามจํานวนหน่วยที่ขายโดยประมาณ

previous_rank

int64

อันดับความนิยมในสัปดาห์หรือเดือนก่อนหน้า

relative_demand

RelativeDemandEnum

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

previous_relative_demand

RelativeDemandEnum

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

relative_demand_change

RelativeDemandChangeTypeEnum

การเปลี่ยนแปลงของดีมานด์โดยประมาณ เพิ่มขึ้น ลดลง หรือคงที่

InventoryStatus

สถานะคลัสเตอร์ผลิตภัณฑ์หรือแบรนด์ในสินค้าคงคลัง

Enum
INVENTORY_STATUS_UNSPECIFIED ไม่ได้ระบุ
IN_STOCK คุณมีผลิตภัณฑ์สำหรับกลุ่มผลิตภัณฑ์หรือแบรนด์นี้พร้อมจำหน่าย
OUT_OF_STOCK คุณมีผลิตภัณฑ์สำหรับกลุ่มผลิตภัณฑ์หรือแบรนด์นี้ในสินค้าคงคลัง แต่ขณะนี้ผลิตภัณฑ์หมด
NOT_IN_INVENTORY คุณไม่มีผลิตภัณฑ์สำหรับกลุ่มผลิตภัณฑ์หรือแบรนด์นี้ในสินค้าคงคลัง

CompetitiveVisibilityBenchmarkView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง competitive_visibility_benchmark_view

รายงานการแสดงผลเทียบกับคู่แข่งที่มีข้อมูลเปรียบเทียบของหมวดหมู่

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
date

Date

วันที่ของแถวนี้

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขเกี่ยวกับ date ในประโยค WHERE

report_country_code

string

ประเทศที่การแสดงผลปรากฏ

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_country_code ในประโยค WHERE

report_category_id

int64

รหัสหมวดหมู่ผลิตภัณฑ์ Google สำหรับคำนวณรายงาน ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_category_id ในประโยค WHERE

traffic_source

TrafficSourceEnum

แหล่งที่มาของการเข้าชมของการแสดงผล

ต้องระบุในประโยค SELECT

your_domain_visibility_trend

double

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

กรองในคำสั่ง "WHERE" ไม่ได้

category_benchmark_visibility_trend

double

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

กรองในคำสั่ง "WHERE" ไม่ได้

CompetitiveVisibilityCompetitorView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง competitive_visibility_competitor_view

รายงานการแสดงผลเทียบกับคู่แข่งกับธุรกิจที่มีการแสดงผลคล้ายกัน

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
date

Date

วันที่ของแถวนี้

ต้องมีเงื่อนไขใน date ในประโยค WHERE

domain

string

โดเมนของคู่แข่งหรือโดเมนของคุณ หาก "is_your_domain" เป็นจริง

ต้องระบุในประโยค SELECT กรองในคำสั่ง "WHERE" ไม่ได้

is_your_domain

bool

จริงหากแถวนี้มีข้อมูลสําหรับโดเมนของคุณ

กรองในคำสั่ง "WHERE" ไม่ได้

report_country_code

string

ประเทศที่การแสดงผลปรากฏขึ้น

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_country_code ในประโยค WHERE

report_category_id

int64

รหัสหมวดหมู่ผลิตภัณฑ์ Google สำหรับคำนวณรายงาน ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_category_id ในประโยค WHERE

traffic_source

TrafficSourceEnum

แหล่งที่มาของการเข้าชมของการแสดงผล

ต้องระบุในประโยค SELECT

rank

int64

ตำแหน่งของโดเมนในการจัดอันดับธุรกิจที่คล้ายกันสำหรับคีย์ที่เลือก (date, report_category_id, report_country_code, traffic_source) โดยอิงตามการแสดงผล โดย 1 คือค่าสูงสุด

กรองในคำสั่ง "WHERE" ไม่ได้

ads_organic_ratio

double

อัตราส่วนโฆษณา / การค้นหาทั่วไปจะแสดงความถี่ที่โดเมนได้รับการแสดงผลจากโฆษณา Shopping เทียบกับการเข้าชมจากการค้นหาทั่วไป ระบบจะปัดเศษและจัดกลุ่มตัวเลข

กรองในคำสั่ง "WHERE" ไม่ได้

page_overlap_rate

double

อัตราการแสดงผลพร้อมกันของหน้าเว็บจะแสดงความถี่ที่ข้อเสนอของผู้ค้าปลีกคู่แข่งแสดงพร้อมกับข้อเสนอของคุณในหน้าเว็บเดียวกัน

กรองในคำสั่ง "WHERE" ไม่ได้

higher_position_rate

double

อัตราสำหรับอันดับที่สูงกว่าจะแสดงความถี่ที่ข้อเสนอของคู่แข่งอยู่ในอันดับที่สูงกว่าข้อเสนอของคุณในหน้าเว็บ

กรองในคำสั่ง "WHERE" ไม่ได้

relative_visibility

double

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

กรองในคำสั่ง "WHERE" ไม่ได้

CompetitiveVisibilityTopMerchantView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง competitive_visibility_top_merchant_view

รายงานการแสดงผลเทียบกับคู่แข่งที่มีธุรกิจที่มีการแสดงผลสูงสุด

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
date

Date

วันที่ของแถวนี้

เลือกในประโยค SELECT ไม่ได้ ต้องมีเงื่อนไขเกี่ยวกับ date ในประโยค WHERE

domain

string

โดเมนของคู่แข่งหรือโดเมนของคุณ หาก "is_your_domain" เป็นจริง

ต้องระบุในประโยค SELECT กรองในคำสั่ง "WHERE" ไม่ได้

is_your_domain

bool

จริงหากแถวนี้มีข้อมูลสําหรับโดเมนของคุณ

กรองในคำสั่ง "WHERE" ไม่ได้

report_country_code

string

ประเทศที่การแสดงผลปรากฏขึ้น

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_country_code ในประโยค WHERE

report_category_id

int64

รหัสหมวดหมู่ผลิตภัณฑ์ Google สำหรับคำนวณรายงาน ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในประโยค SELECT ต้องมีเงื่อนไขใน report_category_id ในประโยค WHERE

traffic_source

TrafficSourceEnum

แหล่งที่มาของการเข้าชมของการแสดงผล

ต้องระบุในประโยค SELECT

rank

int64

ตำแหน่งของโดเมนในการจัดอันดับผู้ขายรายใหญ่สำหรับคีย์ที่เลือก (date, report_category_id, report_country_code, traffic_source) โดยอิงตามการแสดงผล โดย 1 คือค่าสูงสุด

กรองในคำสั่ง "WHERE" ไม่ได้

ads_organic_ratio

double

อัตราส่วนโฆษณา / การค้นหาทั่วไปจะแสดงความถี่ที่โดเมนได้รับการแสดงผลจากโฆษณา Shopping เทียบกับการเข้าชมจากการค้นหาทั่วไป ระบบจะปัดเศษและจัดกลุ่มตัวเลข

กรองในคำสั่ง "WHERE" ไม่ได้

page_overlap_rate

double

อัตราการแสดงผลพร้อมกันของหน้าเว็บจะแสดงความถี่ที่ข้อเสนอของผู้ค้าปลีกคู่แข่งแสดงพร้อมกับข้อเสนอของคุณในหน้าเว็บเดียวกัน

กรองในคำสั่ง "WHERE" ไม่ได้

higher_position_rate

double

อัตราสำหรับอันดับที่สูงกว่าจะแสดงความถี่ที่ข้อเสนอของคู่แข่งอยู่ในอันดับที่สูงกว่าข้อเสนอของคุณในหน้าเว็บ

กรองในคำสั่ง "WHERE" ไม่ได้

MarketingMethod

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

วิธีการทางการตลาดที่ใช้โปรโมตผลิตภัณฑ์บน Google (การค้นหาทั่วไปเทียบกับโฆษณา)

MarketingMethodEnum

ค่าของวิธีทางการตลาด

Enum
MARKETING_METHOD_ENUM_UNSPECIFIED ไม่ได้ระบุ
ORGANIC การตลาดแบบทั่วไป
ADS การตลาดที่อิงตามโฆษณา

NonProductPerformanceView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง non_product_performance_view

ข้อมูลประสิทธิภาพเกี่ยวกับรูปภาพและลิงก์ร้านค้าออนไลน์ที่นำไปสู่หน้าเว็บที่ไม่เกี่ยวข้องกับผลิตภัณฑ์ ซึ่งรวมถึงเมตริกประสิทธิภาพ (เช่น clicks) และมิติข้อมูลตามการแบ่งกลุ่มเมตริกประสิทธิภาพ (เช่น date)

คุณไม่สามารถเลือกฟิลด์กลุ่มในคําค้นหาโดยไม่เลือกฟิลด์เมตริกอย่างน้อย 1 รายการด้วย

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
date

Date

วันที่ตามเขตเวลาของผู้ขายซึ่งเมตริกมีผล กลุ่ม

ต้องมีเงื่อนไขใน date ในประโยค WHERE

week

Date

วันแรกของสัปดาห์ (วันจันทร์) ของวันที่เมตริกในเขตเวลาของผู้ขาย กลุ่ม

clicks

int64

จำนวนการคลิกรูปภาพและลิงก์ร้านค้าออนไลน์ที่นำไปสู่หน้าที่ไม่ใช่หน้าผลิตภัณฑ์ เมตริก

impressions

int64

จำนวนครั้งที่รูปภาพและลิงก์ร้านค้าออนไลน์ที่นำไปสู่หน้าที่ไม่เกี่ยวข้องกับผลิตภัณฑ์แสดง เมตริก

click_through_rate

double

อัตราการคลิกผ่าน - จำนวนคลิก (clicks) หารด้วยจำนวนการแสดงผล (impressions) ของรูปภาพและลิงก์ร้านค้าออนไลน์ที่นำไปสู่หน้าเว็บที่ไม่เกี่ยวข้องกับผลิตภัณฑ์ เมตริก

PriceCompetitivenessProductView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง price_competitiveness_product_view

รายงานความสามารถในการแข่งขันด้านราคา

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
price

Price

ราคาปัจจุบันของผลิตภัณฑ์

benchmark_price

Price

ข้อมูลเปรียบเทียบราคาล่าสุดสำหรับแคตตาล็อกของผลิตภัณฑ์ในประเทศที่เปรียบเทียบ

report_country_code

string

ประเทศของการเปรียบเทียบราคา แสดงในรูปแบบ ISO 3166

ต้องระบุในประโยค SELECT

id

string

รหัส REST ของผลิตภัณฑ์ในรูปแบบ channel~languageCode~feedLabel~offerId ใช้เพื่อรวมข้อมูลกับตาราง product_view ได้

ต้องระบุในประโยค SELECT

offer_id

string

รหัสผลิตภัณฑ์ที่ผู้ขายระบุ

title

string

ชื่อผลิตภัณฑ์

brand

string

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

category_l1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

product_type_l1

string

ประเภทผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l2

string

ประเภทผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l3

string

ประเภทผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l4

string

ประเภทผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l5

string

ประเภทผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

PriceInsightsProductView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง price_insights_product_view

รายงานข้อมูลเชิงลึกด้านราคา

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
price

Price

ราคาปัจจุบันของผลิตภัณฑ์

suggested_price

Price

ราคาแนะนำล่าสุดสำหรับผลิตภัณฑ์

effectiveness

Effectiveness

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

id

string

รหัส REST ของผลิตภัณฑ์ในรูปแบบ channel~languageCode~feedLabel~offerId ใช้เพื่อรวมข้อมูลกับตาราง product_view ได้

ต้องระบุในประโยค SELECT

offer_id

string

รหัสผลิตภัณฑ์ที่ผู้ขายระบุ

title

string

ชื่อผลิตภัณฑ์

brand

string

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

category_l1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

product_type_l1

string

ประเภทผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l2

string

ประเภทผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l3

string

ประเภทผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l4

string

ประเภทผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l5

string

ประเภทผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

predicted_impressions_change_fraction

double

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

predicted_clicks_change_fraction

double

การเปลี่ยนแปลงที่คาดการณ์ของการคลิกเป็นเศษส่วนหลังจากเปิดตัวราคาที่แนะนำเทียบกับราคาที่ใช้งานอยู่ในปัจจุบัน เช่น 0.05 หมายถึงการคลิกที่คาดว่าจะเพิ่มขึ้น 5%

predicted_conversions_change_fraction

double

การเปลี่ยนแปลงที่คาดการณ์ไว้ของ Conversion เป็นเศษส่วนหลังจากเปิดตัวราคาที่แนะนำเทียบกับราคาที่มีผลใช้งานอยู่ในปัจจุบัน เช่น 0.05 คือ Conversion ที่คาดว่าจะเพิ่มขึ้น 5%)

ประสิทธิภาพ

ที่เก็บข้อมูลประสิทธิภาพที่คาดการณ์ไว้

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

Enum
EFFECTIVENESS_UNSPECIFIED ไม่ทราบประสิทธิภาพ
LOW ประสิทธิผลต่ำ
MEDIUM ประสิทธิภาพปานกลาง
HIGH มีประสิทธิภาพสูง

ProductPerformanceView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง product_performance_view

ข้อมูลประสิทธิภาพผลิตภัณฑ์ของบัญชี ซึ่งรวมถึงเมตริกประสิทธิภาพ (เช่น clicks) และมิติข้อมูลตามที่มีการแบ่งกลุ่มเมตริกประสิทธิภาพ (เช่น offer_id) ค่าของมิติข้อมูลผลิตภัณฑ์ เช่น offer_id จะแสดงสถานะของผลิตภัณฑ์ ณ เวลาที่แสดงผล

คุณไม่สามารถเลือกฟิลด์กลุ่มในคําค้นหาโดยไม่เลือกฟิลด์เมตริกอย่างน้อย 1 รายการด้วย

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
date

Date

วันที่ตามเขตเวลาของผู้ขายซึ่งเมตริกมีผล กลุ่ม

ต้องมีเงื่อนไขใน date ในประโยค WHERE

week

Date

วันแรกของสัปดาห์ (วันจันทร์) ของวันที่เมตริกในเขตเวลาของผู้ขาย กลุ่ม

conversion_value

Price

มูลค่าของ Conversion ที่มาจากผลิตภัณฑ์ ซึ่งรายงานในวันที่เกิด Conversion เมตริก

ใช้ได้กับแหล่งที่มาของการเข้าชม FREE เท่านั้น

marketing_method

MarketingMethodEnum

วิธีทางการตลาดที่ใช้กับเมตริก กลุ่ม

customer_country_code

string

รหัสประเทศที่ลูกค้าอยู่ขณะที่มีเหตุการณ์ แสดงในรูปแบบ ISO 3166 กลุ่ม

หากไม่สามารถระบุประเทศของลูกค้าได้ ระบบจะแสดงรหัส "ZZ" พิเศษ

offer_id

string

รหัสผลิตภัณฑ์ที่ผู้ขายระบุ กลุ่ม

title

string

ชื่อผลิตภัณฑ์ กลุ่ม

brand

string

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

category_l1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม

category_l2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม

category_l3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม

category_l4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม

category_l5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม

product_type_l1

string

ประเภทผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม

product_type_l2

string

ประเภทผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม

product_type_l3

string

ประเภทผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม

product_type_l4

string

ประเภทผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม

product_type_l5

string

ประเภทผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม

custom_label0

string

ป้ายที่กำหนดเอง 0 สำหรับการจัดกลุ่มผลิตภัณฑ์ที่กำหนดเอง กลุ่ม

custom_label1

string

ป้ายกํากับที่กําหนดเอง 1 สําหรับการจัดกลุ่มผลิตภัณฑ์ที่กําหนดเอง กลุ่ม

custom_label2

string

ป้ายกํากับที่กําหนดเอง 2 สําหรับการจัดกลุ่มผลิตภัณฑ์ที่กําหนดเอง กลุ่ม

custom_label3

string

ป้ายกํากับที่กําหนดเอง 3 สําหรับการจัดกลุ่มผลิตภัณฑ์ที่กําหนดเอง กลุ่ม

custom_label4

string

ป้ายกํากับที่กําหนดเอง 4 สําหรับการจัดกลุ่มผลิตภัณฑ์ที่กําหนดเอง กลุ่ม

clicks

int64

จํานวนคลิก เมตริก

impressions

int64

จำนวนครั้งที่ระบบแสดงผลิตภัณฑ์ของผู้ขาย เมตริก

click_through_rate

double

อัตราการคลิกผ่าน - จำนวนคลิกที่ผลิตภัณฑ์ของผู้ขายได้รับ (การคลิก) หารด้วยจำนวนครั้งที่ผลิตภัณฑ์แสดง (การแสดงผล) เมตริก

conversions

double

จํานวน Conversion ที่มาจากผลิตภัณฑ์ ซึ่งรายงานในวันที่เกิด Conversion Conversion อาจกระจายไปยังการคลิกหลายรายการ โดยแต่ละคลิกจะได้รับเครดิตของตัวเอง ทั้งนี้ขึ้นอยู่กับรูปแบบการระบุแหล่งที่มา เมตริกนี้เป็นผลรวมของเครดิตทั้งหมดดังกล่าว เมตริก

ใช้ได้กับแหล่งที่มาของการเข้าชม FREE เท่านั้น

conversion_rate

double

จํานวน Conversion หารด้วยจํานวนคลิกที่รายงานในวันที่แสดงผล เมตริก

ใช้ได้กับแหล่งที่มาของการเข้าชม FREE เท่านั้น

ProductView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง product_view

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

ระบบจะตั้งค่าเฉพาะสำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอ

ช่อง
price

Price

ราคาผลิตภัณฑ์ ไม่มีหากไม่มีข้อมูลเกี่ยวกับราคาของผลิตภัณฑ์

gtin[]

string

รายการหมายเลขสินค้าการค้าสากล (GTIN) ของผลิตภัณฑ์

creation_time

Timestamp

เวลาที่ผู้ขายสร้างผลิตภัณฑ์เป็นวินาทีของการประทับเวลา

expiration_date

Date

วันที่หมดอายุของผลิตภัณฑ์ที่ระบุไว้เมื่อแทรก

item_issues[]

ItemIssue

รายการปัญหาเกี่ยวกับสินค้าของผลิตภัณฑ์

ใช้ช่องนี้เพื่อจัดเรียงผลลัพธ์ไม่ได้

มีเพียงแอตทริบิวต์ที่เลือกของช่องนี้ (เช่น item_issues.severity.aggregated_severity) เท่านั้นที่ใช้กรองผลลัพธ์ได้

click_potential

ClickPotential

ประสิทธิภาพที่เป็นไปได้โดยประมาณเมื่อเทียบกับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย

id

string

รหัส REST ของผลิตภัณฑ์ในรูปแบบ channel~languageCode~feedLabel~offerId เมธอด Merchant API ที่ดำเนินการกับผลิตภัณฑ์จะใช้พารามิเตอร์ name นี้

ต้องระบุในประโยค SELECT

channel

ChannelEnum

ช่องทางของผลิตภัณฑ์ อาจเป็น ONLINE หรือ LOCAL

language_code

string

รหัสภาษาของผลิตภัณฑ์ในรูปแบบ BCP 47

feed_label

string

ป้ายกำกับฟีดของผลิตภัณฑ์

offer_id

string

รหัสผลิตภัณฑ์ที่ผู้ขายระบุ

title

string

ชื่อผลิตภัณฑ์

brand

string

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

category_l1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

category_l5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

product_type_l1

string

ประเภทผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l2

string

ประเภทผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l3

string

ประเภทผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l4

string

ประเภทผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

product_type_l5

string

ประเภทผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

condition

string

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

availability

string

ความพร้อมจำหน่ายผลิตภัณฑ์

shipping_label

string

ป้ายกำกับการจัดส่งที่แปลงค่าให้เป็นมาตรฐานซึ่งระบุไว้ในแหล่งข้อมูล

item_group_id

string

รหัสกลุ่มสินค้าที่ผู้ขายระบุไว้สำหรับการจัดกลุ่มผลิตภัณฑ์ย่อยไว้ด้วยกัน

aggregated_reporting_context_status

AggregatedReportingContextStatus

สถานะรวม

click_potential_rank

int64

อันดับของผลิตภัณฑ์ตามโอกาสที่จะได้รับคลิก ผลิตภัณฑ์ที่มี click_potential_rank 1 มีแนวโน้มที่จะได้รับคลิกสูงสุดในบรรดาผลิตภัณฑ์ของผู้ขายที่ตรงกับเงื่อนไขข้อความค้นหา

AggregatedReportingContextStatus

สถานะของผลิตภัณฑ์ที่รวบรวมสําหรับบริบทการรายงานทั้งหมด

ต่อไปนี้คือตัวอย่างวิธีคํานวณสถานะแบบรวม

ข้อมูลที่แสดงฟรี โฆษณา Shopping สถานะ
อนุมัติแล้ว อนุมัติแล้ว มีสิทธิ์
อนุมัติแล้ว รอดำเนินการ มีสิทธิ์
อนุมัติแล้ว ไม่อนุมัติ ELIGIBLE_LIMITED
รอดำเนินการ รอดำเนินการ รอดำเนินการ
ไม่อนุมัติ ไม่อนุมัติ NOT_ELIGIBLE_OR_DISAPPROVED
Enum
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED ไม่ได้ระบุ
NOT_ELIGIBLE_OR_DISAPPROVED ผลิตภัณฑ์ไม่มีสิทธิ์หรือไม่ได้รับอนุมัติสําหรับบริบทการรายงานทั้งหมด
PENDING สถานะของผลิตภัณฑ์อยู่ระหว่างรอดำเนินการในบริบทการรายงานทั้งหมด
ELIGIBLE_LIMITED ผลิตภัณฑ์มีสิทธิ์สำหรับบริบทการรายงานบางรายการ (แต่ไม่ใช่ทั้งหมด)
ELIGIBLE ผลิตภัณฑ์มีสิทธิ์สำหรับบริบทการรายงานทั้งหมด

ClickPotential

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

Enum
CLICK_POTENTIAL_UNSPECIFIED ผลกระทบของการคลิกที่คาดการณ์ซึ่งไม่ทราบ
LOW มีโอกาสที่จะได้รับยอดคลิกน้อยเมื่อเทียบกับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย
MEDIUM มีโอกาสที่จะได้รับยอดคลิกปานกลางเมื่อเทียบกับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย
HIGH มีโอกาสได้รับยอดคลิกเท่ากับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย

ItemIssue

ปัญหาเกี่ยวกับสินค้าที่เกี่ยวข้องกับผลิตภัณฑ์

ช่อง
type

ItemIssueType

ประเภทปัญหาของสินค้า

severity

ItemIssueSeverity

ความรุนแรงของปัญหาเกี่ยวกับสินค้า

resolution

ItemIssueResolution

การแก้ไขปัญหาเกี่ยวกับสินค้า

ItemIssueResolution

วิธีแก้ไขปัญหา

Enum
ITEM_ISSUE_RESOLUTION_UNSPECIFIED ไม่ได้ระบุ
MERCHANT_ACTION ผู้ขายต้องแก้ไขปัญหา
PENDING_PROCESSING ปัญหาจะได้รับการแก้ไขโดยอัตโนมัติ (เช่น การ Crawl รูปภาพ) หรือผ่านการตรวจสอบของ Google ผู้ขายไม่จำเป็นต้องดำเนินการใดๆ ในขณะนี้ การแก้ไขอาจทำให้เกิดปัญหาอื่น (เช่น ทำการ Crawl ไม่สำเร็จ)

ItemIssueSeverity

ปัญหาส่งผลต่อการแสดงผลิตภัณฑ์อย่างไร

ช่อง
severity_per_reporting_context[]

IssueSeverityPerReportingContext

ความรุนแรงของปัญหาตามบริบทการรายงาน

aggregated_severity

AggregatedIssueSeverity

ความรุนแรงที่รวมของปัญหาสําหรับบริบทการรายงานทั้งหมดที่ได้รับผลกระทบ

ช่องนี้ใช้กรองผลลัพธ์ได้

AggregatedIssueSeverity

ความรุนแรงของปัญหาที่รวบรวมสำหรับบริบทการรายงานทั้งหมด

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED ไม่ได้ระบุ
DISAPPROVED ปัญหาทำให้ผลิตภัณฑ์ไม่ได้รับอนุมัติในบริบทการรายงานอย่างน้อย 1 รายการ
DEMOTED ปัญหาจะลดระดับผลิตภัณฑ์ในบริบทการรายงานทั้งหมดที่ได้รับผลกระทบ
PENDING การแก้ปัญหาคือ PENDING_PROCESSING

IssueSeverityPerReportingContext

ความรุนแรงของปัญหาตามบริบทการรายงาน

ช่อง
disapproved_countries[]

string

รายชื่อประเทศที่ไม่ได้รับอนุมัติในบริบทการรายงาน ซึ่งแสดงในรูปแบบ ISO 3166

demoted_countries[]

string

รายชื่อประเทศที่ถูกลดระดับในบริบทการรายงาน ซึ่งแสดงในรูปแบบ ISO 3166

reporting_context

ReportingContextEnum

บริบทการรายงานที่มีปัญหา

ItemIssueType

ประเภทปัญหา

ช่อง
code

string

รหัสข้อผิดพลาดของปัญหา ซึ่งเทียบเท่ากับ code ของปัญหาเกี่ยวกับผลิตภัณฑ์

canonical_attribute

string

ชื่อแอตทริบิวต์ตามแบบฉบับสำหรับปัญหาเฉพาะแอตทริบิวต์

RelativeDemand

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

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

RelativeDemandEnum

ค่าดีมานด์แบบสัมพัทธ์

Enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED ไม่ได้ระบุ
VERY_LOW ความต้องการคิดเป็น 0-5% ของความต้องการคลัสเตอร์ผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด
LOW ความต้องการคิดเป็น 6-10% ของความต้องการคลัสเตอร์หรือแบรนด์ผลิตภัณฑ์ที่มีอันดับสูงสุด
MEDIUM ความต้องการคิดเป็น 11-20% ของความต้องการคลัสเตอร์ผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด
HIGH ความต้องการคิดเป็น 21-50% ของความต้องการคลัสเตอร์ผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด
VERY_HIGH ความต้องการคิดเป็น 51-100% ของความต้องการคลัสเตอร์ผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด

RelativeDemandChangeType

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

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

RelativeDemandChangeTypeEnum

ค่าประเภทการเปลี่ยนแปลงของดีมานด์แบบสัมพัทธ์

Enum
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED ไม่ได้ระบุ
SINKER ความต้องการแบบสัมพัทธ์ต่ำกว่าระยะเวลาก่อนหน้า
FLAT ความต้องการแบบสัมพัทธ์เท่ากับระยะเวลาก่อนหน้า
RISER ความต้องการแบบสัมพัทธ์สูงกว่าระยะเวลาก่อนหน้า

ReportGranularity

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

รายละเอียดของรายงานสินค้าขายดี รายงานสินค้าขายดีจะคํานวณจากกรอบเวลา 1 สัปดาห์และ 1 เดือน

ReportGranularityEnum

ค่าความละเอียดของรายงาน

Enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED ไม่ได้ระบุ
WEEKLY ระบบจะคํานวณรายงานในกรอบเวลา 1 สัปดาห์
MONTHLY ระบบจะคํานวณรายงานในกรอบเวลา 1 เดือน

ReportRow

แถวผลลัพธ์ที่แสดงผลจากคำค้นหา

ระบบจะป้อนข้อมูลเฉพาะข้อความที่เกี่ยวข้องกับตารางที่ค้นหาไว้ในคำตอบ ภายในข้อความที่สร้างขึ้น จะมีเพียงช่องที่ขออย่างชัดเจนในการค้นหาเท่านั้นที่สร้างขึ้น

ช่อง
product_performance_view

ProductPerformanceView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง product_performance_view

non_product_performance_view

NonProductPerformanceView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง non_product_performance_view

product_view

ProductView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง product_view

price_competitiveness_product_view

PriceCompetitivenessProductView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง price_competitiveness_product_view

price_insights_product_view

PriceInsightsProductView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง price_insights_product_view

best_sellers_product_cluster_view

BestSellersProductClusterView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง best_sellers_product_cluster_view

best_sellers_brand_view

BestSellersBrandView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง best_sellers_brand_view

competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง competitive_visibility_competitor_view

competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง competitive_visibility_top_merchant_view

competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

ฟิลด์ที่ใช้ค้นหาได้ในตาราง competitive_visibility_benchmark_view

SearchRequest

คำขอข้อความสำหรับเมธอด ReportService.Search

ช่อง
parent

string

ต้องระบุ รหัสของบัญชีที่โทร ต้องเป็นบัญชีแบบสแตนด์อโลนหรือบัญชีย่อย MCA รูปแบบ: accounts/{account}

query

string

ต้องระบุ คําค้นหาที่กําหนดรายงานที่จะดึงข้อมูล

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

page_size

int32

ไม่บังคับ จำนวน ReportRows ที่จะดึงข้อมูลในหน้าเดียว ค่าเริ่มต้นคือ 1,000 ระบบจะเปลี่ยนค่าที่เกิน 5,000 เป็น 5,000

page_token

string

ไม่บังคับ โทเค็นของหน้าที่จะดึงข้อมูล หากไม่ระบุ ระบบจะแสดงหน้าแรกของผลการค้นหา หากต้องการขอหน้าถัดไปของผลการค้นหา คุณควรใช้ค่าที่ได้รับจาก next_page_token ในการตอบกลับก่อนหน้า

SearchResponse

ข้อความตอบกลับสําหรับเมธอด ReportService.Search

ช่อง
results[]

ReportRow

แถวที่ตรงกับคำค้นหา

next_page_token

string

โทเค็นที่ส่งเป็น page_token เพื่อเรียกข้อมูลหน้าถัดไปได้ หากไม่ระบุ ระบบจะไม่สร้างหน้าต่อๆ ไป

TrafficSource

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

แหล่งที่มาของการเข้าชมของการแสดงผลในรายงานการแสดงผลเทียบกับคู่แข่ง

TrafficSourceEnum

มูลค่าแหล่งที่มาของการเข้าชม

Enum
TRAFFIC_SOURCE_ENUM_UNSPECIFIED ไม่ได้ระบุ
ORGANIC การเข้าชมจากการค้นหาทั่วไป
ADS การเข้าชมจากโฆษณา
ALL การเข้าชมจากการค้นหาทั่วไปและการเข้าชมจากโฆษณา