Kampanie w Usługach lokalnych

Kampanie Usług Lokalnych umożliwiają reklamowanie firmy w Google i otrzymywanie danych kontaktowych 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 w Usługach Lokalnych

Kampanie i budżety w Usługach Lokalnych można pobrać za pomocą metody GoogleAdsService.Search lub GoogleAdsService.SearchStream do wysyłania 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 kampanii i amount_micros powiązanego z nią budżetu kampanii.

Ustawianie strategii ustalania stawek w kampaniach Reklam Usług Lokalnych

W kampaniach Usług lokalnych możesz ustawić te strategie ustalania stawek jako standardowe strategie ustalania stawek:

Ustawianie harmonogramu reklam jako kryterium kampanii

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

Utwórz AdScheduleInfo i ustaw go na ad_schedule CampaignCriterion wysyłanego 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 element LocationInfo i ustaw go na wartość location elementu CampaignCriterion, który jest wysyłany do interfejsu Google Ads API, używając elementu CampaignCriterionService.MutateCampaignCriteria. Więcej informacji znajdziesz w artykule Kierowanie na lokalizację.

Kierowanie reklam na określone typy usług

Aby włączyć kierowanie na określony typ usługi, dodaj 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ę o potencjalnym klientowi, użyj metody ProvideLeadFeedback() w przypadku LocalServicesLeadService. Możesz też sprawdzić pole lead_feedback_submitted w LocalServicesLead, aby określić, czy kontakt do potencjalnego klienta 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 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.

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:

Aby te zasoby zwracały dane, na koncie klienta, które wysyła żądanie, musi być aktywna kampania Reklam Usług Lokalnych. Ponieważ na koncie klienta może być tylko 1 kampania Usług lokalnych, te zasoby nie określają kampanii. Aby określić kampanię, z którą są powiązane te komponenty, 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 dotyczące potencjalnego klienta, które są generowane, gdy konsument dzwoni do reklamodawcy, wysyła do niego wiadomość lub rezerwuje jego usługę.

Dane o potencjalnych klientach z Usług Lokalnych można pobrać z zasobu local_services_lead. 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 pole lead_status ma wartość WIPED_OUT.
  • Dane z zapytaniami od potencjalnych klientów, w których category_id należy do kategorii związanej z ochroną zdrowia, są niedostępne.

Rozmowa z potencjalnym klientem z Usług Lokalnych

LocalServicesLeadConversation ujawnia 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 prowadzić 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 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'

Możesz użyć metody LocalServicesLeadService.AppendLeadConversation do dołączania LocalServicesLeadConversation zasobów 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, do którego należy kampania, z którą powiązany jest potencjalny klient.

  • Żą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

Dokument weryfikacyjny w Usługach lokalnych

LocalServicesVerificationArtifact ujawnia 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ą:

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

  • stan każdego dokumentu weryfikacyjnego.
  • Adres URL sprawdzania przeszłości, który będzie używany do weryfikacji sprawdzania przeszłości
  • Czas rozpatrywania sprawdzenia przeszłości (w stosownych przypadkach)
  • Adres URL dokumentu ubezpieczenia, aby wyświetlić przesłane już informacje o ubezpieczeniu
  • Przyczyna odrzucenia ubezpieczenia (jeśli dotyczy)
  • Szczegóły licencji (typ, numer, imię i nazwisko)
  • Powód odrzucenia licencji (w stosownych przypadkach)
  • Adres URL dokumentu licencji, aby wyświetlić przesłany obraz licencji (w stosownych przypadkach)
  • Informacje dotyczące dowodu zarejestrowania firmy (sprawdź identyfikator, numer rejestracyjny)
  • Powód odrzucenia dowodu zarejestrowania firmy (w stosownych przypadkach)
  • Adres URL dokumentu potwierdzającego dowód zarejestrowania firmy, aby wyświetlić przesłany dowód zarejestrowania firmy obraz (w odpowiednich przypadkach)

Dane artefaktu weryfikacyjnego można pobrać z zasobu local_services_verification_artifact. Oto przykładowe zapytanie, które pobiera dane wszystkich artefaktów weryfikacyjnych 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 geograficzne i kategoryczne dotyczące licencji i ubezpieczenia

Aby programowo określać stan próśb o weryfikację 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.

To pole zawiera 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 ramach profilu reklamowego.

Oto przykładowe zapytanie, które pobiera dane wszystkich pracowników świadczących usługi lokalne 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 umożliwiają skonfigurowanie i określenie kampanii Performance Max, która wyświetla Reklamy Usług Lokalnych (GLS PMax).

Identyfikowanie kampanii Performance Max w Usługach Lokalnych

Aby sprawdzić, czy kampania Performance Max jest kampanią w Reklamach Usług Lokalnych, sprawdź pole tylko do odczytu local_services_enabled w pmax_campaign_settings kampanii.

Konfiguracja

W przypadku kampanii, w których pole 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 usługi lokalnej. To pole jest niezmienne i ustawiane tylko raz podczas tworzenia reklamy. Jest to dwuliterowy kod kraju zapisany 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ą, reprezentowana przez wiadomości LocalServicesPhoneNumber.

Numery telefonów

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

  • phone_number: numer telefonu.
  • country_code: kod kraju składający się z 2 wielkich liter.
  • phone_number_type: typ numeru telefonu zdefiniowany przez GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Obsługiwane typy:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: numer docelowy do połączeń z jednostki reklamowej Usług 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 WhatsApp dostawcy.