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

# Mailchimp

> Füge Mailchimp zu deinem Macaly-Projekt hinzu

Mit Mailchimp sammelst du E-Mail-Abonnenten, versendest Newsletter und führst automatisierte E-Mail-Kampagnen durch. Wenn du von deiner Macaly-Website aus eine Mailingliste aufbauen und pflegen möchtest, ist Mailchimp eine der beliebtesten Möglichkeiten dafür.

<Callout icon="user">
  Verfügbar auf allen Plänen
</Callout>

<Note>
  **Brauchst du Mailchimp wirklich?** Macaly hat eine [integrierte Datenbank](/docs/de/features/databases) und E-Mail-Benachrichtigungen. Wenn du nur ein Kontaktformular oder eine Warteliste brauchst, benötigst du kein externes Tool. Mailchimp lohnt sich, wenn du Newsletter, Drip-Kampagnen oder Zielgruppensegmentierung brauchst.
</Note>

## Warum Mailchimp verwenden

* **Baue deine Liste über deine Website auf.** Sammle Abonnenten und verwalte sie an einem Ort. Segmentiere nach Interessen, Anmeldequelle oder Verhalten.
* **Versende Newsletter, ohne Code anzufassen.** Gestalte und versende E-Mail-Kampagnen an deine Zielgruppe. Plane sie oder sende sie sofort.
* **Automatisiere deine Follow-ups.** Richte Willkommens-E-Mails, Drip-Sequenzen und Erinnerungen für abgebrochene Warenkörbe ein, die von selbst laufen.
* **Sieh, was wirklich funktioniert.** Verfolge Öffnungsraten, Klickraten und welche Links am meisten Engagement erzeugen.

## Was du brauchst

Bevor du startest, stelle sicher, dass du Folgendes hast:

* Ein **Mailchimp-Konto**. Erstelle eins kostenlos unter [mailchimp.com](https://mailchimp.com)
* Eine **Mailchimp-Zielgruppe** (Mailingliste), in die Abonnenten gesammelt werden

Es gibt zwei Wege, Mailchimp mit deiner Website zu verbinden:

* **Eingebettetes Anmeldeformular.** Füge den von Mailchimp generierten Formularcode in deine Website ein. Am besten für einfaches Sammeln von E-Mails.
* **Mailchimp-API.** Verbinde deine Formulare mit Mailchimps API für volle Kontrolle darüber, welche Daten du sendest. Am besten, wenn du individuelle Formulare passend zu deinem Design möchtest.

## Option 1: Eingebettetes Anmeldeformular

Der einfachste Ansatz. Mailchimp generiert ein Formular, das du in deine Website einfügen kannst.

<Steps>
  <Step title="Deinen Formular-Embed-Code holen">
    Gehe in Mailchimp zu **Audience**, dann **Signup forms**, dann **Embedded forms**. Passe die gewünschten Felder an und kopiere anschließend den generierten HTML-Code.
  </Step>

  <Step title="Den Agenten bitten, es hinzuzufügen">
    Öffne den Chat in deinem Macaly-Projekt und frage:

    ```
    Füge dieses Mailchimp-Anmeldeformular zu meiner Website hinzu.
    Hier ist der Embed-Code:

    [füge hier deinen Mailchimp-Embed-Code ein]
    ```
  </Step>

  <Step title="Der Agent platziert das Formular">
    Der Agent fügt das Formular zu deinem Projekt hinzu. Du kannst ihm genau sagen, wo du es haben möchtest, etwa im Footer, auf einer eigenen Seite oder als Popup.
  </Step>
</Steps>

<Tip>
  Wenn das Formular zum Design deiner Website passen soll, sag dem Agenten: *"Style the Mailchimp form to match the rest of my site."*
</Tip>

## Option 2: Individuelles Formular mit Mailchimp-API

Für mehr Kontrolle kann der Agent ein individuelles Formular bauen, das Abonnenten über die API an Mailchimp sendet.

<Steps>
  <Step title="Deine Mailchimp-Zugangsdaten zu Secrets hinzufügen">
    Gehe in deinem Macaly-Projekt zu **Einstellungen** und dann **Secrets**. Füge zwei Secrets hinzu:

    * `MAILCHIMP_API_KEY` - dein Mailchimp-API-Schlüssel
    * `MAILCHIMP_AUDIENCE_ID` - die Zielgruppe, zu der Abonnenten hinzugefügt werden sollen

    <Accordion title="So findest du deinen API-Schlüssel und deine Audience ID">
      **API-Schlüssel:**

      1. Klicke in Mailchimp auf dein Profilsymbol, dann auf **Account & billing**
      2. Gehe zu **Extras**, dann **API keys**
      3. Klicke auf **Create a key** und kopiere ihn

      **Audience ID:**

      1. Gehe zu **Audience**, dann **All contacts**
      2. Klicke auf **Settings**, dann **Audience name and defaults**
      3. Deine **Audience ID** steht auf dieser Seite
    </Accordion>
  </Step>

  <Step title="Den Agenten bitten, das Formular zu bauen">
    Öffne den Chat und frage:

    ```
    Erstelle ein Newsletter-Anmeldeformular im Footer. Wenn sich
    jemand anmeldet, füge ihn über die API zu meiner Mailchimp-
    Zielgruppe hinzu. Ich habe meinen API-Schlüssel und meine
    Audience ID zu Secrets hinzugefügt.
    ```
  </Step>
</Steps>

<Warning>
  Füge API-Schlüssel niemals direkt in den Chat ein. Nutze immer **Settings** und dann **Secrets**, um sensible Zugangsdaten zu speichern. Der Agent kann sie von dort sicher auslesen.
</Warning>

## Prüfen, ob es funktioniert

<Steps>
  <Step title="Eine Test-Anmeldung absenden">
    Besuche deine Website und gib eine Test-E-Mail-Adresse in das Anmeldeformular ein.
  </Step>

  <Step title="Deine Mailchimp-Zielgruppe prüfen">
    Gehe in Mailchimp zu **Audience**, dann **All contacts**. Deine Test-E-Mail sollte als neuer Abonnent erscheinen.
  </Step>
</Steps>

## Gut zu wissen

* Wenn du nur E-Mails sammeln möchtest, ist Macalys [integrierte Datenbank](/docs/de/features/databases) einfacher und braucht kein externes Konto
* Für DSGVO-Konformität aktiviere **Double-Opt-in** in deinen Mailchimp-Zielgruppeneinstellungen. Das versendet eine Bestätigungs-E-Mail, bevor jemand zu deiner Liste hinzugefügt wird
* Der Agent kann auch Pop-up- und Slide-in-Formulare einrichten, falls du etwas Auffälligeres als ein Inline-Anmeldeformular möchtest


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.