지역 서비스 캠페인을 사용하면 Google에 비즈니스를 광고하고 잠재고객으로부터 직접 리드를 받을 수 있습니다. 이 가이드에서는 Google Ads API에서 지원되는 작업과 제한사항을 요약합니다.
지원되는 작업
Google Ads API는 지역 서비스 캠페인에 대해 다음 작업을 지원합니다.
지역 서비스 캠페인 및 예산 가져오기
지역 서비스 캠페인 및 예산은 GoogleAdsService.Search 또는 GoogleAdsService.SearchStream 메서드를 사용하여 advertising_channel_type = 'LOCAL_SERVICES'인 Campaign 리소스를 쿼리하여 가져올 수 있습니다. 예를 들면 다음과 같습니다.
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 필드를 업데이트할 수 있습니다.
입찰 전략 설정
다음 입찰 전략을 지역 서비스 캠페인의 표준 입찰 전략으로 설정할 수 있습니다.
manual_cpa필드를 설정하여ManualCpaLocalServicesCampaignSettings.category_bids를 통해ManualCpa의 입찰가를 설정할 수 있습니다.Campaign.local_services_campaign_settings를 통해 지역 서비스 캠페인의LocalServicesCampaignSettings를 가져오고 설정할 수 있습니다.maximize_conversions필드를 설정하여MaximizeConversions
광고 일정을 캠페인 기준으로 설정하기
지역 서비스 캠페인의 광고 일정을 캠페인 기준으로 설정할 수 있습니다.
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 필드를 검사하여 리드가 평가되고 의견이 제출되었는지 확인할 수도 있습니다.
지원되지 않는 작업
다음 표에는 독립형 지역 서비스 캠페인 (advertising_channel_type = 'LOCAL_SERVICES')에서 지원되지 않는 작업이 나와 있습니다.
| 지원되지 않는 작업 | |
|---|---|
| 캠페인 생성 및 삭제 | Google Ads API는 독립형 지역 서비스 캠페인 (advertising_channel_type = 'LOCAL_SERVICES')의 생성 및 삭제를 차단합니다.
v26부터 pmax_campaign_settings.local_services_enabled = true를 설정하여 새로운 지역 서비스 실적 최대화 캠페인(advertising_channel_type = 'PERFORMANCE_MAX')을 만들 수 있습니다.
지역 서비스 실적 최대화 캠페인 만들기를 참고하세요. |
| 캠페인의 하위 항목에 대한 작업 | 독립형 지역 서비스 캠페인(advertising_channel_type = 'LOCAL_SERVICES')의 경우 Google Ads API는 지원되는 작업에 나열된 캠페인 기준 이외의 광고 그룹, 광고 또는 기준의 생성, 수정, 삭제 또는 검색을 지원하지 않습니다. 지역 서비스 실적 최대화 캠페인의 경우 애셋 그룹 및 캠페인 기준을 사용합니다. |
지역 서비스 리소스
지역 서비스 광고의 일부 데이터는 다음 읽기 전용 보고서 리소스를 통해 Google Ads API에 직접 노출됩니다.
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
이러한 리소스가 데이터를 반환하려면 요청하는 고객 계정에 지역 서비스 캠페인 또는 지역 서비스 실적 최대화 캠페인이 있어야 합니다. local_services_lead.campaign 필드는 리드 레코드를 연결된 캠페인 (campaign.advertising_channel_type = 'PERFORMANCE_MAX' 및 campaign.pmax_campaign_settings.local_services_enabled = true인 리드당 지불 목표를 위한 실적 최대화 캠페인 포함)에 다시 연결합니다. 이러한 리소스가 연결된 캠페인을 식별하려면 다음 쿼리를 사용하세요.
SELECT
campaign.id,
campaign.advertising_channel_type,
campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')
지역 서비스 리드
LocalServicesLead는 소비자가 광고주에게 전화를 걸거나, 메시지를 보내거나, 서비스를 예약하거나, 쿠폰을 사용할 때 생성되는 리드의 세부정보를 노출합니다.
리드 유형은 LocalServicesLeadType에 의해 정의됩니다.
v26부터 지역 서비스 및 지역 서비스 실적 최대화 캠페인에서 쿠폰 리드 유형을 사용 설정할 수 있도록 COUPON가 지원됩니다.
campaign 필드는 리드 레코드를 연결된 캠페인에 다시 연결합니다. 기여도가 부여된 campaign 필드 (예: campaign.id 및 campaign.name)를 선택하는 것 외에도 캠페인 리소스 이름(WHERE local_services_lead.campaign = ...) 또는 광고 채널 유형(WHERE campaign.advertising_channel_type = ...)으로 리드 쿼리를 필터링하여 캠페인 유형별로 리드를 분류할 수 있습니다.
지역 서비스 리드 데이터는 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,
local_services_lead.campaign
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 메서드를 사용하여 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_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_override_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)을 구성하고 식별할 수 있습니다.
지역 서비스 실적 최대화 캠페인 만들기
v26부터 Google Ads API는 지역 서비스 실적 최대화 캠페인의 생성과 업데이트를 모두 지원합니다. 실적 최대화 캠페인 (advertising_channel_type = 'PERFORMANCE_MAX')을 만들고 pmax_campaign_settings에서 local_services_enabled = true를 설정하여 API를 통해 새 지역 서비스 실적 최대화 캠페인을 만들 수 있습니다 (생성 후 변경할 수 없음).
지역 서비스 실적 최대화 캠페인을 만들 때는 local_services_pmax_campaign_settings에 country_code와 listing_id가 모두 필요합니다. v24 및 v25에서 API는 허용 목록에 있는 계정에서 UI를 통해 만든 기존 지역 서비스 실적 최대화 캠페인에 대한 업데이트만 지원합니다. 기본 요건을 구성하고 캠페인을 원자적으로 만드는 방법에 대한 전체 안내는 리드당 지불 목표를 위한 실적 최대화 캠페인 가이드를 참고하세요.
지역 서비스 실적 최대화 캠페인 식별
실적 최대화 캠페인이 지역 서비스 캠페인인지 확인하려면 캠페인의 pmax_campaign_settings에서 local_services_enabled 필드를 확인하세요. 이 필드는 캠페인 생성 시 true로 설정된 변경할 수 없는 (CREATE ONLY) 불리언입니다.
설정 구성
local_services_enabled가 true인 캠페인의 경우 local_services_pmax_campaign_settings 필드에서 설정을 구성합니다.
listing_id: 캠페인에 연결된 Google 비즈니스 프로필 등록정보 ID입니다.v26부터 이 필드는 지역 서비스 실적 최대화 캠페인을 만드는 동안 필수이며 변경할 수 없습니다. 등록정보 ID는 사용 설정된LOCATION확장 소재로 계정에 연결되어야 합니다. 그렇지 않으면 API에서CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID오류를 반환합니다.listing_id는IMMUTABLE로 표시되므로 캠페인 생성 후 이 필드를 업데이트하려고 하면RequestError.IMMUTABLE_FIELD와 함께 실패합니다. 개발자는 사용 설정된LOCATION확장 소재의Asset리소스를 쿼리하여 연결된 등록정보 ID를 검색하거나 확인할 수 있습니다 (location_asset.business_profile_locations검사). 자세한 내용은 위치 확장 소재를 참고하세요.navigational_query_leads_enabled: 탐색 쿼리 필터를 사용할지 여부입니다.founding_year: 비즈니스가 설립된 연도입니다.country_code: 지역 서비스 광고의 국가 코드입니다.v26부터 이 필드는 필수이며 변경할 수 없으며 캠페인 생성 중에 한 번 설정됩니다. 인증 요구사항을 결정하고 위치 기준 선택을 검증하는 데 사용되는 대문자 2자리 국가 코드입니다 (현재 지역 서비스 실적 최대화 캠페인에는US만 지원됨).phone_numbers: 제공업체와 연결된 전화번호 목록으로,LocalServicesPhoneNumber메시지로 표시됩니다. 생략하면 통화 번호는 연결된 Google 비즈니스 프로필 등록정보의 전화번호로 기본 설정되며, 비즈니스 프로필 등록정보에 전화번호가 없는 경우 필수입니다.
전화번호
phone_numbers 반복되는 입력란의 각 항목은 다음 필드와 함께 LocalServicesPhoneNumber 메시지 유형을 사용합니다.
phone_number: 전화번호입니다.country_code: 대문자, 두 글자 국가 코드입니다.phone_number_type: 전화번호 유형입니다.GlsPhoneNumberTypeEnum.GlsPhoneNumberType로 정의됩니다. 지원되는 유형은 다음과 같습니다.DESTINATION_PHONE_NUMBER_FOR_ADS: 지역 서비스 광고 단위의 통화에 사용할 대상 번호입니다 (통화 리드의 경우 기본값).DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: SMS를 지원하는 대상 번호입니다 (선택사항, 메시지 리드 SMS 알림용).DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: 제공업체의 WhatsApp 계정의 대상 번호입니다.