> 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/de/what-would-you-like-to-learn-about/platform-features/product-promotions/upload-product-promotion-files.md).

# Dateien für Produktaktionen hochladen

Die Funktion *Produktaktionen* ermöglicht es Ihnen, Sonderangebote und Aktionen mit Partnern zu teilen. Diese Angebote erscheinen in Produktfeeds und Produkt-APIs der Partner sowie auf dem Produktmarktplatz von impact.com. Dort wird in den Suchergebnissen direkt auf der Produktkachel ein *Sonderangebot* -Label angezeigt.

{% hint style="warning" %}
**Wichtig:** Sie benötigen einen aktiven Produktkatalog, bevor Sie beginnen können. Hilfe beim ersten Hochladen von Produkten finden Sie unter [Produktkataloge hinzufügen](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).
{% endhint %}

#### Aktionsdatei hochladen

Verwenden Sie die [Vorlage für Aktionsdateien](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) , um Ihre Datei zu erstellen. Dasselbe Dateiformat funktioniert für beide Upload-Methoden.

{% tabs %}
{% tab title="Direkter Upload" %}

1. Wählen Sie im linken Navigationsmenü ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Interagieren] → Inhalte → Produkte →** [**Produktaktionen**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. Wählen Sie oben rechts **Aktionsdatei hochladen**.
3. Geben Sie den **Namen der Aktionsdatei ein**.
4. Wählen Sie über die ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Optionsschaltfläche]** **Direkter Upload** als Methode aus.
5. Wählen Sie für die Datei das **Format**.
   * impact.com unterstützt nur Dateien im Format *Google Merchant Center (TXT-Format)* , also `.txt` , und *Google Merchant Center (CSV-Format)* , also `.csv` .
   * Weitere Informationen zu diesen Feldern finden Sie in der *Feldreferenz für Produktaktionsfeeds* weiter unten.
6. Wählen Sie **Datei auswählen**.
   * Suchen Sie auf Ihrem Computer die Datei, die Sie hochladen möchten.
7. Wählen Sie Ihre bevorzugte **Sprache** und anschließend **Speichern**.
   {% endtab %}

{% tab title="Von URL abrufen" %}
Mit dieser Option können Sie eine Datei von einem FTP-/SFTP-Server oder einer HTTP-/HTTPS-URL abrufen, um aktuelle Aktionsdaten sicherzustellen.

1. Wählen Sie im linken Navigationsmenü ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Interagieren] → Inhalte → Produkte →** [**Produktaktionen**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-product-promotion-flow.ihtml).
2. Wählen Sie oben rechts **Aktionsdatei hochladen**.
3. Geben Sie den **Namen der Aktionsdatei ein**.
4. Wählen Sie über die ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Optionsschaltfläche]** **Von URL abrufen** als Upload-Methode aus.
5. Wählen Sie für die Datei das **Format**.
   * impact.com unterstützt nur Dateien im Format *Google Merchant Center (TXT-Format)* , also `.txt` , und *Google Merchant Center (CSV-Format)* , also `.csv` .
   * Weitere Informationen zu diesen Feldern finden Sie in der *Feldreferenz für Produktaktionsfeeds* weiter unten.
6. Geben Sie **Name** deiner Datei unter *Dateiname der Upload-Datei*.
7. Gib die **Abruf-URL** ein, die auf das Verzeichnis verweist, in dem sich deine Werbedatendatei befindet.
   * Diese URL kann eine FTP- oder HTTPS-URL sein. Z. B. `ftp://ftp.acme.com` oder `https://acme.com/anvil_promotions/anvil.txt`
8. Wähle die **Abrufhäufigkeit** aus, mit der impact.com die Datei abrufen soll:
   * Täglich
   * Alle 8 Stunden
   * Alle 4 Stunden
   * Alle 2 Stunden
9. Wähle die **Abrufzeit** aus, zu der impact.com die Datei abrufen soll.
   * Die angezeigten Optionen entsprechen GMT -05:00 Eastern Time.
