지역 서비스 캠페인

지역 서비스 캠페인을 사용하면 Google에 비즈니스를 광고하고 잠재고객으로부터 직접 리드를 받을 수 있습니다. 이 가이드에서는 현재 버전의 Google Ads API에서 지원되는 작업과 제한사항을 요약합니다.

지원되는 작업

Google Ads API는 지역 서비스 캠페인에 대해 다음 작업을 지원합니다.

지역 서비스 캠페인 및 예산 가져오기

advertising_channel_type = 'LOCAL_SERVICES'인 Campaign 리소스를 쿼리하는 GoogleAdsService.Search 또는 GoogleAdsService.SearchStream 메서드를 사용하여 지역 서비스 캠페인 및 예산을 가져올 수 있습니다. 예를 들면 다음과 같습니다.

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'

지역 서비스 캠페인 수정하기

캠페인의 status 및 연결된 캠페인 예산의 amount_micros 필드를 업데이트할 수 있습니다.

지역 서비스 캠페인의 입찰 전략 설정

다음 입찰 전략을 지역 서비스 캠페인의 표준 입찰 전략으로 설정할 수 있습니다.

광고 일정을 캠페인 기준으로 설정

지역 서비스 캠페인의 광고 일정을 캠페인 기준으로 설정할 수 있습니다.

AdScheduleInfo를 만들고 CampaignCriterionService.MutateCampaignCriteria를 사용하여 Google Ads API에 전송되는 CampaignCriterion의 ad_schedule로 설정합니다.

위치 타겟팅 설정

지역 서비스 캠페인의 위치 타겟팅을 사용 설정하려면 LocationInfo를 추가하고 CampaignCriterionService.MutateCampaignCriteria를 사용하여 Google Ads API로 전송되는 CampaignCriterion의 location 필드로 설정합니다. 자세한 내용은 위치 타겟팅을 참고하세요.

특정 서비스 유형 타겟팅

특정 서비스 유형의 타겟팅을 사용 설정하려면 지역 서비스 카테고리 ID 중 하나를 사용하여 LocalServiceIdInfo를 만들고, CampaignCriterion의 local_service_id 필드에 설정하고, CampaignCriterionService.MutateCampaignCriteria를 사용하여 제출합니다.

캠페인의 타겟팅 위치 및 카테고리와 일치하는 서비스 ID를 사용해야 합니다.

리드 피드백 제출

LocalServicesLeadService의 ProvideLeadFeedback 메서드를 사용하여 리드의 평가와 의견을 제출합니다. LocalServicesLead의 lead_feedback_submitted 필드를 검사하여 리드가 평가되었는지, 의견이 제출되었는지 확인할 수도 있습니다.

지원되지 않는 작업

다음 표에 나열된 제한사항은 향후 Google Ads API 버전에서 변경될 수 있습니다.

지원되지 않는 작업
캠페인 생성 및 삭제 Google Ads API는 새 지역 서비스 캠페인 생성을 차단합니다.
캠페인의 하위 항목에 대한 작업 Google Ads API는 지역 서비스 캠페인의 광고 그룹, 광고 또는 기준의 생성, 수정, 삭제 또는 검색을 지원하지 않습니다.

지역 서비스 리소스

지역 서비스 광고의 일부 데이터는 다음 읽기 전용 보고서 리소스를 통해 Google Ads API에 직접 노출됩니다.

이러한 리소스가 데이터를 반환하려면 요청을 수행하는 고객 계정에 지역 서비스 캠페인이 있어야 합니다. 클라이언트 계정당 하나의 Google Local Services 캠페인만 있을 수 있으므로 이러한 리소스는 캠페인을 지정하지 않습니다. 이러한 리소스와 연결된 캠페인을 식별하려면 다음 쿼리를 사용하세요.

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

지역 서비스 리드

LocalServicesLead는 소비자가 광고주에게 전화를 걸거나, 메시지를 보내거나, 서비스를 예약할 때 생성되는 리드의 세부정보를 노출합니다.

지역 서비스 리드 데이터는 local_services_lead 리소스에서 가져올 수 있습니다. 다음은 쿼리의 예입니다.

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

제한사항

  • lead_status이 WIPED_OUT와 같으면 contact_details 필드가 null입니다.
  • v25부터 ContactDetails.email이 삭제되고 local_services_lead.contact_details에서 반환된 ContactDetails 메시지에서 ContactDetails.phone_number_extension을 사용할 수 있습니다.
  • category_id이 헬스케어 카테고리에 속하는 리드의 데이터는 사용할 수 없습니다.

지역 서비스 리드 대화

LocalServicesLeadConversation는 LocalServicesLead의 일부로 진행된 대화의 세부정보를 노출합니다. LocalServicesLead와 일대다 관계가 있습니다. 하나의 리드에 여러 대화가 있을 수 있습니다. 관련 리드의 리소스 이름은 lead 필드에서 확인할 수 있습니다.

대화 데이터는 local_services_lead_conversation 리소스에서 가져올 수 있습니다. 다음은 전화 통화 결과를 필터링하는 쿼리의 예입니다.

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'

LocalServicesLeadService.AppendLeadConversation 메서드를 사용하여 LocalServicesLead에 LocalServicesLeadConversation 리소스를 추가할 수 있습니다.

