Mit Kampagnen für Google 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 Google Lokale Dienstleistungen abrufen
Kampagnen und Budgets für Google Lokale Dienstleistungen können mit der
GoogleAdsService.Search oder
GoogleAdsService.SearchStream
Methode abgerufen werden, um Kampagnenressourcen 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'
Google Lokale Dienstleistungen-Kampagnen bearbeiten
Sie können die Felder status der Kampagne und
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 Google Lokale Dienstleistungen Kampagnen überCampaign.local_services_campaign_settingsabrufen und festlegen.MaximizeConversionsdurch Festlegen des Feldsmaximize_conversions
Werbezeitplaner als Kampagnenkriterium festlegen
Sie können einen Werbezeitplaner für eine Google Lokale Dienstleistungen-Kampagne als Kampagnenkriterium festlegen.
Erstellen Sie eine AdScheduleInfo und legen Sie sie auf die
ad_schedule des
CampaignCriterion fest, das mit
CampaignCriterionService.MutateCampaignCriteria an die Google Ads API gesendet wird.
Geografische Ausrichtung festlegen
Wenn Sie das Geo-Targeting für eine Kampagne für Google Lokale Dienstleistungen aktivieren möchten, fügen Sie eine
LocationInfo hinzu und legen Sie sie auf die location 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, fügen Sie eine LocalServiceIdInfo hinzu und legen Sie sie auf den type of
service fest.
Sie sollten eine Dienst-ID verwenden, die mit dem Ausrichtungsort location und category Ihrer Kampagne übereinstimmt.
Feedback zu Anfragen senden
Verwenden Sie die ProvideLeadFeedback() Methode des
LocalServicesLeadService, um
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 Google 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 Google Lokale Dienstleistungen. |
Ressourcen für Google Lokale Dienstleistungen
Einige Daten aus Google Lokale Dienstleistungen werden direkt in der Google Ads API über die folgenden schreibgeschützten Berichts ressourcen verfügbar gemacht:
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
Damit diese Ressourcen Daten zurückgeben können, muss im Kundenkonto, aus dem die Anfrage stammt, eine Google Lokale Dienstleistungen-Kampagne vorhanden sein. Da pro Kundenkonto nur eine Kampagne für Google Lokale Dienstleistungen vorhanden sein 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 vom 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 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_detailsist null, wennlead_statusgleichWIPED_OUTist. - Daten aus Anfragen, bei denen die
category_idzu 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 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. Daher sollten Sie Unterhaltungen 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.id = LEAD_ID
Bestätigungsartefakt für Google Lokale Dienstleistungen
LocalServicesVerificationArtifact
enthält Daten zur Identitätsbestätigung 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 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 Lizenz- und Versicherungsdaten
Wenn Sie den Status von Bestätigungsanfragen programmatisch nach geografischem
Standort (insbesondere geografischer Zielcode) und
Kategorie für lokale Dienstleistungen
ID bestimmen möchten, können Sie ein neues
Feld in der Ressource customer verwenden, das
LocalServicesSettings heißt.
Dieses Feld enthält eine allgemeine Zusammenfassung des Status von Lizenz- und Versicherungsbestätigungsanfragen nach Standort und Kategorie. Hier 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, die Werbetreibende in unser System hochgeladen haben.
Hier 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 Version 24.2. Mit diesen Einstellungen können Sie eine Performance Max-Kampagne konfigurieren und identifizieren, in der Anzeigen für Google Lokale Dienstleistungen ausgeliefert werden (GLS PMax).
Performance Max-Kampagnen für Google Lokale Dienstleistungen identifizieren
Um festzustellen, ob es sich bei einer Performance Max-Kampagne um eine Google Lokale Dienstleistungen-Kampagne handelt, prüfen Sie das schreibgeschützte Feld local_services_enabled 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:
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 aus zwei Buchstaben bestehender 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 durchLocalServicesPhoneNumber-Nachrichten.
Telefonnummern
Jeder Eintrag im phone_numbers wiederholten 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 durchGlsPhoneNumberTypeEnum.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.