Kampanie w Usługach lokalnych

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 interfejsie Google Ads API.

Obsługiwane operacje

Interfejs Google Ads API obsługuje te operacje w przypadku kampanii w Usługach Lokalnych.

Pobieranie kampanii i budżetów w Usługach Lokalnych

Kampanie i budżety w Usługach Lokalnych można pobierać za pomocą metod GoogleAdsService.Search lub GoogleAdsService.SearchStream , aby wysyłać zapytania o zasoby Campaign, 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

Jako standardową strategię ustalania stawek w kampaniach w Usługach Lokalnych możesz ustawić te strategie:

Ustawianie harmonogramu reklam jako kryterium kampanii

Harmonogram reklam możesz ustawić w kampanii w Usługach Lokalnych jako kryterium kampanii.

Utwórz AdScheduleInfo i ustaw go w polu ad_schedule elementu CampaignCriterion który jest wysyłany 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 LocationInfo i ustaw go w polu location elementu CampaignCriterion który jest wysyłany do interfejsu Google Ads API za pomocą CampaignCriterionService.MutateCampaignCriteria. Więcej informacji znajdziesz w artykule Kierowanie na lokalizację.

Kierowanie na określone rodzaje usług

Aby włączyć kierowanie na określony rodzaj usługi, utwórz LocalServiceIdInfo z jednym z identyfikatorów kategorii Usług Lokalnych, ustaw go w polu local_service_id elementu a CampaignCriterion i prześlij za pomocą CampaignCriterionService.MutateCampaignCriteria.

Użyj identyfikatora usługi, który pasuje do lokalizacji kierowania kampanii i kategorii.

Przesyłanie opinii o potencjalnych klientach

Aby przesłać ocenę i opinię o potencjalnym kliencie, użyj metody ProvideLeadFeedback w usłudści LocalServicesLeadService do przesłania oceny i opinii o potencjalnym kliencie. Możesz też sprawdzić pole lead_feedback_submitted elementu 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:

Aby te zasoby zwracały dane, na koncie klienta wysyłającego żądanie musi być kampania w Usługach Lokalnych. Ponieważ na każdym 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_details ma wartość null, jeśli lead_status ma wartość WIPED_OUT.
  • Od v25 pole ContactDetails.email zostało usunięte, a pole ContactDetails.phone_number_extension jest dostępne w wiadomości ContactDetails zwracanej przez local_services_lead.contact_details.
  • Dane potencjalnych klientów, w przypadku których category_id należ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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'

Artefakty weryfikacji

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 rejestracji 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, 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 tego, jakiego typu żądanie weryfikacji reprezentuje:

  • stan każdego artefaktu weryfikacji;
  • adres URL weryfikacji sprawdzenia przeszłości pracownika
  • czas rozpatrzenia sprawdzenia przeszłości pracownika (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ę, 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);
  • informacje dotyczące rejestracji firmy (identyfikator sprawdzenia, numer rejestracyjny);
  • powód odrzucenia rejestracji firmy (jeśli dotyczy);
  • adres URL dokumentu rejestracyjnego firmy, który umożliwia wyświetlenie przesłanego już obrazu rejestracji (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 weryfikacji 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ć pola `local_services_settings` w zasobie `customer`, które ma typ `LocalServicesSettings`.local_services_settingscustomerLocalServicesSettings

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 v24. Te ustawienia pozwalają skonfigurować i zidentyfikować kampanię Performance Max, która wyświetla reklamy w Usługach Lokalnych (GLS PMax).

Od v26 możesz tworzyć nowe kampanie Performance Max w Usługach Lokalnych za pomocą interfejsu API, ustawiając local_services_enabled = true w pmax_campaign_settings (nie można zmienić po utworzeniu). Podczas tworzenia kampanii Performance Max w Usługach Lokalnych w local_services_pmax_campaign_settings wymagane są zarówno country_code, jak i listing_id. W v25 i starszych wersjach interfejs API obsługiwał tylko aktualizacje istniejących kampanii utworzonych w interfejsie przez użytkowników na liście dozwolonych.

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 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:

  • listing_id: identyfikator wizytówki w Profilu Firmy w Google połączonej z kampanią. Od v26 to pole jest wymagane i nie można go zmienić podczas tworzenia kampanii Performance Max w Usługach Lokalnych. Identyfikator wizytówki musi być połączony z kontem jako włączony LOCATION komponent. W przeciwnym razie interfejs API zwróci CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID błąd. Ponieważ listing_id jest oznaczony jako IMMUTABLE, próba zaktualizowania tego pola po utworzeniu kampanii zakończy się niepowodzeniem i zwróci błąd RequestError.IMMUTABLE_FIELD. Deweloperzy mogą wykrywać lub weryfikować połączone identyfikatory wizytówek, wysyłając zapytania do zasobu Asset o włączone komponenty LOCATION (sprawdzając location_asset.business_profile_locations). Więcej informacji znajdziesz w artykule Komponenty lokalizacji.
  • 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 2-literowy 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 usługodawcą, reprezentowana przez LocalServicesPhoneNumber wiadomości.

Numery telefonów

Każdy wpis w polu powtarzanym phone_numbers używa typu wiadomości LocalServicesPhoneNumber z tymi polami: