Com os scripts do Google Ads, você pode fazer alterações em massa na sua conta enviando 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, é possível fazer certos tipos de mudanças que, de outra forma, não seriam diretamente compatíveis com os 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 upload de um arquivo CSV no Google Drive e, em seguida, fazer upload desse arquivo no Google Ads usando os 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 mudanças.
Depois de verificar se o script está funcionando corretamente, pule a etapa de visualização
e aplique as mudanças diretamente do script. Para 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 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:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Ao especificar uma localidade, é possível 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 horário no arquivo são interpretadas no fuso horário America/Los_Angeles.
É possível 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 vai aparecer com vários modelos para você escolher.
Também é possível baixar vários modelos diferentes na Central de Ajuda.