Configurações de automação de recursos

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

Elas variam 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 ela 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 todas 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 versão 25) Permite que o Google encontre e use vídeos da sua página de destino, do canal do YouTube e dos canais de mídias sociais orgânicas vinculados à sua página de destino. Ao ativar, você pode configurar o automated_video_crawl_setting campo.
FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION	Performance Max, pesquisa	Ativado para Performance Max, desativado para pesquisa. Observação: ativar a expansão de URL final resulta na geração dinâmica de recursos de texto (títulos e descrições) pelo Google 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. Isso contrasta com a TEXT_ASSET_AUTOMATION padrão (personalização de texto), 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, pesquisa	Ativado para Performance Max, desativado 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::V26::Resources::AssetAutomationSetting->new({
      assetAutomationStatus => OPTED_IN,
      assetAutomationType   => $asset_automation_type
    });
}
add_performance_max_campaign.pl
      

curl

Observação:embora um exemplo de código REST direto para esta etapa não seja fornecido aqui, você pode 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 do proto.

Recursos principais:

• Como usar o 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 todas 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 versão 25)
GENERATE_DESIGN_VERSIONS_FOR_IMAGES	DemandGenMultiAssetAd	Ativado
GENERATE_LANDING_PAGE_PREVIEW	DemandGenVideoResponsiveAd	Desativado
GENERATE_LANDING_PAGE_TEXT	DemandGenVideoResponsiveAd	Ativado (a partir da versão 24)
GENERATE_SHORTER_YOUTUBE_VIDEOS	DemandGenVideoResponsiveAd	Ativado
GENERATE_VERTICAL_YOUTUBE_VIDEOS	DemandGenVideoResponsiveAd	Ativado
GENERATE_VIDEOS_FROM_OTHER_ASSETS	DemandGenMultiAssetAd	Ativado

Diretrizes de texto

As diretrizes de texto permitem refinar as mensagens de marca para recursos de texto gerados automaticamente nas campanhas Performance Max e campanha com IA Max, especificando exclusões de termos e restrições de mensagens.

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

• Exclusões de termos: forneça uma lista de palavras ou frases exatas a serem 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 da IA. Você pode fornecer até 40 restrições. Somente 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 versão 25, 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 automated_video_crawl_setting campo de AssetAutomationSetting com uma ou mais AutomatedVideoCrawlInfo entradas em automated_video_crawl_infos:

   • url: o URL a ser incluído para rastreamento (como sua página de destino, perfil 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 à 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 esse URL de origem está aprovado e ativado para rastreamento.

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