Recommendation

권장사항입니다.

JSON 표현 
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  },
  "forecastingSetTargetCpaRecommendation": {
    object (ForecastingSetTargetCpaRecommendation)
  },
  "setTargetCpaRecommendation": {
    object (ForecastingSetTargetCpaRecommendation)
  },
  "setTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "maximizeConversionValueOptInRecommendation": {
    object (MaximizeConversionValueOptInRecommendation)
  },
  "improveGoogleTagCoverageRecommendation": {
    object (ImproveGoogleTagCoverageRecommendation)
  },
  "performanceMaxFinalUrlOptInRecommendation": {
    object (PerformanceMaxFinalUrlOptInRecommendation)
  },
  "refreshCustomerMatchListRecommendation": {
    object (RefreshCustomerMatchListRecommendation)
  },
  "customAudienceOptInRecommendation": {
    object (CustomAudienceOptInRecommendation)
  },
  "leadFormAssetRecommendation": {
    object (LeadFormAssetRecommendation)
  },
  "improveDemandGenAdStrengthRecommendation": {
    object (ImproveDemandGenAdStrengthRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
입력란
resourceName

string

변경할 수 없습니다. 추천의 리소스 이름입니다.

customers/{customerId}/recommendations/{recommendation_id}
type

enum (RecommendationType)

출력 전용. 추천 유형입니다.
impact

object (RecommendationImpact)

출력 전용. 추천 적용이 계정 실적에 미친 영향
campaigns[]

string

출력 전용. 이 추천의 타겟팅 캠페인입니다.

이 필드는 CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET 추천 유형에 대해 설정됩니다.
campaignBudget

string

출력 전용. 이 추천에서 타겟팅하는 예산입니다. 추천이 단일 캠페인 예산에 영향을 미치는 경우에만 설정됩니다.

이 필드는 CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET 추천 유형에 대해 설정됩니다.
campaign

string

출력 전용. 이 추천의 타겟팅 캠페인입니다.

이 필드는 다음 추천 유형에 대해 설정됩니다. CALL_확장
adGroup

string

출력 전용. 이 추천으로 타겟팅하는 광고그룹입니다. 이 추천은 단일 광고 그룹에 영향을 미치는 경우에만 설정됩니다.

이 필드는 KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD 추천 유형에 대해 설정됩니다.
dismissed

boolean

출력 전용. 추천을 닫았는지 여부입니다.
통합 필드 recommendation. 추천 세부정보입니다. recommendation은 다음 중 하나여야 합니다.
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

출력 전용. 캠페인 예산 추천입니다.
forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

출력 전용. 예측 캠페인 예산 추천
keywordRecommendation

object (KeywordRecommendation)

출력 전용. 추천 키워드입니다.
textAdRecommendation

object (TextAdRecommendation)

출력 전용. 확장 텍스트 광고 추천을 추가하세요.
targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

출력 전용. 타겟 CPA 선택 추천
maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

출력 전용. 전환수 최대화 사용 설정 추천
enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

출력 전용. 향상된 클릭당비용 선택 추천
searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

출력 전용. 검색 파트너 선택 추천입니다.
maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

출력 전용. MaxClicks 선택 추천
optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

출력 전용. 광고 로테이션 최적화 추천
keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

출력 전용. 키워드 검색 유형 추천입니다.
moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

출력 전용. 사용하지 않는 이동 예산 추천입니다.
targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

출력 전용. 타겟 광고 투자수익(ROAS) 선택 추천
responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

출력 전용. 반응형 검색 광고 추가 추천
marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

출력 전용. 한계 ROI 캠페인 예산 추천입니다.
useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

출력 전용. 확장검색 키워드 추천 사용
responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

출력 전용. 반응형 검색 광고 확장 소재 추천입니다.
upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

출력 전용. 스마트 쇼핑 캠페인을 실적 최대화 캠페인 추천으로 업그레이드
responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

출력 전용. 반응형 검색 광고는 광고 효력 추천을 개선합니다.
displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

출력 전용. 디스플레이 네트워크 추가 사용 설정 추천
upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

출력 전용. 지역 캠페인을 실적 최대화 캠페인 추천으로 업그레이드합니다.
raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

출력 전용. 타겟 CPA 입찰가 증액 추천이 너무 낮습니다.
forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

출력 전용. 예측 시 타겟 광고 투자수익(ROAS) 추천 설정
calloutAssetRecommendation

object (CalloutAssetRecommendation)

출력 전용. 콜아웃 확장 소재 추천입니다.
callAssetRecommendation

object (CallAssetRecommendation)

출력 전용. 추천 전화번호 확장 소재입니다.
shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용. 쇼핑 추가 연령대 추천
shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용. 쇼핑 광고 추가 색상 권장사항
shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용. 쇼핑 추가 성별 추천
shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용. 쇼핑 추가 GTIN 추천
shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용. 쇼핑 시 식별자 추가 권장사항
shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

출력 전용. 쇼핑 광고 크기 권장사항
shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

출력 전용. 쇼핑 캠페인이 캠페인 추천에 제품을 추가합니다.
shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

출력 전용. 쇼핑 수정 비승인 제품 추천입니다.
shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

출력 전용. 쇼핑 타겟은 모든 추천을 제공합니다.
shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

출력 전용. 쇼핑 수정으로 인해 판매자 센터 계정 추천이 정지되었습니다.
shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

출력 전용. 쇼핑 수정사항 판매자 센터 계정 정지 경고 추천입니다.
shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

출력 전용. 쇼핑 캠페인이 일반 쇼핑 캠페인 혜택을 실적 최대화 캠페인 추천으로 이전했습니다.
dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

출력 전용. Google이 광고 방문 페이지에서 최적의 이미지를 찾아 텍스트 광고를 보완할 수 있도록 계정에 동적 이미지 광고 확장을 사용 설정하라는 추천입니다.
raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

출력 전용. 타겟 CPA를 높이라는 추천입니다.
lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

출력 전용. 타겟 광고 투자수익(ROAS)을 낮추라는 추천입니다.
performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

출력 전용. 실적 최대화 캠페인 선택 추천
improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

출력 전용. 실적 최대화 캠페인의 광고 효력 개선 추천
migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

출력 전용. 동적 검색 광고에서 실적 최대화 캠페인으로의 이전 추천
forecastingSetTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

출력 전용. 예측 시 타겟 CPA 추천 설정
setTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

출력 전용. 설정된 타겟 CPA 추천입니다.
setTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

출력 전용. 설정된 타겟 광고 투자수익(ROAS) 추천입니다.
maximizeConversionValueOptInRecommendation

object (MaximizeConversionValueOptInRecommendation)

출력 전용. 전환 가치 극대화 사용 설정 추천
improveGoogleTagCoverageRecommendation

object (ImproveGoogleTagCoverageRecommendation)

출력 전용. 더 많은 페이지에 Google 태그를 배포하는 것이 좋습니다.
performanceMaxFinalUrlOptInRecommendation

object (PerformanceMaxFinalUrlOptInRecommendation)

출력 전용. 실적 최대화 캠페인에 최종 URL 확장을 사용 설정하라는 추천입니다.
refreshCustomerMatchListRecommendation

object (RefreshCustomerMatchListRecommendation)

출력 전용. 고객 목록 새로고침 권장사항
customAudienceOptInRecommendation

object (CustomAudienceOptInRecommendation)

출력 전용. 맞춤 잠재고객 선택 추천입니다.
leadFormAssetRecommendation

object (LeadFormAssetRecommendation)

출력 전용. 리드 양식 확장 소재 추천
improveDemandGenAdStrengthRecommendation

object (ImproveDemandGenAdStrengthRecommendation)

출력 전용. 디맨드젠 광고 효력 개선을 위한 추천입니다.

RecommendationImpact

권장사항에 설명된 변경의 영향입니다. 일부 추천 유형은 영향 정보가 없을 수도 있습니다.

JSON 표현 
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
입력란
baseMetrics

object (RecommendationMetrics)

출력 전용. 추천이 생성된 시점의 기본 측정항목입니다.
potentialMetrics

object (RecommendationMetrics)

출력 전용. 추천을 적용한 경우의 예상 측정항목입니다.

RecommendationMetrics

주별 계정 실적 측정항목 일부 추천 유형의 경우 지난 90일 동안의 평균이 계산되므로 결과가 소수일 수 있습니다.

JSON 표현 
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionsValue": number,
  "videoViews": number
}
입력란
impressions

number

출력 전용. 광고 노출수입니다.
clicks

number

출력 전용. 광고 클릭수입니다.
costMicros

string (int64 format)

출력 전용. 계정의 현지 통화로 표시되는 광고 비용 (마이크로 단위)입니다.
conversions

number

출력 전용. 전환수입니다.
conversionsValue

number

출력 전용. 전환의 전환 가치 합계입니다.
videoViews

number

출력 전용. 동영상 광고 캠페인의 동영상 조회수입니다.

CampaignBudgetRecommendation

예산이 제한된 캠페인에 대한 예산 추천입니다.

JSON 표현 
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
입력란
budgetOptions[]

object (CampaignBudgetRecommendationOption)

출력 전용. 가능한 예산 금액의 일부 값에 대한 예산 금액 및 관련 예상 효과입니다.
currentBudgetAmountMicros

string (int64 format)

출력 전용. 마이크로 단위의 현재 예산 금액입니다.
recommendedBudgetAmountMicros

string (int64 format)

출력 전용. 마이크로 단위의 권장 예산 금액입니다.

CampaignBudgetRecommendationOption

주어진 예산 금액에 대한 예상 효과입니다.

JSON 표현 
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
입력란
impact

object (RecommendationImpact)

출력 전용. 예산을 이 옵션에 지정된 금액으로 변경할 경우 예상되는 영향입니다.
budgetAmountMicros

string (int64 format)

출력 전용. 이 옵션에 대한 예산 금액입니다.

KeywordRecommendation

추천 키워드입니다.

JSON 표현 
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
입력란
keyword

object (KeywordInfo)

출력 전용. 추천 키워드입니다.
searchTerms[]

object (SearchTerm)

출력 전용. 이 키워드와 일치하는 검색어의 목록입니다. 여러 키워드에 대해 동일한 검색어가 반복될 수 있습니다.
recommendedCpcBidMicros

string (int64 format)

출력 전용. 권장 CPC (클릭당비용) 입찰가입니다.

SearchTerm

키워드 추천과 관련된 검색어에 대한 정보입니다.

JSON 표현 
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
입력란
text

string

출력 전용. 검색어의 텍스트입니다.
estimatedWeeklySearchCount

string (int64 format)

출력 전용. 이 검색어에 대한 주간 예상 이전 검색량입니다.

TextAdRecommendation

텍스트 광고 추천입니다.

JSON 표현 
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
입력란
ad

object (Ad)

출력 전용. 추천 광고입니다.
creationDate

string

출력 전용. 추천 광고의 생성 날짜입니다. YYYY-MM-DD 형식(예: 2018-04-17)입니다.
autoApplyDate

string

출력 전용. 날짜는 추천이 자동 적용되는 가장 빠른 날짜입니다(있는 경우). YYYY-MM-DD 형식(예: 2018-04-17)입니다.

TargetCpaOptInRecommendation

타겟 CPA 선택 추천

JSON 표현 
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
입력란
options[]

object (TargetCpaOptInRecommendationOption)

출력 전용. 타겟 CPA 전략에 사용 가능한 목표 및 해당 옵션
recommendedTargetCpaMicros

string (int64 format)

출력 전용. 권장되는 평균 CPA 타겟입니다. 필요한 예산 금액과 이 추천을 사용할 때의 영향은 옵션 목록에서 확인하세요.

TargetCpaOptInRecommendationOption

예상 효과가 표시된 타겟 CPA 선택 옵션

JSON 표현 
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
입력란
goal

enum (TargetCpaOptInRecommendationGoal)

출력 전용. 이 옵션으로 달성한 목표입니다.
impact

object (RecommendationImpact)

출력 전용. 이 옵션을 선택한 경우의 영향 추정치입니다.
targetCpaMicros

string (int64 format)

출력 전용. 평균 CPA 타겟입니다.
requiredCampaignBudgetAmountMicros

string (int64 format)

출력 전용. 타겟 CPA를 달성하는 데 필요한 최소 캠페인 예산(현지 통화 기준)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다.

TargetCpaOptInRecommendationGoal

TargetCpaOptIn 추천의 목표

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SAME_COST 동일한 비용을 유지하기 위해 타겟 CPA를 설정하는 것이 좋습니다.
SAME_CONVERSIONS 전환수를 동일하게 유지하기 위해 타겟 CPA를 설정하라는 추천입니다.
SAME_CPA CPA를 동일하게 유지하도록 타겟 CPA를 설정하라는 추천사항입니다.
CLOSEST_CPA 타겟 CPA를 실제 CPA (지난 28일 동안 계산됨)에 최대한 가깝지만 이보다 낮은 값으로 설정하라는 권장사항입니다.

MaximizeConversionsOptInRecommendation

전환수 최대화 사용 설정 추천

JSON 표현 
{
  "recommendedBudgetAmountMicros": string
}
입력란
recommendedBudgetAmountMicros

string (int64 format)

출력 전용. 권장 새 예산 금액입니다.

EnhancedCpcOptInRecommendation

이 유형에는 필드가 없습니다.

향상된 클릭당비용 선택 추천

SearchPartnersOptInRecommendation

이 유형에는 필드가 없습니다.

검색 파트너 선택 추천입니다.

MaximizeClicksOptInRecommendation

클릭수 최대화 사용 설정 추천

JSON 표현 
{
  "recommendedBudgetAmountMicros": string
}
입력란
recommendedBudgetAmountMicros

string (int64 format)

출력 전용. 권장 새 예산 금액입니다. 현재 예산이 너무 높은 경우에만 설정합니다.

OptimizeAdRotationRecommendation

이 유형에는 필드가 없습니다.

광고 로테이션 최적화 추천

KeywordMatchTypeRecommendation

키워드 검색 유형 추천입니다.

JSON 표현 
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
입력란
keyword

object (KeywordInfo)

출력 전용. 검색 유형이 더 광범위해야 하는 기존 키워드입니다.
recommendedMatchType

enum (KeywordMatchType)

출력 전용. 권장되는 새 검색 유형입니다.

MoveUnusedBudgetRecommendation

사용하지 않는 이동 예산 추천입니다.

JSON 표현 
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
입력란
budgetRecommendation

object (CampaignBudgetRecommendation)

출력 전용. 제한된 예산을 증액하기 위한 추천입니다.
excessCampaignBudget

string

출력 전용. 초과 예산의 resourceName입니다.

TargetRoasOptInRecommendation

타겟 광고 투자수익(ROAS) 선택 추천

JSON 표현 
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
입력란
recommendedTargetRoas

number

출력 전용. 권장 타겟 ROAS (지출 단위당 수익)입니다. 값은 0.01 이상 1000.0 이하입니다.
requiredCampaignBudgetAmountMicros

string (int64 format)

출력 전용. 타겟 광고 투자수익(ROAS)을 달성하는 데 필요한 계정의 현지 통화로 표시되는 최소 캠페인 예산입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다.

ResponsiveSearchAdRecommendation

반응형 검색 광고 추가 추천

JSON 표현 
{
  "ad": {
    object (Ad)
  }
}
입력란
ad

object (Ad)

출력 전용. 추천 광고입니다.

UseBroadMatchKeywordRecommendation

확장검색 키워드 추천 사용

JSON 표현 
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
입력란
keyword[]

object (KeywordInfo)

출력 전용. 확장검색으로 확장할 키워드 샘플입니다.
suggestedKeywordsCount

string (int64 format)

출력 전용. 캠페인에서 확장검색으로 확장할 총 키워드 수입니다.
campaignKeywordsCount

string (int64 format)

출력 전용. 캠페인에 있는 총 키워드 수입니다.
campaignUsesSharedBudget

boolean

출력 전용. 연결된 캠페인이 공유 예산을 사용하는지 여부입니다.
requiredCampaignBudgetAmountMicros

string (int64 format)

출력 전용. 추천을 적용한 후 예산 제약 상태가 되지 않도록 권장 예산입니다.

ResponsiveSearchAdAssetRecommendation

반응형 검색 광고 확장 소재 추가 추천

JSON 표현 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
입력란
currentAd

object (Ad)

출력 전용. 업데이트할 현재 광고입니다.
recommendedAssets

object (Ad)

출력 전용. 추천 애셋입니다. 이 입력란은 새 광고 제목 및 설명으로만 채워지며 그 외의 경우에는 비어 있습니다.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

스마트 쇼핑 캠페인을 실적 최대화 캠페인 추천으로 업그레이드

JSON 표현 
{
  "merchantId": string,
  "salesCountryCode": string
}
입력란
merchantId

string (int64 format)

출력 전용. 판매자 센터 계정의 ID입니다.
salesCountryCode

string

출력 전용. 판매자 인벤토리의 제품을 포함해야 하는 국가입니다.

ResponsiveSearchAdImproveAdStrengthRecommendation

반응형 검색 광고는 광고 효력 추천을 개선합니다.

JSON 표현 
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
입력란
currentAd

object (Ad)

출력 전용. 업데이트할 현재 광고입니다.
recommendedAd

object (Ad)

출력 전용. 업데이트된 광고

DisplayExpansionOptInRecommendation

이 유형에는 필드가 없습니다.

디스플레이 네트워크 추가 사용 설정 추천

UpgradeLocalCampaignToPerformanceMaxRecommendation

이 유형에는 필드가 없습니다.

지역 캠페인을 실적 최대화 캠페인으로 업그레이드 추천

RaiseTargetCpaBidTooLowRecommendation

타겟 CPA 입찰가 증액 추천이 너무 낮습니다.

JSON 표현 
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
입력란
recommendedTargetMultiplier

number

출력 전용. 1.0보다 큰 숫자는 타겟 CPA의 증액 권장 수준을 나타냅니다.
averageTargetCpaMicros

string (int64 format)

출력 전용. 캠페인의 현재 평균 타겟 CPA로, 고객 현지 통화의 마이크로(micro)입니다.

ForecastingSetTargetRoasRecommendation

예측 시 타겟 광고 투자수익(ROAS) 추천 설정

JSON 표현 
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
입력란
recommendedTargetRoas

number

출력 전용. 권장 타겟 ROAS (지출 단위당 수익)입니다. 값은 0.01 이상 1000.0 이하입니다.
campaignBudget

object (CampaignBudget)

출력 전용. 캠페인 예산입니다.

CampaignBudget

다양한 예산 추천 유형에서 캠페인 예산이 공유됨

JSON 표현 
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
입력란
currentAmountMicros

string (int64 format)

출력 전용. 현재 예산 금액입니다.
recommendedNewAmountMicros

string (int64 format)

출력 전용. 권장 예산 금액입니다.
newStartDate

string

출력 전용. 새 예산이 사용되기 시작하는 날짜입니다. 이 입력란은 다음 추천 유형에 대해 설정됩니다. FORECASTING_SET_TARGET_ROAS , FORECASTING_SET_TARGET_CPA YYYY-MM-DD 형식(예: 2018-04-17)

CalloutAssetRecommendation

콜아웃 확장 소재 추천입니다.

JSON 표현 
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
입력란
recommendedCampaignCalloutAssets[]

object (Asset)

출력 전용. 캠페인 수준에서 새 콜아웃 광고 확장 확장 소재가 추천되었습니다.
recommendedCustomerCalloutAssets[]

object (Asset)

출력 전용. 고객 수준에서 권장되는 새 콜아웃 광고 확장 확장 소재입니다.

SitelinkAssetRecommendation

사이트링크 확장 소재 추천입니다.

JSON 표현 
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
입력란

CallAssetRecommendation

이 유형에는 필드가 없습니다.

추천 전화번호 확장 소재입니다.

ShoppingOfferAttributeRecommendation

속성이 누락되어 순위가 낮아진 제품에 속성을 추가하라는 쇼핑 추천입니다.

JSON 표현 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
입력란
merchant

object (MerchantInfo)

출력 전용. 판매자 센터 계정의 세부정보입니다.
feedLabel

string

출력 전용. 캠페인 피드 라벨입니다.
offersCount

string (int64 format)

출력 전용. 게재 가능한 온라인 상품 수입니다.
demotedOffersCount

string (int64 format)

출력 전용. 누락된 속성으로 인해 순위가 낮아지고 게재 가능한 온라인 상품의 수입니다. 자세한 내용은 판매자 센터를 방문하세요.

MerchantInfo

판매자 센터 계정 세부정보입니다.

JSON 표현 
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
입력란
id

string (int64 format)

출력 전용. 판매자 센터 계정 ID입니다.
name

string

출력 전용. 판매자 센터 계정의 이름입니다.
multiClient

boolean

출력 전용. 판매자 센터 계정이 멀티 클라이언트 계정 (MCA)인지 여부

ShoppingAddProductsToCampaignRecommendation

쇼핑 캠페인 인벤토리에 제품을 추가하기 위한 쇼핑 추천입니다.

JSON 표현 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
입력란
merchant

object (MerchantInfo)

출력 전용. 판매자 센터 계정의 세부정보입니다.
feedLabel

string

출력 전용. 캠페인의 피드 라벨입니다.
reason

enum (Reason)

출력 전용. 캠페인에 연결된 제품이 없는 이유입니다.

이유

쇼핑 캠페인에서 제품 0개를 타겟팅하게 하는 문제

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS 판매자 센터 계정에 제출된 제품이 없습니다.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED 판매자 센터 계정의 피드에 제출된 제품이 없습니다.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN Google Ads 계정에 제품이 포함되지 않도록 하는 활성 캠페인 필터가 있습니다.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN 사용 가능한 모든 제품이 캠페인의 타겟팅 대상에서 명시적으로 제외되었습니다.

ShoppingFixDisapprovedProductsRecommendation

쇼핑 캠페인 인벤토리에서 비승인된 제품을 수정하기 위한 쇼핑 추천입니다.

JSON 표현 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
입력란
merchant

object (MerchantInfo)

출력 전용. 판매자 센터 계정의 세부정보입니다.
feedLabel

string

출력 전용. 캠페인의 피드 라벨입니다.
productsCount

string (int64 format)

출력 전용. 캠페인의 제품 수입니다.
disapprovedProductsCount

string (int64 format)

출력 전용. 비승인된 캠페인의 제품 수입니다.

ShoppingTargetAllOffersRecommendation

모든 혜택을 타겟팅하는 포괄적 캠페인을 만들기 위한 쇼핑 추천

JSON 표현 
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
입력란
merchant

object (MerchantInfo)

출력 전용. 판매자 센터 계정의 세부정보입니다.
untargetedOffersCount

string (int64 format)

출력 전용. 타겟팅되지 않은 제품의 수입니다.
feedLabel

string

출력 전용. 쿠폰 피드 라벨입니다.

ShoppingMerchantCenterAccountSuspensionRecommendation

판매자 센터 계정 정지 문제를 해결하기 위한 쇼핑 추천입니다.

JSON 표현 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
입력란
merchant

object (MerchantInfo)

출력 전용. 판매자 센터 계정의 세부정보입니다.
feedLabel

string

출력 전용. 정지된 캠페인의 피드 라벨입니다.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

일반 쇼핑 캠페인 타겟팅 혜택을 실적 최대화 캠페인으로 이전하라는 쇼핑 추천입니다.

JSON 표현 
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
입력란
merchant

object (MerchantInfo)

출력 전용. 판매자 센터 계정의 세부정보입니다.
feedLabel

string

출력 전용. 이 추천을 공유하는 캠페인에서 타겟팅하는 상품의 피드 라벨입니다.

DynamicImageExtensionOptInRecommendation

이 유형에는 필드가 없습니다.

Google이 광고 방문 페이지에서 최적의 이미지를 찾아 텍스트 광고를 보완할 수 있도록 계정에 동적 이미지 광고 확장을 사용 설정하라는 추천입니다.

RaiseTargetCpaRecommendation

타겟 CPA를 높이라는 추천입니다.

JSON 표현 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
입력란
targetAdjustment

object (TargetAdjustmentInfo)

출력 전용. 권장 타겟 조정을 설명하는 관련 정보입니다.
appBiddingGoal

enum (AppBiddingGoal)

출력 전용. 입찰 전략에서 최적화해야 하는 목표를 나타냅니다. 앱 캠페인에만 채워집니다.

TargetAdjustmentInfo

타겟 조정 추천에 대한 정보입니다.

JSON 표현 
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
입력란
recommendedTargetMultiplier

number

출력 전용. 타겟의 조정을 권장한 값입니다.
currentAverageTargetMicros

string (int64 format)

출력 전용. 이 추천으로 타겟팅된 캠페인 또는 포트폴리오의 현재 평균 타겟입니다.
sharedSet

string

출력 전용. 타겟이 정의된 포트폴리오 입찰 전략의 공유 조합 리소스 이름입니다. 추천이 포트폴리오 수준인 경우에만 채워집니다.

AppBiddingGoal

앱 캠페인의 입찰 전략에서 최적화해야 하는 목표를 나타냅니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전의 API에서 알 수 없는 값을 나타냅니다.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME 앱 캠페인의 입찰 전략은 앱 설치수를 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME 앱 캠페인의 입찰 전략은 선택한 인앱 전환수 최대화를 목표로 해야 합니다.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE 앱 캠페인의 입찰 전략은 모든 전환 가치, 즉 설치 및 선택된 인앱 전환의 가치를 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION 앱 캠페인의 입찰 전략은 타겟 인앱 전환당비용을 달성하거나 초과 달성하면서 선택한 인앱 전환수만 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND 앱 캠페인의 입찰 전략은 타겟 광고 투자수익(ROAS)을 달성하거나 초과 달성하면서 모든 전환 가치, 즉 설치 및 선택된 인앱 전환을 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI 이 앱 캠페인 입찰 전략은 광고주가 제공한 타겟 설치당비용(CPI) 없이 앱 설치를 극대화하는 것을 목표로 해야 합니다.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME 앱 캠페인에서 이 입찰 전략은 앱의 사전 등록을 극대화하는 것을 목표로 해야 합니다.

LowerTargetRoasRecommendation

타겟 광고 투자수익(ROAS)을 낮추라는 추천입니다.

JSON 표현 
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
입력란
targetAdjustment

object (TargetAdjustmentInfo)

출력 전용. 권장 타겟 조정을 설명하는 관련 정보입니다.

PerformanceMaxOptInRecommendation

이 유형에는 필드가 없습니다.

실적 최대화 캠페인 선택 추천

ImprovePerformanceMaxAdStrengthRecommendation

실적 최대화 캠페인의 애셋 그룹 효력을 '매우 좋음' 등급으로 개선하라는 추천입니다.

JSON 표현 
{
  "assetGroup": string
}
입력란
assetGroup

string

출력 전용. 애셋 그룹 리소스 이름입니다.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

동적 검색 광고에서 실적 최대화 캠페인으로의 이전 추천

JSON 표현 
{
  "applyLink": string
}
입력란

ForecastingSetTargetCpaRecommendation

설정된 타겟 CPA 추천

JSON 표현 
{
  "recommendedTargetCpaMicros": string,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
입력란
recommendedTargetCpaMicros

string (int64 format)

출력 전용. 추천 타겟 CPA
campaignBudget

object (CampaignBudget)

출력 전용. 캠페인 예산입니다.

MaximizeConversionValueOptInRecommendation

이 유형에는 필드가 없습니다.

전환 가치 극대화 입찰 전략을 사용하라는 추천입니다.

ImproveGoogleTagCoverageRecommendation

이 유형에는 필드가 없습니다.

더 많은 페이지에 Google 태그를 배포하는 것이 좋습니다.

PerformanceMaxFinalUrlOptInRecommendation

이 유형에는 필드가 없습니다.

실적 최대화 캠페인에 최종 URL 확장을 사용 설정하라는 추천입니다.

RefreshCustomerMatchListRecommendation

지난 90일 동안 업데이트되지 않은 고객 목록을 업데이트하라는 추천입니다. 추천을 받는 고객이 소유자 계정일 필요는 없습니다. 소유자 계정으로 고객 목록을 업데이트해야 합니다.

JSON 표현 
{
  "userListId": string,
  "userListName": string,
  "daysSinceLastRefresh": string,
  "topSpendingAccount": [
    {
      object (AccountInfo)
    }
  ],
  "targetingAccountsCount": string,
  "ownerAccount": {
    object (AccountInfo)
  }
}
입력란
userListId

string (int64 format)

출력 전용. 사용자 목록 ID입니다.
userListName

string

출력 전용. 목록의 이름입니다.
daysSinceLastRefresh

string (int64 format)

출력 전용. 마지막 새로고침 후 경과 일수입니다.
topSpendingAccount[]

object (AccountInfo)

출력 전용. 지출이 가장 많은 계정
targetingAccountsCount

string (int64 format)

출력 전용. 소유자는 사용자 목록을 다른 계정과 공유할 수 있습니다. targetingAccountsCount는 타겟팅에 사용할 수 있는 계정 수입니다.
ownerAccount

object (AccountInfo)

출력 전용. 소유자 계정 이 계정에서 고객 목록을 업데이트해야 합니다.

AccountInfo

Google Ads 계정 정보에 대한 래퍼입니다.

JSON 표현 
{
  "customerId": string,
  "descriptiveName": string
}
입력란
customerId

string (int64 format)

출력 전용. 계정의 고객 ID입니다.
descriptiveName

string

출력 전용. 계정을 설명하는 이름입니다.

CustomAudienceOptInRecommendation

맞춤 잠재고객 선택 추천

JSON 표현 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ]
}
입력란
keywords[]

object (KeywordInfo)

출력 전용. 맞춤 잠재고객 생성에 사용할 키워드 목록입니다.

LeadFormAssetRecommendation

이 유형에는 필드가 없습니다.

리드 양식 확장 소재 추천

ImproveDemandGenAdStrengthRecommendation

디맨드젠 광고 효력 개선을 위한 추천입니다.

JSON 표현 
{
  "ad": string,
  "adStrength": enum (AdStrength),
  "demandGenAssetActionItems": [
    string
  ]
}
입력란
ad

string

출력 전용. 개선할 수 있는 광고의 리소스 이름입니다.
adStrength

enum (AdStrength)

출력 전용. 현재 광고 효력입니다.
demandGenAssetActionItems[]

string

출력 전용. 광고 효력을 개선하기 위한 권장사항 목록입니다.