Kampanie w Usługach lokalnych

Kampanie w Usługach Lokalnych umożliwiają reklamowanie firmy w Google i pozyskiwanie kontaktów do potencjalnych klientów bezpośrednio od nich samych. Ten przewodnik zawiera 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ą metody 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.

Ustaw strategię ustalania stawek

Jako standardową strategię ustalania stawek w kampaniach reklam Usług lokalnych możesz ustawić te strategie:

• ManualCpa, ustawiając pole manual_cpa.

  Stawki dla ManualCpa możesz ustawić w LocalServicesCampaignSettings.category_bids. Możesz pobierać i ustawiać LocalServicesCampaignSettings kampanii w Usługach Lokalnych za pomocą Campaign.local_services_campaign_settings.

• MaximizeConversions, ustawiając pole maximize_conversions.

Ustawianie harmonogramu reklam jako kryterium kampanii

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

Utwórz obiekt AdScheduleInfo i ustaw go jako ad_schedule obiektu CampaignCriterion wysyłanego do interfejsu Google Ads API, używając metody CampaignCriterionService.MutateCampaignCriteria.

Konfigurowanie kierowania na lokalizację

Aby włączyć kierowanie na lokalizację w kampanii w Usługach Lokalnych, dodaj LocationInfo i ustaw go w polu location obiektu 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 typy usług

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

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

Przesyłanie opinii o potencjalnych klientach

Użyj metody ProvideLeadFeedback interfejsu LocalServicesLeadService, aby przesłać ocenę i opinię o potencjalnym kliencie. Możesz też sprawdzić pole lead_feedback_submitted w LocalServicesLead, aby dowiedzieć się, czy kontakt do potencjalnego klienta został oceniony i czy przesłano opinię.

Nieobsługiwane operacje

W tabeli poniżej znajdziesz listę nieobsługiwanych operacji w przypadku samodzielnych kampanii w Usługach Lokalnych (advertising_channel_type = 'LOCAL_SERVICES').

Zasoby 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 zasobów raportów tylko do odczytu:

• 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ć kampania Usług Lokalnych lub kampania Performance Max dla Usług Lokalnych. Pole local_services_lead.campaign łączy rekordy potencjalnych klientów z powiązaną z nimi kampanią (w tym z kampaniami Performance Max z celami typu „płatność za potencjalne zlecenie”, w których campaign.advertising_channel_type = 'PERFORMANCE_MAX' i campaign.pmax_campaign_settings.local_services_enabled = true). Aby zidentyfikować kampanię, z którą są powiązane te zasoby, użyj tego zapytania:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

Potencjalny klient z Usług Lokalnych

LocalServicesLead udostępnia szczegóły potencjalnego klienta, które są generowane, gdy konsument dzwoni, wysyła wiadomość, rezerwuje usługę lub korzysta z kuponu od reklamodawcy.

Typ potencjalnego klienta jest określany przez LocalServicesLeadType. Od v26COUPON obsługuje typy potencjalnych klientów z kuponem w kampaniach w Usługach lokalnych i kampaniach Performance Max w Usługach lokalnych.

Pole campaign łączy rekord potencjalnego klienta z powiązaną z nim kampanią. Oprócz wybrania pól przypisanych do campaign (takich jak campaign.id i campaign.name) możesz filtrować zapytania o potencjalnych klientów według nazwy zasobu kampanii (WHERE local_services_lead.campaign = ...) lub typu kanału reklamowego (WHERE campaign.advertising_channel_type = ...), aby segmentować potencjalnych klientów według typu kampanii.

Dane o potencjalnych klientach 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,
  local_services_lead.campaign
FROM local_services_lead

Ograniczenia

• Pole contact_details ma wartość null, jeśli lead_status jest równe WIPED_OUT.
• Od v25 pole ContactDetails.email jest usunięte, a pole ContactDetails.phone_number_extension jest dostępne w komunikacie ContactDetails zwracanym przez local_services_lead.contact_details.
• Dane od potencjalnych klientów, w przypadku których category_id należy do kategorii opieki zdrowotnej, są niedostępne.

Rozmowa z potencjalnym klientem z Usług Lokalnych

LocalServicesLeadConversation ujawnia szczegóły rozmów, które miały miejsce 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 znajdziesz w polu lead.

Dane rozmowy można pobrać z zasobu local_services_lead_conversation. Oto przykładowe zapytanie, które filtruje wyniki, aby wyświetlić 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'

Możesz użyć metody LocalServicesLeadService.AppendLeadConversation, aby dołączyć 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 dostęp na poziomie co najmniej do odczytu do konta klienta Google Ads, na którym znajduje się kampania powiązana z potencjalnym klientem.

• Żądanie wszystkich rozmów naraz może być czasochłonne, dlatego warto 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_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 te obejmują:

• Weryfikacje licencji
• Weryfikacja ubezpieczenia
• Weryfikacja przeszłości pracownika
• Weryfikacja dowodu zarejestrowania 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 dla niej nowa instancja artefaktu weryfikacji. Każdy artefakt weryfikacji reprezentuje pojedynczą prośbę o weryfikację. Każdy artefakt weryfikacji może zawierać niektóre z tych informacji, w zależności od typu prośby o weryfikację, którą reprezentuje:

