Kampanie Usług Lokalnych pozwalają reklamować firmę w Google i otrzymywać dane kontaktowe bezpośrednio od potencjalnych klientów. Ten przewodnik zawiera podsumowanie obsługiwanych operacji i ograniczeń w bieżącej wersji interfejsu Google Ads API.
Obsługiwane operacje
Obsługiwane są te operacje:
Pobieranie kampanii i budżetów w Usługach Lokalnych
Kampanie i budżety Usług Lokalnych można pobrać za pomocą metody
GoogleAdsService.Search
lub
GoogleAdsService.SearchStream
do wysyłania zapytań o zasoby kampanii, w których
advertising_channel_type = 'LOCAL_SERVICES'
. Oto przykład:
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'
Edytowanie kampanii w Usługach Lokalnych
Możesz zaktualizować pola status
kampanii i amount_micros
powiązanego z nią budżetu kampanii.
Ustawianie strategii ustalania stawek w kampaniach Reklam Usług Lokalnych
W kampaniach Usług Lokalnych możesz ustawić te strategie ustalania stawek jako standardowe:
ManualCpa
przez ustawienie polamanual_cpa
.Stawki za
ManualCpa
możesz ustawić wLocalServicesCampaignSettings.category_bids
. Możesz pobierać i ustawiaćLocalServicesCampaignSettings
kampanii Reklam Usług Lokalnych za pomocąCampaign.local_services_campaign_settings
.MaximizeConversions
przez ustawienie polamaximize_conversions
.
Ustawianie harmonogramu reklam jako kryterium kampanii
Harmonogram reklam w kampanii Usług Lokalnych możesz ustawić jako kryterium kampanii.
Utwórz AdScheduleInfo
i ustaw go na ad_schedule
CampaignCriterion
wysyłanego do interfejsu Google Ads API za pomocą CampaignCriterionService.MutateCampaignCriteria
.
Ustawianie kierowania na lokalizację
Aby włączyć kierowanie na lokalizację w kampanii w Usługach Lokalnych, dodaj element LocationInfo
i ustaw go na wartość location
elementu CampaignCriterion
, który jest wysyłany do interfejsu Google Ads API, używając CampaignCriterionService.MutateCampaignCriteria
. Więcej informacji znajdziesz w sekcji Kierowanie na lokalizację.
Kierowanie na określone typy usług
Aby włączyć kierowanie na określony typ usługi, dodaj LocalServiceIdInfo
i ustaw go na typ usługi.
Użyj identyfikatora usługi, który pasuje do lokalizacji i kategorii kierowania kampanii.
Przesyłanie opinii o potencjalnych klientach
Aby przesłać ocenę i opinię o potencjalnym kliencie, użyj metody ProvideLeadFeedback()
LocalServicesLeadService
. Możesz też sprawdzić pole lead_feedback_submitted
w LocalServicesLead
, aby określić, czy kontakt do potencjalnego klienta został oceniony i czy przesłano opinię.
Nieobsługiwane operacje
Ograniczenia wymienione w tabeli poniżej mogą ulec zmianie w przyszłych wersjach interfejsu Google Ads API.
Nieobsługiwane operacje | |
---|---|
Tworzenie i usuwanie kampanii | Interfejs Google Ads API blokuje tworzenie nowych kampanii w Usługach Lokalnych. |
Operacje na podrzędnych elementach kampanii | Interfejs Google Ads API nie obsługuje tworzenia, modyfikowania, usuwania ani pobierania grup reklam, reklam ani kryteriów w kampaniach w Usługach lokalnych. |
Materiały dotyczące Usług Lokalnych
Niektóre dane z Reklam Usług Lokalnych są udostępniane bezpośrednio w interfejsie Google Ads API za pomocą tych tylko do odczytu zasobów raportów:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
Aby te zasoby zwracały dane, na koncie klienta, które wysyła żądanie, musi być aktywna kampania Reklam Usług Lokalnych. A ponieważ na każdym koncie klienta może być tylko 1 kampania Reklam Usług Lokalnych, te zasoby nie określają kampanii. Aby określić kampanię, z którą są powiązane te komponenty, użyj tego zapytania:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
potencjalny klient Usług Lokalnych,
LocalServicesLead
udostępnia szczegóły potencjalnego klienta, które są generowane, gdy konsument dzwoni do reklamodawcy, wysyła do niego SMS-a lub rezerwuje u niego usługę.
Dane o potencjalnych klientach Usług Lokalnych można pobrać z zasobu local_services_lead
. Przykładowe zapytanie:
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
Ograniczenia
- Pole
contact_details
ma wartość null, jeśli polelead_status
ma wartośćWIPED_OUT
. - Dane z zapytaniami od potencjalnych klientów, w przypadku których
category_id
należy do kategorii związanej z ochroną zdrowia, są niedostępne.
Rozmowa z potencjalnym klientem w Reklamach Usług Lokalnych
LocalServicesLeadConversation
ujawnia szczegóły rozmów, które odbyły się w ramach
LocalServicesLead
. Istnieje relacja jeden do wielu z LocalServicesLead
, gdzie jeden potencjalny klient może prowadzić wiele rozmów. Nazwę zasobu powiązanego potencjalnego klienta znajdziesz w polu lead
.
Dane rozmowy można pobrać z zasobu local_services_lead_conversation
. Oto przykładowe zapytanie, które filtruje wyniki pod kątem połączeń telefonicznych:
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'
Możesz użyć metody
LocalServicesLeadService.AppendLeadConversation
do dołączania
LocalServicesLeadConversation
zasobów do LocalServicesLead
.
Ograniczenia
- Aby uzyskać dostęp do adresu URL nagrania rozmowy, musisz zalogować się za pomocą adresu e-mail, który ma co najmniej dostęp tylko do odczytu do konta klienta Google Ads, do którego należy kampania, z którą jest powiązany potencjalny klient.
Zapytanie o wszystkie rozmowy naraz może być czasochłonne, dlatego warto filtrować rozmowy według potencjalnego klienta, np.:
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
Dokument weryfikacyjny w Usługach lokalnych
LocalServicesVerificationArtifact
udostępnia dane weryfikacyjne dotyczące firm reklamodawców. Pamiętaj, że te weryfikacje są przeprowadzane na poziomie firmy i nie obejmują weryfikacji pracowników. Dane obejmują:
- weryfikację licencji.
- Weryfikacje ubezpieczenia
- Weryfikacja sprawdzenia przeszłości
- Weryfikacje rejestracji firmy
Za każdym razem, gdy do Reklam Usług Lokalnych przesyłana jest prośba o weryfikację, w interfejsie Google Ads API tworzona jest nowa instancja artefaktu weryfikacji. Każdy artefakt weryfikacji reprezentuje jedną prośbę o weryfikację. Każdy dokument weryfikacyjny może zawierać niektóre z tych informacji, w zależności od tego, jakiego typu prośbę o weryfikację reprezentuje:
- stan każdego dokumentu weryfikacyjnego.
- Adres URL sprawdzenia przeszłości, który będzie używany do weryfikacji sprawdzenia przeszłości
- Czas rozpatrywania sprawdzenia przeszłości (w stosownych przypadkach)
- Adres URL dokumentu ubezpieczeniowego, aby wyświetlić przesłane już informacje o ubezpieczeniu
- Przyczyna odrzucenia ubezpieczenia (jeśli dotyczy)
- Szczegóły licencji (typ, numer, imię i nazwisko)
- Powód odrzucenia licencji (jeśli dotyczy)
- Adres URL dokumentu licencji, aby wyświetlić przesłany obraz licencji (w stosownych przypadkach)
- Informacje dotyczące rejestracji firmy (sprawdzenie dokumentu tożsamości, numer rejestracyjny)
- Powód odrzucenia rejestracji firmy (w stosownych przypadkach)
- Adres URL dokumentu potwierdzającego rejestrację firmy, aby wyświetlić przesłany dokument rejestracyjny obraz (jeśli dotyczy)
Dane artefaktu weryfikacyjnego można pobrać z zasobu local_services_verification_artifact
. Oto przykładowe zapytanie, które pobiera dane wszystkich artefaktów weryfikacyjnych związanych z licencją na danym koncie klienta:
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'
Dane geograficzne i kategoryczne dotyczące licencji i ubezpieczenia
Aby programowo określać stan próśb o weryfikację według lokalizacji geograficznej, a konkretnie kodu kierowania geograficznego i identyfikatora kategorii usług lokalnych, możesz użyć nowego pola w zasobie customer
o nazwie LocalServicesSettings
.
To pole zawiera ogólne podsumowanie stanu żądań weryfikacji licencji i ubezpieczenia według lokalizacji i kategorii. Oto przykładowe zapytanie, które pobiera wszystkie takie dane:
SELECT
customer.local_services_settings.granular_license_statuses,
customer.local_services_settings.granular_insurance_statuses
FROM customer
Pracownik usług lokalnych
LocalServicesEmployee
udostępnia dane o pracownikach usług lokalnych, które reklamodawcy przesłali do naszych systemów w ramach profilu reklamowego.
Oto przykładowe zapytanie, które pobiera dane wszystkich pracowników usług lokalnych na danym koncie klienta:
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