Mit Google Lokale Dienstleistungen-Kampagnen 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 Google Lokale Dienstleistungen abrufen
Kampagnen und Budgets bei Google Lokale Dienstleistungen können mit der Methode GoogleAdsService.Search oder GoogleAdsService.SearchStream abgerufen werden. Dazu müssen Sie die 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'
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:
ManualCpadurch Festlegen des Feldsmanual_cpaSie können die Gebote von
ManualCpaüberLocalServicesCampaignSettings.category_bidsfestlegen. Sie könnenLocalServicesCampaignSettingsvon Kampagnen für Google Lokale Dienstleistungen überCampaign.local_services_campaign_settingsabrufen und festlegen.MaximizeConversions, indem Sie das Feldmaximize_conversionsfestlegen.
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 den ad_schedule des CampaignCriterion fest, der an die Google Ads API gesendet wird.
Geografische Ausrichtung festlegen
Wenn Sie die geografische Ausrichtung für eine Kampagne bei Google Lokale Dienstleistungen aktivieren möchten, fügen Sie ein LocationInfo hinzu und legen Sie es auf den location des CampaignCriterion fest, der mit CampaignCriterionService.MutateCampaignCriteria 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, fügen Sie ein LocalServiceIdInfo hinzu und legen Sie es auf den Diensttyp fest.
Verwenden Sie eine Dienst-ID, die mit dem Standort und der Kategorie Ihrer Kampagne übereinstimmt.
Feedback zu Anfragen geben
Verwenden Sie die Methode ProvideLeadFeedback() von LocalServicesLeadService, um eine Bewertung und Feedback für einen Lead einzureichen. Sie können auch das Feld lead_feedback_submitted des LocalServicesLead-Objekts 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 Anzeigengruppen, Anzeigen oder Kriterien in Kampagnen für Google Lokale Dienstleistungen nicht 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:
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
Damit diese Ressourcen Daten zurückgeben, 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 werden, wenn ein Nutzer den Werbetreibenden anruft, ihm eine Nachricht sendet oder einen Dienst bei ihm bucht.
Anfragedaten für Google Lokale Dienstleistungen können über die Ressource local_services_lead 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_detailsist null, wennlead_statusgleichWIPED_OUTist. - Daten aus Leads, bei denen
category_idTeil einer Kategorie für Gesundheitswesen ist, sind nicht verfügbar.
Anfragen aus Google Lokale Dienstleistungen – Unterhaltung
LocalServicesLeadConversation
macht die Details von Unterhaltungen sichtbar, die im Rahmen eines
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 Ressource local_services_lead_conversation 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.
Das Anfordern aller Unterhaltungen auf einmal kann zeitaufwendig sein. 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.id = LEAD_ID
Bestätigungsdokument für Google Lokale Dienstleistungen
LocalServicesVerificationArtifact
stellt Daten zur Identitätsbestätigung 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
- Versicherungsbestätigungen
- Zuverlässigkeitsüberprüfungen
- Bestätigungen der Gewerbeanmeldung
Jedes Mal, wenn ein Überprüfungsantrag für Google Lokale Dienstleistungen eingereicht wird, wird in der Google Ads API eine neue Instanz des Überprüfungsartefakts dafür erstellt. Jedes Überprüfungsartefakt steht für einen einzelnen Überprüfungsantrag. 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 zur Gewerbeanmeldung (Ausweis, Registrierungsnummer)
- Grund für die Ablehnung der Gewerbeanmeldung (falls zutreffend)
- URL des Dokuments zur Gewerbeanmeldung, um das bereits eingereichte Registrierungsbild anzusehen (falls zutreffend)
Daten zu Überprüfungsartefakten 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 geografischer Zielcode) und ID der Kategorie für lokale Dienste ermitteln möchten, können Sie ein neues Feld in der Ressource customer verwenden, das LocalServicesSettings heißt.
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 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 ihr Anzeigenprofil in unseren Systemen hochgeladen haben.
Hier ist ein Beispiel für eine Abfrage, mit der Daten für alle Mitarbeiter von lokalen Diensten 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 Version 24.2 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 Local Services-Anzeige. 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 Anforderungen für die Bestätigung zu ermitteln und die Auswahl des Standortkriteriums zu validieren.phone_numbers: Eine Liste der Telefonnummern, die dem Anbieter zugeordnet sind, dargestellt durchLocalServicesPhoneNumber-Nachrichten.
Telefonnummern
Für jeden Eintrag im wiederkehrenden Feld phone_numbers wird der Nachrichtentyp LocalServicesPhoneNumber mit den folgenden Feldern verwendet:
phone_number: Die Telefonnummer.country_code: Aus zwei Buchstaben bestehender Ländercode in Großbuchstaben.phone_number_type: Der Typ der Telefonnummer, definiert durchGlsPhoneNumberTypeEnum.GlsPhoneNumberType. Folgende Typen werden unterstützt:DESTINATION_PHONE_NUMBER_FOR_ADS: Zielrufnummer 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.