지역 서비스 캠페인

지역 서비스 캠페인을 사용하면 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'

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 (해당하는 경우)
  • 사업자 등록 세부정보 (신분증, 등록 번호 확인)
  • 사업자 등록 거부 사유 (해당하는 경우)
  • 이미 제출된 등록 이미지를 볼 수 있는 사업자 등록증 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별로 인증 요청 상태를 프로그래매틱 방식으로 확인하려면 LocalServicesSetting라는 새 필드를 customer 리소스에 사용하면 됩니다.

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

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