Kampagnen für lokale Dienstleistungen

Mit Google Lokale Dienstleistungen-Kampagnen können Sie Ihr Unternehmen auf Google bewerben und Anfragen direkt 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 Google Ads API unterstützt die folgenden Vorgänge für Google Lokale Dienstleistungen-Kampagnen.

Kampagnen und Budgets für Google Lokale Dienstleistungen abrufen

Kampagnen und Budgets für Google Lokale Dienstleistungen können mit der Methode GoogleAdsService.Search oder GoogleAdsService.SearchStream abgerufen werden, um Campaign-Ressourcen abzufragen, wobei 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'

Google Lokale Dienstleistungen-Kampagnen bearbeiten

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

Gebotsstrategie für Kampagnen für Google Lokale Dienstleistungen festlegen

Sie können die folgenden Gebotsstrategien als Standardgebotsstrategie für Google Lokale Dienstleistungen-Kampagnen festlegen:

Werbezeitplaner als Kampagnenkriterium festlegen

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

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

Geografische Ausrichtung festlegen

Wenn Sie die Standorteinstellung 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 das Feld location des CampaignCriterion fest, das 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, erstellen Sie ein LocalServiceIdInfo mit einer der Kategorie-IDs für Google Lokale Dienstleistungen, legen Sie es im Feld local_service_id eines CampaignCriterion fest und senden Sie es mit CampaignCriterionService.MutateCampaignCriteria ein.

Verwenden Sie eine Dienst-ID, die mit der Ausrichtung Ihrer Kampagne in Bezug auf Standort und Kategorie ü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 mit Google 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 Google Lokale Dienstleistungen-Kampagne vorhanden sein. Da es pro Kundenkonto nur eine Kampagne für Google Lokale Dienstleistungen 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 aus Google Lokale Dienstleistungen

LocalServicesLead enthält die Details einer Anfrage, die generiert wird, wenn ein Nutzer den Werbetreibenden anruft, ihm eine Nachricht sendet oder einen Termin bei ihm bucht.

Lead-Daten für Google Lokale Dienstleistungen können über die Ressource local_services_lead abgerufen werden. Hier ist 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.
  • Ab v25 wird ContactDetails.email entfernt und ContactDetails.phone_number_extension ist in der ContactDetails-Nachricht verfügbar, die von local_services_lead.contact_details zurückgegeben wird.
  • Daten aus Leads, bei denen category_id Teil einer Gesundheitskategorie ist, sind nicht verfügbar.

Anfragen aus 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 local_services_lead_conversation-Ressource abgerufen werden. Hier ist ein Beispiel für eine Abfrage, 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.

  • Wenn Sie alle Unterhaltungen auf einmal anfordern, kann das sehr lange dauern. 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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'

Bestätigungsartefakt für Google Lokale Dienstleistungen

LocalServicesVerificationArtifact stellt Überprüfungsdaten 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
  • Versicherungsüberprüfungen
  • Zuverlässigkeitsüberprüfungen
  • Bestätigungen der Gewerbeanmeldung

Jedes Mal, wenn eine Überprüfungsanfrage für Google Lokale Dienstleistungen gesendet wird, wird in der Google Ads API eine neue Instanz des Überprüfungsobjekts erstellt. Jedes Überprüfungsobjekt steht für eine einzelne Überprüfungsanfrage. 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 zum Aufrufen des bereits eingereichten Lizenzbilds (falls zutreffend)
  • Details der Gewerbeanmeldung (Ausweis, Registrierungsnummer)
  • Grund für die Ablehnung der Gewerbeanmeldung (falls zutreffend)
  • URL des Dokuments zur Gewerbeanmeldung, um bereits eingereichte Registrierungsbilder anzusehen (falls zutreffend)

Daten für das Überprüfungsobjekt 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 Geotargeting-Code) und ID der Kategorie für Google Lokale Dienstleistungen ermitteln möchten, können Sie das Feld local_services_settings in der Ressource customer verwenden, die den Typ LocalServicesSettings hat.

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 unser System hochgeladen haben.

Hier ist ein Beispiel für eine Abfrage, mit der Daten für alle Mitarbeiter von lokalen Dienstleistern 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

Performance Max-Kampagnen für Google Lokale Dienstleistungen

Performance Max-Kampagnen unterstützen ab v24 Einstellungen für lokale Dienstleistungen. Mit diesen Einstellungen können Sie eine Performance Max-Kampagne konfigurieren und identifizieren, in der Anzeigen für lokale Dienstleistungen ausgeliefert werden.

Google Lokale Dienstleistungen Performance Max-Kampagnen erkennen

Wenn Sie herausfinden möchten, ob es sich bei einer Performance Max-Kampagne um eine Google Lokale Dienstleistungen-Kampagne handelt, sehen Sie sich das schreibgeschützte Feld local_services_enabled auf der pmax_campaign_settings der Kampagne an.

Einstellungen konfigurieren

Konfigurieren Sie für Kampagnen, in denen local_services_enabled gleich true ist, die Einstellungen im Feld local_services_pmax_campaign_settings:

  • navigational_query_leads_enabled: Gibt an, ob ein Navigationsabfragefilter verwendet werden soll.
  • founding_year: Das Gründungsjahr des Unternehmens.
  • country_code: Der Ländercode der Anzeige für lokale Dienstleistungen. Dieses Feld ist unveränderlich und wird einmal beim Erstellen der Anzeige festgelegt. Es handelt sich um einen aus zwei Buchstaben bestehenden Ländercode in Großbuchstaben, der verwendet wird, um die Bestätigungsanforderungen zu ermitteln und die Auswahl des Standortkriteriums zu validieren.
  • phone_numbers: Eine Liste der Telefonnummern, die dem Anbieter zugeordnet sind, dargestellt durch LocalServicesPhoneNumber-Nachrichten.

Telefonnummern

Jeder Eintrag im wiederholten Feld phone_numbers verwendet den Nachrichtentyp LocalServicesPhoneNumber mit den folgenden Feldern:

  • phone_number: Die Telefonnummer.
  • country_code: Aus zwei Buchstaben bestehender Ländercode in Großbuchstaben.
  • phone_number_type: Der Typ der Telefonnummer, definiert durch GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Folgende Typen werden unterstützt:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: Zielnummer für Anrufe aus einem Anzeigenblock für lokale Dienstleistungen (Standard).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Zielnummer, die SMS unterstützt.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Zielnummer für das WhatsApp-Konto eines Anbieters.