Upload em massa

Com os scripts do Google AdWords, você pode fazer alterações em massa na sua conta por meio do upload dos dados no formato CSV. É possível fazer o upload dos dados de um arquivo CSV a partir do Google Drive, de uma planilha do Google, de uma planilha do Microsoft Excel ou criar uma solicitação de upload em massa no seu script no tempo de execução. Este guia explica como usar esse recurso nos seus scripts.

Vantagens

O upload em massa proporciona as seguintes vantagens:

  • Uso de novos recursos que talvez ainda não estejam nos scripts do Google AdWords.
  • Facilidade de transformar dados de relatórios ou fazer alterações a entidades.
  • Limites mais altos para quantidades e tempo. Os limites do upload em massa são independentes dos scripts que os acionam.

Quais operações são suportadas?

Atualmente, os scripts do Google AdWords têm suporte para as seguintes operações de upload em massa:

  • Gerenciamento de campanhas: você pode criar, editar ou excluir campanhas, grupos de anúncios, palavras-chave e anúncios de texto usando o upload em massa. Você também pode editar os critérios do grupo de anúncios, os anúncios e os grupos de produtos existentes.
  • Conversões off-line: você pode fazer o upload de conversões off-line para sua conta usando uploads em massa.

Utilização

Criação de upload em massa a partir do Google Drive

A maneira mais simples de usar o recurso de upload em massa é fazer o upload de um arquivo CSV no Google Drive. Em seguida, faça o upload desse arquivo no Google AdWords usando scripts do Google AdWords. Isso pode ser feito da seguinte forma:

var file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
var upload = AdWordsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

Assim será criada uma entrada de visualização de upload em massa na sua conta. Você pode ver isso acessando Operações em massa > Uploads em massa na sua conta.

Clique no link Visualizar para exibir as alterações.

Para aplicar as alterações à sua conta, clique no botão Aplicar alterações, na página de detalhes. Se o arquivo enviado tiver erros ou se você não quiser fazer as alterações, clique no botão Descartar visualização para descartar as alterações.

Depois de verificar se a lógica do seu script funciona corretamente, você pode pular o estágio da visualização e aplicar as alterações diretamente a partir do seu script. Para fazer isso, é necessário chamar o método apply() da instância do upload em massa, em vez do método preview().

Criação de upload em massa de relatórios

O upload em massa também pode ser criado de um relatório do Google AdWords. O snippet de código a seguir pausa todas as campanhas que gastaram mais de US$ 1.000 no mês.

// Run a report to fetch all campaigns that spent more than $1000
// last month.
var query = 'SELECT CampaignId,CampaignName,CampaignStatus,Amount' +
    'FROM CAMPAIGN_PERFORMANCE_REPORT' +
    'WHERE Amount > 1000000000' +
    'DURING THIS_MONTH';
var report = AdWordsApp.report(query);

// Create an upload with the report columns.
var upload = AdWordsApp.bulkUploads().newCsvUpload([
    report.getColumnHeader('CampaignId').getBulkUploadColumnName(),
    report.getColumnHeader('CampaignName').getBulkUploadColumnName(),
    report.getColumnHeader('CampaignStatus').getBulkUploadColumnName()]);
upload.forCampaignManagement();

var rows = report.rows();
while (rows.hasNext()) {
  var row = rows.next();
  // Pause the campaigns.
  row.CampaignStatus = 'paused';

  // Convert the report row into an upload row.
  upload.append(row.formatForUpload());
}

// Use upload.apply() to make changes without previewing.
upload.preview();

Criação de um upload em massa do zero

Você pode criar uma tarefa de upload em massa do zero desta forma:

var columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

var upload = AdWordsApp.bulkUploads().newCsvUpload(columns);

upload.append({
   'Campaign': 'Test Campaign 1',
   'Budget': 2340000,
   'Bid Strategy type': 'cpc',
   'Campaign type': 'Search Only'
});
upload.forCampaignManagement();
upload.preview();

Definição da unidade monetária

Por padrão, os valores monetários em uploads em massa são interpretados como micros. Se você prefere usar valores monetários reais em vez de micros, defina a opção moneyInMicros como false ao criar a tarefa de upload.

var upload = AdWordsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: false});

Definição da localidade do arquivo

Por padrão, o conteúdo do arquivo CSV é interpretado na localidade inglês americano (en_US). Você pode especificar uma localidade diferente usando a opção fileLocale, conforme mostrado abaixo:

var upload = AdWordsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

Ao especificar uma localidade, você pode fornecer os cabeçalhos das colunas seja como localidade en_US ou na localidade especificada na propriedade fileLocale.

Definição do fuso horário

Por padrão, as entradas de horário no arquivo são interpretadas em PST. Você pode especificar um fuso horário diferente usando a opção timeZone, conforme mostrado abaixo:

var upload = AdWordsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "-0800"});

Definir um fuso horário pode ser útil ao fazer o upload de conversões off-line.

Modelos de planilhas para o upload em massa

A maneira mais fácil de ter um modelo de planilha para um upload em massa é a partir da interface do usuário do Google AdWords.

  • Faça login na sua conta do Google AdWords em https://adwords.google.com.br
  • Selecione uma campanha
  • Clique nas guias Palavras-chave, Anúncios, Grupos de anúncios ou Campanhas (dependendo do tipo de edição que você deseja fazer)
  • No menu "Editar", pressione o botão "Fazer o download do relatório"
  • Selecione um formato para sua planilha e clique em Download

É possível recuperar programaticamente essas colunas usando o método AdWordsApp.reports (), conforme a seguir:

var report = AdWordsApp.report("SELECT CampaignName, CampaignStatus " +
    "FROM CAMPAIGN_PERFORMANCE_REPORT " +
    "DURING TODAY");
Logger.log("%s, %s",
    report.getColumnHeader("CampaignName").getBulkUploadColumnName(),
    report.getColumnHeader("CampaignStatus").getBulkUploadColumnName()
);

Consulte a página de referência de entidades de upload em massa para mais detalhes.

Snippets de código

Confira nossa página de snippets de código para ver mais exemplos sobre o uso desse recurso.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.