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

v25 (v25.2부터)에는 SmartCampaignSettingService.GeneratePMaxDraftCampaign 메서드를 사용하여 스마트 캠페인을 실적 최대화 캠페인으로 전환할 수 있습니다. 이 메서드는 v24 이하에서는 사용할 수 없습니다.

전환 작동 방식

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

생성된 실적 최대화 임시 캠페인은 status이 PAUSED로 설정되고 게재 가능 여부가 primary_status에 반영된 상태로 초기화됩니다. 모든 기능 변환기가 스마트 캠페인에 대한 유효성 검사에 실패하면 SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL 오류와 함께 요청이 실패합니다.

이렇게 하면 캠페인을 사용 설정하여 광고를 게재하기 전에 생성된 실적 최대화 캠페인, 예산, 애셋 그룹, 애셋을 검사, 수정, 개선할 수 있습니다. 초안 실적 최대화 캠페인을 생성해도 원래 스마트 캠페인이 수정되거나 일시중지되지 않으며, 수동으로 일시중지할 때까지 활성 상태로 유지됩니다.

요청 매개변수

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

  • resource_name (필수): 전환하려는 스마트 캠페인의 재생성할 SmartCampaignSetting의 리소스 이름입니다. 형식은 다음과 같습니다.

    customers/customer_id/smartCampaignSettings/campaign_id

  • validate_only (선택사항): true인 경우 요청이 검증되지만 실행되지는 않습니다. 검증 오류, 경고 또는 가능한 전환 문제만 초안 항목을 만들지 않고 응답의 validated_info 필드에 반환됩니다.

  • gbp_enabled (지원되지 않음): 선택사항입니다. 실적 최대화 캠페인에 연결된 Google 비즈니스 프로필 (GBP) 위치를 변환할지 여부입니다. 이 필드를 설정하지 않거나 false로 설정하세요. true로 설정하는 것은 v25에서 구현되지 않으며 SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 오류가 반환됩니다.

  • image_enabled (지원되지 않음): 선택사항입니다. 필수 실적 최대화 캠페인 이미지 (예: 가로, 정사각형, 로고 이미지 유형)를 생성할지 여부입니다. 이 필드를 설정하지 않거나 false로 설정합니다. true로 설정하는 것은 v25에서 구현되지 않으며 SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 오류가 반환됩니다.

대답 세부정보

GeneratePMaxDraftCampaignResponse 메시지는 생성된 실적 최대화 임시 캠페인과 연결된 항목의 리소스 이름을 반환합니다.

  • pmax_campaign: 생성된 초안 실적 최대화 캠페인의 Campaign 리소스 이름입니다.
  • campaign_budget: 생성된 실적 최대화 캠페인에 연결된 CampaignBudget 리소스 이름입니다.
  • asset_group: 생성된 실적 최대화 캠페인에 연결된 AssetGroup 리소스 이름입니다.
  • assets: 생성된 실적 최대화 캠페인에 연결된 Asset 리소스 이름 목록입니다.
  • validated_info: 전환 확인에서 반환된 검증 정보 또는 가능한 전환 문제 (validate_only이 true로 설정된 경우와 validate_only이 false인 경우 생성된 항목 리소스 이름과 함께 모두 채워짐).

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

  1. 임시 캠페인 생성: 필수 resource_name만 설정하여 SmartCampaignSettingService.GeneratePMaxDraftCampaign를 호출합니다 (gbp_enabled 및 image_enabled은 설정하지 않거나 false으로 설정). 반환된 pmax_campaign, campaign_budget, asset_group, assets 리소스 이름을 저장합니다.
  2. 캠페인 검토 및 맞춤설정: 초안 실적 최대화 캠페인이 status = PAUSED로 생성되므로 예산, 애셋 그룹, 애셋을 검사하고 구성합니다.
  3. 캠페인 사용 설정 및 기존 캠페인 일시중지: 광고를 게재할 준비가 되면 실적 최대화 캠페인의 status를 ENABLED로 업데이트한 다음 기존 스마트 캠페인의 status를 PAUSED로 업데이트하여 중복 게재를 방지합니다.
이전
개요
다음
추천 받기