Kampanie w Usługach lokalnych

Kampanie Usług 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 bieżącej wersji interfejsu 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 Usług Lokalnych można pobrać za pomocą metody GoogleAdsService.Search lub GoogleAdsService.SearchStream do wysyłania zapytań 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 powiązanego z nią budżetu kampanii amount_micros.

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 w polu location elementu CampaignCriterion, który jest wysyłany do interfejsu Google Ads API, używając CampaignCriterionService.MutateCampaignCriteria. Więcej informacji znajdziesz w sekcji 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 go za pomocą funkcji CampaignCriterionService.MutateCampaignCriteria.

Używaj 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. 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 Usług 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 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, wysyła wiadomość lub rezerwuje usługę u reklamodawcy.

Dane potencjalnych klientów 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 ma wartość null, jeśli lead_status ma wartość WIPED_OUT.
  • Od v25 parametr ContactDetails.email jest usuwany, a parametr ContactDetails.phone_number_extension jest dostępny w wiadomości ContactDetails zwracanej przez local_services_lead.contact_details.
  • Dane z zapytaniami od potencjalnych klientów, w przypadku 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 zasobów 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, 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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/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ą:

  • Weryfikacje licencji
  • Weryfikacje ubezpieczenia
  • Weryfikacja sprawdzenia przeszłości
  • Weryfikacje dowodu zarejestrowania firmy

Za każdym razem, gdy do Reklam Usług Lokalnych przesyłane jest żądanie weryfikacji, w interfejsie Google Ads API tworzona jest nowa instancja artefaktu weryfikacji. Każdy artefakt weryfikacji reprezentuje pojedyncze żądanie weryfikacji. 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 sprawdzenia przeszłości, który będzie używany do weryfikacji sprawdzenia przeszłości
  • Czas rozpatrywania sprawdzenia przeszłości (w stosownych przypadkach)
  • Adres URL dokumentu ubezpieczeniowego, 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 (jeśli dotyczy)
  • 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 odpowiednich przypadkach)
  • Adres URL dokumentu potwierdzającego rejestrację firmy, aby wyświetlić przesłany dokument rejestracyjny obraz (jeśli dotyczy)

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 dotyczące licencji i ubezpieczenia według lokalizacji geograficznej i kategorii

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

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 ujawnia dane o pracownikach usług lokalnych, które reklamodawcy przesłali do naszych systemów w swoich profilach reklamowych.

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).

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 na stronie 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, w którym wyświetla się reklama usługi lokalnej. To pole jest niezmienne i ustawiane tylko raz podczas tworzenia reklamy. Jest to dwuliterowy kod kraju pisany wielkimi literami, który służy do określania wymagań weryfikacyjnych i sprawdzania poprawności wyboru kryteriów lokalizacji.
  • phone_numbers: lista numerów telefonów powiązanych z dostawcą, reprezentowanych 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, który ma być używany w przypadku 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.