지역 서비스 캠페인

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

지원되는 작업

다음 작업이 지원됩니다.

지역 서비스 캠페인 및 예산 검색

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

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로 설정합니다. 자세한 내용은 위치 타겟팅을 참고하세요.

특정 서비스 유형 타겟팅

특정 서비스 유형에 대한 타겟팅을 사용 설정하려면 LocalServiceIdInfo를 추가하고 서비스 유형으로 설정합니다.

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

지원되지 않는 작업

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

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

지역 서비스 리소스

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

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

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입니다.
  • 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'

Google Ads API 버전 17부터 LocalServicesLeadService.AppendLeadConversation 메서드를 사용하여 LocalServicesLeadConversation 리소스를 LocalServicesLead에 추가할 수 있습니다.

제한사항

  • 통화 녹음 파일 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.id = 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'

지역 및 카테고리별 라이선스 및 보험 데이터

지리적 위치(특히 geo target code) 및 local services category ID별로 인증 요청의 상태를 프로그래매틱 방식으로 확인하려면 customer 리소스의 새 필드인 LocalServicesSettings를 사용하면 됩니다.

이 필드는 위치 및 카테고리별로 라이선스 및 보험 확인 요청 상태에 관한 개요를 표시합니다. 다음은 이러한 모든 데이터를 검색하는 쿼리의 예입니다.

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