Raportowanie

Raportowanie umożliwia pobieranie informacji o skuteczności reklam i potencjalnych klientach na połączonych kontach.

Raporty dotyczące kont

Raporty o kontach pokazują skuteczność i dane powiązanych kont Usług Lokalnych na koncie menedżera. Możesz wyświetlać te dane w określonym przedziale czasu. Dane mogą być nieaktualne nawet przez 30 minut.

Aby uzyskać raport, wyślij żądanie HTTP GET do https://localservices.googleapis.com/v1/accountReports:search z tymi konfigurowalnymi parametrami adresu URL:

Parametry adresu URL
query	Wymagany Zawiera co najmniej 1 wartość identyfikatora, z których jedna musi być identyfikatorem konta menedżera dla zapytania. query może przyjmować wiele wartości rozdzielonych średnikami: Wymagane:manager_customer_id:<manager_cid> Opcjonalnie: customer_id:<linked_cid> Przykład:query=manager_customer_id:123;customer_id:456
startDate.day	Opcjonalny Dzień miesiąca, w którym rozpoczyna się okres raportowania. Może przyjmować wartości z zakresu od 1 do 31 włącznie. Domyślna wartość to 1.
startDate.month	Opcjonalny Początkowy miesiąc okresu raportowania. Może przyjmować wartości z przedziału od 1 do 12 (włącznie). Domyślnie jest to bieżący miesiąc.
startDate.year	Opcjonalny Rok rozpoczęcia okresu raportowania w formacie YYYY. Domyślnie jest to bieżący rok.
endDate.day	Opcjonalny Dzień miesiąca, w którym kończy się okres raportowania. Może przyjmować wartości z przedziału od 1 do 31 (obustronnie domkniętego). Domyślnie jest to bieżący dzień.
endDate.month	Opcjonalny Miesiąc, w którym kończy się okres raportowania. Może przyjmować wartości z przedziału od 1 do 12 (włącznie). Domyślnie jest to bieżący miesiąc.
endDate.year	Opcjonalny Rok zakończenia okresu raportowania w formacie YYYY. Domyślnie jest to bieżący rok.
pageSize	Opcjonalny Dodatnia liczba całkowita wskazująca liczbę wpisów do zwrócenia. Domyślna wartość to 1000, a maksymalna – 10000.
pageToken	Opcjonalny Ciąg znaków. Wpisz w tym polu wartość next_page_token z poprzedniej odpowiedzi.

Pola w poprzedniej tabeli służą do tworzenia SearchAccountReportsRequest. Dla każdego identyfikatora klienta w żądaniu w odpowiedzi SearchAccountReportsResponse znajduje się odpowiedni element AccountReports. Każdy raport o koncie jest powiązany z połączonym kontem klienta, na którym wyświetlają się reklamy w Usługach Lokalnych.

Uwaga: po uruchomieniu usługi udostępnimy i połączymy pliki proto dla żądań, odpowiedzi i struktur danych.

W tej tabeli znajdziesz pola w AccountReports:

Pola
accountId	Połączony identyfikator klienta z kontem w Usługach Lokalnych.
businessName	Nazwa firmy klienta.
averageWeeklyBudget	Obecny średni budżet tygodniowy klienta.
averageFiveStarRating	Średnia ocena pięciogwiazdkowa obliczana na podstawie wszystkich dostępnych opinii klienta.
totalReview	Łączna liczba opinii dostępnych dla klienta.
impressionsLastTwoDays	Łączna liczba wyświetleń na koncie w ciągu ostatnich 2 dni.
phoneLeadResponsiveness	Odpowiedzialność konta za połączenia telefoniczne z ostatnich 90 dni. Aby to obliczyć, łączną liczbę połączeń z płatnych połączeń telefonicznych z potencjalnymi klientami dzieli się przez łączną liczbę odebranych połączeń.
currentPeriodChargedLeads	Liczba potencjalnych zleceń, za które pobraliśmy opłatę w określonym zakresie dat.
previousPeriodChargedLeads	Liczba potencjalnych zleceń, za które pobraliśmy opłatę w poprzednim okresie. Jeśli np. zakres dat to 21–30 stycznia, poprzedni okres to 11–20 stycznia.
currentPeriodTotalCost	Suma kosztów potencjalnych zleceń, za które pobraliśmy opłatę w wybranym zakresie dat.
previousPeriodTotalCost	Suma kosztów za obciążone konta w poprzednim okresie. Jeśli na przykład zakres dat to 21–30 stycznia, poprzedni okres to 11–20 stycznia.
currencyCode	Kod waluty konta klienta.
currentPeriodPhoneCalls	Liczba połączeń telefonicznych w określonym zakresie dat, zarówno odebranych, jak i nieodebranych.
previousPeriodPhoneCalls	Liczba połączeń telefonicznych w poprzednim okresie, zarówno odebranych, jak i nieodebranych.
currentPeriodConnectedPhoneCalls	Liczba odebranych połączeń telefonicznych w określonym zakresie dat, które trwały dłużej niż 30 sekund.
previousPeriodConnectedPhoneCalls	Liczba odebranych połączeń telefonicznych w poprzednim okresie, które trwały dłużej niż 30 sekund.

Przykłady

Adres URL żądania HTTP

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

Przykładowe pełne żądanie 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]

Szczegółowe raporty o potencjalnych klientach

Ważne: szczegółowe raporty o potencjalnych klientach zostały wycofane. Użyj interfejsu Google Ads API, aby pobrać potencjalnych klientów i konwersacje powiązane z Twoimi kontami Usług Lokalnych.

