이 가이드에서는 실적 최대화 캠페인을 만들고 업데이트하는 요청을 구성하는 데 필요한 여러 복잡한 사항을 자세히 설명합니다. 통합을 설계할 때 유용한 리소스가 될 수 있습니다. 이 가이드에서는 실적 최대화 캠페인을 변경하는 요청이 처리되는 방식을 설명하며, 실적 최대화 캠페인 문제 해결 가이드 및 실적 최대화 캠페인 일괄 처리 가이드의 보조 리소스로 사용할 수 있습니다.
실적 최대화 캠페인 만들기
Google Ads API에서 실적 최대화 캠페인 항목은 여러 고유 리소스의 조합으로 표현됩니다.
일반 실적 최대화 캠페인
표준 실적 최대화 캠페인을 게재하려면 최소한의 리소스 집합이 필요합니다.
브랜드 가이드라인이 사용 설정된 캠페인의 경우 Campaign 및 필수 CampaignAsset 리소스를 만드는 작업이 단일 요청에 포함되어야 하며 CampaignAsset 리소스는 최소 애셋 요구사항 및 사양을 충족해야 합니다.
AssetGroup 및 AssetGroupAsset 항목을 만드는 작업은 단일 요청에 함께 포함되어야 하며, AssetGroupAsset 리소스는 모든 최소 애셋 요구사항 및 사양을 충족하도록 결합되어야 합니다. 소매 캠페인의 경우 이 작업이 어떻게 다른지 알아보세요.
필수 AssetGroupAsset 항목이 모두 포함되지 않은 AssetGroup를 만들라는 요청은 오류를 발생시킵니다. 자세한 내용은 잘못된 상태와 잘못된 요청을 참조하세요.
실적 최대화 캠페인을 만드는 요청을 구성하는 방법에는 여러 가지가 있습니다. 작업을 그룹화하고 요청을 구조화하는 방법은 주로 목표와 인프라에 따라 달라집니다.
AssetGroup및AssetGroupAsset리소스를 만들기 전에 별도의 요청으로CampaignBudget,Campaign,Asset,CampaignAsset리소스를 만듭니다. (브랜드 가이드라인이 사용 설정된 캠페인의 경우Campaign및 필수CampaignAsset리소스가 단일 요청에 함께 포함되어야 합니다.)- 이러한 모든 리소스를 단일 mutate 요청에 포함합니다.
이전 요청에서 CampaignBudget, Campaign, Asset, CampaignAsset 리소스를 성공적으로 만들 수 있지만 AssetGroup 및 AssetGroupAsset 리소스도 생성될 때까지 실적 최대화 캠페인을 게재할 수 없습니다.
유효한 게재 실적 최대화 캠페인의 최소 요구사항
다이어그램에 표시된 대로 추가 리소스를 만들어 실적 최대화 캠페인을 추가로 맞춤설정할 수 있습니다.
AssetGroup 및 AssetGroupAsset 리소스를 만드는 동일한 요청에 AssetGroupSignal 리소스를 만드는 작업을 포함할 수 있습니다.
또는 AssetGroup를 만든 후 별도의 요청으로 AssetGroupSignal 항목을 만들 수 있습니다.
추가 옵션이 있는 실적 최대화 캠페인
소매업용 실적 최대화 캠페인
소매 캠페인은 유효한 게재 캠페인을 생성하는 애셋 그룹을 만드는 두 가지 개별 방법이 있다는 점에서 독특합니다.
- 맞춤 애셋이 없는 애셋 그룹 (또는 HTML5
MEDIA_BUNDLE애셋만 있는 애셋 그룹) - 모든 필수 애셋이 포함된 애셋 그룹 (권장)
애셋 그룹에서 애셋을 제외하도록 선택하면 Google은 연결된 판매자 센터 계정에 제공된 애셋을 자동으로 사용하여 광고를 만듭니다. 하지만 모든 인벤토리에 도달할 수 있도록 애셋을 제공하는 것이 좋습니다. 실적 최대화 소매 캠페인을 게재하려면 다음과 같은 최소 리소스 집합이 필요합니다.
CampaignBudgetCampaign(ShoppingSetting채워짐)AssetGroupAssetGroupListingGroupFilter
리테일 캠페인에서는 Campaign.shopping_setting 필드를 입력해야 합니다. 또한 AssetGroup에 나열된 모든 final_urls는 Campaign.shopping_setting에 지정된 판매자 센터 계정 ID와 연결된 웹사이트 도메인과 일치해야 합니다. 마지막으로 각 AssetGroup에는 하나 이상의 AssetGroupListingGroupFilter 리소스로 구성된 유효한 제품 등록정보 그룹 트리가 연결되어 있어야 합니다. 최소한 지정된 판매자 센터 피드의 모든 제품을 고려하여 단일 노드 트리를 만들어야 합니다.
이러한 각 리소스는 개별적으로 또는 단일 요청으로 만들 수 있습니다. 하지만 이러한 모든 리소스가 올바르게 생성될 때까지는 캠페인에서 광고를 게재할 수 없습니다.
게재 가능한 실적 최대화 소매 캠페인의 최소 요구사항
실적 최대화 소매 캠페인은 애셋 그룹 신호, 캠페인 전환 목표, 캠페인 기준 만들기를 비롯하여 일반 실적 최대화 캠페인에 사용할 수 있는 모든 옵션을 사용할 수 있습니다. AssetGroup 리소스를 만들 때 AssetGroup에 맞춤 애셋 (HTML5 MEDIA_BUNDLE 애셋 이외)을 추가하는 경우 요청이 모든 최소 애셋 요구사항 (브랜드 가이드라인이 사용 설정된 경우 캠페인 수준 브랜드 애셋 포함)을 충족해야 합니다. 즉, 맞춤 애셋을 포함하지 않거나 필요한 모든 애셋을 포함해야 합니다.
추가 옵션이 있는 소매업체 실적 최대화 캠페인
잘못된 상태와 잘못된 요청
Google Ads API에서 실적 최대화 캠페인을 사용할 때는 잘못된 상태와 잘못된 요청을 구분하는 것이 중요합니다.
- 잘못된 상태
- 캠페인 구성 방식으로 인해 캠페인을 게재할 수 없습니다. 예를 들어
PERFORMANCE_MAX의advertising_channel_type를 사용하여 독립형Campaign리소스를 만들 수 있습니다. 캠페인 생성 요청이 성공하더라도 캠페인에AssetGroup를 하나 이상 추가할 때까지는 광고를 게재할 수 없습니다. 요청이 성공했지만 캠페인 또는 애셋 그룹이 게재되지 않는 경우CampaignPrimaryStatus,CampaignPrimaryStatusReason,AssetGroupPrimaryStatus,AssetGroupPrimaryStatusReason를 사용하여 이유를 확인할 수 있습니다. 자세한 내용은 문제 해결 가이드를 참고하세요. - 잘못된 요청
- 캠페인 또는 리소스가 잘못된 상태가 되므로 성공하지 못하는 요청입니다. 예를 들어 최소 필수 애셋을 포함하지 않고 소매 외 캠페인 (지역 서비스 실적 최대화 캠페인 제외)에 대해
AssetGroup를 만들려고 하면 Google Ads API에서 오류가 발생합니다. 따라서 동일한 요청에AssetGroup및AssetGroupAsset리소스를 포함해야 합니다. 즉, 전체 요청이 실패하지 않도록 모든AssetGroupAsset리소스가 지정된field_type의 올바른 사양을 충족해야 합니다.
mutate 요청으로 작업 그룹화
실적 최대화 캠페인은 여러 리소스로 구성되며, 이러한 개별 리소스를 고유한 요청 또는 단일 일괄 변형 요청으로 만들 수 있습니다. 하지만 이미 언급한 바와 같이 일반 실적 최대화 캠페인의 AssetGroups 및 관련 AssetGroupAssets는 단일 원자적 요청으로 만들어야 합니다.
이 가이드에 언급된 모든 필수 리소스를 만들 때까지 캠페인을 게재할 수 없습니다. 별도의 요청을 실행할 때는 후속 요청에서 참조된 리소스의 실제 리소스 이름을 사용합니다. 여러 작업이 포함된 일괄 mutate 요청을 실행할 때는 임시 ID를 사용하여 형성된 리소스 이름을 사용합니다.
작업 순서
일괄 변형 요청을 사용하여 실적 최대화 캠페인을 만드는지 여부와 관계없이 리소스가 생성되기 전에 리소스를 참조하지 않도록 요청 및 작업을 정렬해야 합니다. 일괄 변형 요청의 경우 참조된 리소스가 참조하는 리소스보다 먼저 나열되도록 작업을 정렬해야 합니다.
AssetGroup 및 AssetGroupAsset 리소스를 만드는 동일한 일괄 변형 요청에서 확장 소재 리소스를 만들도록 선택하는 경우 다이어그램에 표시된 것처럼 모든 AssetOperations가 모든 AssetGroupAssetOperations 앞에 와야 합니다.
Google Ads 광고 서버는 연속된 AssetGroupAssetOperations를 함께 일괄 처리하고 해당 그룹의 마지막 작업 후 AssetGroup가 최소 확장 소재 요구사항을 충족하는지 평가합니다. 요청에서 AssetOperations와 AssetGroupAssetOperations를 번갈아 사용하는 경우 API 서버는 첫 번째 AssetGroupAssetOperation 이후에 최소 애셋 요구사항을 평가하고 요청의 나머지 작업을 진행하지 않고 오류를 반환합니다. 따라서 요청의 확장 소재가 Google Ads 계정에 추가되지 않습니다. 또한 AssetGroup 및 연결된 AssetGroupAsset 리소스가 생성되지 않습니다.
애셋 그룹 업데이트
유효한 AssetGroup를 만든 후에는 애셋 그룹을 최소 애셋 요구사항 미만으로 유지하는 후속 요청을 실행할 수 없습니다. 이러한 요청은 오류를 발생시킵니다. 예를 들어 단일 MARKETING_IMAGE (최소 요구사항)로 AssetGroup를 만드는 경우 해당 MARKETING_IMAGE
AssetGroupAsset만 삭제하는 요청은 오류를 반환합니다. 하지만 실적 최대화 리테일 캠페인에서는 단일 요청으로 모든 맞춤 AssetGroupAsset 링크를 삭제하여 Google 판매자 센터 자동 생성 확장 소재를 사용하는 AssetGroup로 돌아갈 수 있습니다.
연결된 맞춤 애셋 없이 생성된 실적 최대화 리테일 캠페인의 애셋 그룹의 경우, 맞춤 애셋 (HTML5 MEDIA_BUNDLE 애셋 제외)을 연결하는 후속 요청은 AssetGroup에 하나 이상의 final_urls가 설정되어 있는지 확인해야 하며 (원래 생략된 경우 먼저 채움), 단일 원자적 요청에 모든 최소 필수 애셋 (브랜드 가이드라인이 사용 설정된 경우 캠페인 수준 브랜드 애셋 포함)을 제공해야 합니다. YOUTUBE_VIDEO와 같은 선택적 광고 확장 소재를 단독으로 연결하거나 별도의 요청에 걸쳐 광고 확장 소재를 점진적으로 추가하지 마세요. 선택사항인 맞춤 애셋만 연결하면 애셋 그룹이 지원되지 않는 상태로 남아 Google Ads UI에서 수정할 수 없습니다. 자세한 내용은 실적 최대화 리테일 캠페인에서 애셋 그룹을 애셋에 연결을 참고하세요.