Kampagnen für lokale Dienstleistungen

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

Unterstützte Vorgänge

Die Google Ads API unterstützt die folgenden Vorgänge für Kampagnen bei Google Lokale Dienstleistungen.

Kampagnen und Budgets für 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, bei denen advertising_channel_type = 'LOCAL_SERVICES' gilt. 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 amount_micros des zugehörigen Kampagnenbudgets aktualisieren.

Gebotsstrategie festlegen

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

• ManualCpa, indem Sie das Feld manual_cpa festlegen

  Sie können die Gebote von ManualCpa über LocalServicesCampaignSettings.category_bids festlegen. Sie können LocalServicesCampaignSettings von Kampagnen für lokale Dienstleistungen über Campaign.local_services_campaign_settings abrufen und festlegen.

• MaximizeConversions, indem Sie das Feld maximize_conversions 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 die ad_schedule der CampaignCriterion fest, die an die Google Ads API gesendet wird.

Geografisches Targeting festlegen

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

Auf bestimmte Diensttypen ausrichten

Wenn Sie die Ausrichtung 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 reichen Sie es mit CampaignCriterionService.MutateCampaignCriteria ein.

Sie sollten eine Dienst-ID verwenden, die der Zielregion und der Kategorie Ihrer Kampagne entspricht.

Feedback zu Anfragen geben

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

Nicht unterstützte Vorgänge

In der folgenden Tabelle sind nicht unterstützte Vorgänge für eigenständige Kampagnen für Google Lokale Dienstleistungen (advertising_channel_type = 'LOCAL_SERVICES') aufgeführt.

Ressourcen für Google Lokale Dienstleistungen

Einige Daten aus Anzeigen für lokale Dienstleistungen werden direkt in der Google Ads API über die folgenden Lesezugriff Berichtsressourcen bereitgestellt:

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

Damit diese Ressourcen Daten zurückgeben, muss im Kundenkonto, das die Anfrage stellt, eine Kampagne für lokale Dienstleistungen oder eine Performance Max-Kampagne für lokale Dienstleistungen vorhanden sein. Über das Feld local_services_lead.campaign werden Lead-Datensätze mit der zugehörigen Kampagne verknüpft, einschließlich Performance Max-Kampagnen mit Zielvorhaben vom Typ „Abrechnung pro Anfrage“, bei denen campaign.advertising_channel_type = 'PERFORMANCE_MAX' und campaign.pmax_campaign_settings.local_services_enabled = true gilt. Mit der folgenden Abfrage können Sie die Kampagne ermitteln, mit der diese Ressourcen verknüpft sind:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

Anfrage aus Google Lokale Dienstleistungen

LocalServicesLead stellt die Details eines Leads bereit, die generiert werden, wenn ein Nutzer den Werbetreibenden anruft, ihm eine Nachricht sendet, einen Dienst bucht oder einen Gutschein des Werbetreibenden verwendet.

Der Lead-Typ wird durch LocalServicesLeadType definiert. Ab v26 wird COUPON unterstützt, um Gutschein-Anfragetypen in Google Lokale Dienstleistungen und Performance Max-Kampagnen für Google Lokale Dienstleistungen zu aktivieren.

Über das Feld campaign wird der Lead-Datensatz mit der zugehörigen Kampagne verknüpft. Zusätzlich zur Auswahl von zugeordneten campaign-Feldern (z. B. campaign.id und campaign.name) können Sie Lead-Abfragen nach Kampagnenressourcenname (WHERE local_services_lead.campaign = ...) oder nach Werbekanal (WHERE campaign.advertising_channel_type = ...) filtern, um Leads nach Kampagnentyp zu segmentieren.

Anfragedaten zu Google Lokale Dienstleistungen können aus der Ressource local_services_lead abgerufen werden. Hier ist eine Beispielabfrage:

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,
  local_services_lead.campaign
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 von Leads, bei denen die category_id zu einer Gesundheitskategorie gehört, sind nicht verfügbar.

Unterhaltung mit einem Interessenten aus Google Lokale Dienstleistungen

LocalServicesLeadConversation stellt die Details von Unterhaltungen bereit, 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 ist im Feld lead enthalten.

Unterhaltungsdaten können aus der Ressource local_services_lead_conversation abgerufen werden. Hier ist eine Beispielabfrage, die nach Ergebnissen filtert, 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

• Wenn Sie auf die URL der Anrufaufzeichnung zugreifen möchten, 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. Daher sollten Sie Unterhaltungen beispielsweise nach Lead filtern:

  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'
  

Artefakte zur Überprüfung

LocalServicesVerificationArtifact stellt Daten zur Identitätsbestätigung für die Unternehmen von Werbetreibenden bereit. Diese Überprüfungen erfolgen auf Unternehmensebene und umfassen keine Überprüfungen von Mitarbeitern. Die Daten umfassen Folgendes:

• Lizenzüberprüfungen
• Versicherungsüberprüfungen
• Zuverlässigkeitsüberprüfungen
• Überprüfungen der Gewerbeanmeldung

Jedes Mal, wenn eine Überprüfungsanfrage an Google Lokale Dienstleistungen gesendet wird, wird in der Google Ads API eine neue Instanz eines Überprüfungsartefakts dafür erstellt. Jedes Überprüfungsartefakt steht für eine einzelne Überprüfungsanfrage. Jedes Bestätigungsartefakt kann je nach Art der Bestätigungsanfrage 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
• Dauer der 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 das bereits eingereichte Bild der Lizenz anzusehen (falls zutreffend)
• Details der Gewerbeanmeldung (Prüf-ID, Registrierungsnummer)
• Grund für die Ablehnung der Gewerbeanmeldung (falls zutreffend)
• URL des Registrierungsdokuments, um die bereits eingereichte Registrierung anzusehen (falls zutreffend)

