Kampagnen für lokale Dienstleistungen

Mit Kampagnen für lokale Dienstleistungen können Sie für Ihr Unternehmen auf Google werben und direkt Leads von potenziellen Kunden erhalten. In diesem Leitfaden werden die unterstützten Vorgänge und Einschränkungen in der aktuellen Version der Google Ads API zusammengefasst.

Unterstützte Vorgänge

Die folgenden Vorgänge werden unterstützt.

Kampagnen und Budgets für lokale Dienstleistungen abrufen

Kampagnen und Budgets bei Google Lokale Dienstleistungen können mit der Methode GoogleAdsService.Search oder GoogleAdsService.SearchStream abgerufen werden, um die campaign-Ressourcen abzufragen, bei denen advertising_channel_type = 'LOCAL_SERVICES'. Hier ein Beispiel:

SELECT
  campaign.id,
  campaign.status,
  campaign_budget.id,
  campaign_budget.period,
  campaign_budget.amount_micros,
  campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Kampagnen für lokale Dienstleistungen bearbeiten

Sie können die Felder status der Kampagne und die Felder amount_micros des zugehörigen Kampagnenbudgets aktualisieren.

Gebotsstrategie für Kampagnen für lokale Dienstleistungen festlegen

Sie können die folgenden Gebotsstrategien als Standard-Gebotsstrategie für Kampagnen für lokale Dienstleistungen festlegen:

Werbezeitplaner als Kampagnenkriterium festlegen

Sie können einen Werbezeitplaner für eine Kampagne für lokale Dienstleistungen als Kampagnenkriterium festlegen.

Erstellen Sie ein AdScheduleInfo und legen Sie es mit CampaignCriterionService.MutateCampaignCriteria auf den ad_schedule des CampaignCriterion fest, der an die Google Ads API gesendet wird.

Geografische Ausrichtung festlegen

Wenn Sie die geografische Ausrichtung für eine Kampagne bei Google Lokale Dienstleistungen aktivieren möchten, fügen Sie ein LocationInfo hinzu und legen Sie es mit CampaignCriterionService.MutateCampaignCriteria auf den location des CampaignCriterion fest, der an die Google Ads API gesendet wird. Weitere Informationen finden Sie unter Standort-Targeting.

Auf bestimmte Diensttypen ausrichten

Wenn Sie das Targeting für einen bestimmten Diensttyp aktivieren möchten, fügen Sie ein LocalServiceIdInfo hinzu und legen Sie es auf den Diensttyp fest.

Sie sollten eine Dienst-ID verwenden, die mit dem Standort und der Kategorie Ihrer Kampagne übereinstimmt.

Feedback zu Anfragen geben

Verwenden Sie die Methode ProvideLeadFeedback() der LocalServicesLeadService, um eine Bewertung und Feedback für einen Lead einzureichen. Sie können auch das Feld lead_feedback_submitted des LocalServicesLead prüfen, um festzustellen, ob eine Anfrage bewertet und Feedback eingereicht wurde.

Nicht unterstützte Vorgänge

Die in der folgenden Tabelle aufgeführten Einschränkungen können sich in zukünftigen Versionen der Google Ads API ändern.

Nicht unterstützte Vorgänge
Kampagnen erstellen und entfernen Über die Google Ads API können keine neuen Kampagnen bei Google Lokale Dienstleistungen erstellt werden.
Vorgänge für untergeordnete Einheiten in einer Kampagne Mit der Google Ads API können keine Anzeigengruppen, Anzeigen oder Kriterien in Kampagnen für lokale Dienstleistungen erstellt, geändert, entfernt oder abgerufen werden.

Ressourcen für Google Lokale Dienstleistungen

Einige Daten aus Google Lokale Dienstleistungen sind über die folgenden schreibgeschützten Berichtsressourcen direkt in der Google Ads API verfügbar:

Damit für diese Ressourcen Daten zurückgegeben werden, muss im Kundenkonto, aus dem die Anfrage stammt, eine Local Services-Kampagne vorhanden sein. Da es nur eine Kampagne für lokale Dienstleistungen pro Kundenkonto geben kann, wird in diesen Ressourcen keine Kampagne angegeben. Mit der folgenden Abfrage können Sie die Kampagne ermitteln, der diese Ressourcen zugeordnet sind:

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Anfrage für lokale Dienstleistungen

Über LocalServicesLead werden die Details eines Leads angezeigt, der generiert wird, wenn ein Nutzer den Werbetreibenden anruft, ihm eine Nachricht sendet oder eine Dienstleistung bei ihm bucht.

Lead-Daten für Local Services können über die Ressource local_services_lead abgerufen werden. Hier ein Beispiel für eine Abfrage:

SELECT
  local_services_lead.lead_type,
  local_services_lead.category_id,
  local_services_lead.service_id,
  local_services_lead.contact_details,
  local_services_lead.lead_status,
  local_services_lead.creation_date_time,
  local_services_lead.locale,
  local_services_lead.lead_charged,
  local_services_lead.credit_details.credit_state,
  local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead

Beschränkungen

  • Das Feld contact_details ist null, wenn lead_status gleich WIPED_OUT ist.
  • Daten aus Leads, bei denen category_id Teil einer Gesundheitskategorie ist, sind nicht verfügbar.

Anfragen über Google Lokale Dienstleistungen – Unterhaltung

LocalServicesLeadConversation macht die Details von Unterhaltungen sichtbar, die im Rahmen einer LocalServicesLead stattgefunden haben. Es besteht eine 1:n-Beziehung zu LocalServicesLead, wobei ein Lead mehrere Unterhaltungen haben kann. Der Ressourcenname für den zugehörigen Lead befindet sich im Feld lead.

