Indicadores do grupo de recursos

Um AssetGroupSignal é um indicador que você pode fornecer ao Google para otimizar a veiculação de anúncios no nível do grupo de recursos. A campanha Performance Max usa esses indicadores para procurar novas impressões com intenção semelhante ou maior de encontrar conversões nas redes de pesquisa, Display, vídeo e muito mais. Ao combinar os indicadores do grupo de recursos com o entendimento em tempo real do Google sobre as intenções e preferências dos consumidores, a campanha Performance Max pode encontrar novos segmentos de clientes que você talvez não esperasse.

Embora as campanhas Performance Max padrão possam operar sem indicadores de grupo de recursos, as campanhas Performance Max de Serviços Locais exigem pelo menos um indicador de grupo de recursos por grupo. A tentativa de remover o último indicador restante vai acionar um AssetGroupSignalError.CANNOT_REMOVE_ALL_SIGNALS erro.

Há três tipos de dicas que você pode fornecer ao Google: audience, search_theme e local_services_id. Um AssetGroup pode ter vários indicadores de grupo de recursos, mas cada indicador precisa ser adicionado individualmente criando um AssetGroupSignal e preenchendo o oneof AssetGroupSignal.signal campo.

Públicos-alvo

Um Audience é uma coleção reutilizável de segmentos específicos, segmentação demográfica e exclusões. Um AssetGroupSignal permite especificar qual Audience tem maior probabilidade de conversão para seu AssetGroup. Saiba mais sobre os indicadores de público-alvo.

Um AssetGroupSignal só pode ser adicionado ou removido de um AssetGroup. Todas as modificações do Audience relacionado precisam ser feitas usando o AudienceService.

Java

AssetGroupSignal audienceSignal =
    AssetGroupSignal.newBuilder()
        .setAssetGroup(assetGroupResourceName)
        .setAudience(
            AudienceInfo.newBuilder()
                .setAudience(ResourceNames.audience(customerId, audienceId)))
        .build();

mutateOperations.add(
    MutateOperation.newBuilder()
        .setAssetGroupSignalOperation(
            AssetGroupSignalOperation.newBuilder().setCreate(audienceSignal))
        .build());
AddPerformanceMaxCampaign.java
      

C#

operations.Add(
    new MutateOperation()
    {
        AssetGroupSignalOperation = new AssetGroupSignalOperation()
        {
            Create = new AssetGroupSignal()
            {
                AssetGroup = assetGroupResourceName,
                Audience = new AudienceInfo()
                {
                    Audience = ResourceNames.Audience(customerId, audienceId.Value)
                }
            }
        }
    }
);
AddPerformanceMaxCampaign.cs
      

PHP

private static function createAssetGroupSignalOperations(
    int $customerId,
    string $assetGroupResourceName,
    ?int $audienceId
): array {
    $operations = [];
    if (is_null($audienceId)) {
        return $operations;
    }

    $operations[] = new MutateOperation([
        'asset_group_signal_operation' => new AssetGroupSignalOperation([
            // To learn more about Audience Signals, see
            // https://developers.google.com/google-ads/api/docs/performance-max/asset-groups#audience_signals.
            'create' => new AssetGroupSignal([
                'asset_group' => $assetGroupResourceName,
                'audience' => new AudienceInfo([
                    'audience' => ResourceNames::forAudience($customerId, $audienceId)
                ])
            ])
        ])
    ]);

    return $operations;
}
AddPerformanceMaxCampaign.php
      

Python

mutate_operation: MutateOperation = client.get_type("MutateOperation")
operation: AssetGroupSignal = (
    mutate_operation.asset_group_signal_operation.create
)
operation.asset_group = asset_group_resource_name
operation.audience.audience = googleads_service.audience_path(
    customer_id, audience_id
)
operations.append(mutate_operation)
add_performance_max_campaign.py
      

Ruby

# Create a list of MutateOperations that create AssetGroupSignals.
def create_asset_group_signal_operations(client, customer_id, audience_id)
  operations = []
  return operations if audience_id.nil?

  operations << client.operation.mutate do |m|
    m.asset_group_signal_operation = client.operation.create_resource.
        asset_group_signal do |ags|
      ags.asset_group = client.path.asset_group(
        customer_id,
        ASSET_GROUP_TEMPORARY_ID,
      )
      ags.audience = client.resource.audience_info do |ai|
        ai.audience = client.path.audience(customer_id, audience_id)
      end
    end
  end

  operations
end
add_performance_max_campaign.rb
      

Perl

