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

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

전환의 작동 방식

SmartCampaignSettingService.GeneratePMaxDraftCampaign을 호출하면 API는 요청에 제공된 스마트 캠페인의 구성을 기반으로 실적 최대화 캠페인 초안, 예산, 애셋 그룹, 애셋을 생성합니다. 생성되면 캠페인에서 광고를 게재할 수 있도록 설정하기 전에 새 리소스를 검사, 수정, 개선해야 합니다.

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

  • status가 PAUSED로 설정됩니다.
  • 게재 자격은 primary_status에 반영됩니다.
  • contains_eu_political_advertising은 기본적으로 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING 으로 설정됩니다 (스마트 캠페인에 아직 지정되지 않은 경우). 캠페인에 EU 정치 광고가 포함되어 있는 경우 이 필드를 확인하고 업데이트합니다.

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

확장 소재 초안

새 캠페인에는 새 캠페인을 사용 설정하기 전에 대체해야 하는 플레이스홀더 이미지 그룹이 함께 제공됩니다. 요청에서 image_enabled 필드가 지원되고 true로 설정되면 API는 플레이스홀더 이미지를 사용하는 대신 이미지를 자동으로 생성합니다. 다음 단계에 따라 응답의 assets 필드에서 새 애셋을 검사하고 대체할 수 있습니다.

  1. 애셋 요구사항 가이드를 검토합니다.
  2. 이미지 애셋 업로드 예에 따라 새 이미지를 업로드합니다.
  3. 애셋 그룹을 애셋에 연결 가이드에 따라 새 애셋을 초안 캠페인의 애셋 그룹에 연결한 다음 플레이스홀더 이미지의 AssetGroupAsset 링크를 삭제합니다 (동일한 mutate 요청에서 또는 새 애셋을 연결한 후 최소 애셋 요구사항이 충족되도록).

요청 매개변수

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

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

    customers/customer_id/smartCampaignSettings/campaign_id

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

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

  • image_enabled (지원되지 않음): 선택사항입니다. 가로, 정사각형, 로고 이미지 유형과 같은 필수 실적 최대화 캠페인 이미지를 생성할지 여부입니다. 이 필드를 설정하지 않거나 false로 둡니다. true로 설정하는 것은 지원되지 않으며 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 및 creation_status = INCOMPLETE로 생성되므로 예산, 애셋 그룹, 애셋을 검사하고 구성합니다.
  3. 캠페인 사용 설정 및 기존 캠페인 일시중지: 광고를 게재할 준비가 되면 실적 최대화 캠페인의 status를 ENABLED로 업데이트한 다음 중복 게재를 방지하기 위해 기존 스마트 캠페인의 status를 PAUSED로 업데이트합니다.
이전
개요
다음
추천 받기