Com os scripts do Google Ads, você faz alterações em massa na sua conta ao fazer o upload de 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.
Uso
Com os uploads em massa, você pode fazer determinados tipos de alterações que, de outra forma, não seriam diretamente aceitas pelos scripts do Google Ads, como gerenciar campanhas ou fazer 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 de 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 alterações.
Depois de verificar se o script está funcionando corretamente, você pode pular a fase de visualização e aplicar as mudanças diretamente do script. Para isso, chame o
método
apply()
da instância de upload em massa em vez do
preview()
método.
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 a tarefa de upload (por exemplo, € 2,34 seria inserido 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 inglês dos EUA (en_US).
Você pode especificar uma localidade diferente usando a opção fileLocale:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Ao especificar uma localidade, você pode fornecer os cabeçalhos de coluna na localidade en_US ou na localidade especificada na propriedade fileLocale.
Definir fuso horário
Por padrão, as entradas de hora no arquivo são interpretadas em América/Los_Angeles.
Você pode especificar 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 será exibida com vários modelos para escolher.
Você também pode fazer o download de vários modelos diferentes na Central de Ajuda.