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 sind 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, bei denen advertising_channel_type = 'LOCAL_SERVICES'
angegeben ist. 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 die amount_micros
-Felder des zugehörigen Kampagnenbudgets aktualisieren.
Gebotsstrategie für 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 eine AdScheduleInfo
und legen Sie sie mithilfe von CampaignCriterionService.MutateCampaignCriteria
auf den ad_schedule
der CampaignCriterion
fest, die 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 eine LocationInfo
hinzu und legen Sie sie auf den location
der CampaignCriterion
fest, die mit CampaignCriterionService.MutateCampaignCriteria
an die Google Ads API gesendet wird.
Weitere Informationen finden Sie unter Geografische Ausrichtung.
Targeting auf bestimmte Diensttypen
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.
Verwenden Sie eine Dienst-ID, die dem Standort und der Ausrichtungskategorie 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 | Über die Google Ads API können keine neuen Kampagnen für lokale Dienstleistungen erstellt werden. |
Vorgänge an Unterentitäten einer Kampagne | Anzeigengruppen, Anzeigen oder Kriterien in Kampagnen für lokale Dienstleistungen können nicht über die Google Ads API erstellt, geändert, entfernt oder abgerufen werden. |
Ressourcen für Google Lokale Dienstleistungen
Ab Version 15 der Google Ads API werden einige Daten aus Anzeigen für lokale Dienstleistungen direkt in der Google Ads API über die folgenden schreibgeschützten Berichtsressourcen bereitgestellt:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
Damit über diese Ressourcen Daten zurückgegeben werden, muss im Kundenkonto, von dem die Anfrage stammt, eine Kampagne für lokale Dienstleistungen vorhanden sein. Und da es nur eine Kampagne für lokale Dienstleistungen pro Kundenkonto geben kann, geben diese Ressourcen keine Kampagne an. 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'
Lead für Google Lokale Dienstleistungen
In LocalServicesLead
werden die Details eines Leads angezeigt, der generiert wird, wenn ein Nutzer eine Dienstleistung des Werbetreibenden anruft, eine Nachricht sendet oder einen Dienst bucht.
Lead-Daten von 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,
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, wennlead_status
gleichWIPED_OUT
ist. - Daten aus Leads, bei denen
category_id
zu einer Gesundheitskategorie gehört, sind nicht verfügbar.
Gespräch zu Anfragen bei Google Lokale Dienstleistungen
LocalServicesLeadConversation
macht die Details von Unterhaltungen sichtbar, die im Rahmen einer LocalServicesLead
stattgefunden haben. Es besteht eine 1:n-Beziehung mit LocalServicesLead
, wobei ein Lead viele Unterhaltungen führen 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 sehen Sie eine Beispielabfrage, bei 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'
Ab Version 17 der Google Ads API können Sie mit der Methode LocalServicesLeadService.AppendLeadConversation
LocalServicesLeadConversation
-Ressourcen an eine LocalServicesLead
anhängen.
Beschränkungen
- Damit Sie auf die URL zur Anrufaufzeichnung zugreifen 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, zu der der Lead gehört.
Das Anfordern aller Unterhaltungen auf einmal kann eine zeitaufwendige Anfrage sein. Daher sollten Sie Unterhaltungen nach Lead filtern, zum Beispiel:
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
Überprüfungsartefakt für Google Lokale Dienstleistungen
LocalServicesVerificationArtifact
stellt Überprüfungsdaten für Unternehmen von Werbetreibenden bereit. Beachten Sie, dass diese Überprüfungen auf Unternehmensebene erfolgen und keine Bestätigungen für Mitarbeiter beinhalten. Die Daten umfassen Folgendes:
- Lizenzüberprüfungen
- Versicherungsnachweise
- 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 Überprüfungsartefaktinstanz dafür erstellt. Jedes Überprüfungsartefakt stellt eine einzelne Überprüfungsanfrage dar. Jedes Prüfartefakt kann je nach Art der Überprüfungsanfrage einige der folgenden Informationen enthalten:
- Status der einzelnen Verifizierungsartefakte
- URL für Zuverlässigkeitsüberprüfungen, die für die Bestätigung der Zuverlässigkeitsüberprüfung verwendet werden soll
- Entscheidungszeit für 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, Vor- und Nachname)
- Grund für die Ablehnung der Lizenz (falls zutreffend)
- URL des Lizenzdokuments zum Ansehen eines bereits eingereichten Lizenzbildes (falls zutreffend)
- Details zur Gewerbeanmeldung (ID, Registrierungsnummer des Unternehmens)
- Grund für die Ablehnung der Gewerbeanmeldung (falls zutreffend)
- URL des Gewerbescheins zum Ansehen des bereits eingereichten Registrierungsbildes (falls zutreffend)
Daten zu Verifizierungsartefakten können aus der local_services_verification_artifact
-Ressource abgerufen werden. Hier ist eine Beispielabfrage, mit der Daten für alle lizenzbezogenen Verifizierungsartefakte 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 kategoriebezogene Lizenz- und Versicherungsdaten
Wenn Sie den Status von Bestätigungsanfragen programmatisch nach geografischem Standort (insbesondere Geo-Zielcode) und Kategorie-ID für lokale Dienstleistungen ermitteln möchten, können Sie in der Ressource customer
ein neues Feld namens LocalServicesSetting
verwenden.
Dieses Feld enthält eine allgemeine Zusammenfassung des Status von Anfragen zur Überprüfung von Lizenzen und Versicherungen nach Standort und Kategorie. Hier ist eine Beispielabfrage, mit der all diese Daten abgerufen werden:
SELECT
customer.local_services_settings.granular_license_statuses,
customer.local_services_settings.granular_insurance_statuses
FROM customer
Mitarbeiter im lokalen Kundenservice
LocalServicesEmployee
enthält die Daten der Mitarbeiter im lokalen Service, die die Werbetreibenden in unser System hochgeladen haben.
Hier ist eine Beispielabfrage, mit der Daten für alle lokalen Dienstmitarbeiter 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