Gli script Google Ads consentono di apportare modifiche collettive al tuo account caricando i dati in formato CSV. Puoi caricare i dati da un file CSV da Google Drive, un foglio di lavoro Google o Microsoft Excel oppure creare una richiesta di caricamento collettivo nel tuo script in fase di runtime. Questa guida spiega come utilizzare questa funzionalità negli script.
Utilizzo
Con i caricamenti collettivi, puoi apportare determinati tipi di modifiche che altrimenti non sarebbero direttamente supportate dagli script Google Ads, ad esempio la gestione delle campagne o il caricamento di conversioni offline.
Crea un caricamento collettivo da Google Drive
Il modo più semplice per utilizzare la funzionalità di caricamento collettivo consiste nel caricare un file CSV su Google Drive e poi caricare il file in Google Ads utilizzando gli script Google Ads:
const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
.next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();
Viene creata una voce di anteprima del caricamento collettivo nel tuo account in Strumenti e impostazioni > AZIONI COLLETTIVE > Caricamenti.
Fai clic sul link Anteprima per visualizzare le modifiche.
Per applicare le modifiche al tuo account, fai clic sul pulsante Applica modifiche nella pagina dei dettagli. Se il file caricato contiene errori o se non vuoi apportare modifiche, fai clic sul pulsante Ignora anteprima per ignorare le modifiche.
Dopo aver verificato il corretto funzionamento dello script, puoi saltare la fase di anteprima e applicare le modifiche direttamente dallo script. A questo scopo,
chiama il metodo
apply()
dell'istanza di caricamento collettivo anziché il
metodo
preview().
Crea un caricamento collettivo da zero
Puoi creare un job di caricamento collettivo da zero nel seguente modo:
// 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();
Imposta unità monetaria
Per impostazione predefinita, gli importi in denaro nei caricamenti collettivi vengono interpretati come l'importo effettivo in valuta. Se preferisci utilizzare i micro, puoi impostare l'opzione moneyInMicros su true durante la creazione del job di caricamento (ad esempio, 2,34 € verrebbe inserito come 2340000).
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{moneyInMicros: true});
Imposta le impostazioni internazionali del file
Per impostazione predefinita, i contenuti del file CSV vengono interpretati in inglese americano (en_US).
Puoi specificare impostazioni internazionali diverse utilizzando l'opzione fileLocale, come mostrato di seguito:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Quando specifichi un'impostazione internazionale, puoi fornire le intestazioni di colonna in en_US
o nelle impostazioni internazionali specificate nella proprietà fileLocale.
Imposta fuso orario
Per impostazione predefinita, i valori relativi all'ora nel file vengono interpretati in America/Los_Angeles. Puoi specificare un fuso orario diverso utilizzando l'opzione timeZone. Specifica il fuso orario nel formato di database TZ.
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{timeZone: "America/New_York"});
L'impostazione di un fuso orario può essere utile durante il caricamento delle conversioni offline.
Modelli di fogli di lavoro per il caricamento collettivo
Il modo più semplice per ottenere un modello di foglio di lavoro per un caricamento collettivo è tramite l'interfaccia utente di Google Ads.
- Accedi all'account Google Ads.
- Vai a Strumenti e impostazioni > AZIONI COLLETTIVE > Caricamenti.
- Fai clic sul pulsante + per avviare un nuovo caricamento.
- Viene visualizzata una sezione con una serie di modelli tra cui scegliere.
Puoi anche scaricare molti modelli diversi dal Centro assistenza.