O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Desempenho dos aplicativos

A biblioteca de cliente .NET do Google Ads simplifica as interações do seu app com a API Google Ads, com configuração mínima da sua parte. No entanto, o desempenho geral depende muito de como a biblioteca é usada e integrada ao seu app.

Este guia aborda otimizações de performance específicas para apps .NET e complementa as práticas recomendadas que geralmente se aplicam à API Google Ads.

Reutilize o GoogleAdsClient sempre que possível

GoogleAdsClient representa a sessão de um usuário ao fazer chamadas de API. Ele oferece otimizações como:

Armazenamento em cache dos canais gRPC usados pelos serviços de API. Isso reduz o tempo de configuração ao fazer chamadas de API iniciais.
Reutilizar tokens de acesso sempre que possível. Isso reduz o número de viagens de ida e volta que a biblioteca de cliente .NET do Google Ads precisa fazer para atualizar os tokens de acesso.

Use tokens de acesso de uma conta no nível de administrador sempre que possível

Se você tiver um token de acesso emitido no nível de uma conta de administrador, poderá usá-lo para fazer chamadas de API em todas as contas de clientes do Google Ads na hierarquia dessa conta. Quando combinado com a reutilização de instâncias GoogleAdsClient, isso pode reduzir ainda mais o número de viagens de ida e volta que a biblioteca de cliente precisa realizar para atualizar os tokens de acesso.

Use SearchStream em vez de Search sempre que possível

A API Google Ads oferece duas maneiras principais de recuperar objetos: GoogleAdsService.Search (que usa paginação) e GoogleAdsService.SearchStream (que usa streaming).

Enquanto Search envia várias solicitações paginadas para baixar um relatório inteiro, SearchStream envia uma única solicitação e inicia uma conexão persistente com a API Google Ads, independente do tamanho do relatório. Ao eliminar o tempo de rede de ida e volta necessário para solicitar cada página individual de uma resposta Search, o SearchStream geralmente oferece melhor desempenho do que a paginação. Consulte o guia de relatórios de streaming para saber quando escolher cada método.

Gerenciar manualmente as atualizações de tokens de acesso

Em determinados ambientes sem estado, como o Google Cloud Functions, talvez não seja possível reutilizar instâncias GoogleAdsClient em várias invocações. Esses ambientes têm práticas recomendadas próprias para persistir e reutilizar dados.

No Google.Ads.GoogleAds v27.0.0 e versões mais recentes, é possível injetar sua própria instância ICredential pré-configurada diretamente em GoogleAdsConfig usando a propriedade Credentials e desativar o armazenamento em cache do canal (UseChannelCache = false).

Se você preferir encapsular a criação de credenciais em uma classe de configuração personalizada (ou estiver usando uma versão anterior da biblioteca), estenda a classe GoogleAdsConfig para realizar suas próprias atualizações de token de acesso da seguinte maneira:

// Create your own config class by extending the GoogleAdsConfig class.
class MyGoogleAdsConfig : GoogleAdsConfig
{
    public MyGoogleAdsConfig() : base()
    {
        // Disable the library's built-in channel caching mechanism.
        UseChannelCache = false;
    }

    protected override ICredential CreateCredentials()
    {
        // Create your own ICredential object here. You may refer to the
        // default implementation of GoogleAdsConfig.CreateCredentials
        // for an example.
    }
}

// Use your own config class when initializing the GoogleAdsClient instance.
MyGoogleAdsConfig myConfig = new MyGoogleAdsConfig();
GoogleAdsClient client = new GoogleAdsClient(myConfig);

Compilar para build de lançamento

Compile o app usando a configuração de lançamento ao implantar no servidor. Ao usar a configuração de depuração, seu app é compilado com informações de depuração simbólica completas e sem otimizações do compilador.

Gerar um perfil do seu app

Crie um perfil do app para uso de CPU e memória e identifique gargalos de desempenho. O Visual Studio oferece ferramentas de diagnóstico para ajudar a criar o perfil do seu app. Também há outras ferramentas comerciais de criação de perfil disponíveis.

Usar métodos assíncronos

A programação assíncrona usando o paradigma async-await ajuda a evitar gargalos de performance e melhora a capacidade de resposta geral do app. A biblioteca .NET do Google Ads gera métodos assíncronos para todos os serviços e métodos RPC.

Cancelamento de métodos assíncronos

