Upload em massa

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

Uso

Com os uploads em massa, é possível fazer determinados tipos de alterações que não seriam diretamente compatíveis com os scripts do Google Ads, como o gerenciamento de campanhas ou o 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, em seguida, 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 do upload em massa na sua conta em Ferramentas e configurações > AÇÕES EM MASSA > Uploads.

Clique no link Visualizar para conferir as mudanças.

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 mudanças, clique no botão Descartar visualização para descartar as mudanças.

Depois de verificar se o script está funcionando corretamente, pule a etapa de visualização e aplique as alterações diretamente nele. Para fazer isso, chame o método apply() da instância de upload em massa em vez do método 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 monetários em uploads em massa são interpretados como o valor real da moeda. Se preferir usar micros, defina a opção moneyInMicros como true ao criar o job de upload (por exemplo, € 2,34 seria inserido como 2340.000).

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 inglês americano (en_US). Você pode 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, você pode fornecer os cabeçalhos das colunas na localidade en_US 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. Especifique um fuso horário diferente usando a opção timeZone. Especifique o fuso horário no formato de 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.
• Em seguida, aparecerá uma seção com vários modelos à sua escolha.

Também é possível fazer o download de vários modelos diferentes na Central de Ajuda.