> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-promotions/upload-product-promotion-files.md).

# Téléverser des fichiers de promotion de produits

La fonctionnalité *Promotions de produits* vous permet de partager des offres spéciales et des promotions avec vos partenaires. Ces offres apparaissent dans les flux de produits des partenaires, les API de produits et la marketplace de produits d’impact.com, où une étiquette *Offre spéciale* s’affiche directement sur la vignette du produit dans les résultats de recherche.

{% hint style="warning" %}
**Important :** Vous devez disposer d’un catalogue de produits actif avant de commencer. Pour obtenir de l’aide afin de créer votre premier fichier de produits, consultez [Ajouter des catalogues de produits](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

#### Importer un fichier de promotion

Utilisez le [modèle de fichier de promotion](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) pour créer votre fichier. Le même format de fichier fonctionne pour les deux méthodes d’importation.

{% tabs %}
{% tab title="Téléversement direct" %}

1. Dans le menu de navigation à gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Contenu → Produits →** [**Promotions de produits**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. Dans le coin supérieur droit, sélectionnez **Importer un fichier de promotion**.
3. Saisissez le **Nom du fichier de promotion**.
4. Sélectionnez la méthode ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Bouton radio]** **Importation directe** .
5. Sélectionnez le **format de fichier**.
   * impact.com prend uniquement en charge les fichiers *Google Merchant Center (format TXT)* c’est-à-dire `.txt` et *Google Merchant Center (format CSV)* c’est-à-dire `.csv` .
   * Consultez la *référence des champs du flux de promotions de produits* ci-dessous pour en savoir plus sur ces champs.
6. Sélectionnez **Choisir un fichier**.
   * Recherchez sur votre ordinateur le fichier que vous souhaitez importer.
7. Sélectionnez la **langue** et **Enregistrer**.
   {% endtab %}

{% tab title="Récupérer depuis une URL" %}
Cette option permet de récupérer un fichier depuis un serveur FTP/SFTP ou une URL HTTP/HTTPS afin de disposer de données de promotion à jour.

1. Dans le menu de navigation à gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Contenu → Produits →** [**Promotions de produits**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. Dans le coin supérieur droit, sélectionnez **Importer un fichier de promotion**.
3. Saisissez le **Nom du fichier de promotion**.
4. Sélectionnez la méthode ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Bouton radio]** **Récupérer depuis une URL** d’importation.
5. Sélectionnez le **format de fichier**.
   * impact.com prend uniquement en charge les fichiers *Google Merchant Center (format TXT)* c’est-à-dire `.txt` et *Google Merchant Center (format CSV)* c’est-à-dire `.csv` .
   * Consultez la *référence des champs du flux de promotions de produits* ci-dessous pour en savoir plus sur ces champs.
6. Saisissez le **nom** de votre fichier sous *Nom du fichier à téléverser*.
7. Saisissez l’ **URL d’extraction** qui pointe vers le répertoire contenant votre fichier de données de promotions.
   * Cette URL peut être une URL FTP ou HTTPS. Par exemple, `ftp://ftp.acme.com` ou `https://acme.com/anvil_promotions/anvil.txt`
8. Sélectionnez la **Fréquence d’extraction** à laquelle impact.com doit récupérer le fichier :
   * Tous les jours
   * Toutes les 8 heures
   * Toutes les 4 heures
   * Toutes les 2 heures
9. Sélectionnez l’ **Heure d’extraction** à laquelle impact.com doit récupérer le fichier.
   * Les options affichées sont en GMT -05:00, heure de l’Est.
10. Sélectionnez votre **Fuseau horaire**.
11. Sélectionnez la **langue** et **Enregistrer**.
    {% endtab %}
    {% endtabs %}

<details>

<summary>Référence des champs du flux de promotions de produits</summary>

| Champs attendus                                   | Obligatoire ? | Description                                                                                                   | Format                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID `[promotion_id]`                               | Oui           | L’ID unique de chaque promotion.                                                                              | L’ID est sensible à la casse, peut contenir jusqu’à 50 caractères et ne peut pas contenir d’espaces ni de symboles. Par exemple, `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Applicabilité `[product_applicability]`           | Oui           | Cet attribut indique si la promotion s’applique à tous les produits ou uniquement à des produits spécifiques. | <p>Valeurs prises en charge :</p><p>• <code>all\_products</code></p><p>•<code>specific\_products</code></p><p>impact.com peut uniquement associer les promotions de votre fichier de <a href="https://support.google.com/merchants/answer/2906014?hl=en">flux de promotions Google</a> à des produits spécifiques de votre <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md">catalogue de produits</a> si votre catalogue de produits comprend <code>promotion\_id</code>. Vous ne pouvez pas utiliser la valeur <code>specific\_products</code> à moins que votre catalogue de produits contienne des ID de promotion. Consultez <a href="#link-promotions-to-specific-products">Associer des promotions à des produits spécifiques</a>.</p> |
| Description `[long_title]`                        | Oui           | Le titre complet de chaque promotion.                                                                         | La longueur maximale du titre est de 60 caractères. Par exemple, `Free mug with purchase`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Période de validité `[promotion_effective_dates]` | Oui           | La période de la promotion.                                                                                   | <p>• La date de <strong>début</strong> et la date de <strong>fin</strong> sont séparées par une barre oblique (/).</p><p>• Le format de date est (AAAA-MM-JJ), suivi de la lettre « T », de l’heure à laquelle la promotion commence ou se termine et d’une indication du fuseau horaire de la promotion.</p><p>• Exemple : <code>2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Affichage `[promotion_display_dates]`             | Non           | Cet attribut indique la date et la période pendant lesquelles la promotion sera active.                       | Les dates de **début** et de **fin** sont séparées par une barre oblique (/), par exemple, `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Canal `[redemption_channel]`                      | Oui           | Cet attribut indique si la promotion est valable en ligne ou en magasin.                                      | <p>Valeurs prises en charge :</p><p>• <code>online</code></p><p>• <code>in\_store</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Type de code de l’offre `[offer_type]`            | Oui           | Cet attribut indique si les clients doivent utiliser un code de coupon pour profiter de l’offre.              | <p>Valeurs prises en charge :</p><p>• <code>no\_code</code></p><p>• <code>generic\_code</code></p><p><strong>Important :</strong> Si la valeur de cet attribut est <code>generic\_code</code>, alors <code>generic\_redemption\_code</code> est obligatoire.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Code de l’offre `[generic_redemption_code]`       | Non           | Cet attribut indique le code utilisable en ligne pour profiter de la promotion.                               | La longueur maximale est de 20 caractères. Par exemple, `EXTRA20`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Destination `[promotion_destination]`             | Non           | Cet attribut indique le format de chaque promotion.                                                           | <p>Valeurs prises en charge :</p><p>• <code>Shopping\_ads</code></p><p>•<code>Buy\_on\_Google\_listings</code></p><p>• <code>Free\_listings</code></p><p>Pour envoyer votre promotion vers une ou plusieurs destinations, indiquez chaque valeur de destination dans une colonne distincte.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

</details>

#### Associer des promotions à des produits spécifiques

Si une promotion ne s'applique qu'à certains de vos produits, définissez `product_applicability` sur `specific_products` dans votre fichier de promotions. Ajoutez ensuite l'ID de la promotion à chaque produit admissible de votre catalogue de produits afin qu'impact.com puisse les associer. Si la promotion s'applique à tous vos produits, utilisez `all_products` et ignorez ces étapes.

1. Dans votre fichier de promotions, attribuez à la promotion un identifiant unique `promotion_id`, par exemple `103330482`.
2. Dans le catalogue de produits de Google Merchant Center, ajoutez un champ `promotion_id` .
   * Consultez [Formats de fichiers pour les catalogues de produits](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/file-formats-for-product-catalogs.md) pour connaître les types de fichiers Google Merchant Center pris en charge par impact.com.
3. Pour chaque produit concerné par la promotion, saisissez la même valeur `promotion_id` .
   * Les valeurs doivent correspondre exactement, y compris les majuscules et les minuscules.
4. Importez votre catalogue de produits mis à jour et votre fichier de promotions.
   * Pour obtenir de l'aide, consultez [Ajouter des catalogues de produits](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md) et [Importer un fichier de promotions](#upload-a-promotion-file).
   * La promotion s'applique uniquement aux produits dont la valeur `promotion_id` correspond dans votre catalogue de produits.

{% hint style="info" %}
**Exemple :** La promotion *Mug gratuit à l'achat* s'applique aux grains de café et à la cafetière à piston, mais pas à la bouilloire. Les autres colonnes obligatoires sont omises par souci de clarté.
{% endhint %}

Fichier de promotions :

| promotion\_id | product\_applicability | long\_title           |
| ------------- | ---------------------- | --------------------- |
| 103330482     | specific\_products     | Mug gratuit à l'achat |

Catalogue de produits :

| id       | title                | promotion\_id |
| -------- | -------------------- | ------------- |
| SKU-1001 | Grains de café, 1 kg | 103330482     |
| SKU-1002 | Cafetière à piston   | 103330482     |
| SKU-1003 | Bouilloire à thé     |               |

#### Résoudre les erreurs et les avertissements

<details>

<summary>Afficher les erreurs et les avertissements</summary>

Sur l’écran *Promotions de produits* dans la colonne *État* sélectionnez *erreurs* ou *avertissements* pour afficher plus d’informations sur l’erreur, comme son type ou son message. Consultez [Gérer vos fichiers de promotion de produits](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) pour en savoir plus sur le *État* de votre fichier de promotion.

</details>

<details>

<summary>Rechercher et filtrer les erreurs</summary>

Vous pouvez accéder aux *erreurs* et *avertissements* du fichier, puis utiliser le champ de recherche et les filtres pour parcourir toutes les erreurs du fichier de promotion importé.

*Type d’erreur* Les filtres incluent :

* Tous
* Avertissement
* Erreur
* Dupliquer

</details>

<details>

<summary>Messages d’erreur et d’avertissement</summary>

| Message d’erreur                                                          | Explication                                                                               |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| Champ(s) obligatoire(s) manquant(s) :{Required field}                     | Un ou plusieurs champs obligatoires sont absents du fichier importé.                      |
| Enregistrements ignorés en raison d’une date d’entrée en vigueur dépassée | La date de fin d’application de la promotion est passée et cet enregistrement est ignoré. |

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-promotions/upload-product-promotion-files.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
