요청 구조화

이 가이드에서는 실적 최대화 캠페인을 만들고 업데이트하는 요청을 구조화하는 데 따르는 여러 복잡한 문제를 자세히 설명합니다. 통합을 설계할 때 유용한 리소스가 될 수 있습니다. 이 가이드에서는 실적 최대화 캠페인을 변경하는 요청이 처리되는 방식을 설명하며 실적 최대화 캠페인 문제 해결 가이드의 컴패니언 리소스가 될 수 있습니다.

실적 최대화 캠페인 만들기

Google Ads API에서 실적 최대화 캠페인 항목은 여러 고유한 리소스의 조합으로 표시됩니다.

표준 실적 최대화 캠페인

표준 실적 최대화 캠페인에서 광고를 게재하려면 최소한의 리소스 집합이 필요합니다.

AssetGroupAssetGroupAsset 항목을 생성하는 작업은 단일 요청에 함께 포함되어야 하고 AssetGroupAsset 리소스는 모든 최소 애셋 요구사항과 사양을 충족하도록 결합되어야 합니다. 소매업 캠페인의 경우 이 두 가지의 차이점을 확인하세요. 모든 필수 AssetGroupAsset 항목 없이 AssetGroup를 생성하도록 요청하면 오류가 발생합니다. 자세한 내용은 잘못된 상태 및 잘못된 요청을 참조하세요.

실적 최대화 캠페인을 생성하는 요청을 구조화하는 데는 다양한 옵션이 있습니다. 작업을 그룹화하고 요청을 구조화하는 방법은 주로 목표와 인프라에 따라 결정됩니다.

  • AssetGroupAssetGroupAsset 리소스를 만들기 전에 별도의 요청으로 CampaignBudget, Campaign, Asset 리소스를 만듭니다.
  • 이러한 모든 리소스를 단일 change 요청에 포함합니다.

별도의 이전 요청에서 CampaignBudget, Campaign, Asset 리소스를 만들 수 있지만 실적 최대화 캠페인은 AssetGroupAssetGroupAsset 리소스도 만들 때까지 광고를 게재할 수 없습니다.

유효한 실적 최대화 캠페인을 운영하기 위한 최소 요건

이미지

다이어그램과 같이 추가 리소스를 만들어 실적 최대화 캠페인을 추가로 맞춤설정할 수 있습니다.

AssetGroupAssetGroupAsset 리소스를 만드는 동일한 요청에 AssetGroupSignal 리소스를 만드는 작업을 포함할 수 있습니다. 또는 AssetGroup를 만든 후 별도의 요청에서 AssetGroupSignal 항목을 만들 수 있습니다.

추가 옵션이 있는 실적 최대화 캠페인

이미지

소매업을 위한 실적 최대화 캠페인

소매 캠페인은 유효한 게재 캠페인을 생성하는 애셋 그룹을 만드는 별도의 두 가지 방법이 있다는 점에서 고유합니다.

  • 애셋이 없는 애셋 그룹
  • 모든 필수 애셋이 포함된 애셋 그룹 (권장)

애셋 그룹에서 애셋을 제외하도록 선택하면 Google에서 연결된 판매자 센터 계정에서 제공된 애셋을 사용하여 자동으로 광고를 만듭니다. 하지만 모든 인벤토리에서 도달할 수 있는 애셋을 제공하는 것이 좋습니다. 소매업체를 위한 실적 최대화 캠페인에서 광고를 게재하려면 다음과 같은 최소한의 리소스 집합이 필요합니다.

  • CampaignBudget
  • Campaign (ShoppingSettings가 채워짐)
  • AssetGroup
  • AssetGroupListingGroupFilter

소매업 캠페인에서는 Campaign.shopping_settings 필드를 채워야 합니다. 또한 각 AssetGroup에 나열된 final_urlsCampaign.shopping_settings에 지정된 판매자 센터 계정 ID와 연결된 URL과 일치해야 합니다. 마지막으로 각 AssetGroup에는 하나 이상의 AssetGroupListingGroupFilter 리소스로 구성된 유효한 연결 제품 등록정보 그룹 트리가 있어야 합니다. 최소한 지정된 판매자 센터 피드의 모든 제품을 고려하여 단일 노드 트리를 만들어야 합니다.

이러한 각 리소스는 개별적으로 또는 단일 요청으로 만들 수 있습니다. 그러나 이러한 모든 리소스가 올바르게 생성되어야 캠페인을 게재할 수 있습니다.

유효한 소매업 실적 최대화 캠페인을 운영하기 위한 최소 요구사항

이미지

소매업 캠페인에서는 애셋 그룹 신호, 캠페인 전환 목표, 캠페인 기준 생성을 포함하여 표준 실적 최대화 캠페인에 사용할 수 있는 모든 옵션을 활용할 수 있습니다. AssetGroup 리소스를 만들 때 애셋을 AssetGroup에 추가하도록 선택하면 AssetGroup에 최소 애셋 요구사항이 적용됩니다. 즉, 애셋을 포함하지 않거나 모든 필수 애셋을 포함할 수 있습니다.

