Báo cáo

Tính năng báo cáo cho phép bạn truy xuất thông tin về hiệu suất quảng cáo và thông tin khách hàng tiềm năng của các tài khoản được liên kết.

Báo cáo tài khoản

Báo cáo tài khoản cho biết hiệu suất và các chỉ số liên quan đến tài khoản Dịch vụ tại địa phương được liên kết của một Tài khoản người quản lý. Bạn có thể xem dữ liệu này trong một khoảng thời gian cụ thể. Dữ liệu có thể bị trễ tối đa 30 phút.

Để nhận báo cáo, hãy gửi yêu cầu HTTP GET đến https://localservices.googleapis.com/v1/accountReports:search bằng các tham số URL có thể định cấu hình sau:

Thông số URL
query	Bắt buộc Chứa một hoặc nhiều giá trị mã nhận dạng, trong đó phải có một giá trị là mã nhận dạng của Tài khoản người quản lý cho truy vấn. query có thể chấp nhận nhiều giá trị được phân tách bằng dấu chấm phẩy: Bắt buộc: manager_customer_id:<manager_cid> Không bắt buộc: customer_id:<linked_cid> Ví dụ: query=manager_customer_id:123;customer_id:456
startDate.day	Không bắt buộc Ngày trong tháng mà kỳ báo cáo bắt đầu. Có thể nhận các giá trị trong khoảng từ 1 đến 31. Mặc định là 1.
startDate.month	Không bắt buộc Tháng bắt đầu của kỳ báo cáo. Có thể nhận các giá trị trong khoảng từ 1 đến 12 (bao gồm cả 2 giá trị này). Giá trị mặc định là tháng hiện tại.
startDate.year	Không bắt buộc Năm bắt đầu kỳ báo cáo, ở định dạng YYYY. Giá trị mặc định là năm hiện tại.
endDate.day	Không bắt buộc Ngày trong tháng mà kỳ báo cáo kết thúc. Có thể nhận các giá trị trong khoảng từ 1 đến 31. Giá trị mặc định là ngày hiện tại.
endDate.month	Không bắt buộc Tháng kết thúc kỳ báo cáo. Có thể nhận các giá trị trong khoảng từ 1 đến 12 (bao gồm cả 2 giá trị này). Giá trị mặc định là tháng hiện tại.
endDate.year	Không bắt buộc Năm kết thúc kỳ báo cáo, ở định dạng YYYY. Giá trị mặc định là năm hiện tại.
pageSize	Không bắt buộc Một số nguyên dương cho biết số lượng mục cần trả về. Giá trị mặc định là 1000 và giá trị tối đa là 10000.
pageToken	Không bắt buộc Một chuỗi. Nhập next_page_token từ phản hồi trước vào trường này.

Các trường trong bảng trước được dùng để tạo một SearchAccountReportsRequest. Đối với mỗi mã khách hàng trong yêu cầu, một AccountReports tương ứng sẽ được đưa vào SearchAccountReportsResponse. Mỗi Báo cáo tài khoản đều tương ứng với một tài khoản khách hàng được liên kết hiển thị quảng cáo Dịch vụ tại địa phương.

Lưu ý: Các giao thức cho yêu cầu, phản hồi, cấu trúc dữ liệu đều có sẵn và được liên kết sau khi bạn ra mắt.

Bảng sau đây cho thấy các trường trong AccountReports:

