지역 서비스 캠페인 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
필드
지역 서비스 캠페인의 입찰 전략 설정
다음 입찰 전략을 표준 입찰 전략으로 설정할 수 있습니다. 지역 서비스 캠페인:
ManualCpa
드림manual_cpa
필드를 설정하여다음 방법으로
ManualCpa
의 입찰가를 설정할 수 있습니다.LocalServicesCampaignSettings.category_bids
LocalServicesCampaignSettings
의 지역 서비스를 가져오고 설정할 수 있습니다. 캠페인을Campaign.local_services_campaign_settings
MaximizeConversions
드림 필드를 설정하여maximize_conversions
광고 일정을 캠페인 기준으로 설정
지역 서비스 캠페인의 광고 일정을 캠페인으로 설정할 수 있습니다. 있습니다.
AdScheduleInfo
를 만들고
ad_schedule
의
CampaignCriterion
: Google Ads API에
CampaignCriterionService.MutateCampaignCriteria
위치 타겟팅 설정
지역 서비스 캠페인에 위치 타겟팅을 사용하려면 광고에
LocationInfo
를 선택하고
location
의
CampaignCriterion
: Google Ads API에
CampaignCriterionService.MutateCampaignCriteria
자세한 내용은 위치를 참조하세요.
타겟팅을 사용합니다.
특정 서비스 유형 타겟팅
특정 서비스 유형에 타겟팅을 사용 설정하려면
LocalServiceIdInfo
를 선택하고
유형
서비스를 참고하세요.
캠페인의 타겟팅과 일치하는 서비스 ID를 사용해야 합니다. location 및 category를 사용합니다.
지원되지 않는 작업
다음 표에 나열된 제한사항은 Google Ads API
지원되지 않는 작업 | |
---|---|
캠페인 만들기 및 삭제 | Google Ads API는 새로운 지역 서비스 캠페인 생성을 차단합니다. |
캠페인의 하위 항목에 대한 작업 | Google Ads API는 캠페인의 생성, 수정, 삭제 또는 지역 서비스 캠페인에서 광고 그룹, 광고, 기준을 가져옵니다. |
지역 서비스 리소스
Google Ads API v15부터 지역 서비스 광고는 직접 노출됩니다. Google Ads API에서 다음과 같은 읽기 전용 보고서 리소스를 사용합니다.
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
이러한 리소스에서 데이터를 반환하려면 지역 서비스가 있어야 합니다. 확인할 수 있습니다. 한 번에 여러 개의 지역 서비스 캠페인 1개를 사용하는 경우 이러한 리소스는 캠페인을 지정할 수 있습니다. 이러한 리소스가 연결된 캠페인을 식별하기 위해 다음 쿼리를 사용합니다.
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
입니다. Kubernetes는 일대다 관계입니다
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가 있는 경우 새로운
customer
리소스의 필드
LocalServicesSetting
이 필드에는 라이선스 및 보험 상태의 대략적인 요약이 표시됩니다. 인증 요청을 확인할 수 있습니다. 이 예시에서는 는 다음과 같은 모든 데이터를 검색합니다.
SELECT
customer.local_services_settings.granular_license_statuses,
customer.local_services_settings.granular_insurance_statuses
FROM customer
지역 서비스 직원
LocalServicesEmployee
는 데이터 노출
광고주가 광고를 업로드한 지역 서비스 직원 정보
확인할 수 있습니다
다음은 이 쿼리와 관련된 모든 로컬 서비스 직원 수를 나타냅니다.
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