Überprüfungsartefakt-Daten können aus der Ressource local_services_verification_artifact abgerufen werden. Hier ist eine Beispielabfrage, 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_override_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 kategoriespezifische Bestätigungsdaten

Wenn Sie den Status von Bestätigungsanfragen nach geografischem Standort (insbesondere Code für geografisches Targeting) und Kategorie-ID für Google Lokale Dienstleistungen programmatisch ermitteln möchten, können Sie das Feld local_services_settings der Ressource customer verwenden, die den Typ LocalServicesSettings hat.

In diesem Feld wird eine allgemeine Zusammenfassung des Status von Anfragen zur Überprüfung von Lizenzen und Versicherungen nach Standort und Kategorie angezeigt. Hier ist eine Beispielabfrage, 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

LocalServicesEmployee stellt die Daten zu Mitarbeitern von lokalen Dienstleistern bereit, die Werbetreibende in ihren Anzeigenprofilen in unsere Systeme hochgeladen haben.

Hier ist eine Beispielabfrage, mit der Daten für alle Mitarbeiter des lokalen Dienstes 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 lokale Dienstleistungen

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

Performance Max-Kampagnen für lokale Dienstleistungen erstellen

Ab v26 können Sie mit der Google Ads API Performance Max-Kampagnen für lokale Dienstleistungen erstellen und aktualisieren. Sie können neue Performance Max-Kampagnen für Google Lokale Dienstleistungen über die API erstellen. Erstellen Sie dazu eine Performance Max-Kampagne (advertising_channel_type = 'PERFORMANCE_MAX') und legen Sie local_services_enabled = true für pmax_campaign_settings fest (nach der Erstellung unveränderlich). Beim Erstellen einer Performance Max-Kampagne für Google Lokale Dienstleistungen sind sowohl country_code als auch listing_id in local_services_pmax_campaign_settings erforderlich. In v24 und v25 unterstützt die API nur Aktualisierungen für vorhandene Performance Max-Kampagnen für lokale Dienstleistungen, die in der Benutzeroberfläche von Konten auf der Zulassungsliste erstellt wurden. Eine vollständige Anleitung zum Konfigurieren der Voraussetzungen und zum atomaren Erstellen von Kampagnen finden Sie im Leitfaden zu Performance Max-Kampagnen mit Zielvorhaben vom Typ „Abrechnung pro Anfrage“.

Performance Max-Kampagnen für Google Lokale Dienstleistungen identifizieren

Wenn Sie herausfinden möchten, ob eine Performance Max-Kampagne eine Kampagne für lokale Dienstleistungen ist, prüfen Sie das Feld local_services_enabled in der pmax_campaign_settings der Kampagne. Dieses Feld ist ein unveränderlicher (CREATE ONLY) boolescher Wert, der bei der Kampagnenerstellung auf true festgelegt wird.

Einstellungen konfigurieren

Konfigurieren Sie für Kampagnen, bei denen local_services_enabled den Wert true hat, die Einstellungen im Feld local_services_pmax_campaign_settings:

• listing_id: Die ID des Google Unternehmensprofil-Eintrags, der mit der Kampagne verknüpft ist. Ab v26 ist dieses Feld beim Erstellen von Performance Max-Kampagnen für Google Lokale Dienstleistungen erforderlich und kann nicht mehr geändert werden. Die Eintrags-ID muss mit dem Konto als aktiviertes LOCATION-Asset verknüpft sein. Andernfalls gibt die API den Fehler CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID zurück. Da listing_id als IMMUTABLE gekennzeichnet ist, schlägt der Versuch, dieses Feld nach dem Erstellen der Kampagne zu aktualisieren, mit RequestError.IMMUTABLE_FIELD fehl. Entwickler können verknüpfte Eintrags-IDs ermitteln oder überprüfen, indem sie die Ressource Asset nach aktivierten LOCATION-Assets abfragen (location_asset.business_profile_locations prüfen). Weitere Informationen finden Sie unter Standort-Assets.
• 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. Ab v26 ist dieses Feld erforderlich und unveränderlich. Es wird einmalig beim Erstellen der Kampagne festgelegt. Es handelt sich um einen aus zwei Großbuchstaben bestehenden Ländercode (derzeit wird nur US für Performance Max-Kampagnen für lokale Dienstleistungen unterstützt), mit dem die Bestätigungsanforderungen ermittelt und die Auswahl der Standortkriterien validiert werden.
• phone_numbers: Eine Liste der Telefonnummern, die dem Anbieter zugeordnet sind, dargestellt durch LocalServicesPhoneNumber-Nachrichten. Wenn Sie keine angeben, wird standardmäßig die Telefonnummer aus dem verknüpften Google Unternehmensprofil-Eintrag verwendet. Wenn der Unternehmensprofil-Eintrag keine Telefonnummer enthält, ist die Angabe einer Telefonnummer erforderlich.

Telefonnummern

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

• phone_number: Die Telefonnummer.
• country_code: Ländercode mit zwei 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 über einen Anzeigenblock für lokale Dienstleistungen (für Anrufanfragen, Standard).
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Zielnummer, die SMS unterstützt (optional, für SMS-Benachrichtigungen zu SMS-Anfragen).
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Zielnummer für das WhatsApp-Konto eines Anbieters.