Mit Kampagnen für lokale Dienstleistungen können Sie auf Google für Ihr Unternehmen werben und Leads direkt von potenziellen Kunden erhalten. In diesem Leitfaden werden die in der aktuellen Version der Google Ads API unterstützten Vorgänge und Einschränkungen zusammengefasst.
Unterstützte Vorgänge
Kampagnen und Budgets für Google Lokale Dienstleistungen abrufen
Kampagnen und Budgets für lokale Dienstleistungen können mit der Methode GoogleAdsService.Search
oder GoogleAdsService.SearchStream
abgerufen werden, um die Ressourcen der Kampagne abzufragen, wobei 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 status
der Kampagne und die amount_micros
-Felder des zugehörigen Kampagnenbudgets aktualisieren.
Gebotsstrategie von Kampagnen für lokale Dienstleistungen festlegen
Sie können die folgenden Gebotsstrategien als Standard-Gebotsstrategie für Kampagnen für lokale Dienstleistungen festlegen:
ManualCpa
durch Festlegen des Feldsmanual_cpa
Sie können die Gebote von
ManualCpa
bisLocalServicesCampaignSettings.category_bids
festlegen. Sie könnenLocalServicesCampaignSettings
von Kampagnen für lokale Dienstleistungen überCampaign.local_services_campaign_settings
abrufen und festlegen.MaximizeConversions
durch Festlegen des Feldsmaximize_conversions
Werbezeitplaner als Kampagnenkriterium festlegen
Sie können einen Werbezeitplaner für eine Kampagne für lokale Dienstleistungen als Kampagnenkriterium festlegen.
Erstellen Sie ein AdScheduleInfo
und legen Sie dafür den ad_schedule
des CampaignCriterion
fest, der mit CampaignCriterionService.MutateCampaignCriteria
an die Google Ads API gesendet wird.
Geografische Ausrichtung festlegen
Wenn Sie die geografische Ausrichtung für eine Kampagne für lokale Dienstleistungen aktivieren möchten, fügen Sie einen LocationInfo
hinzu und legen Sie ihn auf den location
der CampaignCriterion
fest, die mithilfe von CampaignCriterionService.MutateCampaignCriteria
an die Google Ads API gesendet wird.
Weitere Informationen finden Sie unter Geografische Ausrichtung.
Targeting auf bestimmte Dienstleistungstypen
Wenn Sie das Targeting für einen bestimmten Diensttyp aktivieren möchten, fügen Sie einen LocalServiceIdInfo
hinzu und legen Sie ihn auf den Diensttyp fest.
Sie sollten eine Dienstleistungs-ID verwenden, die dem Standort und der Kategorie für die Ausrichtung Ihrer Kampagne entspricht.
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 das Erstellen neuer Kampagnen für lokale Dienstleistungen. |
Vorgänge für Unterentitäten in einer Kampagne | Mit der Google Ads API können Anzeigengruppen, Anzeigen oder Kriterien in Kampagnen für lokale Dienstleistungen weder erstellt, geändert, entfernt noch abgerufen werden. |
Ressourcen für Google Lokale Dienstleistungen
Ab Version 15 der Google Ads API werden einige Daten von Anzeigen für lokale Dienstleistungen direkt in der Google Ads API über die folgenden schreibgeschützten Berichtsressourcen verfügbar gemacht:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
Damit von diesen Ressourcen Daten zurückgegeben werden können, muss im Kundenkonto, von dem die Anfrage stammt, eine Kampagne für lokale Dienstleistungen vorhanden sein. Da es nur eine Kampagne für lokale Dienstleistungen pro Kundenkonto geben kann, ist 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'
Google Lokale Dienstleistungen-Lead
LocalServicesLead
enthält die Details zu einem Lead, die generiert werden, wenn ein Nutzer einen Dienst des Werbetreibenden anruft, eine Nachricht sendet oder bucht.
Lead-Daten für Google Lokale Dienstleistungen können aus der Ressource local_services_lead
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
FROM local_services_lead
Beschränkungen
- Das Feld
contact_details
ist null, wennlead_status
gleichWIPED_OUT
ist. - Daten von Leads, bei denen
category_id
zu einer Gesundheitskategorie gehört, sind nicht verfügbar.
Google Lokale Dienstleistungen – Lead-Gespräch
LocalServicesLeadConversation
gibt die Details von Unterhaltungen an, die im Rahmen einer LocalServicesLead
stattgefunden haben. Es gibt 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, mit der Ergebnisse nach Anrufen gefiltert werden:
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
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'
Beschränkungen
- Wenn Sie auf die URL für die 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 der Lead verknüpft ist.
Alle Unterhaltungen auf einmal anzufordern, kann zeitaufwendig sein. Daher sollten Sie die Unterhaltungen nach Leads 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
In LocalServicesVerificationArtifact
werden Überprüfungsdaten für Unternehmen von Werbetreibenden offengelegt. Diese Überprüfungen erfolgen auf Geschäftsebene und umfassen keine Überprüfungen für Mitarbeiter. Die Daten umfassen Folgendes:
- Lizenzüberprüfungen
- Versicherungsüberprüfungen
- Zuverlässigkeitsüberprüfungen
- Bestätigung der Gewerbeanmeldung
Jedes Mal, wenn eine Überprüfungsanfrage an Google Lokale Dienstleistungen gesendet wird, wird in der Google Ads API eine neue Instanz für ein Bestätigungsartefakt erstellt. Jedes Prüfartefakt stellt eine einzelne Überprüfungsanfrage dar. Jedes Bestätigungsartefakt kann einige der folgenden Informationen enthalten, je nachdem, um welche Art von Überprüfungsanfrage es sich handelt:
- Status der einzelnen Prüfartefakte
- URL für Zuverlässigkeitsüberprüfungen, die zur Überprüfung der Zuverlässigkeitsüberprüfung verwendet wird
- Zeit für die Entscheidung über die Zuverlässigkeitsüberprüfung (falls zutreffend)
- URL des Versicherungsdokuments zum Ansehen der bereits eingereichten Versicherungsinformationen
- Grund für die Ablehnung der Versicherung (falls zutreffend)
- Lizenzdetails (Typ, Nummer, Vorname, Nachname)
- Grund für die Ablehnung der Lizenz (falls zutreffend)
- Lizenzdokument-URL zum Ansehen des bereits eingereichten Lizenzbildes (falls zutreffend)
- Informationen zur Gewerbeanmeldung (ID, Registrierungsnummer prüfen)
- Ablehnungsgrund für die Gewerbeanmeldung (falls zutreffend)
- URL des Dokuments zur Gewerbeanmeldung, um ggf. ein Bild der bereits eingereichten Gewerbeanmeldung zu sehen
Die Daten des Bestätigungsartefakts können aus der Ressource local_services_verification_artifact
abgerufen werden. Mit der folgenden Beispielabfrage werden Daten für alle lizenzbezogenen Verifizierungsartefakte für ein bestimmtes Kundenkonto abgerufen:
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 kategoriebasierte Lizenz- und Versicherungsdaten
Sie können ein neues Feld mit dem Namen LocalServicesSetting
in der Ressource customer
verwenden, um den Status von Bestätigungsanfragen programmatisch nach geografischem Standort (insbesondere geografischem Zielcode) und ID der Kategorie für lokale Dienstleistungen zu ermitteln.
In diesem Feld wird eine Zusammenfassung des Status von Lizenz- und Versicherungsüberprüfungsanfragen nach Standort und Kategorie angezeigt. 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 vor Ort
LocalServicesEmployee
legt die Daten zu Mitarbeitern im lokalen Dienst offen, für die die Werbetreibenden ihr Anzeigenprofil in unsere Systeme hochgeladen haben.
Hier ist eine Beispielabfrage, mit der Daten für alle lokalen Servicemitarbeiter 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