보고

보고를 사용하면 연결된 계정의 광고 실적 및 리드 정보를 가져올 수 있습니다.

계정 보고서

계정 보고서에는 관리자 계정의 연결된 지역 서비스 계정과 관련된 실적 및 측정항목이 표시됩니다. 지정된 기간 동안 이 데이터를 볼 수 있습니다. 데이터가 최대 30분까지 오래될 수 있습니다.

보고서를 가져오려면 다음 구성 가능한 URL 매개변수를 사용하여 HTTP GET 요청을 https://localservices.googleapis.com/v1/accountReports:search에 보냅니다.

URL 매개변수
query

필수

하나 이상의 ID 값을 포함하며, 그중 하나는 쿼리의 관리자 계정 ID여야 합니다. 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를 구성하는 데 사용됩니다. 요청의 각 고객 ID에 대해 해당하는 AccountReports가 SearchAccountReportsResponse에 포함됩니다. 각 계정 보고서는 지역 서비스 광고를 표시하는 연결된 고객 계정과 일대일로 매핑됩니다.

다음 표에는 AccountReports의 필드가 나와 있습니다.

필드
accountId 지역 서비스 계정과 연결된 고객 ID입니다.
businessName 고객의 비즈니스 이름입니다.
averageWeeklyBudget 고객의 현재 평균 주간 예산입니다.
averageFiveStarRating 고객의 모든 리뷰를 바탕으로 계산된 평균 5성급 평점입니다.
totalReview 고객이 볼 수 있는 총 리뷰 수입니다.
impressionsLastTwoDays 지난 2일 동안 계정에서 발생한 총 노출수입니다.
phoneLeadResponsiveness 지난 90일 동안의 계정 전화 리드 응답성입니다. 이를 계산하려면 요금이 청구된 전화 리드에서 연결된 총 통화 수를 수신된 총 통화 수로 나눕니다.
currentPeriodChargedLeads 지정된 기간의 청구된 리드 수입니다.
previousPeriodChargedLeads 이전 기간의 청구된 리드 수입니다. 예를 들어 기간이 1월 21일부터 1월 30일까지로 설정된 경우 이전 기간은 1월 11일부터 1월 20일까지입니다.
currentPeriodTotalCost 지정된 기간의 청구된 리드에서 발생한 비용의 합계입니다.
previousPeriodTotalCost 이전 기간에 청구된 리드의 비용 합계입니다. 예를 들어 기간이 1월 21일~1월 30일로 설정된 경우 이전 기간은 1월 11일~1월 20일입니다.
currencyCode 고객 계정의 통화 코드입니다.
currentPeriodPhoneCalls 지정된 기간의 연결된 통화와 연결되지 않은 통화의 수입니다.
previousPeriodPhoneCalls 이전 기간의 전화 통화 수입니다(연결된 통화와 연결되지 않은 통화 모두 포함).
currentPeriodConnectedPhoneCalls 지정된 기간에 30초 이상 지속된 연결된 전화 통화 수입니다.
previousPeriodConnectedPhoneCalls 이전 기간에 연결된 전화 중 통화 시간이 30초를 초과하는 전화 수입니다.

예

HTTP 요청 URL

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분까지 오래될 수 있습니다.

보고서를 가져오려면 다음 구성 가능한 URL 매개변수를 사용하여 HTTP GET 요청을 https://localservices.googleapis.com/v1/detailedLeadReports:search에 보냅니다.

URL 매개변수
query

필수

하나 이상의 ID 값을 포함하며, 그중 하나는 쿼리의 관리자 계정 ID여야 합니다. 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를 구성하는 데 사용됩니다. 요청의 각 고객 ID에 대해 해당 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 클라이언트에 대해서만 채워집니다.
timezone 리드와 연결된 계정의 시간대입니다. IANA 시간대 데이터베이스 형식으로 제공됩니다.

예

HTTP 요청 URL

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]