제한사항

  • 통화 녹음 URL에 액세스하려면 리드가 연결된 캠페인을 소유한 Google Ads 고객 계정에 대한 읽기 전용 액세스 권한 이상이 있는 이메일 주소로 로그인해야 합니다.

  • 모든 대화를 한 번에 요청하면 시간이 오래 걸릴 수 있으므로 다음과 같이 리드로 대화를 필터링해야 합니다.

    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'

지역 서비스 인증 아티팩트

LocalServicesVerificationArtifact는 광고주 비즈니스의 인증 데이터를 노출합니다. 이러한 인증은 비즈니스 수준에서 이루어지며 직원 인증은 포함되지 않습니다. 데이터에는 다음이 포함됩니다.

  • 라이선스 확인
  • 보험 확인
  • 백그라운드 확인
  • 비즈니스 등록 확인

인증 요청이 지역 서비스 광고에 제출될 때마다 Google Ads API에 새 인증 아티팩트 인스턴스가 생성되며 각 인증 아티팩트는 단일 인증 요청을 나타냅니다. 각 확인 아티팩트에는 어떤 유형의 확인 요청을 나타내는지에 따라 다음 정보 중 일부가 포함될 수 있습니다.

  • 각 확인 아티팩트의 상태
  • 백그라운드 확인에 사용되는 백그라운드 확인 URL
  • 백그라운드 확인 판정 시간 (해당하는 경우)
  • 이미 제출된 보험 정보를 볼 수 있는 보험 서류 URL
  • 보험 거부 사유 (해당하는 경우)
  • 라이선스 세부정보 (유형, 번호, 성, 이름)
  • 라이선스 거부 사유 (해당하는 경우)
  • 이미 제출된 라이선스 이미지를 볼 수 있는 라이선스 문서 URL(해당하는 경우)
  • 비즈니스 등록 세부정보 (ID, 등록 번호 확인)
  • 비즈니스 등록 거부 사유 (해당하는 경우)
  • 이미 제출된 등록 이미지를 볼 수 있는 비즈니스 등록 서류 URL (해당하는 경우)

인증 아티팩트 데이터는 local_services_verification_artifact 리소스에서 가져올 수 있습니다. 다음은 특정 고객 계정의 모든 라이선스 관련 인증 아티팩트의 데이터를 가져오는 쿼리의 예입니다.

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'

지리적 및 범주별 라이선스 및 보험 데이터

지리적 위치 (특히 지역 타겟팅 코드) 및 지역 서비스 카테고리 ID별로 인증 요청의 상태를 프로그래매틱 방식으로 확인하려면 LocalServicesSettings 유형의 customer 리소스에 있는 local_services_settings 필드를 사용하면 됩니다.

이 필드는 위치 및 카테고리별 라이선스 및 보험 확인 요청 상태의 상위 수준 요약을 노출합니다. 다음은 이러한 모든 데이터를 가져오는 쿼리의 예입니다.

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

지역 서비스 직원

LocalServicesEmployee은 광고주가 광고 프로필을 Google 시스템에 업로드한 현지 서비스 직원에 관한 데이터를 노출합니다.

다음은 지정된 고객 계정의 모든 현지 서비스 직원의 데이터를 가져오는 쿼리의 예입니다.

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

지역 서비스 실적 최대화 캠페인

실적 최대화 캠페인은 v24부터 지역 서비스 관련 설정을 지원합니다. 이러한 설정을 사용하면 지역 서비스 광고 (GLS PMax)를 게재하는 실적 최대화 캠페인을 구성하고 식별할 수 있습니다.

지역 서비스 실적 최대화 캠페인 식별

실적 최대화 캠페인이 지역 서비스 캠페인인지 확인하려면 캠페인의 pmax_campaign_settings에서 읽기 전용 local_services_enabled 필드를 확인하세요.

설정 구성

local_services_enabled이 true인 캠페인의 경우 local_services_pmax_campaign_settings 필드에서 설정을 구성합니다.

  • navigational_query_leads_enabled: 탐색 쿼리 필터를 사용할지 여부입니다.
  • founding_year: 비즈니스의 설립 연도입니다.
  • country_code: 지역 서비스 광고의 국가 코드입니다. 이 필드는 변경할 수 없으며 광고 생성 중에 한 번 설정됩니다. 확인 요구사항을 결정하고 위치 기준 선택을 검증하는 데 사용되는 대문자 2자리 국가 코드입니다.
  • phone_numbers: 프로바이더와 연결된 전화번호 목록으로, LocalServicesPhoneNumber 메시지로 표시됩니다.

전화번호

phone_numbers 반복 필드의 각 항목은 다음 필드가 있는 LocalServicesPhoneNumber 메시지 유형을 사용합니다.

  • phone_number: 전화번호
  • country_code: 대문자 2자리 국가 코드입니다.
  • phone_number_type: GlsPhoneNumberTypeEnum.GlsPhoneNumberType에 의해 정의된 전화번호 유형입니다. 지원되는 유형은 다음과 같습니다.
    • DESTINATION_PHONE_NUMBER_FOR_ADS: 지역 서비스 광고 단위의 통화에 사용할 대상 번호입니다 (기본값).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: SMS를 지원하는 대상 번호입니다.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: 제공업체의 WhatsApp 계정의 대상 번호입니다.