Configurações de automação de recursos

O Google Ads oferece várias otimizações de recursos que podem ser realizadas automaticamente para melhorar a qualidade dos seus anúncios.

Isso inclui desde a criação automática de recursos de imagem com uma prévia da página de destino de um anúncio até a otimização de recursos de vídeo para diferentes formatos e durações.

Cada configuração de automação de recursos tem um asset_automation_type, que define o tipo de automação de recursos que ele representa, e um asset_automation_status, que representa se a automação está ativada ou desativada.

Algumas automações de recursos são configuradas no nível da campanha, enquanto outras são definidas no nível do anúncio do grupo de anúncios.

Configurações de automação de recursos no nível da campanha

Elas configuram uma automação de recursos para uma campanha inteira. Nem todos estão disponíveis para todos os tipos de campanha. Consulte a documentação de referência para mais detalhes.

Tipo de automação de recursos	Tipos de campanha compatíveis	Padrão
AUTOMATED_VIDEO_CRAWL	Performance Max	Desativado (disponível a partir da v25) Permite que o Google encontre e use vídeos da sua página de destino, do canal do YouTube e dos canais sociais orgânicos vinculados a ela. Ao ativar, você pode configurar o campo automated_video_crawl_setting.
FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION	Performance Max e pesquisa	Ativada para campanhas Performance Max e desativada para pesquisa. Observação:ao ativar a expansão de URL final, o Google gera recursos de texto (títulos e descrições) de forma dinâmica para corresponder ao conteúdo das páginas de destino selecionadas dinamicamente. Não é possível desativar essa opção se a expansão de URL final estiver ativa. Compare isso com a TEXT_ASSET_AUTOMATION (personalização de texto) padrão, que personaliza o texto em todos os anúncios da campanha.
GENERATE_ENHANCED_YOUTUBE_VIDEOS	Performance Max	Ativado
GENERATE_IMAGE_ENHANCEMENT	Performance Max	Ativado
GENERATE_IMAGE_EXTRACTION	Performance Max	O valor de controle da extensão de imagem dinâmica no nível da conta. Observação:essa configuração no nível da conta só pode ser feita na interface da Web do Google Ads.
TEXT_ASSET_AUTOMATION	Performance Max e pesquisa	Ativada para campanhas Performance Max e desativada para pesquisa

O snippet a seguir mostra como definir as configurações de automação de recursos como OPTED_IN para uma campanha Performance Max:

Java

