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 für lokale Dienstleistungen.

Kampagnen und Budgets für lokale Dienstleistungen abrufen

Kampagnen und Budgets für lokale Dienstleistungen können mit der GoogleAdsService.Search oder GoogleAdsService.SearchStream Methode abgerufen werden. Dazu müssen Sie Campaign Ressourcen abfragen, 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 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 durch Festlegen des Felds manual_cpa

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

• MaximizeConversions durch Festlegen des Felds maximize_conversions

Werbezeitplaner als Kampagnenkriterium festlegen

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

Erstellen Sie eine AdScheduleInfo und legen Sie sie für die ad_schedule des CampaignCriterion fest, das mit CampaignCriterionService.MutateCampaignCriteria an die Google Ads API gesendet wird.

Geografisches Targeting festlegen

Wenn Sie die geografische Ausrichtung für eine Kampagne für lokale Dienstleistungen aktivieren möchten, fügen Sie eine LocationInfo hinzu und legen Sie sie für das location Feld des CampaignCriterion fest, das mit CampaignCriterionService.MutateCampaignCriteria an die Google Ads API gesendet wird. Weitere Informationen finden Sie unter Geografische Ausrichtung.

Auf bestimmte Diensttypen ausrichten

Wenn Sie die Ausrichtung auf einen bestimmten Diensttyp aktivieren möchten, erstellen Sie eine LocalServiceIdInfo mit einer der Kategorie-IDs für lokale Dienstleistungen, legen Sie sie für das Feld local_service_id eines a CampaignCriterion fest und senden Sie sie mit CampaignCriterionService.MutateCampaignCriteria.

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

Feedback zu Anfragen senden

Verwenden Sie die ProvideLeadFeedback Methode von LocalServicesLeadService, um eine Bewertung und Feedback für eine Anfrage zu senden. Sie können auch das lead_feedback_submitted Feld von LocalServicesLead prüfen, um festzustellen, ob eine Anfrage bewertet und Feedback gesendet wurde.

Nicht unterstützte Vorgänge

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

Ressourcen für lokale Dienstleistungen

Einige Daten aus Anzeigen für lokale Dienstleistungen werden direkt in der Google Ads API über die folgenden Lesezugriff Berichts ressourcen verfügbar gemacht:

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

Damit diese Ressourcen Daten zurückgeben können, muss im Kundenkonto, das die Anfrage stellt, eine Kampagne für lokale Dienstleistungen vorhanden sein. Da es nur eine Kampagne für lokale Dienstleistungen pro Kundenkonto geben kann, wird in diesen Ressourcen keine Kampagne angegeben. Verwenden Sie die folgende Abfrage, um die Kampagne zu ermitteln, mit der diese Ressourcen verknüpft 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 einen Dienst des Werbetreibenden anruft, ihm eine Nachricht sendet oder ihn bucht.

Anfragedaten aus Google Lokale Dienstleistungen können aus der local_services_lead Ressource 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.
• Ab v25 wird ContactDetails.email entfernt und ContactDetails.phone_number_extension ist in der Nachricht ContactDetails verfügbar, die von local_services_lead.contact_details zurückgegeben wird.
• Daten aus Anfragen, bei denen die category_id zu einer Kategorie im Gesundheitswesen gehört, sind nicht verfügbar.

Unterhaltung zu einer Anfrage aus Google Lokale Dienstleistungen

LocalServicesLeadConversation enthält die Details von Unterhaltungen, die im Rahmen einer LocalServicesLead. Es besteht eine 1:n-Beziehung zu LocalServicesLead, wobei eine Anfrage viele Unterhaltungen haben kann. Der Ressourcenname für die zugehörige Anfrage befindet sich im Feld lead.

Unterhaltungsdaten können aus der local_services_lead_conversation Ressource abgerufen werden. Hier ein Beispiel für eine Abfrage, 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 LocalServicesLeadService.AppendLeadConversation Methode 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 die Anfrage verknüpft ist.

• Das Anfordern aller Unterhaltungen auf einmal kann zeitaufwendig sein. Sie sollten Unterhaltungen daher nach Anfrage filtern, z. B.:

  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'
  

Überprüfungsartefakte

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

• Lizenzbestätigungen
• Versicherungsbestätigungen
• Bestätigungen der Zuverlässigkeitsüberprüfung
• Bestätigungen der Gewerbeanmeldung