sub create_asset_group_signal_operations {
  my ($customer_id, $audience_id) = @_;

  my $operations = [];
  return $operations if not defined $audience_id;

  push @$operations,
    Google::Ads::GoogleAds::V24::Services::GoogleAdsService::MutateOperation->
    new({
      assetGroupSignalOperation =>
        Google::Ads::GoogleAds::V24::Services::AssetGroupSignalService::AssetGroupSignalOperation
        ->new({
          # To learn more about Audience Signals, see:
          # https://developers.google.com/google-ads/api/docs/performance-max/asset-groups#audience_signals
          create =>
            Google::Ads::GoogleAds::V24::Resources::AssetGroupSignal->new({
              assetGroup =>
                Google::Ads::GoogleAds::V24::Utils::ResourceNames::asset_group(
                $customer_id, ASSET_GROUP_TEMPORARY_ID
                ),
              audience =>
                Google::Ads::GoogleAds::V24::Common::AudienceInfo->new({
                  audience =>
                    Google::Ads::GoogleAds::V24::Utils::ResourceNames::audience(
                    $customer_id, $audience_id
                    )})})})});
  return $operations;
}
add_performance_max_campaign.pl
      

curl

Observação:embora não seja fornecido 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 do proto.

Principais recursos:

• 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.

Os públicos-alvo podem ser criados com um scope de ASSET_GROUP para especificar que o público-alvo seja usado em um único grupo de recursos. O campo Audience.asset_group precisa ser preenchido com o nome do recurso de um grupo de recursos se e somente se Audience.scope estiver definido como ASSET_GROUP. Se um público-alvo com escopo ASSET_GROUP for atualizado para o escopo CUSTOMER, Audience.asset_group será limpo automaticamente.

Dica: se você estiver fazendo upgrade para campanhas Performance Max de outros tipos de campanha, poderá reutilizar o AudienceSegment das outras campanhas para criar um público-alvo para campanhas Performance Max. Saiba mais sobre como criar públicos-alvo.

Recomendações para otimização de indicadores de público-alvo

A API Google Ads oferece dois tipos de recomendação para ajudar você a otimizar os indicadores de público-alvo:

1. REFRESH_CUSTOMER_MATCH_LIST recomenda atualizar uma lista de clientes que não foi atualizada há algum tempo. Isso é útil se os públicos-alvo que você está usando como indicadores de grupo de recursos contiverem listas de clientes.

2. IMPROVE_GOOGLE_TAG_COVERAGE recomenda implantar a tag do Google em mais partes do seu site para melhorar o rastreamento de conversões. Isso pode levar a uma maior precisão dos relatórios de conversão, o que, por sua vez, pode gerar indicadores de público-alvo mais precisos para seus grupos de recursos.

Para mais informações, acesse o guia Pontuação de otimização e recomendações.

Temas de pesquisa

Um search_theme na campanha Performance Max permite enviar à IA do Google informações valiosas sobre o que os clientes estão procurando e quais tópicos geram conversões para sua empresa. Esse novo tipo de critério pode ser usado exclusivamente em campanhas Performance Max para criar um AssetGroupSignal preenchendo o AssetGroupSignal.search_theme campo com um SearchThemeInfo critério.

Java

AssetGroupSignal searchThemeSignal =
    AssetGroupSignal.newBuilder()
        .setAssetGroup(assetGroupResourceName)
        .setSearchTheme(SearchThemeInfo.newBuilder().setText("travel").build())
        .build();

mutateOperations.add(
    MutateOperation.newBuilder()
        .setAssetGroupSignalOperation(
            AssetGroupSignalOperation.newBuilder().setCreate(searchThemeSignal))
        .build());
AddPerformanceMaxCampaign.java
      

C#

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

PHP

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

Python

mutate_operation: MutateOperation = client.get_type("MutateOperation")
operation: AssetGroupSignal = (
    mutate_operation.asset_group_signal_operation.create
)
operation.asset_group = asset_group_resource_name
operation.search_theme.text = "travel"
operations.append(mutate_operation)
add_performance_max_campaign.py
      

Ruby

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

Perl

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

curl

Observação:embora não seja fornecido 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 do proto.

Principais recursos:

• 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.

Serviços locais

Um local_services_id na campanha Performance Max permite otimizar a veiculação de anúncios usando indicadores de ID de serviço dos anúncios de Serviços Locais. Você pode usar esse tipo de critério em campanhas Performance Max para criar um AssetGroupSignal preenchendo o AssetGroupSignal.local_services_id campo com uma LocalServiceIdInfo mensagem.

Observação: esse tipo de indicador é um recurso de lista de permissões apenas para campanhas Performance Max de Serviços Locais (GLS PMax) e não pode ser usado com outros tipos de campanha Performance Max.

O preenchimento desse campo especifica uma categoria e local dos Serviços Locais (como install_faucet ou categorias de encanamento) para orientar a otimização da campanha. Esse indicador ajuda a encontrar clientes em potencial com forte intenção para esses tipos de serviço específicos.