> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Klaviyo

> Verbinden Sie Klaviyo mit einem eingeschränkten, schreibgeschützten privaten API-Schlüssel mit Iru Compliance, um den Benutzerzugriff auf das Konto, das API-Schlüssel-Inventar mit Scopes sowie Metadaten zu Listen und Segmenten zu erfassen.

### Über Klaviyo

Iru liest **Kontobenutzer und ihre Berechtigungen**, **API-Schlüssel mit ihren Scopes**, **Metadaten zu Listen und Segmenten** sowie **Integrationsverbindungen** aus der Klaviyo-API. Die Authentifizierung erfolgt mit einem **privaten API-Schlüssel**, der unter **Einstellungen** → **API-Schlüssel** erstellt wird. Private Klaviyo-Schlüssel erhalten ihre **Scopes bei der Erstellung**. Erteilen Sie schreibgeschützten Zugriff auf die Objekte, die Ihre Kontrollen abdecken.

Iru liest **nur Metadaten**. Namen und Konfiguration von Listen und Segmenten werden erfasst; die **darin enthaltenen Profile nicht**.

### So funktioniert es

```http theme={null}
Authorization: Klaviyo-API-Key YOUR_PRIVATE_API_KEY
revision: 2024-10-15
```

Klaviyo verwendet ein **benutzerdefiniertes Autorisierungsschema**: Dem Header-Wert wird `Klaviyo-API-Key` vorangestellt, nicht `Bearer`. Jede Anfrage erfordert außerdem einen **`revision`**-Header mit einem ISO-8601-Datum, das die API-Version festlegt. Klaviyo versioniert seine API über datierte Revisionen statt über ein Pfadsegment, und eine Anfrage ohne gültige Revision wird abgelehnt. Iru legt die Revision fest; Sie geben nur den Schlüssel an.

Anfragen richten sich an `https://a.klaviyo.com/api`. Es muss weder eine Subdomain noch ein Konto-Host konfiguriert werden. Der **öffentliche** API-Schlüssel (eine kurze Unternehmens-ID, die bei clientseitigen Abonnementaufrufen verwendet wird) ist eine andere Anmeldeinformation und funktioniert hier nicht zur Authentifizierung.

| Detail | Wert |
| - | - |
| **Kategorie** | Marketing |
| **Authentifizierung** | Klaviyo-API-Key (privater API-Schlüssel) |

Offizielle Referenzen: [API-Anfragen authentifizieren](https://developers.klaviyo.com/en/docs/authenticate_), [Richtlinie zu API-Versionierung und -Einstellung](https://developers.klaviyo.com/en/docs/api_versioning_and_deprecation_policy).

### Voraussetzungen

* Eine Kontorolle, die in Klaviyo **API-Schlüssel verwalten** kann.
* Legen Sie fest, was im Umfang enthalten ist. In Klaviyo können Sie die Überwachung von Listen und Segmenten ausschließen; ausgeschlossene Objekte liefern keine Nachweise.

### Klaviyo mit Iru verbinden

<Tabs>
  <Tab title="Klaviyo">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Bei Klaviyo anmelden">
        Melden Sie sich bei Klaviyo mit einem Konto an, das API-Schlüssel verwalten kann.
      </Step>

      <Step title="Einstellungen öffnen">
        Öffnen Sie das **Kontomenü** unten links und wählen Sie dann **Einstellungen**.
      </Step>

      <Step title="API-Schlüssel öffnen">
        Gehen Sie zu **API-Schlüssel**.
      </Step>

      <Step title="Privaten API-Schlüssel erstellen">
        Wählen Sie **Create private API key**.
      </Step>

      <Step title="Schlüssel benennen und Scopes festlegen">
        Geben Sie eine Bezeichnung wie **Iru Compliance** ein, damit Sie die Integration später prüfen können. Setzen Sie den Zugriff des Schlüssels auf **schreibgeschützt**. Verwenden Sie **benutzerdefinierte Scopes** und erteilen Sie Lesezugriff nur auf die Objekte, die Ihr Compliance-Programm abdeckt. Accounts, Lists und Segments decken die Nachweise ab, die Iru erfasst. Erteilen Sie weder Vollzugriff noch Schreib-Scopes.
      </Step>

      <Step title="Schlüssel erstellen und kopieren">
        Erstellen Sie den Schlüssel und kopieren Sie den Wert **einmalig**, während Klaviyo ihn anzeigt.
      </Step>
    </Steps>

    <Note>
      Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**Klaviyo**](#klaviyo) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Klaviyo aktivieren">
        Suchen Sie **Klaviyo** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich ein Browser-Tab oder -Fenster für den Connector-Assistenten.
      </Step>

      <Step title="Privaten API-Schlüssel einfügen">
        Fügen Sie den **privaten API-Schlüssel** ein.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **Anmeldedaten senden**. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Bestätigen, dass die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und bestätigen Sie, dass die Karte **Klaviyo** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Prüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="Authentifizierung schlägt fehl">
    Bestätigen Sie, dass Sie einen **privaten** Schlüssel erstellt haben, keinen öffentlichen. Der öffentliche Schlüssel ist eine kurze Unternehmens-ID für clientseitige Aufrufe und authentifiziert keine Server-zu-Server-Anfrage.
  </Accordion>

  <Accordion title="403 bei einigen Objekten">
    Der private Schlüssel wurde mit **benutzerdefinierten Scopes** erstellt, die diese Objekte ausschließen. Klaviyo-Scopes werden bei der Erstellung festgelegt. Erstellen Sie einen neuen Schlüssel mit den benötigten Scopes.
  </Accordion>

  <Accordion title="Listen und Segmente fehlen">
    Entweder fehlt dem Schlüssel der Lesezugriff darauf, oder die Überwachung von Listen und Segmenten liegt außerhalb des Umfangs dieser Verbindung.
  </Accordion>

  <Accordion title="Profildaten werden nicht angezeigt">
    Dies ist zu erwarten. Iru erfasst **Metadaten** zu Listen und Segmenten, nicht die darin enthaltenen Profile.
  </Accordion>
</AccordionGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Artifacts-Verwaltung" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>