Jedes Mal, wenn eine Bestätigungsanfrage an Google Lokale Dienstleistungen gesendet wird, wird in der Google Ads API eine neue Bestätigungsartefaktinstanz dafür erstellt. Jedes Bestätigungsartefakt steht für eine einzelne Bestätigungsanfrage. Je nach Art der Bestätigungsanfrage kann jedes Bestätigungsartefakt 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
• Zeitpunkt der Entscheidung zur Zuverlässigkeitsüberprüfung (falls zutreffend)
• URL des Versicherungsdokuments, um die bereits eingereichten Versicherungsinformationen anzusehen
• 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 Lizenzbild anzusehen (falls zutreffend)
• Details zur Gewerbeanmeldung (Bestätigungs-ID, Registrierungsnummer)
• Grund für die Ablehnung der Gewerbeanmeldung (falls zutreffend)
• URL des Dokuments zur Gewerbeanmeldung, um das bereits eingereichte Registrierungsbild anzusehen (falls zutreffend)

Bestätigungsartefaktdaten können aus der local_services_verification_artifact Ressource abgerufen werden. Hier ein Beispiel für eine Abfrage, die Daten für alle lizenzbezogenen Bestätigungsartefakte für ein bestimmtes Kundenkonto abruft:

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 Bestätigungsdaten

Wenn Sie den Status von Bestätigungsanfragen programmatisch nach geografischem Standort (insbesondere nach geografischem Zielcode) und Kategorie-ID für lokale Dienstleistungenbestimmen möchten, können Sie das local_services_settings Feld in der Ressource customer verwenden, die den Typ LocalServicesSettingshat.

Dieses Feld enthält eine allgemeine Zusammenfassung des Status von Lizenz- und Versicherungsbestätigungsanfragen nach Standort und Kategorie. Hier ein Beispiel für eine Abfrage, die alle diese Daten abruft:

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

Mitarbeiter von Google Lokale Dienstleistungen

LocalServicesEmployee enthält die Daten zu Mitarbeitern von Google Lokale Dienstleistungen, die Werbetreibende in unser System hochgeladen haben.

Hier ein Beispiel für eine Abfrage, die Daten für alle Mitarbeiter von Google Lokale Dienstleistungen für ein bestimmtes Kundenkonto abruft:

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 Einstellungen für lokale Dienstleistungen ab v24. Mit diesen Einstellungen können Sie eine Performance Max-Kampagne konfigurieren und identifizieren, in der Anzeigen für lokale Dienstleistungen ausgeliefert werden (GLS PMax).

Performance Max-Kampagnen für lokale Dienstleistungen erstellen

Ab v26 können Sie neue Performance Max-Kampagnen für lokale Dienstleistungen über die API erstellen, indem Sie eine Performance Max-Kampagne (advertising_channel_type = 'PERFORMANCE_MAX') erstellen und local_services_enabled = true für pmax_campaign_settings festlegen (nach dem Erstellen unveränderlich). Beim Erstellen einer Performance Max-Kampagne für 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.

Performance Max-Kampagnen für lokale Dienstleistungen identifizieren

Wenn Sie feststellen möchten, ob es sich bei einer Performance Max-Kampagne um eine Kampagne für lokale Dienstleistungen handelt, prüfen Sie das local_services_enabled Feld in den pmax_campaign_settings der Kampagne.

Einstellungen konfigurieren

Konfigurieren Sie für Kampagnen, bei denen local_services_enabled auf true gesetzt ist, die Einstellungen im local_services_pmax_campaign_settings Feld:

• listing_id: Die Google Unternehmensprofil-Eintrags-ID, die mit der Kampagne verknüpft ist. Ab v26 ist dieses Feld beim Erstellen von Performance Max-Kampagnen für lokale Dienstleistungen erforderlich und unveränderlich. Die Eintrags-ID muss als aktiviertes LOCATION Asset mit dem Konto verknüpft sein. Andernfalls gibt die API den CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID Fehler 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 Asset Ressource nach aktivierten LOCATION Assets abfragen (Prüfen von location_asset.business_profile_locations). Weitere Informationen finden Sie unter Standort-Assets.
• navigational_query_leads_enabled: Gibt an, ob ein Filter für Navigationsabfragen 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 ist ein Ländercode mit zwei Buchstaben in Großbuchstaben, der verwendet wird, um die Bestätigungsanforderungen zu bestimmen und die Auswahl von Standortkriterien zu validieren.
• phone_numbers: Eine Liste von Telefonnummern, die mit dem Anbieter verknüpft sind, dargestellt durch LocalServicesPhoneNumber-Nachrichten.

Telefonnummern

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

• phone_number: Die Telefonnummer.
• country_code: Ländercode mit zwei Buchstaben in Großbuchstaben .
• phone_number_type: Der Typ der Telefonnummer, definiert durch GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Unterstützte Typen:
  • 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.