Les scripts Google Ads vous permettent d'effectuer des modifications groupées dans votre compte en important des données au format CSV. Vous pouvez importer des données à partir d'un fichier CSV depuis Google Drive, d'une feuille de calcul Google Sheets ou Microsoft Excel, ou créer une demande d'importation groupée dans votre script au moment de l'exécution. Ce guide explique comment utiliser cette fonctionnalité dans vos scripts.
Utilisation
Les importations groupées vous permettent d'apporter certains types de modifications qui ne seraient pas directement compatibles avec les scripts Google Ads, comme la gestion des campagnes ou l'importation de conversions hors connexion.
Créer une importation groupée depuis Google Drive
Le moyen le plus simple d'utiliser la fonctionnalité d'importation groupée consiste à importer un fichier CSV dans Google Drive, puis à importer ce fichier dans Google Ads à l'aide de scripts Google Ads :
const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
.next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();
Une entrée de prévisualisation de l'importation groupée est alors créée dans votre compte sous Outils et paramètres > ACTIONS GROUPÉES > Importations.
Cliquez sur le lien Prévisualiser pour afficher les modifications.
Pour appliquer les modifications à votre compte, cliquez sur le bouton Appliquer les modifications sur la page d'informations. Si le fichier importé comporte des erreurs ou si vous ne souhaitez pas apporter les modifications, cliquez sur le bouton Supprimer l'aperçu pour les annuler.
Une fois que vous avez vérifié que votre script fonctionne correctement, vous pouvez ignorer l'étape d'aperçu et appliquer les modifications directement à partir de votre script. Pour ce faire, appelez la méthode apply() de l'instance d'importation groupée au lieu de la méthode preview().
Créer une importation groupée en partant de zéro
Pour créer une tâche d'importation groupée à partir de zéro :
// 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();
Définir l'unité monétaire
Par défaut, les montants dans les importations groupées sont interprétés comme le montant réel de la devise. Si vous préférez utiliser des micros, vous pouvez définir l'option moneyInMicros sur true lorsque vous créez le job d'importation (par exemple, 2,34 € sera saisi sous la forme 2340000).
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{moneyInMicros: true});
Définir les paramètres régionaux du fichier
Par défaut, le contenu du fichier CSV est interprété dans le paramètre régional anglais (États-Unis) (en_US).
Vous pouvez spécifier un autre paramètre régional à l'aide de l'option fileLocale :
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Lorsque vous spécifiez des paramètres régionaux, vous pouvez fournir les en-têtes de colonne dans les paramètres régionaux en_US ou dans ceux que vous spécifiez dans la propriété fileLocale.
Définir le fuseau horaire
Par défaut, les entrées temporelles du fichier sont interprétées dans le fuseau horaire America/Los_Angeles.
Vous pouvez spécifier un autre fuseau horaire à l'aide de l'option timeZone. Spécifiez le fuseau horaire au format de la base de données TZ.
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{timeZone: "America/New_York"});
Définir un fuseau horaire peut être utile lorsque vous importez des conversions hors connexion.
Modèles de feuilles de calcul pour l'importation groupée
Le moyen le plus simple d'obtenir un modèle de feuille de calcul pour une importation groupée consiste à utiliser l'interface utilisateur Google Ads.
- Connectez-vous à votre compte Google Ads.
- Accédez à Outils et paramètres > ACTIONS GROUPÉES > Importations.
- Cliquez sur le bouton + pour lancer un nouvel import.
- Une section s'affiche alors avec différents modèles au choix.
Vous pouvez également télécharger de nombreux modèles différents depuis le Centre d'aide.