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_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS, FORECASTING_SET_TARGET_CPA, SET_TARGET_CPA, SET_TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE_OPT_IN, IMPROVE_GOOGLE_TAG_COVERAGE, PERFORMANCE_MAX_FINAL_URL_OPT_IN 추천 유형에 대해 설정됩니다.

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)

출력 전용입니다. 클릭수 최대화 사용 설정 추천

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 사이입니다(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

출력 전용입니다. 타겟 CPA를 얼마만큼 높여야 하는지 나타내는 계수로, 1.0보다 큰 숫자입니다.

averageTargetCpaMicros

string (int64 format)

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

ForecastingSetTargetRoasRecommendation

예측 설정 타겟 ROAS 추천

JSON 표현
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
필드
recommendedTargetRoas

number

출력 전용입니다. 추천 타겟 광고 투자수익(ROAS)(지출 단위당 수익) 값은 0.01~1000.0 사이입니다(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 앱 캠페인의 이 입찰 전략은 광고주가 제공하는 타겟 설치당비용 없이 앱 설치를 극대화하는 것을 목표로 합니다.
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

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