Szczegółowe raporty o potencjalnych klientach zawierają szczegółowe informacje o potencjalnych klientach powiązanych z połączonymi kontami Reklam Usług Lokalnych na koncie menedżera. Możesz wyświetlać te dane w określonym przedziale czasu. W danym zakresie czasu raport zawiera potencjalnych klientów, którzy zostali utworzeni lub których stan sporu został zaktualizowany. Dane mogą być nieaktualne nawet o 30 minut.

Uwaga: klienci interfejsu API mogą przesyłać prośby o Szczegółowe raporty o potencjalnych klientach tylko w przypadku okresu nie dłuższego niż 31 dni. Wynika to z dużej liczby potencjalnych klientów, jaką może zwrócić raport.

Aby uzyskać raport, wyślij żądanie HTTP GET do https://localservices.googleapis.com/v1/detailedLeadReports:search z tymi konfigurowalnymi parametrami adresu URL:

Parametry adresu URL
query	Wymagany Zawiera co najmniej 1 wartość identyfikatora, z których jedna musi być identyfikatorem konta menedżera dla zapytania. query może przyjmować wiele wartości rozdzielonych średnikami: Wymagane:manager_customer_id:<manager_cid> Opcjonalnie: customer_id:<linked_cid> Przykład:query=manager_customer_id:123;customer_id:456
startDate.day	Opcjonalny Dzień miesiąca, w którym rozpoczyna się okres raportowania. Może przyjmować wartości z zakresu od 1 do 31 włącznie. Domyślna wartość to 1.
startDate.month	Opcjonalny Początkowy miesiąc okresu raportowania. Może przyjmować wartości z przedziału od 1 do 12 (włącznie). Domyślnie jest to bieżący miesiąc.
startDate.year	Opcjonalny Rok rozpoczęcia okresu raportowania w formacie YYYY. Domyślnie jest to bieżący rok.
endDate.day	Opcjonalny Dzień miesiąca, w którym kończy się okres raportowania. Może przyjmować wartości z przedziału od 1 do 31 (obustronnie domkniętego). Domyślnie jest to bieżący dzień.
endDate.month	Opcjonalny Miesiąc, w którym kończy się okres raportowania. Może przyjmować wartości z przedziału od 1 do 12 (włącznie). Domyślnie jest to bieżący miesiąc.
endDate.year	Opcjonalny Rok zakończenia okresu raportowania w formacie YYYY. Domyślnie jest to bieżący rok.
pageSize	Opcjonalny Dodatnia liczba całkowita wskazująca liczbę wpisów do zwrócenia. Domyślna wartość to 1000, a maksymalna – 10000.
pageToken	Opcjonalny Ciąg znaków. Wpisz w tym polu wartość next_page_token z poprzedniej odpowiedzi.

Poprzednie pola służą do tworzenia SearchDetailedLeadReportsRequest. Dla każdego identyfikatora klienta w żądaniu w SearchDetailedLeadReportsResponse znajduje się odpowiedni element DetailedLeadReports. Każdy szczegółowy raport o kontaktach do potencjalnych klientów jest powiązany z konkretnym kontaktem do potencjalnego klienta, który jest z kolei powiązany z połączonym kontem klienta wyświetlającym reklamy w Usługach Lokalnych.

W tej tabeli znajdziesz pola w DetailedLeadReports:

Pola
leadId	Unikalny identyfikator potencjalnego klienta.
accountId	Określa konto, na które trafił potencjalny klient.
businessName	Nazwa firmy powiązana z kontem.
leadCreationTimestamp	Sygnatura czasowa utworzenia potencjalnego klienta. Zawiera datę w formacie M/D/YYYY i godzinę w formacie HH:MM:SS. Przykład: 11/1/2019 12:13:20
leadType	Typ potencjalnego klienta: MESSAGE lub PHONE_CALL.
leadCategory	Kategoria usługi powiązana z potencjalnym klientem. Przykład: housecleaner
geo	Lokalizacje miasta, w którym znajduje się dom powiązanego konta. Przykład: San Francisco, California, United States
messageLead	Informacje powiązane tylko z potencjalnymi klientami z wiadomości:customerName, jobType,postalCode i consumerPhoneNumber.
phoneLead	Informacje powiązane tylko z potencjalnymi klientami z telefonu:chargedCallTimestamp,chargedConnectedCallDurationSeconds i consumerPhoneNumber.
bookingLead	Informacje powiązane tylko z potencjalnymi klientami z rezerwacji:customerName,consumerPhoneNumber,jobType,consumerEmail i bookingAppointmentTimestamp.
chargeStatus	Informacja o tym, czy za kontakt do potencjalnego klienta pobrano opłatę. Może to być true lub false.
currencyCode	Kod waluty konta, dla którego utworzono potencjalnego klienta.
disputeStatus	Stan sporu dotyczący potencjalnego klienta.
aggregatorInfo	Informacje dotyczące konkretnych partnerów zewnętrznych będących agregatorami. To pole jest wypełniane tylko w przypadku klientów interfejsu API powiązanych z partnerami zewnętrznymi będącymi agregatorami. Uwaga: nie dotyczy to klientów korzystających ze standardowego konta Moje Centrum Klienta (MCC).
timezone	Strefa czasowa konta powiązanego z potencjalnym klientem. Podana w formacie bazy danych stref czasowych IANA.

Przykłady

Adres URL żądania HTTP

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

Przykładowe pełne żądanie 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]