Berichterstellung

Mit Berichten können Sie Informationen zur Anzeigenleistung und Lead-Informationen Ihrer verknüpften Konten abrufen.

Kontoberichte

In Kontoberichten sehen Sie die Leistung und Messwerte, die mit den verknüpften Local Services-Konten eines Verwaltungskontos verknüpft sind. Sie können sich diese Daten für einen bestimmten Zeitraum ansehen. Die Daten sind möglicherweise bis zu 30 Minuten alt.

Senden Sie zum Abrufen des Berichts eine HTTP-GET-Anfrage an https://localservices.googleapis.com/v1/accountReports:search mit den folgenden konfigurierbaren URL-Parametern:

URL-Parameter
query	Erforderlich Enthält einen oder mehrere ID-Werte, von denen einer die ID des Verwaltungskontos für die Anfrage sein muss. query kann mehrere durch Semikolons getrennte Werte enthalten: Erforderlich: manager_customer_id:<manager_cid> Optional: customer_id:<linked_cid> Beispiel: query=manager_customer_id:123;customer_id:456.
startDate.day	Optional Der Tag des Monats, an dem der Berichtszeitraum beginnt. Kann Werte zwischen 1 und 31 (einschließlich) annehmen. Die Standardeinstellung ist 1.
startDate.month	Optional Der Startmonat für den Berichtszeitraum. Kann Werte zwischen 1 und 12 (einschließlich) annehmen. Die Standardeinstellung ist der aktuelle Monat.
startDate.year	Optional Das Jahr, in dem der Berichtszeitraum beginnt, im Format YYYY. Die Standardeinstellung ist das aktuelle Jahr.
endDate.day	Optional Der Tag des Monats, an dem der Berichtszeitraum endet. Kann Werte zwischen 1 und 31 (einschließlich) annehmen. Die Standardeinstellung ist der aktuelle Tag.
endDate.month	Optional Der Monat, in dem der Berichtszeitraum endet. Kann Werte zwischen 1 und 12 (einschließlich) annehmen. Die Standardeinstellung ist der aktuelle Monat.
endDate.year	Optional Das Jahr, in dem der Berichtszeitraum endet, im Format YYYY. Die Standardeinstellung ist das aktuelle Jahr.
pageSize	Optional Eine positive Ganzzahl, die die Anzahl der zurückzugebenden Einträge angibt. Der Standardwert ist 1000 und der Höchstwert 10000.
pageToken	Optional Ein String. Geben Sie in dieses Feld das next_page_token aus der vorherigen Antwort ein.

Die Felder in der vorherigen Tabelle werden verwendet, um ein SearchAccountReportsRequest zu erstellen. Für jede Kundennummer in der Anfrage ist in SearchAccountReportsResponse ein entsprechendes AccountReports enthalten. Jeder Kontobericht entspricht einem verknüpften Kundenkonto, in dem Anzeigen für lokale Dienstleistungen ausgeliefert werden.

Hinweis: Protos für Anfragen, Antworten und Datenstrukturen sind nach dem Start verfügbar und verlinkt.

In der folgenden Tabelle sind die Felder in AccountReports aufgeführt:

Felder
accountId	Die Kundennummer ist mit einem Konto für Google Lokale Dienstleistungen verknüpft.
businessName	Name des Kundenunternehmens.
averageWeeklyBudget	Das aktuelle durchschnittliche Wochenbudget des Kunden.
averageFiveStarRating	Die durchschnittliche Fünf-Sterne-Bewertung, die aus allen verfügbaren Rezensionen des Kunden berechnet wird.
totalReview	Gesamtzahl der für den Kunden verfügbaren Rezensionen.
impressionsLastTwoDays	Gesamtzahl der Impressionen, die das Konto in den letzten zwei Tagen erzielt hat.
phoneLeadResponsiveness	Reaktionsfähigkeit des Kontos auf Telefonanrufe in den letzten 90 Tagen. Dazu wird die Gesamtzahl der verbundenen Anrufe aus kostenpflichtigen Telefonanrufen durch die Gesamtzahl der eingegangenen Anrufe geteilt.
currentPeriodChargedLeads	Anzahl der in Rechnung gestellten Anfragen im angegebenen Zeitraum.
previousPeriodChargedLeads	Anzahl der abgerechneten Leads im vorherigen Zeitraum. Wenn der Zeitraum beispielsweise auf den 21. bis 30. Januar festgelegt ist, wäre der vorherige Zeitraum der 11. bis 20. Januar.
currentPeriodTotalCost	Summe der Kosten für abgerechnete Anfragen im angegebenen Zeitraum.
previousPeriodTotalCost	Summe der Kosten für abgerechnete Leads im vorherigen Zeitraum. Wenn der Zeitraum beispielsweise auf den 21. bis 30. Januar festgelegt ist, wäre der vorherige Zeitraum der 11. bis 20. Januar.
currencyCode	Währungscode des Kundenkontos.
currentPeriodPhoneCalls	Anzahl der Telefonanrufe im angegebenen Zeitraum, sowohl verbundene als auch nicht verbundene.
previousPeriodPhoneCalls	Anzahl der Telefonanrufe im vorherigen Zeitraum, sowohl verbundene als auch nicht verbundene.
currentPeriodConnectedPhoneCalls	Anzahl der verbundenen Telefonanrufe im angegebenen Zeitraum mit einer Dauer von mehr als 30 Sekunden.
previousPeriodConnectedPhoneCalls	Anzahl der Telefonverbindungen im vorherigen Zeitraum mit einer Dauer von mehr als 30 Sekunden.

Beispiele

HTTP-Anfrage-URL

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

Beispiel für vollständige HTTP-Anfrage

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]

