> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/openai-ads.md).

# OpenAI Ads

Erstellen, bearbeiten und archivieren Sie OpenAI Ads-Ressourcen mit aktivierten Workflow-Schritten.

OpenAI Ads-Steps ermöglichen es einem Workflow, ChatGPT-Anzeigenkampagnen, Anzeigengruppen und Anzeigen zu erstellen und zu verwalten. Verkette Steps, um die Kontohierarchie aufzubauen und Werbemotive hochzuladen, bevor Anzeigen erstellt werden.

{% hint style="info" %}
OpenAI Ads-Workflow-Aktionen erfordern eine separate Freischaltung des Workspaces und ein verbundenes ChatGPT Ads-Konto. Wende dich an dein AirOps-Team, wenn die Integration im Step-Auswahldialog nicht verfügbar ist.
{% endhint %}

## So richten Sie es ein

1. Fügen Sie einen **OpenAI Ads** Füge deinem Workflow einen Step hinzu und wähle eine Aktion aus.
2. Wähle die OpenAI Ads-Authentifizierung aus. Verwende einen Schlüssel, der erstellt wurde in [ChatGPT Ads Manager](https://docs.airops.com/docs/de/insights/analytics/settings/chatgpt-ads-manager.md).
3. Teste die Verbindung. Ein gültiger Schlüssel kann trotzdem eine Kontoprüfung erfordern, bevor das Konto für Werbung bereit ist.
4. Wähle eine vorhandene übergeordnete Ressource aus oder verweise bei einer Erstellungsaktion auf die von einem früheren Step erstellte übergeordnete Ressource.
5. Konfiguriere die Eingaben der Aktion. Wähle **Pausiert** wenn Ressourcen für die Prüfung vor der Auslieferung vorbereitet werden.
6. Führe den Workflow aus und prüfe die zurückgegebenen Ressourcendetails und den Anzeigenprüfstatus.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9ff2439b819ed119039867ffe808d8f04f368476%2Fopenai-ads-01-create-campaign.png?alt=media" alt="OpenAI Ads step set to Create Campaign with a SpaceOps authentication, budget, and Paused status"><figcaption><p>Erstelle Anzeigenressourcen als pausiert, damit du sie zuerst prüfen kannst.</p></figcaption></figure>

## Aktionen und Parameter

| Action                         | Haupteingaben                                                                                                                            |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Kampagne erstellen**         | Name, expliziter Status, Ziel, Budgettyp und -betrag sowie alle Zeitplan- oder Targeting-Einstellungen                                   |
| **Kampagne bearbeiten**        | Kampagnenauswahl und die zu aktualisierenden Felder                                                                                      |
| **Kampagne archivieren**       | Kampagnenauswahl                                                                                                                         |
| **Anzeigengruppe erstellen**   | Vorhandene Kampagne oder Kampagnen-ID/Referenz, Gruppenname, Höchstgebot, Status und Kontext-Hinweise                                    |
| **Anzeigengruppe bearbeiten**  | Kampagnen- und Anzeigengruppenauswahl sowie die zu aktualisierenden Felder                                                               |
| **Anzeigengruppe archivieren** | Kampagnen- und Anzeigengruppenauswahl                                                                                                    |
| **Anzeigenbild hochladen**     | Öffentliche URL, die direkt auf ein Bild verweist                                                                                        |
| **Anzeige erstellen**          | Vorhandene Anzeigengruppe oder Anzeigengruppen-ID/Referenz, Name, Status, Titel, Text, Ziel-URL und die hochgeladene Datei-ID des Bildes |
| **Anzeige bearbeiten**         | Kampagnen-, Anzeigengruppen- und Anzeigenauswahl sowie die zu aktualisierenden Felder                                                    |
| **Anzeige archivieren**        | Kampagnen-, Anzeigengruppen- und Anzeigenauswahl                                                                                         |

Gib Budget- und Gebotsbeträge in der Währung des Anzeigenkontos ein. Verwende die Datums-/Uhrzeit-Eingaben, um Zeitplanung und Zeitzone festzulegen. Kontext-Hinweise können separate Zeilen oder ein JSON-Array aus einem früheren Step sein.

**Anzeigenbild hochladen** liefert ein `file_id`. Gib diesen Wert an **Anzeige erstellen** für das Chat-Card-Creative. Erstell-, Bearbeitungs- und Archivierungsaktionen geben die Antwort des Anbieters zurück; Anzeigenantworten enthalten `review_status`.

### Erneutes Ausführen von Erstellungs-Steps

Beim erneuten Ausführen desselben Erstellungs-Steps im selben Workflow wird dessen ursprüngliche Kampagne, Anzeigengruppe oder Anzeige wiederverwendet, selbst wenn du die Eingaben änderst. Verwende einen **Bearbeiten** Step, um eine vorhandene Ressource zu aktualisieren. Verwende einen anderen Erstellungs-Step oder Workflow, wenn du eine separate Ressource erstellen möchtest.

Ein Bild-Upload-Step kann einen neuen `file_id` bei einem erneuten Ausführen zurückgeben. Dadurch erstellt der folgende Erstellungs-Step keine zweite Anzeige.

{% hint style="warning" %}
Diese Steps schreiben in dein verbundenes Anzeigenkonto. Aktive Ressourcen können Anzeigen ausliefern und Budget ausgeben. Das Archivieren ist irreversibel. Verwende explizite pausierte Status und einen Prüfprozess, wenn du einen Erstellungs-Workflow aufbaust.
{% endhint %}

## Beispiel

Erstelle einen Workflow mit diesen Steps:

1. **Kampagne erstellen** mit dem gewünschten Ziel und Budget, mit Status **Pausiert**.
2. **Anzeigengruppe erstellen** unter Verwendung der vom ersten Step zurückgegebenen Kampagnen-ID, auch **Pausiert**.
3. **Anzeigenbild hochladen** unter Verwendung einer öffentlichen URL für dein freigegebenes Creative.
4. **Anzeige erstellen** unter Verwendung der Anzeigengruppen-ID und des hochgeladenen `file_id`, mit freigegebenem Text und Ziel-URL sowie Status **Pausiert**.
5. Prüfe die zurückgegebenen Ressourcen und das Creative, bevor du sie über eine aktivierte Verwaltungsoberfläche aktivierst.


---

# 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://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/openai-ads.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.