// Configures the optional opt-in/out status for asset automation settings.
.addAllAssetAutomationSettings(ImmutableList.of(
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(AssetAutomationType.GENERATE_IMAGE_EXTRACTION)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build(),
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(
            AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build(),
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(AssetAutomationType.TEXT_ASSET_AUTOMATION)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build(),
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build(),
    AssetAutomationSetting.newBuilder()
        .setAssetAutomationType(AssetAutomationType.GENERATE_IMAGE_ENHANCEMENT)
        .setAssetAutomationStatus(AssetAutomationStatus.OPTED_IN).build()))
AddPerformanceMaxCampaign.java
      

C#

campaign.AssetAutomationSettings.AddRange(new[]{
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.GenerateImageExtraction,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.FinalUrlExpansionTextAssetAutomation,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.TextAssetAutomation,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.GenerateEnhancedYoutubeVideos,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
    new Campaign.Types.AssetAutomationSetting
    {
        AssetAutomationType = AssetAutomationType.GenerateImageEnhancement,
        AssetAutomationStatus = AssetAutomationStatus.OptedIn
    },
});
AddPerformanceMaxCampaign.cs
      

PHP

This example is not yet available in PHP; you can take a look at the other languages.
    

Python

# Configures the optional opt-in/out status for asset automation settings.
for asset_automation_type_enum in [
    client.enums.AssetAutomationTypeEnum.GENERATE_IMAGE_EXTRACTION,
    client.enums.AssetAutomationTypeEnum.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION,
    client.enums.AssetAutomationTypeEnum.TEXT_ASSET_AUTOMATION,
    client.enums.AssetAutomationTypeEnum.GENERATE_ENHANCED_YOUTUBE_VIDEOS,
    client.enums.AssetAutomationTypeEnum.GENERATE_IMAGE_ENHANCEMENT,
]:
    asset_automattion_setting: Campaign.AssetAutomationSetting = (
        client.get_type("Campaign").AssetAutomationSetting()
    )
    asset_automattion_setting.asset_automation_type = (
        asset_automation_type_enum
    )
    asset_automattion_setting.asset_automation_status = (
        client.enums.AssetAutomationStatusEnum.OPTED_IN
    )
    campaign.asset_automation_settings.append(asset_automattion_setting)
add_performance_max_campaign.py
      

Ruby

# Configures the optional opt-in/out status for asset automation settings.
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :GENERATE_IMAGE_EXTRACTION
  aas.asset_automation_status = :OPTED_IN
end
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION
  aas.asset_automation_status = :OPTED_IN
end
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :TEXT_ASSET_AUTOMATION
  aas.asset_automation_status = :OPTED_IN
end
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :GENERATE_ENHANCED_YOUTUBE_VIDEOS
  aas.asset_automation_status = :OPTED_IN
end
c.asset_automation_settings << client.resource.asset_automation_setting do |aas|
  aas.asset_automation_type = :GENERATE_IMAGE_ENHANCEMENT
  aas.asset_automation_status = :OPTED_IN
end
add_performance_max_campaign.rb
      

Perl

# Configures the optional opt-in/out status for asset automation settings.
# When we create the campaign object, we set campaign->{assetAutomationSettings}
# equal to $asset_automation_settings.
my $asset_automation_settings = [];
my $asset_automation_types    = [
  GENERATE_IMAGE_EXTRACTION, FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION,
  TEXT_ASSET_AUTOMATION,     GENERATE_ENHANCED_YOUTUBE_VIDEOS,
  GENERATE_IMAGE_ENHANCEMENT
];
foreach my $asset_automation_type (@$asset_automation_types) {
  push @$asset_automation_settings,
    Google::Ads::GoogleAds::V25::Resources::AssetAutomationSetting->new({
      assetAutomationStatus => OPTED_IN,
      assetAutomationType   => $asset_automation_type
    });
}
add_performance_max_campaign.pl
      

curl

Observação:embora não haja um exemplo de código REST direto para esta etapa, é possível fazer isso usando uma solicitação REST manual.

Consulte a documentação da interface REST da API Google Ads e as páginas de referência específicas do método. Você precisará criar o payload JSON com base nas definições de protocolo.

Principais recursos:

• Como usar REST
• Estrutura da interface REST
• Mapeamentos de campos JSON
• Consulte a Referência da API REST para o serviço e método específicos.

Configurações de automação de recursos no nível do anúncio

Elas configuram uma automação de recursos para um único anúncio. Nem todos estão disponíveis para todos os tipos de anúncio. Consulte a documentação de referência para mais detalhes.

Tipo de automação de recursos	Tipos de anúncios compatíveis	Padrão
GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	DemandGenMultiAssetAd	Ativado (a partir da v25)
GENERATE_DESIGN_VERSIONS_FOR_IMAGES	DemandGenMultiAssetAd	Ativado
GENERATE_LANDING_PAGE_PREVIEW	DemandGenVideoResponsiveAd	Desativado
GENERATE_LANDING_PAGE_TEXT	DemandGenVideoResponsiveAd	Ativado (a partir da v24)
GENERATE_SHORTER_YOUTUBE_VIDEOS	DemandGenVideoResponsiveAd	Ativado
GENERATE_VERTICAL_YOUTUBE_VIDEOS	DemandGenVideoResponsiveAd	Ativado
GENERATE_VIDEOS_FROM_OTHER_ASSETS	DemandGenMultiAssetAd	Ativado

Diretrizes de texto

Com as diretrizes de texto (disponíveis a partir da v23), é possível refinar as mensagens da marca para recursos de texto gerados automaticamente em campanhas Performance Max e IA Max especificando exclusões de termos e restrições de mensagens.

Para usar diretrizes de texto, preencha o campo text_guidelines do recurso Campaign:

• Exclusões de termos: forneça uma lista de palavras ou frases exatas que precisam ser excluídas dos recursos de texto gerados. Cada exclusão pode ter até 30 caracteres, com um máximo de 25 exclusões.
• Restrições de mensagens: forneça instruções de formato livre (até 300 caracteres cada) para orientar a geração de texto de IA. É possível adicionar até 40 restrições. Apenas RESTRICTION_BASED_EXCLUSION é compatível com o tipo de restrição.

Configurações de rastreamento automatizado de vídeos

O rastreamento automatizado de vídeos (disponível a partir da v25, também conhecido como vídeos de origem) permite que o Google descubra e use vídeos relevantes de fontes aprovadas para campanhas Performance Max, ajudando a melhorar a performance dos anúncios sem exigir uploads manuais de vídeos.

Para usar o rastreamento automatizado de vídeos:

1. Defina o asset_automation_type como AUTOMATED_VIDEO_CRAWL.
2. Defina o asset_automation_status como OPTED_IN.

3. Configure o campo automated_video_crawl_setting de AssetAutomationSetting com uma ou mais entradas AutomatedVideoCrawlInfo em automated_video_crawl_infos:

   • url: o URL a ser incluído para rastreamento (como sua página de destino, perfil de rede social ou canal do YouTube).
   • source_platform: o VideoCrawlSourcePlatform que representa o tipo de origem:
     • LANDING_PAGE: vídeos encontrados na página de destino do anunciante.
     • SOCIAL: URLs de vídeos sociais orgânicos vinculados na página de destino do anunciante (Facebook, Instagram, X, LinkedIn, TikTok).
     • YOUTUBE: vídeos do canal do YouTube do anunciante.
   • enabled: um booleano que indica se este URL de origem está aprovado e ativado para rastreamento.

Observação:ao ativar a rastreamento automático de vídeos, você confirma que detém todos os direitos legais sobre os vídeos das fontes ativadas e tem permissão para compartilhá-los com o Google para fins de publicidade.