Recommendation

Un consiglio.

Rappresentazione 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.
}
Campi
resourceName

string

Immutabile. Il nome della risorsa del suggerimento.

customers/{customerId}/recommendations/{recommendation_id}

type

enum (RecommendationType)

Solo output. Il tipo di suggerimento.

impact

object (RecommendationImpact)

Solo output. L'impatto sul rendimento dell'account a seguito dell'applicazione del consiglio.

campaigns[]

string

Solo output. Le campagne scelte come target di questo consiglio.

Questo campo verrà impostato per i seguenti tipi di consigli: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET e MOVE_UNused_BUDGET

campaignBudget

string

Solo output. Il budget scelto come target di questo consiglio. Il valore verrà impostato solo quando il consiglio influisce su un singolo budget della campagna.

Questo campo verrà impostato per i seguenti tipi di consigli: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNused_BUDGET

campaign

string

Solo output. La campagna scelta come target da questo consiglio.

Questo campo verrà impostato per i seguenti tipi di consigli: 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

Solo output. Il gruppo di annunci scelto come target da questo consiglio. Il valore verrà impostato solo quando il consiglio interessa un singolo gruppo di annunci.

Questo campo verrà impostato per i seguenti tipi di consigli: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD

dismissed

boolean

Solo output. Se il consiglio è ignorato o meno.

Campo unione recommendation. I dettagli del suggerimento. recommendation può essere solo uno dei seguenti:
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Solo output. Il consiglio sul budget della campagna.

forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Solo output. Il consiglio sul budget della campagna basato sulla previsione.

keywordRecommendation

object (KeywordRecommendation)

Solo output. Il consiglio per le parole chiave.

textAdRecommendation

object (TextAdRecommendation)

Solo output. Aggiungi un consiglio sull'annuncio di testo espanso.

targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

Solo output. Il consiglio di attivazione del CPA target.

maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

Solo output. Il consiglio di attivazione di Massimizza le conversioni.

enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

Solo output. Il consiglio di attivazione del costo per clic ottimizzato.

searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

Solo output. Il consiglio di attivazione dei partner di ricerca.

maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

Solo output. Il consiglio di attivazione di Massimizza i clic.

optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

Solo output. Il consiglio Ottimizza la rotazione degli annunci.

keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

Solo output. Il consiglio sul tipo di corrispondenza delle parole chiave.

moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

Solo output. Il consiglio per il trasferimento del budget non utilizzato.

targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

Solo output. Il consiglio di attivazione del ROAS target.

responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

Solo output. Il consiglio per aggiungere annunci adattabili della rete di ricerca.

marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

Solo output. Il consiglio sul budget della campagna per il ROI marginale.

useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

Solo output. Il consiglio di utilizzare le parole chiave a corrispondenza generica.

responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

Solo output. Il consiglio per gli asset degli annunci adattabili della rete di ricerca.

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

Solo output. Il consiglio per eseguire l'upgrade di una campagna Shopping intelligente a una campagna Performance Max.

responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

Solo output. L'annuncio adattabile della rete di ricerca migliora l'efficacia dell'annuncio.

displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

Solo output. Il consiglio per l'attivazione dell'Espansione alla Rete Display.

upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

Solo output. Il consiglio di eseguire l'upgrade di una campagna locale a una campagna Performance Max.

raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

Solo output. Il consiglio di aumentare l'offerta basata su CPA target è troppo bassa.

forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

Solo output. Il consiglio sul ROAS target impostato per il set di previsione.

calloutAssetRecommendation

object (CalloutAssetRecommendation)

Solo output. Il consiglio sugli asset callout.

callAssetRecommendation

object (CallAssetRecommendation)

Solo output. Il consiglio sugli asset di chiamata.

shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

Solo output. Il suggerimento per l'età dell'annuncio Shopping.

shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

Solo output. Il consiglio sul colore per gli acquisti aggiunti.

shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

Solo output. Il consiglio per l'aggiunta del genere all'annuncio Shopping.

shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

Solo output. Il consiglio GTIN per gli annunci Shopping.

shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

Solo output. Il consiglio per gli acquisti Aggiungi altri identificatori.

shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

Solo output. Il consiglio sulla taglia dell'aggiunta di Shopping.

shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

Solo output. Il consiglio sull'aggiunta di prodotti alla campagna su Shopping.

shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

Solo output. Il consiglio per la correzione dei prodotti non approvati di Shopping.

shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

Solo output. Il target Shopping per tutte le offerte consigliato.

shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Solo output. La correzione di Shopping ha sospeso il consiglio per l'account Merchant Center.

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

Solo output. Il consiglio relativo all'avviso di sospensione dell'account Merchant Center per la correzione degli acquisti.

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

Solo output. La migrazione delle offerte della campagna Shopping standard al consiglio Performance Max.

dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

Solo output. Consiglio per attivare le estensioni immagine dinamiche nell'account, in modo che Google possa trovare le immagini migliori dalle pagine di destinazione degli annunci e integrare gli annunci di testo.

raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

Solo output. Consiglio per aumentare il CPA target.

lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

Solo output. Consiglio per ridurre il ROAS target.

performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

Solo output. Il consiglio di attivazione di Performance Max.

improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

Solo output. Il consiglio per migliorare l'efficacia dell'annuncio Performance Max.

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

Solo output. Il consiglio per la migrazione dagli annunci dinamici della rete di ricerca a Performance Max.

forecastingSetTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

Solo output. Il consiglio per il CPA target dell'impostazione di previsione.

setTargetCpaRecommendation

object (ForecastingSetTargetCpaRecommendation)

Solo output. Il consiglio sul CPA target impostato.

setTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

Solo output. Il consiglio per il ROAS target impostato.

maximizeConversionValueOptInRecommendation

object (MaximizeConversionValueOptInRecommendation)

Solo output. Il consiglio di attivazione di Massimizza il valore di conversione.

improveGoogleTagCoverageRecommendation

object (ImproveGoogleTagCoverageRecommendation)

Solo output. Consiglio di implementare il tag Google su più pagine.

performanceMaxFinalUrlOptInRecommendation

object (PerformanceMaxFinalUrlOptInRecommendation)

Solo output. Consiglio per attivare l'espansione dell'URL finale per le campagne Performance Max.

refreshCustomerMatchListRecommendation

object (RefreshCustomerMatchListRecommendation)

Solo output. Il suggerimento per aggiornare l'elenco di clienti.

customAudienceOptInRecommendation

object (CustomAudienceOptInRecommendation)

Solo output. Il consiglio di attivazione del segmento di pubblico personalizzato.

leadFormAssetRecommendation

object (LeadFormAssetRecommendation)

Solo output. Il consiglio per l'asset modulo per i lead.

improveDemandGenAdStrengthRecommendation

object (ImproveDemandGenAdStrengthRecommendation)

Solo output. Il consiglio per migliorare l'efficacia dell'annuncio Demand Gen.

RecommendationImpact

L'impatto della modifica descritta nel consiglio. Per alcuni tipi di consigli potrebbero non essere disponibili informazioni sull'impatto.

Rappresentazione JSON
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
Campi
baseMetrics

object (RecommendationMetrics)

Solo output. Metriche di base al momento della generazione del consiglio.

potentialMetrics

object (RecommendationMetrics)

Solo output. Metriche stimate se viene applicato il consiglio.

RecommendationMetrics

Metriche sul rendimento dell'account settimanali. Per alcuni tipi di consigli, viene calcolata la media degli ultimi 90 giorni, pertanto possono essere frazionarie.

Rappresentazione JSON
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionsValue": number,
  "videoViews": number
}
Campi
impressions

number

Solo output. Numero di impressioni dell'annuncio.

clicks

number

Solo output. Numero di clic sugli annunci.

costMicros

string (int64 format)

Solo output. Costo (in micro) per la pubblicità, nella valuta locale dell'account.

conversions

number

Solo output. Numero di conversioni.

conversionsValue

number

Solo output. Somma del valore di conversione delle conversioni.

videoViews

number

Solo output. Numero di visualizzazioni di un video per una campagna pubblicitaria video.

CampaignBudgetRecommendation

Il consiglio sul budget per le campagne con limiti di budget.

Rappresentazione JSON
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
Campi
budgetOptions[]

object (CampaignBudgetRecommendationOption)

Solo output. Gli importi del budget e le stime dell'impatto associate per alcuni valori di possibili importi del budget.

currentBudgetAmountMicros

string (int64 format)

Solo output. L'importo corrente del budget in micro.

