> 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 seine Kampagnenstruktur und tägliche Leistung in **Einblicke → Anzeigen → Leistung**. Das Verbinden und Synchronisieren eines Kontos ändert dessen Kampagnen nicht. Wenn separat aktiviert, **Eigene Anzeigen**, Playbooks und Workflows können die Verbindung nutzen, um Anzeigenressourcen zu erstellen und zu verwalten.

## Voraussetzungen

* Eine **AirOps** Arbeitsbereich mit Zugriff auf Einblicke und Anzeigen
* Zugriff auf [ChatGPT-Anzeigenmanager](https://ads.openai.com) mit Berechtigung zum Erstellen von API-Schlüsseln
* Ein **Brand Kit** um das Anzeigenkonto zu verknüpfen

Beobachtete Anzeigen in **Anzeigenbibliothek** und **Markt** benötigen diese Verbindung nicht. Ihre Daten stammen aus den ChatGPT-Antworten, die AirOps für deine verfolgten Prompts erfasst.

## So richtest du es ein

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

1. Melde dich an unter [ChatGPT-Anzeigenmanager](https://ads.openai.com).
2. Gehen Sie 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 Schlüssel im ChatGPT Ads Manager. Ein standardmäßiger API-Schlüssel der OpenAI-Plattform, etwa ein Schlüssel, der mit `sk-`, beginnt, authentifiziert sich nicht gegenüber der Ads-API. Jeder Schlüssel ist genau einem Anzeigenkonto zugeordnet. Erstelle also einen Schlüssel pro Konto, das du verbinden möchtest.
{% endhint %}

### 2. Füge die Integration deinem Arbeitsbereich hinzu

1. Gehe in AirOps zu **Konto → Integrationen**.
2. Füge eine Integration hinzu und wähle **OpenAI-Anzeigen**.
3. Füge den Schlüssel ein in **API-Schlüssel**, und speichere dann.

Die Integration gehört zu deinem Arbeitsbereich und kann über dessen Brand Kits ausgewählt werden. Das bloße Speichern des Schlüssels füllt Performance nicht; verknüpfe ihn als Nächstes mit einem Brand Kit.

### 3. Verknüpfe das Konto mit einem Brand Kit

1. Wähle das Brand Kit aus und öffne dann **Einblicke → Einstellungen → Allgemein**.
2. Suche **Verbundene Integrationen** und öffne das **OpenAI-Anzeigen** Auswahlmenü.
3. Wähle die Integration aus, die du erstellt hast.

AirOps ruft das Anzeigenkonto ab, speichert dessen Konto-ID und Währung und startet die erste Synchronisierung. Wenn die Ads-API den Schlüssel ablehnt, **Verbundene Integrationen** zeigt den Fehler an, damit du den Schlüssel korrigieren und erneut auswählen kannst.

Wenn dein AirOps-Team für das Brand Kit ein von AirOps verwaltetes Anzeigenkonto bereitgestellt hat, kläre mit ihnen, welches Konto du verwenden sollst, bevor du eine weitere Verbindung hinzufügst.

### 4. Bestätige die Verbindung

Öffnen **Einblicke → Anzeigen → Leistung**. Das Dashboard unterscheidet ein Konto, das auf die erste Synchronisierung wartet, von einem Konto, das bereits synchronisiert wurde, aber noch keine Kampagnen oder noch keine Auslieferung hat.

| Status                                       | Was zu tun ist                                                                                                                                     |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nicht verbunden**                          | Prüfe, ob du die Integration mit diesem Brand Kit verknüpft hast, statt sie nur im Arbeitsbereich zu speichern.                                    |
| **Wird synchronisiert**                      | Warte, bis die erste Synchronisierung abgeschlossen ist. Wenn der Status bestehen bleibt, prüfe die Verbindung unter **Verbundene Integrationen**. |
| **Keine Kampagnen**                          | Erstelle eine Kampagne im ChatGPT Ads Manager oder, sofern aktiviert, über AirOps.                                                                 |
| **Kampagnen wurden noch nicht ausgeliefert** | Prüfe im Anzeigenkonto den Kampagnen- und Anzeigenstatus, die Freigabe, die Planung und die Auslieferung.                                          |
| **Performance verfügbar**                    | Wähle den Datumsbereich und nutze Filter für Kampagne, Anzeigengruppe, Anzeige oder Region, um die Ergebnisse zu prüfen.                           |

## Was AirOps synchronisiert

| Daten                                   | Detail                                                                                                                       |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Kampagnen, Anzeigengruppen und Anzeigen | Kontohierarchie, Namen, Status, Prüfstatus, Creatives sowie unterstützte Felder für Budget, Gebot, Targeting und Zeitplanung |
| Tägliche Leistung                       | 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 aktuelle Werte nachträglich anpassen, sodass sich aktuelle Summen nach einer späteren Synchronisierung ändern können. AirOps ersetzt die Werte jedes Tages durch die neuesten Werte.

## Verwaltungszugriff

Performance-Reporting und Anzeigenverwaltung sind getrennt verfügbar. Eine Reporting-Verbindung aktiviert nicht automatisch **Eigene Anzeigen** oder Schreibaktionen in Playbooks und Workflows. Wende dich bezüglich des Zugriffs auf [Eigene Anzeigen](/docs/de/insights/ads/owned-ads.md), [Tools für das Anzeigen-Playbook](/docs/de/aktionen/playbooks/tools/ads.md), oder [OpenAI Ads Workflow-Schritte](/docs/de/aktionen/workflow-concepts/workflow-steps/openai-ads.md).

Wenn sie aktiviert sind, können diese Aktionen das verbundene Anzeigenkonto ändern. Prüfe das Zielkonto, das Budget und den Ressourcenstatus, bevor du Anzeigen erstellst oder aktivierst.

## Beispiel

Um über eine bestehende Kampagne zu berichten, füge den API-Schlüssel ihres Kontos unter **Konto → Integrationen**, verknüpfe diese Integration mit dem Brand Kit der Kampagne und öffne **Einblicke → Anzeigen → Leistung**. Wähle nach der Synchronisierung die Kampagne und den Datumsbereich aus, um Ausgaben, Impressionen und Klicks zu prüfen.

## Fehlerbehebung

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

**Ein Verbindungstest meldet, dass das Konto überprüft werden muss.** Der Schlüssel kann gültig sein, während das Anzeigenkonto die Prüfung des Anbieters noch nicht abgeschlossen hat. Erfülle die Prüfanforderungen des Kontos im ChatGPT Ads Manager.

**Die Zahlen weichen vom ChatGPT Ads Manager ab.** Vergleiche dasselbe Konto, denselben Datumsbereich und dieselben Filter. Aktuelle Werte können abweichen, bis die nächste Synchronisierung die Änderungen der Plattform übernimmt.

**Die Anzeigenbibliothek ist nach dem Verbinden leer.** Die Anzeigenbibliothek verwendet beobachtete Antworten, nicht die Auslieferungsdaten deines Anzeigenkontos. Prüfe das ausgewählte Brand Kit, die verfolgten ChatGPT-Prompts, die Daten und die Filter. Nutze 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.