Upload em massa

Com os scripts do Google Ads, você pode fazer com que mudanças na sua conta fazer o upload de dados no formato CSV. É possível fazer o upload de dados de um arquivo CSV do Google Drive, uma planilha do Google, uma planilha do Microsoft Excel ou crie um arquivo em massa de upload no script no ambiente de execução. Este guia explica como usar esse recurso nos seus scripts.

Uso

Com os uploads em massa, é possível fazer alguns tipos de mudanças que não teriam suporte direto dos scripts do Google Ads, como gerenciar campanhas ou fazer upload de conversões off-line.

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 e fazer o upload desse arquivo no Google Ads usando scripts do Google Ads:

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

Isso cria uma entrada de visualização de upload em massa na sua conta em Ferramentas e configurações > AÇÕES EM MASSA > Uploads.

Clique no link Visualizar para conferir 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 alterações e, em seguida, clique no botão Descartar visualização para descartá-las.

Depois de verificar se o script está funcionando corretamente, você pode pular a etapa de visualização e aplicar as mudanças diretamente no script. Isso pode ser feito chamando apply() da instância do upload em massa em vez da preview() .

Criação de um upload em massa do zero

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

// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

const upload = AdsApp.bulkUploads().newCsvUpload(columns);

// Call append once for each row you'd like to upload
upload.append({
   "Campaign": "Test Campaign 1",
   "Budget": 2.34,
   "Bid Strategy type": "cpc",
   "Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();

Definição da unidade monetária

Por padrão, os valores em dinheiro em uploads em massa são interpretados como o valor real da moeda. Se você preferir usar micros, defina a opção moneyInMicros como true ao criar o job de upload. Por exemplo, "€2,34" seria digitado como 2340000.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

Definição da localidade do arquivo

Por padrão, o conteúdo do arquivo CSV é interpretado na localidade de inglês dos EUA (en_US). É possível especificar uma localidade diferente usando a opção fileLocale, conforme mostrado abaixo:

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

Ao especificar uma localidade, é possível fornecer os cabeçalhos das colunas em en_US. localidade ou na localidade especificada na propriedade fileLocale.

Definir fuso horário

Por padrão, as entradas de horário no arquivo são interpretadas em America/Los_Angeles. Você pode especifique um fuso horário diferente usando a opção timeZone. Especifique o fuso horário no formato do banco de dados TZ.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

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

  • Faça login na sua conta do Google Ads.
  • Acesse Ferramentas e configurações > AÇÕES EM MASSA > Uploads.
  • Clique no botão + para iniciar um novo upload.
  • Uma seção vai aparecer com vários modelos para você escolher.

Você também pode fazer o download de vários modelos diferentes na Central de Ajuda.