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, um 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 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:

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.

Verwenden Sie eine Dienst-ID, die mit dem Ausrichtungsort location und category Ihrer Kampagne übereinstimmt.

Feedback zu Anfragen senden

Verwenden Sie die ProvideLeadFeedback Methode des LocalServicesLeadService, um eine Bewertung und Feedback für eine Anfrage zu senden. Sie können auch das lead_feedback_submitted Feld des LocalServicesLead prüfen, um festzustellen, ob eine Anfrage bewertet und Feedback gesendet 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 Die Google Ads API blockiert die Erstellung neuer Kampagnen für lokale Dienstleistungen.
Vorgänge für untergeordnete Entitäten in einer Kampagne Die Google Ads API unterstützt nicht das Erstellen, Ändern, Entfernen oder Abrufen von Anzeigengruppen, Anzeigen oder Kriterien in Kampagnen für lokale Dienstleistungen.

Ressourcen für lokale Dienstleistungen

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

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 identifizieren, 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 Kunde 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 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
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 eines 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 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 LocalServicesLeadService.AppendLeadConversation Methode können Sie LocalServicesLeadConversation Ressourcen an ein LocalServicesLead anhängen.

Beschränkungen

  • Um auf die URL der 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 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 ist eine Beispielabfrage, 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 kategoriale Bestätigungsdaten

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

Dieses Feld enthält eine allgemeine Zusammenfassung des Status von Lizenz- und Versicherungsbestätigungsanfragen nach Standort und Kategorie. Hier ist eine Beispielabfrage, 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, deren Anzeigenprofil von den Werbetreibenden in unsere Systeme hochgeladen wurde.

Hier ist eine Beispielabfrage, 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 Google Lokale Dienstleistungen

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

Ab v26 können Sie neue Performance Max-Kampagnen für Google Lokale Dienstleistungen über die API erstellen, indem Sie local_services_enabled = true für pmax_campaign_settings festlegen (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 v25 und früher unterstützte die API nur Updates für bestehende Kampagnen, die in der Benutzeroberfläche von Nutzern auf der Zulassungsliste erstellt wurden.

Performance Max-Kampagnen für Google Lokale Dienstleistungen identifizieren

Prüfen Sie das Feld local_services_enabled in den pmax_campaign_settings der Kampagne, um festzustellen, ob es sich um eine Performance Max-Kampagne für Google Lokale Dienstleistungen handelt.

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 bei der Erstellung von Performance Max-Kampagnen für Google 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 der Kampagnenerstellung 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 bei der Anzeigenerstellung festgelegt. Es ist ein zweistelliger Ländercode in Großbuchstaben, der verwendet wird, um die Bestätigungsanforderungen zu bestimmen und die Auswahl der 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: Zweistelliger Ländercode 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.