지역 서비스 캠페인

지역 서비스 캠페인을 사용하면 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 v15부터 지역 서비스 광고의 일부 데이터가 다음과 같은 읽기 전용 보고서 리소스를 통해 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'

제한사항

  • 통화 녹음 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'

지역 및 범주형 라이선스와 보험 데이터

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

이 필드는 위치 및 카테고리별 라이선스 및 보험 인증 요청의 상태에 관한 대략적인 요약을 노출합니다. 다음은 이러한 데이터를 모두 검색하는 쿼리의 예입니다.

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