스마트 캠페인을 실적 최대화 캠페인으로 전환

v25_2 출시부터 Google Ads API는 스마트 캠페인을 실적 최대화 캠페인으로 전환하는 데 도움이 되는 SmartCampaignSettingService.GeneratePMaxDraftCampaign 메서드를 도입합니다.

전환 작동 방식

SmartCampaignSettingService.GeneratePMaxDraftCampaign를 호출하면 API가 기존 스마트 캠페인의 구성을 기반으로 초안 실적 최대화 캠페인을 생성합니다.

생성된 실적 최대화 임시 캠페인은 다음 상태 값으로 초기화됩니다.

  • statusPAUSED로 설정됩니다.
  • creation_statusINCOMPLETE로 설정됩니다.

이렇게 하면 캠페인을 사용 설정하여 광고를 게재하기 전에 생성된 실적 최대화 캠페인, 예산, 애셋 그룹, 애셋을 검사, 수정, 개선할 수 있습니다.

요청 매개변수

GeneratePMaxDraftCampaignRequest 메시지는 다음 필드를 허용합니다.

  • resource_name (필수): 변환하려는 기존 스마트 캠페인과 연결된 SmartCampaignSetting의 리소스 이름입니다. 형식은 다음과 같습니다.

    customers/customer_id/smartCampaignSettings/campaign_id
    
  • validate_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_onlytrue로 설정된 경우 반환되는 추가 검증 정보 또는 가능한 변환 문제입니다.

스마트 캠페인을 전환하려면 다음 워크플로를 사용하세요.

  1. 임시 캠페인 생성: 필수 resource_name만 설정된 상태로 SmartCampaignSettingService.GeneratePMaxDraftCampaign를 호출합니다 (gbp_enabledimage_enabled은 설정되지 않은 상태로 두거나 false로 설정). 반환된 pmax_campaign, campaign_budget, asset_group, assets 리소스 이름을 저장합니다.
  2. 캠페인 검토 및 맞춤설정: 초안 실적 최대화 캠페인은 status = PAUSEDcreation_status = INCOMPLETE로 생성되므로 예산, 애셋 그룹, 애셋을 검사하고 구성합니다.
  3. 캠페인 사용 설정: 광고를 게재할 준비가 되면 캠페인의 statusENABLED로, creation_statusCOMPLETE로 업데이트합니다.