실적 최대화 캠페인 보고와 마찬가지로 GoogleAdsService.SearchStream를 사용하여 캠페인 및 애셋 그룹 메타데이터를 가져와 일반적인 문제를 해결합니다.
캠페인 문제 해결
실적 최대화 캠페인의 실적이 예상보다 저조하다면 광고, 입찰, 타겟팅, 전환 추적 또는 캠페인 설정 문제 때문일 수 있습니다. 문제 해결 단계는 다음 가이드를 참고하세요.
브랜드 가이드라인이 사용 설정된 캠페인
브랜드 가이드라인을 사용하여 실적 최대화 캠페인에서 브랜드가 표시되는 방식을 관리합니다. Campaign.brand_guidelines_enabled를 사용하여 캠페인에 브랜드 가이드라인이 사용 설정되었는지 확인할 수 있습니다.
Campaign.brand_guidelines_enabled가 true로 설정된 실적 최대화 캠페인은 캠페인 수준 브랜드 애셋(BUSINESS_NAME, LOGO, LANDSCAPE_LOGO)을 사용하며,
BUSINESS_NAME애셋 정확히 1개LOGO애셋 1개 이상
필요한 경우 이러한 CampaignAsset 리소스를 연결하지 못하면 누락된 애셋 유형에 따라 CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED 또는 CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED 오류가 발생할 수 있습니다. 이러한 오류는 다음 작업 중 하나를 통해 브랜드 가이드라인이 사용 설정된 캠페인에서 트리거될 수 있습니다.
- 동일한 요청에서
BUSINESS_NAME및LOGO를 모두CampaignAsset리소스로 제공하지 않고 새Campaign를 만듭니다. - 하나 이상의
CampaignAsset리소스를 삭제하면 캠페인이 더 이상 최소 브랜드 애셋 요구사항을 충족하지 않게 됩니다. - 동일한 요청에 필요한 모든
CampaignAsset리소스를 제공하지 않고 이전에 확장 소재가 없는 실적 최대화 소매 캠페인에 필수 확장 소재 그룹 수준 맞춤 확장 소재를 연결합니다. (YOUTUBE_VIDEO와 같은 선택적 맞춤 확장 소재만 연결하는 경우에도 최소 확장 소재 그룹 요구사항과 필수CampaignAsset브랜드 링크가 모두 필요하므로 확장 소재 그룹이 Google Ads UI에서 수정을 차단하는 지원되지 않는 상태가 되지 않습니다.)
잘못된 수준에서 브랜드 애셋을 연결하려고 하면 오류가 발생하며, 다음과 같이 해결할 수 있습니다.
AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL- 캠페인에 브랜드 가이드라인이 사용 설정되어 있으므로
CampaignAsset리소스를 사용하여 브랜드 애셋을 연결합니다.
- 캠페인에 브랜드 가이드라인이 사용 설정되어 있으므로
AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL- 캠페인에 브랜드 가이드라인이 사용 설정되지 않았으므로
AssetGroupAsset리소스를 사용하여 브랜드 애셋을 연결합니다.
- 캠페인에 브랜드 가이드라인이 사용 설정되지 않았으므로
애셋 그룹 문제 해결
asset_group.primary_status 및 asset_group.primary_status_reasons 필드를 사용하여 애셋 그룹의 실적에 대한 통계를 제공합니다.
SELECT
asset_group.resource_name,
asset_group.primary_status,
asset_group.primary_status_reasons
FROM asset_group
WHERE asset_group.resource_name = "customers/CUSTOMER_ID/assetGroups/ASSET_GROUP_ID"
마찬가지로 asset_group_asset.primary_status, asset_group_asset.primary_status_details, asset_group_asset.primary_status_reasons 필드를 사용하여 애셋 그룹 애셋이 게재 중인지 여부 또는 게재되지 않는 이유를 표시합니다.
SELECT
asset_group_asset.resource_name,
asset_group_asset.primary_status,
asset_group_asset.primary_status_reasons,
asset_group_asset.primary_status_details
FROM asset_group_asset
WHERE asset_group_asset.resource_name = "customers/CUSTOMER/assetGroupAssets/ASSET_GROUP_ID~ASSET_ID~FIELD_TYPE"
일반적인 애셋 그룹 오류
AssetGroup를 만들거나 연결된 AssetGroupAsset 리소스를 업데이트하는 요청이 NOT_ENOUGH_*_ASSET
AssetGroupError (예: AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET)로 인해 실패하는 경우 AssetGroup가 최소 확장 소재 요구사항을 충족하지 않는 것입니다.
이 오류는 필수 애셋이 누락된 표준 AssetGroup를 만들거나, 모든 필수 애셋을 제공하지 않고 애셋이 없는 소매 AssetGroup에 필수 맞춤 애셋을 연결하거나, 단일 소매 요청에서 모든 맞춤 애셋을 연결 해제하지 않고 필수 애셋을 삭제할 때 발생합니다. (YOUTUBE_VIDEO와 같은 선택사항인 맞춤 애셋만 연결하는 경우에도 모든 최소 필수 애셋이 필요하므로 애셋 그룹이 Google Ads UI에서 수정을 차단하는 지원되지 않는 상태가 되지 않습니다.)
예를 들어 AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET 오류는 최소 개수의 MARKETING_IMAGE 확장 소재 (이 경우 1개) 없이 요청이 제출되었음을 나타냅니다. 이 오류를 해결하려면 애셋 그룹을 애셋에 연결에 설명된 대로 asset_group_operation(새 애셋 그룹을 만들 때) 및 모든 필수 asset_group_asset_operation 항목이 포함된 GoogleAdsService.Mutate 메서드를 사용하여 요청을 일괄 mutate 요청으로 제출하세요.
이 예시에서 일괄 mutate 요청의 변형 작업 목록에는 field_type가 MARKETING_IMAGE인 AssetGroupAsset가 하나 이상 포함되어야 합니다. AssetGroupAsset에서 참조하는 애셋은 MARKETING_IMAGE의 사양도 충족해야 합니다.
마찬가지로 AssetGroup을 만드는 요청이 AssetGroupError.SHORT_DESCRIPTION_REQUIRED로 인해 실패하면 AssetGroup에 60자(영문 기준) 이하의 TEXT 확장 소재와 DESCRIPTION의 field_type가 누락된 것입니다. 이 문제를 해결하는 단계는 NOT_ENOUGH_MARKETING_IMAGE_ASSET 예시에 표시된 단계와 동일합니다. 하지만 요청에는 field_type가 DESCRIPTION인 AssetGroupAsset가 하나 이상 포함되어야 하며 AssetGroupAsset에서 참조하는 애셋은 60자(영문 기준) 이하여야 합니다.
일반적인 오류 목록과 해결 방법은 일반적인 오류를 참조하세요.
문제 해결을 위한 애셋 소스 찾기
실적 최대화 캠페인은 광고주가 업로드하고 Google에서 자동으로 생성한 확장 소재가 포함된 광고를 게재한다는 점에서 독특합니다. 광고주는 확장 소재의 소스를 파악하여 문제를 해결하거나 실적을 평가할 수 있습니다. 이 경우 다음과 같이 asset_group_asset.source 필드를 사용할 수 있습니다.
SELECT
asset.id,
asset.name,
asset_group.id,
asset_group_asset.source
FROM asset_group_asset
WHERE campaign.id = CAMPAIGN_ID
신규 고객 확보 목표의 전환 가치
실적 최대화 캠페인 또는 검색 캠페인에서 신규 고객 획득을 설정한 경우 보고된 전환 가치가 수동으로 업로드한 전환 가치보다 높을 수 있습니다. 신규 고객 가치 모드 (입찰가 높이기)를 선택하면 모든 신규 고객 평생 가치가 전환 액션의 전환 가치에 추가됩니다. 모든 신규 고객 평생 가치는 Google Ads 웹 인터페이스를 통해서만 사용할 수 있습니다.
모든 신규 고객 평생 가치를 제외하고 전환 가치를 계산해야 하는 경우 다음 의사 코드를 참고하세요. 모든 신규 고객 평생 가치는 Google Ads 웹 인터페이스에서 다운로드할 수 있습니다.
nonNewCustomerAcquisitionConversionValueTotal = 0;
// For each campaign that has that conversion...
for (campaign in campaigns) {
// If the new customer acquisition value is 'Bid higher', then subtract.
if (bidHigher == true) {
nonNewCustomerAcquisitionConversionValueTotal +=
campaign.allConversionsValue - campaign.allNewCustomerLifetimeValue;
}
// If the new customer acquisition value is 'Only bid' or not set, then don't subtract.
else {
nonNewCustomerAcquisitionConversionValueTotal += campaign.allConversionsValue;
}
}