Transfert groupé

Les scripts Google Ads vous permettent d'apporter des modifications groupées à votre compte en important des données au format CSV. Vous pouvez importer des données à partir d'un fichier CSV à partir de Google Drive, d'une feuille de calcul Google ou d'une feuille de calcul 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 autrement pas directement compatibles avec les scripts Google Ads, telles que 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 des 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 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 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 les 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 de prévisualisation et appliquer les modifications directement à partir du 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 entièrement une tâche d'importation groupée, 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 une unité monétaire

Par défaut, les montants des importations groupées sont interprétés comme le montant réel en devise. Si vous préférez utiliser des micros, vous pouvez définir l'option moneyInMicros sur true lors de la création de la tâche d'importation (par exemple, 2,34 € serait saisi sous la forme 2340 000).

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é en anglais américain (en_US). Vous pouvez spécifier des paramètres régionaux différents à 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 en 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 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"});

Il peut être utile de définir un fuseau horaire 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.

Vous pouvez également télécharger de nombreux modèles différents à partir du Centre d'aide.