Trường
accountId	Mã khách hàng được liên kết với Tài khoản Dịch vụ địa phương.
businessName	Tên doanh nghiệp của khách hàng.
averageWeeklyBudget	Ngân sách trung bình hằng tuần hiện tại của khách hàng.
averageFiveStarRating	Điểm xếp hạng trung bình năm sao, được tính từ tất cả các bài đánh giá hiện có của khách hàng.
totalReview	Tổng số bài đánh giá mà khách hàng có thể xem.
impressionsLastTwoDays	Tổng số lượt hiển thị mà tài khoản nhận được trong 2 ngày qua.
phoneLeadResponsiveness	Mức độ phản hồi của khách hàng tiềm năng qua điện thoại của tài khoản trong 90 ngày trước đó. Để tính toán chỉ số này, tổng số cuộc gọi được kết nối từ khách hàng tiềm năng qua điện thoại có tính phí sẽ được chia cho tổng số cuộc gọi nhận được.
currentPeriodChargedLeads	Số khách hàng tiềm năng bị tính phí trong khoảng thời gian của phạm vi ngày được chỉ định.
previousPeriodChargedLeads	Số lượng khách hàng tiềm năng có tính phí trong khoảng thời gian trước. Ví dụ: nếu phạm vi ngày được đặt là từ ngày 21 tháng 1 đến ngày 30 tháng 1, thì khoảng thời gian trước đó sẽ là từ ngày 11 tháng 1 đến ngày 20 tháng 1.
currentPeriodTotalCost	Tổng chi phí của các khách hàng tiềm năng có tính phí trong khoảng thời gian được chỉ định.
previousPeriodTotalCost	Tổng chi phí của các khách hàng tiềm năng có tính phí trong khoảng thời gian trước. Ví dụ: nếu phạm vi ngày được đặt là từ ngày 21 tháng 1 đến ngày 30 tháng 1, thì khoảng thời gian trước đó sẽ là từ ngày 11 tháng 1 đến ngày 20 tháng 1.
currencyCode	Mã đơn vị tiền tệ của tài khoản khách hàng.
currentPeriodPhoneCalls	Số lượng cuộc gọi điện thoại trong khoảng thời gian được chỉ định, cả cuộc gọi được kết nối và không được kết nối.
previousPeriodPhoneCalls	Số lượng cuộc gọi điện thoại trong khoảng thời gian trước, cả cuộc gọi được kết nối và không được kết nối.
currentPeriodConnectedPhoneCalls	Số lượng cuộc gọi điện thoại được kết nối trong khoảng thời gian ngày đã chỉ định với thời lượng trên 30 giây.
previousPeriodConnectedPhoneCalls	Số lượng cuộc gọi điện thoại được kết nối trong khoảng thời gian trước đó với thời lượng trên 30 giây.

Ví dụ

URL yêu cầu HTTP

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

Mẫu yêu cầu HTTP hoàn chỉnh

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]

Báo cáo chi tiết về khách hàng tiềm năng

Lưu ý quan trọng: Báo cáo chi tiết về khách hàng tiềm năng không còn được dùng nữa. Sử dụng Google Ads API để tìm nạp Khách hàng tiềm năng và Cuộc trò chuyện được liên kết với tài khoản Dịch vụ địa phương của bạn.

Báo cáo chi tiết về khách hàng tiềm năng cho thấy thông tin chi tiết về khách hàng tiềm năng được liên kết với tài khoản Dịch vụ địa phương đã liên kết của một Tài khoản người quản lý. Bạn có thể xem dữ liệu này trong một khoảng thời gian cụ thể. Đối với một phạm vi thời gian nhất định, báo cáo này bao gồm những khách hàng tiềm năng đã được tạo hoặc những khách hàng tiềm năng đã được cập nhật trạng thái tranh chấp. Dữ liệu có thể đã cũ đến 30 phút.

Lưu ý: Các ứng dụng API chỉ có thể yêu cầu Báo cáo chi tiết về khách hàng tiềm năng trong khoảng thời gian tối đa là 31 ngày. Điều này là do báo cáo có thể trả về số lượng lớn khách hàng tiềm năng.

Để nhận báo cáo, hãy gửi yêu cầu HTTP GET đến https://localservices.googleapis.com/v1/detailedLeadReports:search bằng các tham số URL có thể định cấu hình sau:

Thông số URL
query	Bắt buộc Chứa một hoặc nhiều giá trị mã nhận dạng, trong đó phải có một giá trị là mã nhận dạng của Tài khoản người quản lý cho truy vấn. query có thể chấp nhận nhiều giá trị được phân tách bằng dấu chấm phẩy: Bắt buộc: manager_customer_id:<manager_cid> Không bắt buộc: customer_id:<linked_cid> Ví dụ: query=manager_customer_id:123;customer_id:456
startDate.day	Không bắt buộc Ngày trong tháng mà kỳ báo cáo bắt đầu. Có thể nhận các giá trị trong khoảng từ 1 đến 31. Mặc định là 1.
startDate.month	Không bắt buộc Tháng bắt đầu của kỳ báo cáo. Có thể nhận các giá trị trong khoảng từ 1 đến 12 (bao gồm cả 2 giá trị này). Giá trị mặc định là tháng hiện tại.
startDate.year	Không bắt buộc Năm bắt đầu kỳ báo cáo, ở định dạng YYYY. Giá trị mặc định là năm hiện tại.
endDate.day	Không bắt buộc Ngày trong tháng mà kỳ báo cáo kết thúc. Có thể nhận các giá trị trong khoảng từ 1 đến 31. Giá trị mặc định là ngày hiện tại.
endDate.month	Không bắt buộc Tháng kết thúc kỳ báo cáo. Có thể nhận các giá trị trong khoảng từ 1 đến 12 (bao gồm cả 2 giá trị này). Giá trị mặc định là tháng hiện tại.
endDate.year	Không bắt buộc Năm kết thúc kỳ báo cáo, ở định dạng YYYY. Giá trị mặc định là năm hiện tại.
pageSize	Không bắt buộc Một số nguyên dương cho biết số lượng mục cần trả về. Giá trị mặc định là 1000 và giá trị tối đa là 10000.
pageToken	Không bắt buộc Một chuỗi. Nhập next_page_token từ phản hồi trước vào trường này.

Các trường trước đó được dùng để tạo một SearchDetailedLeadReportsRequest. Đối với mỗi mã khách hàng trong yêu cầu, một DetailedLeadReports tương ứng sẽ được đưa vào SearchDetailedLeadReportsResponse. Mỗi Báo cáo chi tiết về khách hàng tiềm năng đều tương ứng với một khách hàng tiềm năng cụ thể được liên kết với một tài khoản khách hàng được liên kết hiển thị quảng cáo Dịch vụ địa phương.

Bảng sau đây cho thấy các trường trong DetailedLeadReports:

Trường
leadId	Giá trị nhận dạng duy nhất của khách hàng tiềm năng.
accountId	Xác định tài khoản đã nhận được khách hàng tiềm năng.
businessName	Tên doanh nghiệp được liên kết với tài khoản.
leadCreationTimestamp	Dấu thời gian cho biết thời điểm tạo khách hàng tiềm năng. Bao gồm ngày ở định dạng M/D/YYYY và giờ ở định dạng HH:MM:SS. Ví dụ: 11/1/2019 12:13:20
leadType	Loại khách hàng tiềm năng: MESSAGE hoặc PHONE_CALL.
leadCategory	Danh mục dịch vụ liên quan đến khách hàng tiềm năng. Ví dụ: housecleaner
geo	Vị trí của thành phố nơi tài khoản được liên kết sinh sống. Ví dụ: San Francisco, California, United States
messageLead	Thông tin chỉ liên quan đến khách hàng tiềm năng qua tin nhắn: customerName, jobType, postalCode và consumerPhoneNumber.
phoneLead	Thông tin chỉ liên kết với khách hàng tiềm năng qua điện thoại: chargedCallTimestamp, chargedConnectedCallDurationSeconds và consumerPhoneNumber.
bookingLead	Thông tin chỉ liên quan đến khách hàng tiềm năng đặt trước: customerName, consumerPhoneNumber, jobType, consumerEmail và bookingAppointmentTimestamp.
chargeStatus	Khách hàng tiềm năng đã bị tính phí hay chưa. Có thể là true hoặc false.
currencyCode	Mã đơn vị tiền tệ của tài khoản mà khách hàng tiềm năng được tạo.
disputeStatus	Trạng thái tranh chấp của khách hàng tiềm năng.
aggregatorInfo	Thông tin dành riêng cho các đối tác là đơn vị tổng hợp bên thứ ba. Trường này chỉ được điền sẵn cho những ứng dụng API được liên kết với các đối tác tổng hợp bên thứ ba. Lưu ý: Điều này không áp dụng cho khách hàng tiêu chuẩn của Trung tâm Khách hàng (MCC).
timezone	Múi giờ của tài khoản được liên kết với khách hàng tiềm năng. Được cung cấp ở định dạng Cơ sở dữ liệu múi giờ IANA.

Ví dụ

URL yêu cầu HTTP

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

Mẫu yêu cầu HTTP hoàn chỉnh

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]