• stan każdego artefaktu weryfikacji.
• Adres URL do sprawdzenia przeszłości pracownika, który ma być używany do weryfikacji sprawdzenia przeszłości pracownika
• Czas rozpatrywania wniosku o sprawdzenie przeszłości pracownika (jeśli dotyczy)
• URL dokumentu ubezpieczenia, aby wyświetlić przesłane już informacje 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, pod którym można wyświetlić przesłany już obraz licencji (jeśli dotyczy)
• informacje dotyczące dowodu zarejestrowania firmy (sprawdź identyfikator, numer rejestracyjny);
• Powód odrzucenia rejestracji firmy (jeśli dotyczy)
• Adres URL dokumentu rejestracyjnego firmy, pod którym można wyświetlić przesłany już obraz dokumentu (jeśli dotyczy)

Dane artefaktu weryfikacji można pobrać z zasobu local_services_verification_artifact. Oto przykładowe zapytanie, które pobiera dane dotyczące 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_override_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 weryfikacyjne dotyczące lokalizacji geograficznej i kategorii

Aby automatycznie określić stan próśb o weryfikację według położenia geograficznego (konkretnie według kodu docelowego regionu geograficznego) i identyfikatora kategorii Usług Lokalnych, możesz użyć pola local_services_settings w zasobie customer, który ma typ LocalServicesSettings.

To pole zawiera ogólne podsumowanie stanu próśb o weryfikację 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

Osoba zatrudniona w usługach lokalnych

LocalServicesEmployee udostępnia dane o pracownikach usług lokalnych, których profile reklamowe reklamodawcy przesłali do naszych systemów.

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 umożliwiają skonfigurowanie i zidentyfikowanie kampanii Performance Max, która wyświetla Reklamy Usług Lokalnych (GLS PMax).

Tworzenie kampanii Performance Max w Usługach Lokalnych

Od v26 interfejs Google Ads API obsługuje zarówno tworzenie, jak i aktualizowanie kampanii Performance Max w Usługach Lokalnych. Nowe kampanie Performance Max w Usługach Lokalnych możesz tworzyć za pomocą interfejsu API. W tym celu utwórz kampanię Performance Max (advertising_channel_type = 'PERFORMANCE_MAX') i ustaw local_services_enabled = true w pmax_campaign_settings (nie można tego zmienić po utworzeniu kampanii). Podczas tworzenia kampanii Performance Max dla Usług lokalnych w parametrze local_services_pmax_campaign_settings wymagane są zarówno country_code, jak i listing_id. W wersjach v24 i v25 interfejs API obsługuje tylko aktualizacje dotychczasowych kampanii Performance Max w Usługach Lokalnych utworzonych w interfejsie przez konta z listy dozwolonych. Szczegółowe instrukcje dotyczące konfigurowania wymagań wstępnych i tworzenia kampanii znajdziesz w przewodniku po kampaniach Performance Max z celami typu płatność za potencjalne zlecenie.

Identyfikowanie kampanii Performance Max w Usługach Lokalnych

Aby sprawdzić, czy kampania Performance Max jest kampanią Usług lokalnych, sprawdź pole local_services_enabled w pmax_campaign_settings kampanii. To pole jest niezmienną (CREATE ONLY) wartością logiczną ustawioną na true podczas tworzenia kampanii.

Konfiguracja

W przypadku kampanii, w których local_services_enabled to 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 dla Usług lokalnych. Identyfikator oferty musi być połączony z kontem jako włączony komponent LOCATION. W przeciwnym razie interfejs API zwróci błąd CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. Pole listing_id jest oznaczone jako IMMUTABLE, więc próba jego zaktualizowania po utworzeniu kampanii zakończy się niepowodzeniem i zostanie zwrócony błąd RequestError.IMMUTABLE_FIELD. Deweloperzy mogą wykrywać lub weryfikować połączone identyfikatory wizytówek, wysyłając zapytanie do zasobu Asset o włączone komponenty LOCATION (sprawdzając location_asset.business_profile_locations). Więcej informacji znajdziesz w artykule Komponenty z lokalizacją.
• navigational_query_leads_enabled: określa, czy używać filtra zapytań nawigacyjnych.
• founding_year: rok założenia firmy.
• country_code: kod kraju reklamy Usług Lokalnych. Od v26 to pole jest wymagane i nie można go zmienić po ustawieniu podczas tworzenia kampanii. Jest to dwuliterowy kod kraju zapisany wielkimi literami (obecnie w przypadku kampanii Performance Max dla Usług lokalnych obsługiwany jest tylko kod US), który służy do określania wymagań weryfikacyjnych i sprawdzania poprawności wyboru kryterium lokalizacji.
• phone_numbers: lista numerów telefonów powiązanych z usługodawcą, reprezentowana przez komunikaty LocalServicesPhoneNumber. Jeśli go pominiesz, numer telefonu będzie domyślnie taki sam jak numer telefonu w połączonej wizytówce w Profilu Firmy w Google. Jest on wymagany, jeśli w wizytówce w Profilu Firmy nie ma numeru telefonu.

Numery telefonów

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

• phone_number: numer telefonu.
• country_code: dwuliterowy kod kraju zapisany wielkimi literami.
• phone_number_type: typ numeru telefonu określony przez GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Obsługiwane typy:
  • DESTINATION_PHONE_NUMBER_FOR_ADS: numer docelowy, który ma być używany do połączeń z jednostki reklamowej Usług Lokalnych (w przypadku kontaktów do potencjalnych klientów, domyślnie).
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: numer docelowy, który obsługuje SMS-y (opcjonalnie, w przypadku powiadomień SMS o potencjalnych klientach, którzy wysłali wiadomość).
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: numer docelowy konta WhatsApp dostawcy.