หน้านี้ได้รับการแปลโดย Cloud Translation API

การรายงาน

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

รายงานบัญชี

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

หากต้องการรับรายงาน ให้ส่งคำขอ HTTP GET ไปยัง https://localservices.googleapis.com/v1/accountReports:search โดยมีพารามิเตอร์ของ URL ที่กำหนดค่าได้ต่อไปนี้

พารามิเตอร์ URL
`query`	จำเป็น มีค่ารหัสอย่างน้อย 1 ค่า ซึ่งค่าใดค่าหนึ่งต้องเป็นรหัสของ บัญชีดูแลจัดการสำหรับการค้นหา `query` รับค่าที่คั่นด้วยเครื่องหมาย อัฒภาคได้หลายค่า จำเป็น: `manager_customer_id:<manager_cid>` ไม่บังคับ: `customer_id:<linked_cid>` ตัวอย่าง `query=manager_customer_id:123;customer_id:456`
`startDate.day`	ไม่บังคับ วันที่ของเดือนที่ระยะเวลาการรายงานเริ่มต้น สามารถใช้ค่าระหว่าง `1` ถึง `31` ค่าเริ่มต้น คือ `1`
`startDate.month`	ไม่บังคับ เดือนเริ่มต้นของระยะเวลาการรายงาน โดยอาจมีค่าระหว่าง `1` ถึง `12` ค่าเริ่มต้นคือเดือนปัจจุบัน
`startDate.year`	ไม่บังคับ ปีที่ระยะเวลารายงานเริ่มต้นในรูปแบบ `YYYY` ค่าเริ่มต้นคือปีปัจจุบัน
`endDate.day`	ไม่บังคับ วันที่ของเดือนที่ระยะเวลาการรายงานสิ้นสุด โดยอาจมีค่า ระหว่าง `1` ถึง `31` ค่าเริ่มต้นคือ วันที่ปัจจุบัน
`endDate.month`	ไม่บังคับ เดือนที่ระยะเวลาการรายงานสิ้นสุด โดยอาจมีค่าระหว่าง `1` ถึง `12` ค่าเริ่มต้นคือเดือนปัจจุบัน
`endDate.year`	ไม่บังคับ ปีที่ระยะเวลาการรายงานสิ้นสุดในรูปแบบ `YYYY` ค่าเริ่มต้นคือปีปัจจุบัน
`pageSize`	ไม่บังคับ จำนวนเต็มบวกที่ระบุจำนวนรายการที่จะแสดงผล ค่าเริ่มต้นคือ `1000` และค่าสูงสุดคือ `10000`
`pageToken`	ไม่บังคับ สตริง ป้อน `next_page_token` จากคำตอบก่อนหน้า ในช่องนี้

ระบบจะใช้ฟิลด์ในตารางก่อนหน้าเพื่อสร้าง SearchAccountReportsRequest สำหรับรหัสลูกค้าแต่ละรายการในคำขอ ระบบจะรวม AccountReportsที่เกี่ยวข้องไว้ใน SearchAccountReportsResponse รายงานบัญชีแต่ละรายการจะแมปแบบหนึ่งต่อหนึ่งกับบัญชีลูกค้าที่ลิงก์ซึ่งแสดงโฆษณาบริการในพื้นที่

ตารางต่อไปนี้แสดงช่องใน AccountReports

ช่อง
`accountId`	รหัสลูกค้าที่ลิงก์กับบัญชีบริการในพื้นที่
`businessName`	ชื่อธุรกิจของลูกค้า
`averageWeeklyBudget`	งบประมาณรายสัปดาห์เฉลี่ยปัจจุบันของลูกค้า
`averageFiveStarRating`	คะแนนเฉลี่ย 5 ดาว ซึ่งคำนวณจากรีวิวทั้งหมดที่มีของลูกค้า
`totalReview`	จำนวนรีวิวทั้งหมดที่ลูกค้าดูได้
`impressionsLastTwoDays`	จำนวนการแสดงผลทั้งหมดที่บัญชีได้รับในช่วง 2 วันที่ผ่านมา
`phoneLeadResponsiveness`	การตอบสนองต่อโอกาสในการขายทางโทรศัพท์ของบัญชีในช่วง 90 วันที่ผ่านมา ในการคำนวณนี้ ระบบจะนำจำนวนการโทรที่เชื่อมต่อทั้งหมดจากโอกาสในการขายทางโทรศัพท์ที่เรียกเก็บเงิน มาหารด้วยจำนวนการโทรทั้งหมดที่ได้รับ
`currentPeriodChargedLeads`	จำนวนโอกาสในการขายที่เรียกเก็บเงินในช่วงวันที่ที่ระบุ
`previousPeriodChargedLeads`	จำนวนโอกาสในการขายที่เรียกเก็บเงินในช่วงก่อนหน้า เช่น หากตั้งค่า ช่วงวันที่เป็น 21-30 มกราคม ระยะเวลาก่อนหน้า จะเป็น 11-20 มกราคม
`currentPeriodTotalCost`	ผลรวมของต้นทุนจากโอกาสในการขายที่เรียกเก็บเงินในช่วงวันที่ที่ระบุ
`previousPeriodTotalCost`	ผลรวมของต้นทุนจากโอกาสในการขายที่เรียกเก็บเงินในช่วงก่อนหน้า ตัวอย่างเช่น หากตั้งค่าช่วงวันที่เป็น 21-30 มกราคม ระยะเวลาก่อนหน้าจะเป็น 11-20 มกราคม
`currencyCode`	รหัสสกุลเงินของบัญชีลูกค้า
`currentPeriodPhoneCalls`	จำนวนการโทรในช่วงวันที่ที่ระบุ ทั้งที่ เชื่อมต่อและไม่ได้เชื่อมต่อ
`previousPeriodPhoneCalls`	จำนวนการโทรในช่วงก่อนหน้า ทั้งที่โทรติดและ โทรไม่ติด
`currentPeriodConnectedPhoneCalls`	จำนวนการโทรที่เชื่อมต่อในช่วงวันที่ที่ระบุ ซึ่งมีระยะเวลานานกว่า 30 วินาที
`previousPeriodConnectedPhoneCalls`	จํานวนการโทรที่เชื่อมต่อในระยะเวลาก่อนหน้าซึ่งมีระยะเวลานานกว่า 30 วินาที

ตัวอย่าง

URL ของคำขอ HTTP

https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:{manager_customer_id}

ตัวอย่างคำขอ HTTP ที่สมบูรณ์

GET /v1/accountReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]

รายงานโอกาสในการขายแบบละเอียด

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

หากต้องการรับรายงาน ให้ส่งคำขอ HTTP GET ไปยัง https://localservices.googleapis.com/v1/detailedLeadReports:search โดยมีพารามิเตอร์ของ URL ที่กำหนดค่าได้ต่อไปนี้

พารามิเตอร์ URL
`query`	จำเป็น มีค่ารหัสอย่างน้อย 1 ค่า ซึ่งค่าใดค่าหนึ่งต้องเป็นรหัสของ บัญชีดูแลจัดการสำหรับการค้นหา `query` รับค่าที่คั่นด้วยเครื่องหมาย อัฒภาคได้หลายค่า จำเป็น: `manager_customer_id:<manager_cid>` ไม่บังคับ: `customer_id:<linked_cid>` ตัวอย่าง `query=manager_customer_id:123;customer_id:456`
`startDate.day`	ไม่บังคับ วันที่ของเดือนที่ระยะเวลาการรายงานเริ่มต้น สามารถใช้ค่าระหว่าง `1` ถึง `31` ค่าเริ่มต้น คือ `1`
`startDate.month`	ไม่บังคับ เดือนเริ่มต้นของระยะเวลาการรายงาน โดยอาจมีค่าระหว่าง `1` ถึง `12` ค่าเริ่มต้นคือเดือนปัจจุบัน
`startDate.year`	ไม่บังคับ ปีที่ระยะเวลารายงานเริ่มต้นในรูปแบบ `YYYY` ค่าเริ่มต้นคือปีปัจจุบัน
`endDate.day`	ไม่บังคับ วันที่ของเดือนที่ระยะเวลาการรายงานสิ้นสุด โดยอาจมีค่า ระหว่าง `1` ถึง `31` ค่าเริ่มต้นคือ วันที่ปัจจุบัน
`endDate.month`	ไม่บังคับ เดือนที่ระยะเวลาการรายงานสิ้นสุด โดยอาจมีค่าระหว่าง `1` ถึง `12` ค่าเริ่มต้นคือเดือนปัจจุบัน
`endDate.year`	ไม่บังคับ ปีที่ระยะเวลาการรายงานสิ้นสุดในรูปแบบ `YYYY` ค่าเริ่มต้นคือปีปัจจุบัน
`pageSize`	ไม่บังคับ จำนวนเต็มบวกที่ระบุจำนวนรายการที่จะแสดงผล ค่าเริ่มต้นคือ `1000` และค่าสูงสุดคือ `10000`
`pageToken`	ไม่บังคับ สตริง ป้อน `next_page_token` จากคำตอบก่อนหน้า ในช่องนี้