추가 옵션이 있는 소매업 실적 최대화 캠페인

이미지

잘못된 상태와 잘못된 요청 비교

Google Ads API에서 실적 최대화 캠페인을 사용할 때는 잘못된 상태와 잘못된 요청을 크게 구분합니다.

잘못된 상태
구성된 방식으로 인해 캠페인을 게재할 수 없습니다. 예를 들어 advertising_channel_typePERFORMANCE_MAX인 독립형 Campaign 리소스를 만들 수 있습니다. 캠페인 생성 요청이 성공하더라도 캠페인에 AssetGroup를 하나 이상 추가해야 캠페인이 게재될 수 있습니다. 요청에는 성공했지만 캠페인 또는 애셋 그룹에서 게재되지 않는 경우 문제 해결 가이드의 설명에 따라 CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus, AssetGroupPrimaryStatusReason를 사용하여 이유를 확인할 수 있습니다.
잘못된 요청
요청이 캠페인 또는 리소스를 잘못된 상태로 전환하므로 성공하지 못합니다. 예를 들어 필수 최소 애셋을 포함하지 않고 소매업이 아닌 캠페인에 AssetGroup를 만들려고 하면 Google Ads API에서 오류가 발생합니다. 따라서 동일한 요청에 AssetGroupAssetGroupAsset 리소스를 포함해야 합니다. 또한 전체 요청이 실패하지 않도록 모든 AssetGroupAsset 리소스가 해당 field_type의 올바른 사양을 충족해야 합니다.

변경 요청을 사용한 그룹화 작업

실적 최대화 캠페인은 여러 리소스로 구성되며, 고유한 요청이나 단일 일괄 변경 요청으로 별도의 리소스를 만들 수 있습니다. 그러나 표준 실적 최대화 캠페인의 AssetGroups 및 관련 AssetGroupAssets는 이미 언급한 것처럼 단일 원자 요청으로 만들어야 합니다.

이 가이드에서 설명하는 필수 리소스를 모두 만들어야 캠페인을 게재할 수 있습니다. 개별 요청을 실행할 때는 후속 요청에서 참조된 리소스의 실제 리소스 이름을 사용합니다. 여러 연산이 포함된 대량 변경 요청을 실행할 때는 임시 ID를 사용하여 구성된 리소스 이름을 사용합니다.

작업 순서

실적 최대화 캠페인을 만들 때 일괄 변경 요청을 사용하든 리소스를 생성하기 전에 참조하지 않도록 요청과 작업을 정렬해야 합니다. 일괄 변경 요청의 경우 참조된 리소스를 참조하는 리소스보다 먼저 나열하는 방식으로 연산을 정렬합니다.

AssetGroupAssetGroupAsset 리소스를 만드는 동일한 일괄 변경 요청에서 애셋 리소스를 생성하도록 선택한 경우 다이어그램에 표시된 것처럼 모든 AssetOperations가 모든 AssetGroupAssetOperations 앞에 와야 합니다.

이미지

Google Ads 서버는 연속된 AssetGroupAssetOperations를 일괄 처리하고 AssetGroup가 해당 그룹의 마지막 연산 후 최소 애셋 요구사항을 충족하는지 평가합니다. 요청에서 AssetOperationsAssetGroupAssetOperations를 번갈아 사용하면 API 서버는 첫 번째 AssetGroupAssetOperation 이후에 최소 애셋 요구사항을 평가하고 요청의 나머지 작업을 진행하지 않고 오류를 반환합니다. 따라서 요청에 포함된 애셋은 Google Ads 계정에 추가되지 않습니다. 또한 AssetGroup 및 연결된 AssetGroupAsset 리소스는 생성되지 않습니다.

애셋 그룹 업데이트

유효한 AssetGroup를 만든 후에는 최소 애셋 요구사항이 더 이상 충족되지 않는 잘못된 상태가 되는 후속 요청을 실행할 수 없습니다. 이러한 요청에서 오류가 발생합니다. 예를 들어 단일 MARKETING_IMAGE(최소 요구사항)로 AssetGroup를 만드는 경우 해당 MARKETING_IMAGE와 연결된 AssetGroupAsset를 삭제하도록 요청하면 오류가 반환됩니다.

이는 관련 애셋 없이 생성된 소매 캠페인의 애셋 그룹의 경우 특히 중요합니다. 이후 AssetGroupAsset 리소스를 만들어 AssetGroup에 애셋을 추가하는 요청은 모든 애셋 요구사항을 충족하는 경우에만 성공합니다. 즉, 이러한 애셋 그룹에 애셋을 점진적으로 추가할 수 없습니다.