> 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/insights/analytics/settings/chatgpt-ads-manager.md).

# ChatGPT Ads Manager

Verbinde dein ChatGPT-Ads-Konto mit einem Brand Kit für Performance-Berichte und aktivierte Anzeigenverwaltungs-Tools.

Verbinde dein ChatGPT-Ads-Konto, damit AirOps die Kampagnenstruktur und die tägliche Performance synchronisieren kann mit **Insights → Ads → Performance**. Das Verbinden und Synchronisieren eines Kontos ändert nichts an den Kampagnen. Workspace-Admins können **Owned Ads** verwenden, um Anzeigenressourcen zu erstellen und zu verwalten. Separat aktivierte Playbook- und Workflow-Tools können ebenfalls die Verbindung nutzen.

## Voraussetzungen

* Ein **AirOps** Workspace mit Zugriff auf Insights und Ads
* Zugriff auf [ChatGPT Ads Manager](https://ads.openai.com) mit der Berechtigung, API-Schlüssel zu erstellen
* Ein **Brand Kit** zum Verknüpfen des Anzeigenkontos

Beobachtete Anzeigen in **Ad Library** und **Market** erfordern diese Verbindung nicht. Ihre Daten stammen aus den ChatGPT-Antworten, die AirOps für deine erfassten Prompts sammelt.

## Konfiguration

### 1. API-Schlüssel im ChatGPT Ads Manager erstellen

1. Melde dich an unter [ChatGPT Ads Manager](https://ads.openai.com).
2. Gehe zu **Einstellungen**.
3. Erstelle einen API-Schlüssel für das Anzeigenkonto, das du verbinden möchtest.
4. Kopiere den Schlüssel und behandle ihn wie ein Passwort.

{% hint style="warning" %}
Erstelle den API-Schlüssel unter **ChatGPT Ads Manager → Einstellungen** für das Anzeigenkonto, das du verbinden möchtest. Schlüssel, die auf der **OpenAI developer platform** erstellt wurden, authentifizieren nicht gegenüber der Ads API. Jeder Schlüssel ist einem einzelnen Anzeigenkonto zugeordnet. Erstelle daher für jedes Konto, das du verbinden möchtest, einen eigenen Schlüssel.
{% endhint %}

### 2. Integration zu deinem Workspace hinzufügen

1. Gehe in AirOps zu **Account → Integrations**.
2. Füge eine Integration hinzu und wähle **OpenAI Ads**.
3. Füge den Schlüssel in das Feld **API-Schlüssel**ein und speichere.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-42e9fb4f37e48ffd261dbbc83c3ebaa3392ce59e%2Fads-manager-01-openai-ads-integration.png?alt=media" alt="Connect OpenAI Ads dialog with an authentication name, a masked API key, an optional expiration date, and Save credentials and Test connection"><figcaption><p>Füge den API-Schlüssel des ChatGPT Ads Managers als OpenAI-Ads-Integration hinzu.</p></figcaption></figure>

Die Integration gehört zu deinem Workspace und kann von dessen Brand Kits ausgewählt werden. Allein durch das Speichern des Schlüssels werden noch keine Daten in Performance geladen. Verknüpfe ihn als Nächstes mit einem Brand Kit.

### 3. Konto mit einem Brand Kit verknüpfen

1. Wähle das Brand Kit aus und öffne dann **Insights → Einstellungen → Allgemein**.
2. Suche nach **Verknüpfte Integrationen** und öffne die Auswahl für **OpenAI Ads** .
3. Wählen Sie die von Ihnen erstellte Integration aus.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-4a54e602f71c99012c24994a3444a747a88dd4a5%2Fads-manager-02-attach-to-brand-kit.png?alt=media" alt="Insights Settings Connected Integrations with the OpenAI Ads integration selected"><figcaption><p>Verknüpfen Sie das Anzeigenkonto mit einem Brand Kit.</p></figcaption></figure>

AirOps ruft das Anzeigenkonto ab, speichert dessen Konto-ID und Währung und startet die erste Synchronisierung. Wenn die Anzeigen-API den Schlüssel ablehnt, **Verbundene Integrationen** wird der Fehler angezeigt, damit Sie den Schlüssel korrigieren und die Integration erneut auswählen können.

Wenn Ihr AirOps-Team ein von AirOps verwaltetes Anzeigenkonto für das Brand Kit eingerichtet hat, klären Sie vor dem Hinzufügen einer weiteren Verbindung mit dem Team, welches Konto Sie verwenden sollen.

### 4. Verbindung bestätigen

Öffnen Sie **Insights → Ads → Performance**. Im Dashboard wird unterschieden, ob ein Konto auf seine erste Synchronisierung wartet oder bereits synchronisiert wurde, aber noch keine Kampagnen oder Auslieferungen aufweist.

| Status                                       | Aktion                                                                                                                                                                    |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nicht verbunden**                          | Prüfen Sie, ob Sie die Integration mit diesem Brand Kit verknüpft haben und sie nicht nur im Workspace gespeichert ist.                                                   |
| **Synchronisierung läuft**                   | Warten Sie, bis die erste Synchronisierung abgeschlossen ist. Wenn der Status weiterhin angezeigt wird, überprüfen Sie die Verbindung unter **Verbundene Integrationen**. |
| **Keine Kampagnen**                          | Erstellen Sie eine Kampagne im ChatGPT Ads Manager oder, sofern verfügbar, über AirOps.                                                                                   |
| **Kampagnen wurden noch nicht ausgeliefert** | Überprüfen Sie den Status der Kampagne und der Anzeigen, die Genehmigung, die Planung und die Auslieferung im Anzeigenkonto.                                              |
| **Performance verfügbar**                    | Wählen Sie den Zeitraum aus und verwenden Sie Filter für Kampagnen, Anzeigengruppen, Anzeigen oder Regionen, um die Ergebnisse zu untersuchen.                            |

## Welche Daten AirOps synchronisiert

| Daten                                   | Details                                                                                                                   |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Kampagnen, Anzeigengruppen und Anzeigen | Kontohierarchie, Namen, Status, Prüfstatus, Creatives sowie unterstützte Felder für Budget, Gebote, Targeting und Planung |
| Tägliche Performance                    | Impressionen, Klicks und Ausgaben pro Anzeige und Tag                                                                     |
| Aufschlüsselungen                       | Tägliche Impressionen, Klicks und Ausgaben nach Land und Gerät                                                            |

AirOps aktualisiert die Daten täglich. Die Anzeigenplattform kann kürzlich erfasste Zahlen nachträglich ändern, sodass sich aktuelle Gesamtwerte nach einer späteren Synchronisierung ändern können. AirOps ersetzt die Werte für jeden Tag durch die neuesten Angaben.

## Zugriff auf die Verwaltung

Performance-Berichte und Anzeigenverwaltung sind nicht gleichermaßen verfügbar. Eine Verbindung für Berichte aktiviert nicht automatisch **Owned Ads** oder Schreibaktionen in Playbooks und Workflows. Wenden Sie sich an Ihr AirOps-Team, um Zugriff auf [Owned Ads](https://docs.airops.com/docs/de/insights/ads/owned-ads.md), [Ads Playbook-Tools](https://docs.airops.com/docs/de/aktionen/playbooks/tools/ads.md), oder [OpenAI Ads Workflow-Schritte](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/openai-ads.md).

zu erhalten. Wenn diese Aktionen aktiviert sind, können sie das verbundene Anzeigenkonto ändern. Prüfen Sie vor dem Erstellen oder Aktivieren von Anzeigen das Zielkonto, das Budget und den Status der Ressourcen.

## Beispiel

Um über eine bestehende Kampagne zu berichten, fügen Sie den API-Schlüssel ihres Kontos unter **Account → Integrations**hinzu, verknüpfen Sie diese Integration mit dem Brand Kit der Kampagne und öffnen Sie **Insights → Ads → Performance**. Wählen Sie nach der Synchronisierung die Kampagne und den Zeitraum aus, um Ausgaben, Impressionen und Klicks zu überprüfen.

## Fehlerbehebung

**Die Integration wird als fehlgeschlagen angezeigt.** Prüfen Sie, ob der Schlüssel aus dem ChatGPT Ads Manager stammt und nicht widerrufen wurde. Aktualisieren Sie ihn und wählen Sie dann die Integration erneut aus.

**Bei einem Verbindungstest wird angezeigt, dass das Konto überprüft werden muss.** Der Schlüssel kann gültig sein, obwohl das Anzeigenkonto die Prüfung durch den Anbieter noch nicht abgeschlossen hat. Erfüllen Sie die Prüfanforderungen für das Konto im ChatGPT Ads Manager.

**Die Zahlen weichen vom ChatGPT Ads Manager ab.** Vergleichen Sie dasselbe Konto, denselben Zeitraum und dieselben Filter. Aktuelle Zahlen können abweichen, bis beim nächsten Synchronisierungsvorgang die Änderungen der Plattform berücksichtigt werden.

**Die Anzeigenbibliothek ist nach dem Verbinden leer.** Die Anzeigenbibliothek basiert auf beobachteten Antworten, nicht auf den Auslieferungsdaten Ihres Anzeigenkontos. Prüfen Sie das ausgewählte Brand Kit, die erfassten ChatGPT-Prompts, die Zeiträume und die Filter. Verwenden Sie „Performance“, um das verbundene Konto zu prüfen.


---

# 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/insights/analytics/settings/chatgpt-ads-manager.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.
