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 queryBắ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.dayKhô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.monthKhô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.yearKhô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.dayKhô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.monthKhô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.yearKhô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.
pageSizeKhô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.
pageTokenKhô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 queryBắ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.dayKhô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.monthKhô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.yearKhô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.dayKhô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.monthKhô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.yearKhô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.
pageSizeKhô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.
pageTokenKhô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. leadCreationTimestampDấ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. leadCategoryDanh mục dịch vụ liên quan đến khách hàng tiềm năng.
Ví dụ: housecleaner
geoVị 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. aggregatorInfoThô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]