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ć za pomocą 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ług Lokalnych
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
. Możesz jednak pobierać i ustawiaćLocalServicesCampaignSettings
kampanii Reklam Usług Lokalnych za pomocą funkcjiCampaign.local_services_campaign_settings
.MaximizeConversions
poprzez skonfigurowanie polamaximize_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 artykule Celewanie reklamą według lokalizacji.
Kierowanie reklam 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 odpowiada kierowaniu kampanii na lokalizację i kategorię.
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ą dostępne 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 jedna kampania Usług Lokalnych, te zasoby nie określają kampanii. Aby określić kampanię, z którą te zasoby są powiązane, 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
jest puste, 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. Nazwa zasobu powiązanego z potencjalnym klientem znajduje się w polu lead
.
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'
Od wersji 17 interfejsu Google Ads API możesz używać metody LocalServicesLeadService.AppendLeadConversation
, aby dodawać zasoby LocalServicesLeadConversation
do zasobu LocalServicesLead
.
Ograniczenia
- Aby uzyskać dostęp do adresu URL nagrywania rozmów, musisz zalogować się 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.
Żądanie wszystkich rozmów 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 pojedyncze żą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 (jeśli dotyczy)
- 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 zwraca 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, w szczególności 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 pobiera dane o wszystkich pracownikach 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