recommendedBudgetAmountMicros

string (int64 format)

Solo output. L'importo del budget consigliato in micro.

CampaignBudgetRecommendationOption

Le stime dell'impatto per un determinato importo del budget.

Rappresentazione JSON
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
Campi
impact

object (RecommendationImpact)

Solo output. La stima dell'impatto se il budget viene modificato in base all'importo specificato in questa opzione.

budgetAmountMicros

string (int64 format)

Solo output. L'importo del budget per questa opzione.

KeywordRecommendation

Il consiglio sulle parole chiave.

Rappresentazione JSON
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
Campi
keyword

object (KeywordInfo)

Solo output. La parola chiave consigliata.

searchTerms[]

object (SearchTerm)

Solo output. Un elenco di termini di ricerca corrispondenti a questa parola chiave. Lo stesso termine di ricerca può essere ripetuto per più parole chiave.

recommendedCpcBidMicros

string (int64 format)

Solo output. L'offerta CPC (costo per clic) consigliata.

SearchTerm

Informazioni su un termine di ricerca correlato a una parola chiave consigliata.

Rappresentazione JSON
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
Campi
text

string

Solo output. Il testo del termine di ricerca.

estimatedWeeklySearchCount

string (int64 format)

Solo output. Numero stimato delle ricerche settimanali storiche di questo termine di ricerca.

Consiglio testo annuncio

Il consiglio per l'annuncio di testo.

Rappresentazione JSON
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
Campi
ad

object (Ad)

Solo output. Annuncio consigliato.

creationDate

string

Solo output. Data di creazione dell'annuncio consigliato. Formato AAAA-MM-GG, ad esempio 2018-04-17.

autoApplyDate

string

Solo output. La data, se presente, è la prima data in cui il consiglio verrà applicato automaticamente. Formato AAAA-MM-GG, ad esempio 2018-04-17.

TargetCpaOptInRecommendation

Il consiglio di attivazione del CPA target.

Rappresentazione JSON
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
Campi
options[]

object (TargetCpaOptInRecommendationOption)

Solo output. Gli obiettivi disponibili e le opzioni corrispondenti per la strategia basata su CPA target.

recommendedTargetCpaMicros

string (int64 format)

Solo output. Il CPA target medio consigliato. Visualizza l'importo del budget richiesto e l'impatto dell'utilizzo di questo consiglio nell'elenco delle opzioni.

TargetCpaOptInRecommendationOption

L'opzione di attivazione del CPA target con stima dell'impatto.

Rappresentazione JSON
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
Campi
goal

enum (TargetCpaOptInRecommendationGoal)

Solo output. L'obiettivo raggiunto da questa opzione.

impact

object (RecommendationImpact)

Solo output. La stima dell'impatto se questa opzione è selezionata.

targetCpaMicros

string (int64 format)

Solo output. CPA target medio.

requiredCampaignBudgetAmountMicros

string (int64 format)

Solo output. Il budget minimo della campagna, in valuta locale dell'account, necessario per raggiungere il CPA target. L'importo è specificato in micro, dove un milione è equivalente a un'unità di valuta.

TargetCpaOptInRecommendationGoal

Obiettivo del consiglio TargetCpaOptIn.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
SAME_COST Consiglio per impostare il CPA target in modo da mantenere lo stesso costo.
SAME_CONVERSIONS Consiglio per impostare il CPA target in modo da mantenere le stesse conversioni.
SAME_CPA Consiglio per impostare il CPA target in modo da mantenere lo stesso CPA.
CLOSEST_CPA Consiglio di impostare il CPA target su un valore il più vicino possibile al CPA effettivo (calcolato negli ultimi 28 giorni), ma inferiore.

MaximizeConversionsOptInRecommendation

Il consiglio di attivazione di Massimizza le conversioni.

Rappresentazione JSON
{
  "recommendedBudgetAmountMicros": string
}
Campi
recommendedBudgetAmountMicros

string (int64 format)

Solo output. Il nuovo importo del budget consigliato.

EnhancedCpcOptInRecommendation

Questo tipo non contiene campi.

Il consiglio di attivazione del costo per clic ottimizzato.

SearchPartnersOptInRecommendation

Questo tipo non contiene campi.

Il consiglio di attivazione dei partner di ricerca.

MaximizeClicksOptInRecommendation

