v25_2 출시부터 Google Ads API는 스마트 캠페인을 실적 최대화 캠페인으로 전환하는 데 도움이 되는 SmartCampaignSettingService.GeneratePMaxDraftCampaign 메서드를 도입합니다.
전환 작동 방식
SmartCampaignSettingService.GeneratePMaxDraftCampaign를 호출하면 API가 기존 스마트 캠페인의 구성을 기반으로 초안 실적 최대화 캠페인을 생성합니다.
생성된 실적 최대화 임시 캠페인은 다음 상태 값으로 초기화됩니다.
status이PAUSED로 설정됩니다.creation_status이INCOMPLETE로 설정됩니다.
이렇게 하면 캠페인을 사용 설정하여 광고를 게재하기 전에 생성된 실적 최대화 캠페인, 예산, 애셋 그룹, 애셋을 검사, 수정, 개선할 수 있습니다.
요청 매개변수
GeneratePMaxDraftCampaignRequest 메시지는 다음 필드를 허용합니다.
resource_name(필수): 변환하려는 기존 스마트 캠페인과 연결된SmartCampaignSetting의 리소스 이름입니다. 형식은 다음과 같습니다.customers/customer_id/smartCampaignSettings/campaign_idvalidate_only(선택사항):true인 경우 요청이 검증되지만 실행되지는 않습니다. 유효성 검사 오류, 경고 또는 가능한 전환 문제만 응답의validated_info필드에 반환됩니다.gbp_enabled(현재 지원되지 않음): 스마트 캠페인과 연결된 Google 비즈니스 프로필 (GBP) 위치를 생성된 실적 최대화 캠페인으로 변환하고 연결할지 여부입니다. 이 필드를true로 설정하는 것은 현재 구현되지 않았으며GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED오류가 반환됩니다.image_enabled(현재 지원되지 않음): 실적 최대화 캠페인에 필요한 이미지 (예: 가로, 정사각형, 로고 이미지 확장 소재)를 자동으로 생성할지 여부입니다. 이 필드를true로 설정하는 것은 현재 구현되지 않았으며IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED오류가 반환됩니다.
대답 세부정보
GeneratePMaxDraftCampaignResponse 메시지는 새로 생성된 실적 최대화 임시 캠페인과 연결된 항목의 리소스 이름을 반환합니다.
pmax_campaign: 생성된 초안 실적 최대화 캠페인의Campaign리소스 이름입니다.campaign_budget: 생성된 실적 최대화 캠페인에 연결된CampaignBudget리소스 이름입니다.asset_group: 생성된 실적 최대화 캠페인에 연결된AssetGroup리소스 이름입니다.assets: 생성된 실적 최대화 캠페인에 연결된Asset리소스 이름 목록입니다.validated_info:validate_only이true로 설정된 경우 반환되는 추가 검증 정보 또는 가능한 변환 문제입니다.
권장 워크플로
스마트 캠페인을 전환하려면 다음 워크플로를 사용하세요.
- 임시 캠페인 생성: 필수
resource_name만 설정된 상태로SmartCampaignSettingService.GeneratePMaxDraftCampaign를 호출합니다 (gbp_enabled및image_enabled은 설정되지 않은 상태로 두거나false로 설정). 반환된pmax_campaign,campaign_budget,asset_group,assets리소스 이름을 저장합니다. - 캠페인 검토 및 맞춤설정: 초안 실적 최대화 캠페인은
status = PAUSED및creation_status = INCOMPLETE로 생성되므로 예산, 애셋 그룹, 애셋을 검사하고 구성합니다. - 캠페인 사용 설정: 광고를 게재할 준비가 되면 캠페인의
status을ENABLED로,creation_status을COMPLETE로 업데이트합니다.