Kampanie Usług Lokalnych pozwalają reklamować firmę w Google i pozyskiwać 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 Usługi Lokalne
Kampanie i budżety Usług Lokalnych można pobrać, korzystając z metody GoogleAdsService.Search
lub GoogleAdsService.SearchStream
, aby 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
w kampanii i amount_micros
w powiązanym budżecie kampanii.
Konfigurowanie strategii ustalania stawek w kampaniach Usługi lokalne
Jako standardową strategię ustalania stawek w kampaniach Usługi lokalne możesz ustawić jedną z tych strategii:
ManualCpa
poprzez ustawienie polamanual_cpa
Stawki
ManualCpa
możesz ustawiać za pomocąLocalServicesCampaignSettings.category_bids
. Za pomocą funkcjiCampaign.local_services_campaign_settings
możesz pobierać i ustawiaćLocalServicesCampaignSettings
kampanii Reklam Usług Lokalnych.MaximizeConversions
, ustawiając polemaximize_conversions
Ustawianie harmonogramu reklam jako kryterium kampanii
Harmonogram reklam w kampanii Usługi lokalne możesz ustawić jako kryterium kampanii.
Utwórz parametr AdScheduleInfo
i przypisz mu wartość ad_schedule
parametru CampaignCriterion
, który jest wysyłany do interfejsu Google Ads API za pomocą parametru CampaignCriterionService.MutateCampaignCriteria
.
Ustawianie kierowania na lokalizację
Aby włączyć kierowanie na lokalizację w kampanii w Usługach Lokalnych, dodaj parametr LocationInfo
i ustaw go na location
parametru CampaignCriterion
, który jest wysyłany do interfejsu Google Ads API za pomocą parametru CampaignCriterionService.MutateCampaignCriteria
. Więcej informacji znajdziesz w sekcji Celewanie na podstawie lokalizacji.
Kierowanie na konkretne typy usług
Aby włączyć kierowanie na konkretny typ usługi, dodaj element 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ę dotyczącą potencjalnego klienta, użyj metody ProvideLeadFeedback()
w LocalServicesLeadService
. Możesz też sprawdzić pole lead_feedback_submitted
w kolumnie LocalServicesLead
, aby dowiedzieć się, czy kontakt do potencjalnego klienta został oceniony i czy została przesłana opinia.
Nieobsługiwane operacje
Ograniczenia wymienione w tabeli poniżej mogą ulec zmianie w kolejnych 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 podelementach w kampanii | Interfejs Google Ads API nie obsługuje tworzenia, modyfikowania, usuwania ani pobierania grup reklam, reklam i kryteriów w kampaniach Usługi lokalne. |
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 mogły zwracać dane, na koncie klienta musi znajdować się kampania Reklam Usług Lokalnych, która wysyła żądanie. Ponieważ na jednym koncie klienta może być tylko 1 kampania w Usługach lokalnych, te zasoby nie określają kampanii. Aby określić kampanię, z którą są powiązane te zasoby, użyj tego zapytania:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
Usługi lokalne
LocalServicesLead
zawiera 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 z Usług Lokalnych można pobrać z zasobu local_services_lead
. Oto 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ślilead_status
=WIPED_OUT
. - Dane o potencjalnych klientach, w których przypadku
category_id
należy do kategorii opieki zdrowotnej, są niedostępne.
Rozmowa z potencjalnym klientem w Usługach Lokalnych
LocalServicesLeadConversation
pokazuje szczegóły rozmów prowadzonych w ramach LocalServicesLead
. Istnieje relacja jeden do wielu z LocalServicesLead
, w której jeden potencjalny klient może prowadzić wiele rozmów. W polu lead
znajdziesz nazwę zasobu powiązanego z potencjalnym klientem.
Dane rozmowy można pobrać z zasobu local_services_lead_conversation
. Oto przykład zapytania, które filtruje wyniki, aby zawierały tylko połączenia telefoniczne:
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'
Za pomocą metody LocalServicesLeadService.AppendLeadConversation
możesz dodawać zasoby LocalServicesLeadConversation
do pliku LocalServicesLead
.
Ograniczenia
- Aby uzyskać dostęp do adresu URL nagrania rozmowy, musisz się zalogować za pomocą adresu e-mail, który ma co najmniej dostęp tylko do odczytu do konta klienta Google Ads, które jest właścicielem kampanii powiązanej z potencjalnym klientem.
Zapytanie o wszystkie rozmowy naraz może być czasochłonne, dlatego powinieneś filtrować rozmowy według potencjalnego klienta, na przykład:
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
Artefakt weryfikacji Usług lokalnych
LocalServicesVerificationArtifact
pozwala uzyskać dostęp do danych weryfikacyjnych firm reklamodawców. Pamiętaj, że te weryfikacje odbywają się na poziomie firmy i nie obejmują weryfikacji pracowników. Dane te obejmują:
- Weryfikacja licencji
- Weryfikacja ubezpieczenia
- Weryfikacja sprawdzenia przeszłości
- Weryfikacja rejestracji firmy
Za każdym razem, gdy do Reklam Usług Lokalnych zostanie przesłane żądanie weryfikacji, w interfejsie Google Ads API tworzony jest nowy artefakt weryfikacji, a każdy artefakt weryfikacji reprezentuje jedno żądanie weryfikacji. Każdy artefakt weryfikacji może zawierać niektóre z tych informacji w zależności od typu prośby o weryfikację:
- Stan każdego artefaktu weryfikacji
- Adres URL sprawdzenia przeszłości, który ma być używany do weryfikacji
- Czas rozpatrywania sprawdzenia przeszłości (w stosownych przypadkach)
- Adres URL dokumentu ubezpieczenia, aby wyświetlić już przesłane informacje o ubezpieczeniu
- Powód 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 odpowiednich przypadkach)
- Dane rejestracyjne firmy (identyfikator, numer rejestracyjny)
- Powód odrzucenia rejestracji firmy (w stosownych przypadkach)
- URL dokumentu potwierdzającego rejestrację firmy, aby wyświetlić przesłany już obraz pliku z dokumentem (jeśli dotyczy)
Dane artefaktu weryfikacji można pobrać z zasobu local_services_verification_artifact
. Oto przykład zapytania, które pobiera dane wszystkich artefaktów weryfikacji 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 o licencjach i ubezpieczeniach z podziałem na kategorie i regiony
Aby programowo określić stan żądań weryfikacji według lokalizacji geograficznej, a ściślej kodu obszaru docelowego 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 wniosków o weryfikację licencji i ubezpieczenia według lokalizacji i kategorii. Oto przykład zapytania, 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 świadczących usługi lokalne, które reklamodawcy przesłali do naszych systemów w ramach swoich profili reklamowych.
Oto przykład zapytania, które zwraca dane wszystkich pracowników lokalnych usług 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