Il consiglio di attivazione dell'offerta Massimizza i clic.

Rappresentazione JSON
{
  "recommendedBudgetAmountMicros": string
}
Campi
recommendedBudgetAmountMicros

string (int64 format)

Solo output. Il nuovo importo del budget consigliato. Impostalo solo se il budget corrente è troppo alto.

OptimizeAdRotationRecommendation

Questo tipo non contiene campi.

Il consiglio Ottimizza la rotazione degli annunci.

KeywordMatchTypeRecommendation

Il consiglio sul tipo di corrispondenza delle parole chiave.

Rappresentazione JSON
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
Campi
keyword

object (KeywordInfo)

Solo output. La parola chiave esistente per cui il tipo di corrispondenza deve essere più generico.

recommendedMatchType

enum (KeywordMatchType)

Solo output. Il nuovo tipo di corrispondenza consigliato.

MoveUnusedBudgetRecommendation

Il consiglio per trasferire il budget non utilizzato.

Rappresentazione JSON
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
Campi
budgetRecommendation

object (CampaignBudgetRecommendation)

Solo output. Il consiglio per aumentare il budget limitato.

excessCampaignBudget

string

Solo output. Il valore resourceName del budget in eccesso.

TargetRoasOptInRecommendation

Il consiglio di attivazione del ROAS target.

Rappresentazione JSON
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
Campi
recommendedTargetRoas

number

Solo output. Il ROAS target consigliato (entrate per unità di spesa). Il valore deve essere compreso tra 0,01 e 1000,0 inclusi.

requiredCampaignBudgetAmountMicros

string (int64 format)

Solo output. Il budget minimo della campagna, in valuta locale dell'account, necessario per raggiungere il ROAS target. L'importo è specificato in micro, dove un milione è equivalente a un'unità di valuta.

ResponsiveSearchAdRecommendation

Il consiglio Aggiungi annuncio adattabile della rete di ricerca.

Rappresentazione JSON
{
  "ad": {
    object (Ad)
  }
}
Campi
ad

object (Ad)

Solo output. Annuncio consigliato.

UseBroadMatchKeywordRecommendation

Il consiglio di utilizzare le parole chiave a corrispondenza generica.

Rappresentazione JSON
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
Campi
keyword[]

object (KeywordInfo)

Solo output. Esempio di parole chiave da espandere alla corrispondenza generica.

suggestedKeywordsCount

string (int64 format)

Solo output. Numero totale di parole chiave da espandere alla corrispondenza generica nella campagna.

campaignKeywordsCount

string (int64 format)

Solo output. Numero totale di parole chiave nella campagna.

campaignUsesSharedBudget

boolean

Solo output. Indica se la campagna associata utilizza un budget condiviso.

requiredCampaignBudgetAmountMicros

string (int64 format)

Solo output. Budget consigliato per evitare di subire limiti di budget dopo aver applicato il consiglio.

ResponsiveSearchAdAssetRecommendation

Il consiglio di aggiungere asset per gli annunci adattabili della rete di ricerca.

Rappresentazione JSON
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
Campi
currentAd

object (Ad)

Solo output. L'annuncio corrente da aggiornare.

recommendedAssets

object (Ad)

Solo output. Gli asset consigliati. Viene compilato solo con i nuovi titoli e/o le nuove descrizioni ed è altrimenti vuoto.

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

Eseguire l'upgrade di una campagna Shopping intelligente a un consiglio per la campagna Performance Max.

Rappresentazione JSON
{
  "merchantId": string,
  "salesCountryCode": string
}
Campi
merchantId

string (int64 format)

Solo output. ID dell'account Merchant Center.

salesCountryCode

string

Solo output. Paese di cui devono essere inclusi i prodotti dell'inventario del commerciante.

ResponsiveSearchAdImproveAdStrengthRecommendation

Il consiglio per migliorare l'efficacia dell'annuncio adattabile della rete di ricerca.

Rappresentazione JSON
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
Campi
currentAd

object (Ad)

Solo output. L'annuncio corrente da aggiornare.

recommendedAd

object (Ad)

Solo output. L'annuncio aggiornato.

DisplayExpansionOptInRecommendation

Questo tipo non contiene campi.

Il consiglio di attivazione dell'Espansione alla Rete Display.

UpgradeLocalCampaignToPerformanceMaxRecommendation

Questo tipo non contiene campi.

