Recursos em uma campanha de maior desempenho

As campanhas de maior desempenho têm algumas características únicas em relação aos recursos.

  1. Há um número mínimo obrigatório de recursos de diferentes tipos.
  2. Os recursos são agrupados em uma coleção chamada AssetGroup, que é exclusiva das campanhas de maior desempenho.
  3. Os recursos são gerados automaticamente pelo aprendizado de máquina.

Garantir que os requisitos mínimos de recursos sejam atendidos

Cada campanha de maior desempenho exige um conjunto mínimo inicial de recursos. Podem ser recursos existentes usados em outras campanhas ou novos recursos especificamente para uma campanha de maior desempenho.

Tipo de recurso Tipo de campo Especificações Mín. Máx.
TEXT HEADLINE Até 30 caracteres, pelo menos um com até 15 caracteres. 3 5
LONG_HEADLINE Até 90 caracteres 1 5
DESCRIÇÃO Até 90 caracteres. Pelo menos um com até 60 caracteres. 2 5
BUSINESS_NAME No máximo 25 caracteres 1 1
IMAGE MARKETING_IMAGEM Paisagem (1,91:1) 1.200 x 628 (recomendado); 600 x 314 (mínimo); arquivo de até 5.120 KB 1 20
Marketplace_IMAGEM_MERCADO (1:1) 1.200 x 1.200 (recomendado), 300 x 300 (mínimo), arquivo de até 5.120 KB 1 20
PORTRAIT_MARKETING_IMAGEM (4:5) 960 x 1.200 (recomendado); 480 x 600 (mínimo) 0 20
LOGOTIPO (1:1) 1.200 x 1.200 (recomendado); 128 x 128 (mínimo); arquivo de até 5.120 KB 1 5
LANDSCAPE_LOGOTIPO (4:1) 1.200 x 300 (recomendado), 512 x 128 (mínimo), arquivo de até 5.120 KB 0 5
YOUTUBE_VIDEO YOUTUBE_VIDEO Horizontal, vertical ou quadrado; >=10 segundos de duração 0 5
LIGAR_TO_ACTION LIGAR_TO_ACTION_SELECTION Automatizada por padrão ou selecionada em uma lista 0 1
MEDIA_BUNDLE MEDIA_BUNDLE < 150 KB 0 1

Os recursos repetidos (HEADLINE, DESCRIPTION) precisam ser criados em uma solicitação separada antes de criar a campanha.

O snippet de código a seguir ilustra a criação dos recursos repetidos necessários em uma nova solicitação:

Java

/** Creates multiple text assets and returns the list of resource names. */
private List<String> createMultipleTextAssets(
    GoogleAdsClient googleAdsClient, long customerId, List<String> texts) {
  List<MutateOperation> mutateOperations = new ArrayList<>();
  for (String text : texts) {
    Asset asset = Asset.newBuilder().setTextAsset(TextAsset.newBuilder().setText(text)).build();
    AssetOperation assetOperation = AssetOperation.newBuilder().setCreate(asset).build();
    mutateOperations.add(MutateOperation.newBuilder().setAssetOperation(assetOperation).build());
  }

  List<String> assetResourceNames = new ArrayList<>();
  // Creates the service client.
  try (GoogleAdsServiceClient googleAdsServiceClient =
      googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
    // Sends the operations in a single Mutate request.
    MutateGoogleAdsResponse response =
        googleAdsServiceClient.mutate(Long.toString(customerId), mutateOperations);
    for (MutateOperationResponse result : response.getMutateOperationResponsesList()) {
      if (result.hasAssetResult()) {
        assetResourceNames.add(result.getAssetResult().getResourceName());
      }
    }
    printResponseDetails(response);
  }
  return assetResourceNames;
}
      

C#

/// <summary>
/// Creates multiple text assets and returns the list of resource names.
/// </summary>
/// <param name="client">The Google Ads Client.</param>
/// <param name="customerId">The customer's ID.</param>
/// <param name="texts">The texts to add.</param>
/// <returns>A list of asset resource names.</returns>
private List<string> CreateMultipleTextAssets(
    GoogleAdsClient client,
    long customerId,
    string[] texts)
{
    // Get the GoogleAdsService.
    GoogleAdsServiceClient googleAdsServiceClient =
        client.GetService(Services.V11.GoogleAdsService);

    MutateGoogleAdsRequest request = new MutateGoogleAdsRequest()
    {
        CustomerId = customerId.ToString()
    };

    foreach (string text in texts)
    {
        request.MutateOperations.Add(
            new MutateOperation()
            {
                AssetOperation = new AssetOperation()
                {
                    Create = new Asset()
                    {
                        TextAsset = new TextAsset()
                        {
                            Text = text
                        }
                    }
                }
            }
        );
    }

    // Send the operations in a single Mutate request.
    MutateGoogleAdsResponse response = googleAdsServiceClient.Mutate(request);

    List<string> assetResourceNames = new List<string>();

    foreach (MutateOperationResponse operationResponse in response.MutateOperationResponses)
    {
        MutateAssetResult assetResult = operationResponse.AssetResult;
        assetResourceNames.Add(assetResult.ResourceName);
    }

    PrintResponseDetails(response);

    return assetResourceNames;
}

      

