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

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로 업데이트하여 중복 게재를 방지합니다.
이전
개요
다음
추천 받기