Il consiglio di eseguire l'upgrade della campagna locale a Performance Max.

RaiseTargetCpaBidTooLowRecommendation

Il consiglio di aumentare l'offerta basata su CPA target è troppo basso.

Rappresentazione JSON
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
Campi
recommendedTargetMultiplier

number

Solo output. Un numero maggiore di 1,0 che indica il fattore per cui consigliamo di aumentare il CPA target.

averageTargetCpaMicros

string (int64 format)

Solo output. Il CPA target medio corrente della campagna, in micro della valuta locale del cliente.

ForecastingSetTargetRoasRecommendation

Il consiglio sul ROAS target impostato per il set di previsione.

Rappresentazione JSON
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Campi
recommendedTargetRoas

number

Solo output. Il ROAS target consigliato (entrate per unità di spesa). Il valore deve essere compreso tra 0,01 e 1000,0 inclusi.

campaignBudget

object (CampaignBudget)

Solo output. Il budget della campagna.

CampaignBudget

Un budget della campagna condiviso tra i vari tipi di consigli sul budget.

Rappresentazione JSON
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
Campi
currentAmountMicros

string (int64 format)

Solo output. Importo del budget attuale.

recommendedNewAmountMicros

string (int64 format)

Solo output. Importo del budget consigliato.

newStartDate

string

Solo output. La data di inizio dell'utilizzo del nuovo budget. Questo campo verrà impostato per i seguenti tipi di consigli: FORECASTING_SET_TARGET_ROAS, FORECASTING_SET_TARGET_CPA nel formato AAAA-MM-GG, ad esempio 2018-04-17.

CalloutAssetRecommendation

Il consiglio per l'asset callout.

Rappresentazione JSON
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
Campi
recommendedCampaignCalloutAssets[]

object (Asset)

Solo output. Nuovi asset estensione callout consigliati a livello di campagna.

recommendedCustomerCalloutAssets[]

object (Asset)

Solo output. Nuovi asset di estensioni callout consigliati a livello di cliente.

SitelinkAssetRecommendation

Il consiglio per gli asset sitelink.

Rappresentazione JSON
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
Campi

CallAssetRecommendation

Questo tipo non contiene campi.

Il consiglio sugli asset di chiamata.

ShoppingOfferAttributeRecommendation

Il consiglio per gli acquisti di aggiungere un attributo alle offerte che vengono retrocesse perché mancante.

Rappresentazione JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
Campi
merchant

object (MerchantInfo)

Solo output. I dettagli dell'account Merchant Center.

feedLabel

string

Solo output. L'etichetta del feed della campagna.

offersCount

string (int64 format)

Solo output. Il numero di offerte disponibili online.

demotedOffersCount

string (int64 format)

Solo output. Il numero di offerte online pubblicabili che vengono retrocesse a causa degli attributi mancanti. Per saperne di più, visita Merchant Center.

MerchantInfo

I dettagli dell'account Merchant Center.

Rappresentazione JSON
{
  "id": string,
  "name": string,
  "multiClient": boolean
}
Campi
id

string (int64 format)

Solo output. L'ID account Merchant Center.

name

string

Solo output. Il nome dell'account Merchant Center.

multiClient

boolean

Solo output. Se l'account Merchant Center è un account multi-cliente (AMC).

ShoppingAddProductsToCampaignRecommendation

Il consiglio di Shopping per aggiungere prodotti all'inventario di una campagna Shopping.

Rappresentazione JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
Campi
merchant

object (MerchantInfo)

Solo output. I dettagli dell'account Merchant Center.

feedLabel

string

Solo output. L'etichetta del feed per la campagna.

reason

enum (Reason)

Solo output. Il motivo per cui nessun prodotto è associato alla campagna.

Motivo

Problemi che comportano una campagna Shopping che ha come target zero prodotti.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS L'account Merchant Center non contiene prodotti inviati.
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED L'account Merchant Center non contiene prodotti inviati nel feed.
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN L'account Google Ads contiene filtri delle campagne attivi che impediscono l'inclusione delle offerte nella campagna.
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN Tutti i prodotti disponibili sono stati esclusi esplicitamente dal targeting della campagna.

ShoppingFixDisapprovedProductsRecommendation

Il consiglio di Shopping per correggere i prodotti non approvati nell'inventario di una campagna Shopping.

Rappresentazione JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
Campi
merchant