Detaillierte Anfrageberichte

Wichtig :Detaillierte Lead-Berichte werden eingestellt. Mit der Google Ads API können Sie Leads und Unterhaltungen abrufen, die mit Ihren Konten für Google Lokale Dienstleistungen verknüpft sind.

Detaillierte Lead-Berichte bieten einen umfassenden Überblick über Leads, die mit den verknüpften Konten für Google Lokale Dienstleistungen eines Verwaltungskontos verknüpft sind. Sie können sich diese Daten für einen bestimmten Zeitraum ansehen. Für einen bestimmten Zeitraum enthält der Bericht Leads, die erstellt wurden, oder Leads, deren Einspruchsstatus aktualisiert wurde. Die Daten sind möglicherweise bis zu 30 Minuten alt.

Hinweis :API-Clients können detaillierte Anfrageberichte nur für einen Zeitraum von maximal 31 Tagen anfordern. Das liegt an der großen Anzahl von Leads, die im Bericht zurückgegeben werden können.

Senden Sie zum Abrufen des Berichts eine HTTP-GET-Anfrage an https://localservices.googleapis.com/v1/detailedLeadReports:search mit den folgenden konfigurierbaren URL-Parametern:

URL-Parameter
query	Erforderlich Enthält einen oder mehrere ID-Werte, von denen einer die ID des Verwaltungskontos für die Anfrage sein muss. query kann mehrere durch Semikolons getrennte Werte enthalten: Erforderlich: manager_customer_id:<manager_cid> Optional: customer_id:<linked_cid> Beispiel: query=manager_customer_id:123;customer_id:456.
startDate.day	Optional Der Tag des Monats, an dem der Berichtszeitraum beginnt. Kann Werte zwischen 1 und 31 (einschließlich) annehmen. Die Standardeinstellung ist 1.
startDate.month	Optional Der Startmonat für den Berichtszeitraum. Kann Werte zwischen 1 und 12 (einschließlich) annehmen. Die Standardeinstellung ist der aktuelle Monat.
startDate.year	Optional Das Jahr, in dem der Berichtszeitraum beginnt, im Format YYYY. Die Standardeinstellung ist das aktuelle Jahr.
endDate.day	Optional Der Tag des Monats, an dem der Berichtszeitraum endet. Kann Werte zwischen 1 und 31 (einschließlich) annehmen. Die Standardeinstellung ist der aktuelle Tag.
endDate.month	Optional Der Monat, in dem der Berichtszeitraum endet. Kann Werte zwischen 1 und 12 (einschließlich) annehmen. Die Standardeinstellung ist der aktuelle Monat.
endDate.year	Optional Das Jahr, in dem der Berichtszeitraum endet, im Format YYYY. Die Standardeinstellung ist das aktuelle Jahr.
pageSize	Optional Eine positive Ganzzahl, die die Anzahl der zurückzugebenden Einträge angibt. Der Standardwert ist 1000 und der Höchstwert 10000.
pageToken	Optional Ein String. Geben Sie in dieses Feld das next_page_token aus der vorherigen Antwort ein.

Die vorherigen Felder werden verwendet, um ein SearchDetailedLeadReportsRequest zu erstellen. Für jede Kunden-ID in der Anfrage ist ein entsprechender DetailedLeadReports in SearchDetailedLeadReportsResponse enthalten. Jeder detaillierte Anfragenbericht entspricht einer bestimmten Anfrage, die mit einem verknüpften Kundenkonto verknüpft ist, in dem Anzeigen für lokale Dienstleistungen ausgeliefert werden.

In der folgenden Tabelle sind die Felder in DetailedLeadReports aufgeführt:

Felder
leadId	Eindeutige Kennung eines Leads.
accountId	Gibt das Konto an, das den Lead erhalten hat.
businessName	Der mit dem Konto verknüpfte Name des Unternehmens.
leadCreationTimestamp	Zeitstempel für die Erstellung des Leads. Enthält das Datum im Format M/D/YYYY und die Uhrzeit im Format HH:MM:SS. Beispiel: 11/1/2019 12:13:20
leadType	Art der Anfrage: MESSAGE oder PHONE_CALL.
leadCategory	Die mit dem Lead verknüpfte Dienstkategorie. Beispiel: housecleaner
geo	Standorte der Heimatstadt des zugehörigen Kontos. Beispiel: San Francisco, California, United States
messageLead	Informationen, die nur mit Nachrichten-Leads verknüpft sind: customerName, jobType, postalCode und consumerPhoneNumber.
phoneLead	Informationen, die nur mit Telefonanrufen in Verbindung stehen: chargedCallTimestamp, chargedConnectedCallDurationSeconds und consumerPhoneNumber.
bookingLead	Informationen, die nur mit Terminanfragen verknüpft sind: customerName, consumerPhoneNumber, jobType, consumerEmail und bookingAppointmentTimestamp.
chargeStatus	Gibt an, ob die Anfrage in Rechnung gestellt wurde. Kann true oder false sein.
currencyCode	Währungscode des Kontos, für das der Lead erstellt wurde.
disputeStatus	Status des Einspruchs für den Lead.
aggregatorInfo	Informationen, die speziell für Drittanbieter-Aggregatorpartner gelten. Dieses Feld wird nur für API-Clients ausgefüllt, die mit Drittanbieter-Aggregatorpartnern verknüpft sind. Hinweis:Dies gilt nicht für Standard-MCC-Kunden.
timezone	Zeitzone des Kontos, das mit dem Lead verknüpft ist. Im Format der IANA-Zeitzonendatenbank.

Beispiele

HTTP-Anfrage-URL

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

Beispiel für vollständige HTTP-Anfrage

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]