ระบบจะใช้ฟิลด์ก่อนหน้าเพื่อสร้าง SearchDetailedLeadReportsRequest สำหรับรหัสลูกค้าแต่ละรายการในคำขอ ระบบจะรวม DetailedLeadReports ที่เกี่ยวข้องไว้ใน SearchDetailedLeadReportsResponse รายงานโอกาสในการขายแบบละเอียดแต่ละรายการจะจับคู่แบบหนึ่งต่อหนึ่งกับโอกาสในการขายที่เฉพาะเจาะจงซึ่งเชื่อมโยงกับบัญชีลูกค้าที่ลิงก์ไว้ ซึ่งแสดงโฆษณาบริการในพื้นที่

ตารางต่อไปนี้แสดงช่องใน DetailedLeadReports

ช่อง
`leadId`	ตัวระบุที่ไม่ซ้ำกันของโอกาสในการขาย
`accountId`	ระบุบัญชีที่ได้รับโอกาสในการขาย
`businessName`	ชื่อธุรกิจที่เชื่อมโยงกับบัญชี
`leadCreationTimestamp`	การประทับเวลาของเวลาที่สร้างโอกาสในการขาย ประกอบด้วยวันที่ในรูปแบบ `M/D/YYYY` และเวลาในรูปแบบ `HH:MM:SS` ตัวอย่าง: `11/1/2019 12:13:20`
`leadType`	ประเภทโอกาสในการขาย: `MESSAGE` หรือ `PHONE_CALL`
`leadCategory`	หมวดหมู่บริการที่เชื่อมโยงกับโอกาสในการขาย ตัวอย่าง: `housecleaner`
`geo`	สถานที่ตั้งของเมืองบ้านเกิดของบัญชีที่เชื่อมโยง ตัวอย่าง: `San Francisco, California, United States`
`messageLead`	ข้อมูลที่เชื่อมโยงกับโอกาสในการขายที่มาจากข้อความเท่านั้น `customerName`, `jobType` `postalCode` และ `consumerPhoneNumber`
`phoneLead`	ข้อมูลที่เชื่อมโยงกับโอกาสในการขายทางโทรศัพท์เท่านั้น ได้แก่ `chargedCallTimestamp` `chargedConnectedCallDurationSeconds` และ `consumerPhoneNumber`
`bookingLead`	ข้อมูลที่เชื่อมโยงกับโอกาสในการขายที่ทำการจองเท่านั้น `customerName` `consumerPhoneNumber` `jobType` `consumerEmail` และ `bookingAppointmentTimestamp`
`chargeStatus`	มีการเรียกเก็บเงินโอกาสในการขายหรือไม่ ต้องเป็น `true` หรือ `false`
`currencyCode`	รหัสสกุลเงินของบัญชีที่สร้างโอกาสในการขาย
`disputeStatus`	สถานะการโต้แย้งของโอกาสในการขาย
`aggregatorInfo`	ข้อมูลที่เฉพาะเจาะจงสำหรับพาร์ทเนอร์ผู้รวบรวมข้อมูลบุคคลที่สาม ฟิลด์นี้จะกรอกข้อมูลสำหรับไคลเอ็นต์ API ที่เชื่อมโยงกับพาร์ทเนอร์ผู้รวบรวมข้อมูลบุคคลที่สามเท่านั้น หมายเหตุ: ข้อกำหนดนี้ไม่เกี่ยวข้องกับลูกค้าศูนย์ลูกค้าของฉัน (MCC) มาตรฐาน
`timezone`	เขตเวลาของบัญชีที่เชื่อมโยงกับโอกาสในการขาย ระบุในรูปแบบฐานข้อมูลเขตเวลาของ IANA

ตัวอย่าง

URL ของคำขอ HTTP

https://localservices.googleapis.com/v1/detailedLeadReports:search?query=manager_customer_id:{manager_customer_id}

ตัวอย่างคำขอ HTTP ที่สมบูรณ์

GET /v1/detailedReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]