object (MerchantInfo)

Solo output. I dettagli dell'account Merchant Center.

feedLabel

string

Solo output. L'etichetta del feed per la campagna.

productsCount

string (int64 format)

Solo output. Il numero di prodotti della campagna.

disapprovedProductsCount

string (int64 format)

Solo output. Il numero di prodotti della campagna che non sono stati approvati.

ShoppingTargetAllOffersRecommendation

Il consiglio Shopping per creare una campagna generica che abbia come target tutte le offerte.

Rappresentazione JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
Campi
merchant

object (MerchantInfo)

Solo output. I dettagli dell'account Merchant Center.

untargetedOffersCount

string (int64 format)

Solo output. Il numero di offerte non mirate.

feedLabel

string

Solo output. L'etichetta del feed delle offerte.

ShoppingMerchantCenterAccountSuspensionRecommendation

Il consiglio di Shopping per risolvere i problemi di sospensione dell'account Merchant Center.

Rappresentazione JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Campi
merchant

object (MerchantInfo)

Solo output. I dettagli dell'account Merchant Center.

feedLabel

string

Solo output. L'etichetta del feed della campagna per cui si è verificata la sospensione.

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

Il consiglio di Shopping relativo alla migrazione delle offerte delle campagne Shopping standard alle campagne Performance Max.

Rappresentazione JSON
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
Campi
merchant

object (MerchantInfo)

Solo output. I dettagli dell'account Merchant Center.

feedLabel

string

Solo output. L'etichetta del feed delle offerte scelte come target dalle campagne che condividono questo suggerimento.

DynamicImageExtensionOptInRecommendation

Questo tipo non contiene campi.

Consiglio di attivare le estensioni immagine dinamiche nell'account, per consentire a Google di trovare le immagini migliori nelle pagine di destinazione degli annunci e di integrare gli annunci di testo.

RaiseTargetCpaRecommendation

Consiglio di aumentare il CPA target.

Rappresentazione JSON
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
Campi
targetAdjustment

object (TargetAdjustmentInfo)

Solo output. Le informazioni pertinenti che descrivono l'aggiustamento del target consigliato.

appBiddingGoal

enum (AppBiddingGoal)

Solo output. Rappresenta l'obiettivo in base al quale deve essere ottimizzata la strategia di offerta. Compilato solo per le campagne per app.

TargetAdjustmentInfo

Informazioni su un consiglio sull'aggiustamento del target.

Rappresentazione JSON
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
Campi
recommendedTargetMultiplier

number

Solo output. Il fattore in base al quale consigliamo la regolazione del target.

currentAverageTargetMicros

string (int64 format)

Solo output. Il target medio attuale della campagna o del portafoglio scelto come target da questo consiglio.

sharedSet

string

Solo output. Il nome della risorsa set condiviso della strategia di offerta di portafoglio in cui è definito il target. Viene compilato solo se il consiglio è a livello di portafoglio.

AppBiddingGoal

Rappresenta l'obiettivo in base al quale deve essere ottimizzata la strategia di offerta di una campagna per app.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Rappresenta un valore sconosciuto in questa versione dell'API.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME La strategia di offerta della campagna per app deve mirare a massimizzare l'installazione dell'app.
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME La strategia di offerta della campagna per app deve avere come obiettivo la massimizzazione del volume delle conversioni in-app selezionate.
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE La strategia di offerta della campagna per app deve avere lo scopo di massimizzare il valore di tutte le conversioni, ovvero le installazioni e le conversioni in-app selezionate.
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION La strategia di offerta della campagna per app deve avere come obiettivo la massimizzazione del volume solo della conversione in-app selezionata, raggiungendo o superando al contempo il costo per conversione in-app target.
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND La strategia di offerta della campagna per app deve mirare a massimizzare il valore di tutte le conversioni, ovvero le installazioni e le conversioni in-app selezionate, raggiungendo o superando il ritorno sulla spesa pubblicitaria target.
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI Questa strategia di offerta della campagna per app dovrebbe mirare a massimizzare l'installazione dell'app senza il costo per installazione target fornito dall'inserzionista.
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME Questa strategia di offerta della campagna per app deve avere lo scopo di massimizzare la preregistrazione dell'app.

LowerTargetRoasRecommendation

Consiglio per ridurre il ROAS target.