10. Wähle deine **Zeitzone**.
11. Wählen Sie Ihre bevorzugte **Sprache** und anschließend **Speichern**.
    {% endtab %}
    {% endtabs %}

<details>

<summary>Referenz zu den Feldern des Produktangebots-Feeds</summary>

| Erwartete Felder                                  | Erforderlich? | Beschreibung                                                                                               | Format                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID `[promotion_id]`                               | Ja            | Die eindeutige ID jedes Angebots.                                                                          | Bei der ID wird zwischen Groß- und Kleinschreibung unterschieden. Sie darf bis zu 50 Zeichen lang sein und keine Leerzeichen oder Symbole enthalten, z. B. `103330482`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Gültigkeit `[product_applicability]`              | Ja            | Dieses Attribut gibt an, ob das Angebot für alle Produkte oder nur für bestimmte Produkte gilt.            | <p>Unterstützte Werte:</p><p>• <code>all\_products</code></p><p>•<code>specific\_products</code></p><p>impact.com kann Angebote in deiner <a href="https://support.google.com/merchants/answer/2906014?hl=en">Google-Angebotsfeed-Datei</a> nur bestimmten Produkten in deinem <a href="https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md">Produktkatalog</a> zuordnen, wenn dein Produktkatalog <code>promotion\_id</code>enthält. Du kannst den Wert <code>specific\_products</code> nur verwenden, wenn dein Produktkatalog Angebots-IDs enthält. Siehe <a href="#link-promotions-to-specific-products">Angebote bestimmten Produkten zuordnen</a>.</p> |
| Beschreibung `[long_title]`                       | Ja            | Der vollständige Titel jeder Promotion.                                                                    | Der Titel darf maximal 60 Zeichen lang sein. Z. B. `Free mug with purchase`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Gültigkeitszeitraum `[promotion_effective_dates]` | Ja            | Der Zeitraum der Promotion.                                                                                | <p>• Das <strong>Startdatum</strong> und <strong>Enddatum</strong> werden durch einen Schrägstrich (/) getrennt.</p><p>• Das Datumsformat lautet (YYYY-MM-DD), gefolgt vom Buchstaben „T“, der Tageszeit, zu der der Verkauf beginnt oder endet, und einer Angabe der Zeitzone des Verkaufs.</p><p>• Beispiel: <code>2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00</code></p>                                                                                                                                                                                                                                                                                                                                                                |
| Anzeigezeitraum `[promotion_display_dates]`       | Nein          | Dieses Attribut gibt das Datum und den Zeitraum an, in dem die Promotion aktiv ist.                        | Das **Startdatum** und **Enddatum** werden durch einen Schrägstrich (/) getrennt, z. B. `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Kanal `[redemption_channel]`                      | Ja            | Dieses Attribut gibt an, ob die Promotion online oder im Geschäft gültig ist.                              | <p>Unterstützte Werte:</p><p>• <code>online</code></p><p>• <code>in\_store</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Angebotscode-Typ `[offer_type]`                   | Ja            | Dieses Attribut gibt an, ob Kundinnen und Kunden einen Gutscheincode benötigen, um das Angebot einzulösen. | <p>Unterstützte Werte:</p><p>• <code>no\_code</code></p><p>• <code>generic\_code</code></p><p><strong>Wichtig:</strong> Wenn der Wert dieses Attributs <code>generic\_code</code>lautet, ist <code>generic\_redemption\_code</code> erforderlich.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Angebotscode `[generic_redemption_code]`          | Nein          | Dieses Attribut gibt den Code an, mit dem die Promotion online eingelöst werden kann.                      | Die maximale Länge beträgt 20 Zeichen, z. B. `EXTRA20`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Ziel `[promotion_destination]`                    | Nein          | Dieses Attribut gibt das Format jeder Promotion an.                                                        | <p>Unterstützte Werte:</p><p>• <code>Shopping\_ads</code></p><p>•<code>Buy\_on\_Google\_listings</code></p><p>• <code>Free\_listings</code></p><p>Um Ihre Promotion an ein oder mehrere Ziele zu übermitteln, geben Sie jeden Zielwert in einer separaten Spalte an.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

</details>

#### Promotionen mit bestimmten Produkten verknüpfen

Wenn eine Promotion nur für einige Ihrer Produkte gilt, setzen Sie `product_applicability` in Ihrer Promotionsdatei auf `specific_products` Fügen Sie dann die ID der Promotion zu jedem berechtigten Produkt in Ihrem Produktkatalog hinzu, damit impact.com sie zuordnen kann. Wenn die Promotion für alle Ihre Produkte gilt, verwenden Sie `all_products` und überspringen Sie diese Schritte.

1. Weisen Sie der Promotion in Ihrer Promotionsdatei eine eindeutige `promotion_id`, z. B. `103330482`.
2. Fügen Sie in Ihrem Google Merchant Center-Produktkatalog ein Feld `promotion_id` hinzu.
   * Weitere Informationen finden Sie unter [Dateiformate für Produktkataloge](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/product-catalogs/file-formats-for-product-catalogs.md) Dort erfahren Sie, welche Dateitypen für Google Merchant Center von impact.com unterstützt werden.
3. Geben Sie für jedes Produkt, für das die Promotion gilt, denselben Wert für `promotion_id` ein.
   * Die Werte müssen exakt übereinstimmen, einschließlich Groß- und Kleinschreibung.
4. Laden Sie Ihren aktualisierten Produktkatalog und Ihre Promotionsdatei hoch.
   * Hilfe finden Sie unter [Produktkataloge hinzufügen](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md) und [Promotionsdatei hochladen](#upload-a-promotion-file).
   * Die Promotion gilt nur für Produkte, deren `promotion_id` mit dem Wert in Ihrem Produktkatalog übereinstimmt.

{% hint style="info" %}
**Beispiel:** Die Promotion *Gratisbecher beim Kauf* gilt für die Kaffeebohnen und die French Press, nicht aber für den Teekessel. Andere Pflichtspalten wurden der Übersichtlichkeit halber weggelassen.
{% endhint %}

Promotionsdatei:

| promotion\_id | product\_applicability | long\_title            |
| ------------- | ---------------------- | ---------------------- |
| 103330482     | specific\_products     | Gratisbecher beim Kauf |

Produktkatalog:

| id       | title              | promotion\_id |
| -------- | ------------------ | ------------- |
| SKU-1001 | Kaffeebohnen, 1 kg | 103330482     |
| SKU-1002 | French Press       | 103330482     |
| SKU-1003 | Teekessel          |               |

#### Fehler- und Warnmeldungen beheben

<details>

<summary>Fehler und Warnungen anzeigen</summary>

Wählen Sie auf dem Bildschirm *Produktaktionen* in der Spalte *Status* die Option *Fehler* oder *Warnungen* aus, um weitere Informationen zum Fehler anzuzeigen, beispielsweise den Fehlertyp oder die Fehlermeldung. Weitere Informationen finden Sie unter [Produktaktionsdateien verwalten](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/product-promotions/manage-your-product-promotion-files.md) Weitere Informationen zum *Status* Ihrer Aktionsdatei.

</details>

<details>

<summary>Fehler suchen und filtern</summary>

Sie können in der Datei auf *Fehler* und *Warnungen* klicken und das Suchfeld sowie die Filter verwenden, um die Fehler in der hochgeladenen Aktionsdatei zu durchsuchen.

*Fehlertyp* Die Filter umfassen:

* Alle
* Warnung
* Fehler
* Duplizieren

</details>

<details>

<summary>Fehler- und Warnmeldungen</summary>

| Fehlermeldung                                                         | Erläuterung                                                                                                  |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Erforderliche Felder fehlen:{Required field}                          | In der Upload-Datei fehlt mindestens ein erforderliches Feld.                                                |
| Datensätze aufgrund eines abgelaufenen Gültigkeitsdatums übersprungen | Das Enddatum der Gültigkeit der Aktion liegt in der Vergangenheit, daher wird dieser Datensatz übersprungen. |

</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/de/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.
