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, d'une feuille de calcul Microsoft Excel ou créer une requête 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 pris en charge par 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 à l'importer 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 d'aperçu d'importation groupée est alors créée dans votre compte sous Outils et paramètres > ACTIONS GROUPÉES > Importations.
Cliquez sur le lien Aperçu 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 effectuer de modifications, cliquez sur le bouton Supprimer l'aperçu pour les supprimer.
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
Vous pouvez créer une tâche d'importation groupée en partant de zéro. Pour ce faire, procédez comme suit:
// 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 monétaires des 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 la tâche d'importation (par exemple, 2,34 € s'affichera 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 la langue anglaise américaine (en_US).
Vous pouvez spécifier une autre langue à l'aide de l'option fileLocale, comme indiqué ci-dessous :
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 fuseau horaire différent à l'aide de l'option timeZone. Spécifiez le fuseau horaire au format de 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 une nouvelle importation.
- Une section contenant différents modèles s'affiche alors.
Vous pouvez également télécharger de nombreux modèles différents à partir du Centre d'aide.