Rappresentazione JSON
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
Campi
targetAdjustment

object (TargetAdjustmentInfo)

Solo output. Le informazioni pertinenti che descrivono l'aggiustamento del target consigliato.

PerformanceMaxOptInRecommendation

Questo tipo non contiene campi.

Il consiglio di attivazione di Performance Max.

ImprovePerformanceMaxAdStrengthRecommendation

Consiglio per migliorare l'efficacia del gruppo di asset di una campagna Performance Max fino a una valutazione "Eccellente".

Rappresentazione JSON
{
  "assetGroup": string
}
Campi
assetGroup

string

Solo output. Il nome della risorsa del gruppo di asset.

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

Il consiglio per la migrazione dagli annunci dinamici della rete di ricerca a Performance Max.

Rappresentazione JSON
{
  "applyLink": string
}
Campi

ForecastingSetTargetCpaRecommendation

I consigli sul CPA target impostati.

Rappresentazione JSON
{
  "recommendedTargetCpaMicros": string,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
Campi
recommendedTargetCpaMicros

string (int64 format)

Solo output. Il CPA target consigliato.

campaignBudget

object (CampaignBudget)

Solo output. Il budget della campagna.

MaximizeConversionValueOptInRecommendation

Questo tipo non contiene campi.

Consiglio di attivare la strategia di offerta Massimizza il valore di conversione.

ImproveGoogleTagCoverageRecommendation

Questo tipo non contiene campi.

Consiglio per l'implementazione del tag Google in più pagine.

PerformanceMaxFinalUrlOptInRecommendation

Questo tipo non contiene campi.

Consiglio per attivare l'espansione dell'URL finale per le campagne Performance Max.

RefreshCustomerMatchListRecommendation

Il consiglio di aggiornare un elenco di clienti che non è stato aggiornato negli ultimi 90 giorni. Il cliente che riceve il consiglio non è necessariamente l'account proprietario. L'account proprietario deve aggiornare l'elenco dei clienti.

Rappresentazione JSON
{
  "userListId": string,
  "userListName": string,
  "daysSinceLastRefresh": string,
  "topSpendingAccount": [
    {
      object (AccountInfo)
    }
  ],
  "targetingAccountsCount": string,
  "ownerAccount": {
    object (AccountInfo)
  }
}
Campi
userListId

string (int64 format)

Solo output. L'ID elenco utente.

userListName

string

Solo output. Il nome dell'elenco.

daysSinceLastRefresh

string (int64 format)

Solo output. Giorni dall'ultimo aggiornamento.

topSpendingAccount[]

object (AccountInfo)

Solo output. L'account con la spesa più elevata.

targetingAccountsCount

string (int64 format)

Solo output. Gli elenchi di utenti possono essere condivisi con altri account dal proprietario. targetingAccountsCount indica il numero di account che possono utilizzarlo per il targeting.

ownerAccount

object (AccountInfo)

Solo output. L'account proprietario. Questo è l'account che deve aggiornare l'elenco clienti.

AccountInfo

Elemento contenitore per le informazioni su un account Google Ads.

Rappresentazione JSON
{
  "customerId": string,
  "descriptiveName": string
}
Campi
customerId

string (int64 format)

Solo output. L'ID cliente dell'account.

descriptiveName

string

Solo output. Il nome descrittivo dell'account.

CustomAudienceOptInRecommendation

Il consiglio di attivazione dei segmenti di pubblico personalizzati.

Rappresentazione JSON
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ]
}
Campi
keywords[]

object (KeywordInfo)

Solo output. L'elenco di parole chiave da utilizzare per la creazione di segmenti di pubblico personalizzati.

LeadFormAssetRecommendation

Questo tipo non contiene campi.

Il consiglio per l'asset modulo per i lead.

ImproveDemandGenAdStrengthRecommendation

Il consiglio per migliorare l'efficacia dell'annuncio Demand Gen.

Rappresentazione JSON
{
  "ad": string,
  "adStrength": enum (AdStrength),
  "demandGenAssetActionItems": [
    string
  ]
}
Campi
ad

string

Solo output. Il nome della risorsa dell'annuncio che può essere migliorata.

adStrength

enum (AdStrength)

Solo output. L'efficacia dell'annuncio corrente.

demandGenAssetActionItems[]

string

Solo output. Un elenco di consigli per migliorare l'efficacia dell'annuncio.