Unterhaltungsdaten können aus der Ressource local_services_lead_conversation abgerufen werden. Hier ist ein Beispiel für eine Anfrage, mit der nach Ergebnissen gefiltert wird, die Telefonanrufe sind:

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.conversation_channel,
  local_services_lead_conversation.participant_type,
  local_services_lead_conversation.lead,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.phone_call_details.call_duration_millis,
  local_services_lead_conversation.phone_call_details.call_recording_url,
  local_services_lead_conversation.message_details.text,
  local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

Mit der Methode LocalServicesLeadService.AppendLeadConversation können Sie LocalServicesLeadConversation-Ressourcen an eine LocalServicesLead anhängen.

Beschränkungen

  • Um auf die URL für die Anrufaufzeichnung zuzugreifen, müssen Sie sich mit einer E-Mail-Adresse anmelden, die mindestens Lesezugriff auf das Google Ads-Kundenkonto hat, zu dem die Kampagne gehört, mit der der Lead verknüpft ist.

  • Das Abrufen aller Unterhaltungen auf einmal kann zeitaufwendig sein. Filtern Sie Unterhaltungen daher beispielsweise nach Lead:

    SELECT
local_services_lead_conversation.id,
local_services_lead_conversation.event_date_time,
local_services_lead_conversation.message_details.text
FROM local_services_lead_conversation
WHERE local_services_lead.id = LEAD_ID

Bestätigungsartefakt für Google Lokale Dienstleistungen

LocalServicesVerificationArtifact stellt Bestätigungsdaten für die Unternehmen von Werbetreibenden bereit. Diese Bestätigungen erfolgen auf Unternehmensebene und umfassen keine Bestätigungen für Mitarbeiter. Die Daten umfassen Folgendes:

  • Lizenzüberprüfungen
  • Versicherungsbestätigungen
  • Zuverlässigkeitsüberprüfungen
  • Überprüfungen der Gewerbeanmeldung

Jedes Mal, wenn ein Überprüfungsantrag für Google Lokale Dienstleistungen eingereicht wird, wird dafür eine neue Instanz des Überprüfungsobjekts in der Google Ads API erstellt. Jedes Überprüfungsobjekt steht für einen einzelnen Überprüfungsantrag. Je nach Art der Überprüfungsanfrage kann jedes Überprüfungsobjekt einige der folgenden Informationen enthalten:

  • Status der einzelnen Bestätigungsartefakte
  • URL für die Zuverlässigkeitsüberprüfung, die für die Bestätigung der Zuverlässigkeitsüberprüfung verwendet werden soll
  • Bearbeitungszeit für die Zuverlässigkeitsüberprüfung (falls zutreffend)
  • URL des Versicherungsdokuments, um die bereits eingereichten Versicherungsinformationen aufzurufen
  • Grund für die Ablehnung der Versicherung (falls zutreffend)
  • Lizenzdetails (Typ, Nummer, Vor- und Nachname)
  • Grund für die Ablehnung der Lizenz (falls zutreffend)
  • URL des Lizenzdokuments, um bereits eingereichte Lizenzbilder anzusehen (falls zutreffend)
  • Details zur Registrierung des Unternehmens (Ausweis, Registrierungsnummer)
  • Ablehnungsgrund für die Gewerbeanmeldung (falls zutreffend)
  • URL des Dokuments zur Gewerbeanmeldung, um bereits eingereichte Bilder der Registrierung anzusehen (falls zutreffend)

Daten zu Überprüfungsartefakten können aus der Ressource local_services_verification_artifact abgerufen werden. Hier ist ein Beispiel für eine Abfrage, mit der Daten für alle lizenzbezogenen Bestätigungsartefakte für ein bestimmtes Kundenkonto abgerufen werden:

SELECT
  local_services_verification_artifact.id,
  local_services_verification_artifact.creation_date_time,
  local_services_verification_artifact.status,
  local_services_verification_artifact.artifact_type,
  local_services_verification_artifact.license_verification_artifact.license_type,
  local_services_verification_artifact.license_verification_artifact.license_number,
  local_services_verification_artifact.license_verification_artifact.licensee_first_name,
  local_services_verification_artifact.license_verification_artifact.licensee_last_name,
  local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'

Geografische und kategorische Lizenz- und Versicherungsdaten

Wenn Sie den Status von Bestätigungsanfragen programmatisch nach geografischem Standort (insbesondere geografischer Zielcode) und ID der Kategorie für lokale Dienste ermitteln möchten, können Sie ein neues Feld in der Ressource customer verwenden, das LocalServicesSettings heißt.

Dieses Feld enthält eine allgemeine Zusammenfassung des Status von Anfragen zur Überprüfung von Lizenzen und Versicherungen nach Standort und Kategorie. Hier ist ein Beispiel für eine Abfrage, mit der alle diese Daten abgerufen werden:

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

Mitarbeiter von Google Lokale Dienstleistungen

Über LocalServicesEmployee werden die Daten zu Mitarbeitern von lokalen Dienstleistern bereitgestellt, die Werbetreibende in ihr Anzeigenprofil in unseren Systemen hochgeladen haben.

Hier ist ein Beispiel für eine Abfrage, mit der Daten für alle Mitarbeiter von lokalen Diensten für ein bestimmtes Kundenkonto abgerufen werden:

SELECT
  local_services_employee.status,
  local_services_employee.type,
  local_services_employee.university_degrees,
  local_services_employee.residencies,
  local_services_employee.fellowships,
  local_services_employee.job_title,
  local_services_employee.year_started_practicing,
  local_services_employee.languages_spoken,
  local_services_employee.first_name,
  local_services_employee.middle_name,
  local_services_employee.last_name
FROM local_services_employee