Você pode usar o parâmetro callSettings para transmitir um CancellationToken para métodos assíncronos, como SearchStreamAsync:

using CancellationTokenSource cancellationTokenSource =
    new CancellationTokenSource();
cancellationTokenSource.CancelAfter(3000);
CallSettings callSettings =
    CallSettings.FromCancellationToken(cancellationTokenSource.Token);

string query = "SELECT campaign.name FROM campaign";
var request = new SearchGoogleAdsStreamRequest()
{
    CustomerId = customerId.ToString(),
    Query = query,
};

GoogleAdsServiceClient googleAdsService = client.GetService(
    Services.V25.GoogleAdsService);

await googleAdsService.SearchStreamAsync(
    request,
    (SearchGoogleAdsStreamResponse resp) =>
    {
        foreach (GoogleAdsRow googleAdsRow in resp.Results)
        {
            // Process the row.
        }
    },
    callSettings);

Desativar a geração de registros quando possível

A biblioteca .NET do Google Ads desativa o registro em log por padrão e usa uma abordagem de registro em log lenta que oferece melhor performance ao app. Se você ativar a geração de registros durante o desenvolvimento, desative-a no ambiente de produção. Se você precisar monitorar solicitações com falha específicas na produção, siga uma ou mais das etapas abaixo sem afetar negativamente o desempenho do app:

Ative apenas os registros de resumo.
Defina os registros completos para o nível ERROR.
Salve o ID das solicitações com falha para compartilhar com os canais de suporte.

Consulte o guia de geração de registros para saber mais.

Usar a opção ReadyToRun

O .NET moderno permite pré-compilar seus binários para uma plataforma e arquitetura específicas definindo PublishReadyToRun como true e publicando o binário especificando um RuntimeIdentifier válido. Consulte o guia de implantação do ReadyToRun para saber mais.

Usar TieredCompilation

O TieredCompilation (ativado por padrão em versões modernas do .NET, como o .NET 8) permite que o .NET identifique pontos de acesso e melhore o desempenho do ambiente de execução. A compilação em camadas funciona bem com o ReadyToRun porque pode usar a imagem pré-gerada para inicialização rápida e recompilar métodos ativos com otimizações completas. Consulte o guia do TieredCompilation para saber mais.

Ajustar a coleta de lixo (GC)

O .NET oferece dois perfis gerais para coleta de lixo (GC, na sigla em inglês): um perfil de estação de trabalho e um perfil de servidor. Esses dois perfis têm compromissos de desempenho diferentes. Os apps de servidor dedicado que usam a biblioteca .NET do Google Ads geralmente têm uma performance melhor quando executados em um perfil de servidor.

É possível se beneficiar do ajuste das seguintes configurações de GC:

Coleta de lixo do servidor:permite que o tempo de execução do .NET ofereça maior capacidade de processamento a um app da API Google Ads ao operar em várias pilhas e linhas de execução de coleta de lixo. Consulte o guia de GC do servidor para mais detalhes. Para ativar a coleta de lixo do servidor, adicione as seguintes linhas ao arquivo .csproj do app:
```
<PropertyGroup>
  <ServerGarbageCollection>true</ServerGarbageCollection>
</PropertyGroup>
```
Coleta de lixo simultânea:é possível ativar a coleta de lixo simultânea para dar ao GC do .NET uma linha de execução dedicada para coleta de lixo na geração 2. Essa configuração pode ser útil ao processar relatórios grandes. Para ativar a coleta de lixo simultânea, adicione as seguintes linhas ao arquivo .csproj do app:
```
<PropertyGroup>
  <ConcurrentGarbageCollection>true</ConcurrentGarbageCollection>
</PropertyGroup>
```
Manter a coleta de lixo da VM:a RetainVMGarbageCollection configura se os segmentos de memória virtual que precisam ser excluídos são colocados em uma lista de espera para uso futuro ou são liberados de volta para o sistema operacional (SO). Para ativar a retenção de memória virtual, adicione as seguintes linhas ao arquivo .csproj do app:
```
<PropertyGroup>
  <RetainVMGarbageCollection>true</RetainVMGarbageCollection>
</PropertyGroup>
```

É possível ajustar o GC escolhendo uma configuração que equilibre o comportamento da estação de trabalho e do servidor. Todas as configurações relevantes do GC podem ser especificadas no arquivo runtimeconfig.json do app .NET, por variáveis de ambiente ou no App.config.