PHP

private static function createMultipleTextAssets(
    GoogleAdsClient $googleAdsClient,
    int $customerId,
    array $texts
): array {
    // Here again, we use the GoogleAdService to create multiple text assets in a single
    // request.
    $operations = [];
    foreach ($texts as $text) {
        // Creates a mutate operation for a text asset.
        $operations[] = new MutateOperation([
            'asset_operation' => new AssetOperation([
                'create' => new Asset(['text_asset' => new TextAsset(['text' => $text])])
            ])
        ]);
    }

    // Issues a mutate request to add all assets.
    $googleAdsService = $googleAdsClient->getGoogleAdsServiceClient();
    /** @var MutateGoogleAdsResponse $mutateGoogleAdsResponse */
    $mutateGoogleAdsResponse = $googleAdsService->mutate($customerId, $operations);

    $assetResourceNames = [];
    foreach ($mutateGoogleAdsResponse->getMutateOperationResponses() as $response) {
        /** @var MutateOperationResponse $response */
        $assetResourceNames[] = $response->getAssetResult()->getResourceName();
    }
    self::printResponseDetails($mutateGoogleAdsResponse);

    return $assetResourceNames;
}
      

Python

def create_multiple_text_assets(client, customer_id, texts):
    """Creates multiple text assets and returns the list of resource names.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        texts: a list of strings, each of which will be used to create a text
          asset.

    Returns:
        asset_resource_names: a list of asset resource names.
    """
    # Here again we use the GoogleAdService to create multiple text
    # assets in a single request.
    googleads_service = client.get_service("GoogleAdsService")

    operations = []
    for text in texts:
        mutate_operation = client.get_type("MutateOperation")
        asset = mutate_operation.asset_operation.create
        asset.text_asset.text = text
        operations.append(mutate_operation)

    # Send the operations in a single Mutate request.
    response = googleads_service.mutate(
        customer_id=customer_id,
        mutate_operations=operations,
    )
    asset_resource_names = []
    for result in response.mutate_operation_responses:
        if result._pb.HasField("asset_result"):
            asset_resource_names.append(result.asset_result.resource_name)
    print_response_details(response)
    return asset_resource_names
      

Ruby

# Creates multiple text assets and returns the list of resource names.
def create_multiple_text_assets(client, customer_id, texts)
  operations = texts.map do |text|
    client.operation.mutate do |m|
      m.asset_operation = client.operation.create_resource.asset do |asset|
        asset.text_asset = client.resource.text_asset do |text_asset|
          text_asset.text = text
        end
      end
    end
  end

  # Send the operations in a single Mutate request.
  response = client.service.google_ads.mutate(
    customer_id: customer_id,
    mutate_operations: operations,
  )

  asset_resource_names = []
  response.mutate_operation_responses.each do |result|
    if result.asset_result
      asset_resource_names.append(result.asset_result.resource_name)
    end
  end
  print_response_details(response)
  asset_resource_names
end
      

Perl

sub create_multiple_text_assets {
  my ($api_client, $customer_id, $texts) = @_;

  # Here again we use the GoogleAdService to create multiple text assets in a
  # single request.
  my $operations = [];
  foreach my $text (@$texts) {
    # Create a mutate operation for a text asset.
    push @$operations,
      Google::Ads::GoogleAds::V11::Services::GoogleAdsService::MutateOperation
      ->new({
        assetOperation =>
          Google::Ads::GoogleAds::V11::Services::AssetService::AssetOperation->
          new({
            create => Google::Ads::GoogleAds::V11::Resources::Asset->new({
                textAsset =>
                  Google::Ads::GoogleAds::V11::Common::TextAsset->new({
                    text => $text
                  })})})});
  }

  # Issue a mutate request to add all assets.
  my $mutate_google_ads_response = $api_client->GoogleAdsService()->mutate({
    customerId       => $customer_id,
    mutateOperations => $operations
  });

  my $asset_resource_names = [];
  foreach
    my $response (@{$mutate_google_ads_response->{mutateOperationResponses}})
  {
    push @$asset_resource_names, $response->{assetResult}{resourceName};
  }
  print_response_details($mutate_google_ads_response);

  return $asset_resource_names;
}
      

Grupos de recursos

Cada campanha requer pelo menos um grupo de recursos. Os recursos são misturados e combinados automaticamente com base no canal do Google Ads (YouTube, Gmail, Pesquisa etc.) em que seu anúncio é veiculado.

Recursos gerados automaticamente

A automação do Google usando machine learning gera outros recursos, conforme necessário, para abranger todos os canais relevantes.

Se você não adicionar um vídeo ao grupo de recursos de maior desempenho, um ou mais recursos de vídeo poderão ser gerados com base nos recursos do grupo. Se você não quiser mais que vídeos gerados automaticamente sejam veiculados na sua campanha de maior desempenho, faça upload do seu próprio vídeo personalizado, e os vídeos gerados automaticamente deixarão de ser veiculados.