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 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 für Google Lokale Dienstleistungen können mit der Methode GoogleAdsService.Search oder GoogleAdsService.SearchStream abgerufen werden. Suchen Sie dazu nach den Kampagnen-Ressourcen, 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 für lokale Dienstleistungen festlegen

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

Werbezeitplaner als Kampagnenkriterium festlegen

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

Erstellen Sie eine AdScheduleInfo und legen Sie sie mit CampaignCriterionService.MutateCampaignCriteria als ad_schedule der CampaignCriterion fest, die an die Google Ads API gesendet wird.

Geografische Ausrichtung festlegen

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

Targeting auf bestimmte Dienstleistungstypen

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

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

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 verhindert das Erstellen neuer Kampagnen bei Google Lokale Dienstleistungen.
Vorgänge auf untergeordneten Entitäten in einer Kampagne Die Google Ads API unterstützt nicht das Erstellen, Ändern, Entfernen oder Abrufen von Anzeigengruppen, Anzeigen oder Kriterien in lokalen Dienstleistungen-Kampagnen.

Ressourcen für Google Lokale Dienstleistungen

Einige Daten aus Google Lokale Dienstleistungen werden über die folgenden schreibgeschützten Berichtsressourcen direkt in der Google Ads API bereitgestellt:

Damit diese Ressourcen Daten zurückgeben können, muss im Kundenkonto, über das die Anfrage erfolgt, 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. Mit der folgenden Abfrage können Sie die Kampagne ermitteln, mit der diese Ressourcen verknüpft sind:

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

Google Lokale Dienstleistungen-Lead

LocalServicesLead enthält die Details eines Leads, die generiert werden, wenn ein Nutzer den Werbetreibenden anruft, ihm eine Nachricht sendet oder einen Dienst bucht.

Lead-Daten für lokale Dienstleistungen können aus der Ressource local_services_lead abgerufen werden. Hier 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.
  • Daten von Leads, bei denen die category_id zu einer Gesundheitskategorie gehört, sind nicht verfügbar.

Unterhaltung mit Leads für lokale Dienstleistungen

LocalServicesLeadConversation enthält die Details zu Unterhaltungen, die im Rahmen einer LocalServicesLead stattgefunden haben. Es besteht eine 1:n-Beziehung zu LocalServicesLead, bei der ein Lead viele Unterhaltungen haben kann. Den Ressourcennamen für den zugehörigen Lead finden Sie im Feld lead.

Unterhaltungsdaten können aus der Ressource local_services_lead_conversation abgerufen werden. Hier ist eine Beispielabfrage, die nach Ergebnissen für Anrufe filtert:

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'

Ab Version 17 der Google Ads API können Sie mit der Methode LocalServicesLeadService.AppendLeadConversation LocalServicesLeadConversation-Ressourcen an eine LocalServicesLead anhängen.

Beschränkungen

  • Um auf die URL der Anrufaufzeichnung zugreifen zu können, 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 Anfordern aller Unterhaltungen gleichzeitig kann zeitaufwendig sein. Daher sollten Sie Unterhaltungen nach Lead 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.id = LEAD_ID

Bestätigungs-Artefakt für lokale Dienstleistungen

LocalServicesVerificationArtifact enthält Bestätigungsdaten für die 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
  • Überprüfungen der Zuverlässigkeitsüberprüfung
  • Überprüfungen der Gewerbeanmeldung

Jedes Mal, wenn eine Überprüfungsanfrage an Google Lokale Dienstleistungen gesendet wird, wird in der Google Ads API eine neue Überprüfungsartefakt-Instanz erstellt. Jedes Überprüfungsartefakt steht für eine einzelne Überprüfungsanfrage. Je nach Art der Bestätigungsanfrage kann jedes Bestätigungsartefakt einige der folgenden Informationen enthalten:

  • Status der einzelnen Überprüfungsartefakte
  • URL für die Zuverlässigkeitsüberprüfung
  • Dauer der Zuverlässigkeitsüberprüfung (falls zutreffend)
  • URL des Versicherungsdokuments, unter der die bereits eingereichten Versicherungsinformationen angezeigt werden
  • Ablehnungsgrund der Versicherung (falls zutreffend)
  • Lizenzdetails (Typ, Nummer, Vorname, Nachname)
  • Grund für die Ablehnung der Lizenz (falls zutreffend)
  • URL des Lizenzdokuments, unter der das bereits eingereichte Lizenzbild angezeigt wird (falls zutreffend)
  • Details zur Registrierung des Unternehmens (Identitätsnachweis, Registrierungsnummer)
  • Ablehnungsgrund für die Gewerbeanmeldung (falls zutreffend)
  • URL des Dokuments zur Gewerbeanmeldung, unter der das bereits eingereichte Bild der Gewerbeanmeldung angezeigt wird (falls zutreffend)

Daten zu Überprüfungsartefakten können aus der Ressource local_services_verification_artifact abgerufen werden. Hier ist eine Beispielabfrage, mit der Daten für alle lizenzbezogenen Überprüfungsartefakte 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 Geotarget-Code) und Kategorie-ID für lokale Dienstleistungen ermitteln möchten, können Sie ein neues Feld namens LocalServicesSettings in der Ressource customer verwenden.

Dieses Feld enthält eine allgemeine Zusammenfassung des Status der Anträge auf Überprüfung von Lizenzen und Versicherungen nach Standort und Kategorie. 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 gibt die Daten zu Mitarbeitern von lokalen Dienstleistungen preis, die die Werbetreibenden in unsere Systeme hochgeladen haben.

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