Kampanie w Usługach Lokalnych pozwalają reklamować firmę w Google i pozyskiwać kontakty do potencjalnych klientów bezpośrednio od nich samych. W tym przewodniku znajdziesz 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 w Usługach Lokalnych można pobierać za pomocą
GoogleAdsService.Search lub
GoogleAdsService.SearchStream
metody, aby wysyłać zapytania 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 powiązanego z nią budżetu amount_micros.
Ustawianie strategii ustalania stawek w kampaniach w Usługach Lokalnych
Jako standardową strategię ustalania stawek w kampaniach w Usługach Lokalnych możesz ustawić te strategie:
ManualCpaprzez ustawienie polamanual_cpa.Stawki
ManualCpamożesz ustawić za pomocąLocalServicesCampaignSettings.category_bids. Możesz pobierać i ustawiaćLocalServicesCampaignSettingskampanii w Usługach Lokalnych za pomocąCampaign.local_services_campaign_settings.MaximizeConversionsprzez ustawienie polamaximize_conversions.
Ustawianie harmonogramu reklam jako kryterium kampanii
Harmonogram reklam w kampanii w Usługach Lokalnych możesz ustawić jako kryterium kampanii.
Utwórz AdScheduleInfo i ustaw go jako
ad_schedule w
CampaignCriterion wysyłanym 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 a
LocationInfo i ustaw go jako location w CampaignCriterion wysyłanym
do interfejsu Google Ads API za pomocą
CampaignCriterionService.MutateCampaignCriteria.
Więcej informacji znajdziesz w artykule Kierowanie na lokalizację.
Kierowanie na konkretne typy usług
Aby włączyć kierowanie na konkretny typ usługi, dodaj LocalServiceIdInfo i ustaw go jako 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() w
LocalServicesLeadService do przesłania
oceny i opinii o potencjalnym kliencie. Możesz też sprawdzić pole
lead_feedback_submitted w
LocalServicesLead, aby dowiedzieć się
czy potencjalny klient 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 w 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. |
Zasoby 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_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
Aby te zasoby zwracały dane, na koncie klienta wysyłającego żądanie musi być kampania w Usługach Lokalnych. Ponieważ na koncie klienta może być tylko 1 kampania w Usługach Lokalnych, te zasoby nie określają kampanii. Aby zidentyfikować 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'
Potencjalny klient z Usług Lokalnych
LocalServicesLead udostępnia szczegóły potencjalnego klienta, które są generowane, gdy konsument dzwoni do reklamodawcy, wysyła mu wiadomość lub rezerwuje jego usługę.
Dane potencjalnych klientów z Usług Lokalnych można pobierać 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_detailsma wartość null, jeślilead_statusjest równeWIPED_OUT. - Dane potencjalnych klientów, których
category_idnależy do kategorii związanej z opieką zdrowotną, są niedostępne.
Rozmowa z potencjalnym klientem z Usług Lokalnych
LocalServicesLeadConversation
udostępnia 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 mieć wiele rozmów. Nazwę zasobu powiązanego potencjalnego klienta można znaleźć w polu lead.
Dane rozmów można pobierać 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'
Za pomocą metody
LocalServicesLeadService.AppendLeadConversation
możesz dołączać zasoby
LocalServicesLeadConversation
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, które jest właścicielem kampanii powiązanej z potencjalnym klientem.
Żądanie wszystkich rozmów 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
Artefakt weryfikacji 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ą:
- weryfikacje licencji,
- weryfikacje ubezpieczenia,
- weryfikacje sprawdzenia przeszłości,
- weryfikacje dowodu zarejestrowania firmy.
Za każdym razem, gdy do Reklam Usług Lokalnych zostanie przesłane żądanie weryfikacji, w interfejsie Google Ads API zostanie utworzona nowa instancja artefaktu weryfikacji. Każdy artefakt weryfikacji reprezentuje pojedyncze żądanie weryfikacji. W zależności od typu żądania weryfikacji każdy artefakt weryfikacji może zawierać niektóre z tych informacji:
- stan każdego artefaktu weryfikacji;
- adres URL sprawdzenia przeszłości, który ma być używany do weryfikacji sprawdzenia przeszłości;
- czas rozpatrzenia sprawdzenia przeszłości (jeśli dotyczy);
- adres URL dokumentu ubezpieczeniowego, który umożliwia wyświetlenie przesłanych już informacji 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, który umożliwia wyświetlenie przesłanego już obrazu licencji (jeśli dotyczy);
- dowód zarejestrowania firmy (identyfikator sprawdzenia, numer rejestracyjny)
- powód odrzucenia dowodu zarejestrowania firmy (jeśli dotyczy);
- Adres URL dokumentu dowodu zarejestrowania firmy, który umożliwia wyświetlenie przesłanego już dowodu zarejestrowania firmy (jeśli dotyczy).
Dane artefaktu weryfikacji można pobierać z zasobu
local_services_verification_artifact. Oto przykładowe zapytanie, 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 licencji i ubezpieczenia według lokalizacji geograficznej i kategorii
Aby programowo określić stan żądań weryfikacji 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`.customerLocalServicesSettings
To pole udostępnia 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 swoim profilu reklamowym.
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
Kampanie Performance Max w Usługach Lokalnych
Kampanie Performance Max obsługują ustawienia związane z Usługami Lokalnymi od wersji 24.2. Te ustawienia pozwalają skonfigurować i zidentyfikować kampanię Performance Max, która wyświetla reklamy w Usługach Lokalnych (GLS PMax).
Identyfikowanie kampanii Performance Max w Usługach Lokalnych
Aby sprawdzić, czy kampania Performance Max jest kampanią w Usługach Lokalnych,
sprawdź pole local_services_enabled tylko do odczytu w
pmax_campaign_settings kampanii.
Konfiguracja
W przypadku kampanii, w których local_services_enabled ma wartość true, skonfiguruj ustawienia
w polu
local_services_pmax_campaign_settings:
navigational_query_leads_enabled: czy używać filtra zapytań nawigacyjnych.founding_year: rok założenia firmy.country_code: kod kraju reklamy w Usługach Lokalnych. Tego pola nie można zmienić po utworzeniu reklamy. Jest to dwuliterowy kod kraju pisany wielkimi literami, który służy do określania wymagań dotyczących weryfikacji i sprawdzania poprawności wyboru kryterium lokalizacji .phone_numbers: lista numerów telefonów powiązanych z dostawcą, reprezentowanych przezLocalServicesPhoneNumberwiadomości.
Numery telefonów
Każdy wpis w powtarzającym się polu phone_numbers używa typu wiadomości
LocalServicesPhoneNumber z tymi polami:
phone_number: numer telefonu.country_code: dwuliterowy kod kraju pisany wielkimi literami .phone_number_type: typ numeru telefonu zdefiniowany przezGlsPhoneNumberTypeEnum.GlsPhoneNumberType. Obsługiwane typy:DESTINATION_PHONE_NUMBER_FOR_ADS: numer docelowy, który ma być używany w przypadku połączeń z jednostki reklamowej w Usługach Lokalnych (domyślnie).DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: numer docelowy, który obsługuje SMS-y.DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: numer docelowy konta dostawcy w WhatsApp.