---
title: "Marketing Module"
source: "https://ayoune.com/de/docs/api-reference/marketing-module"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "API-Referenz"
language: "de"
retrieved: "2026-09-11T16:35:51.842Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# Marketing Module

Das Marketing-Modul deckt klassisches Outbound-Marketing ab: E-Mail-Kampagnen, Coupons, Tracking. Routing: `marketing-api.ayoune.app` (separates `mail-tracking-api.ayoune.app` für Open/Click-Pixel).

## Hauptentitäten

### Coupons

Rabatt-Codes mit Lifecycle und Limits.

| Feld | Hinweis |
|---|---|
| `code` | unique pro Customer |
| `value` | Zahl |
| `type` | `percent` / `fixed` / `freeshipping` |
| `validFrom` / `validUntil` | Date-Range |
| `usageLimit` | global Max-Einlösungen |
| `perUserLimit` | Max-Einlösungen pro User |
| `applicableProducts` | ProductId-Array (leer = alle) |
| `_status` | `active` / `paused` / `expired` |

Rights: `marketing.coupons.{view|create|edit|delete|export}`.

Beispiel:

```bash
ay create coupons "SUMMER25" \
  --set type=percent --set value=25 \
  --set validUntil=2026-09-30
```

### Newsletters

Mail-Templates + Versand-Trigger.

| Feld | Hinweis |
|---|---|
| `subject` | Pflicht |
| `body` | Handlebars-Template |
| `recipientFilter` | Mongo-Query auf Consumers |
| `scheduleAt` | Versand-Zeitpunkt |
| `tracking` | bool — Open/Click-Pixel? |

```bash
ay create newsletters "Summer-Sale 2026" \
  --set subject="25% auf Outdoor" \
  --set recipientFilter='{"tags":"outdoor","_status":"active"}' \
  --set scheduleAt=2026-06-01T08:00:00Z
```

Custom-Actions:

```bash
POST /newsletters/:id/actions/send-test --body '{"to":"qa@firma.tld"}'
POST /newsletters/:id/actions/cancel
POST /newsletters/:id/actions/duplicate
```

### MailLogs

Read-Only-Audit aller versendeten Mails — entsteht automatisch beim Versand.

| Feld | Hinweis |
|---|---|
| `to` | Empfänger-Email |
| `consumer` | ConsumerId (wenn matchbar) |
| `newsletter` | NewsletterId |
| `status` | `queued` / `sent` / `bounced` / `complained` / `opened` / `clicked` |
| `openedAt` | Date |
| `clickedAt` | Date |
| `bounceReason` | string |

Tracking-Pixel und Click-Redirects laufen über `mail-tracking-api.ayoune.app` — separates Service, weil es **public** sein muss (kein Auth).

Rights: `marketing.maillogs.{view|export}`.

## Tracking-Pipeline

```text
Newsletter-Send
  → MailLog erzeugt
  → Mail durch Provider versendet
  → Empfänger öffnet → Pixel-Hit auf mail-tracking-api → MailLog.openedAt
  → Empfänger klickt Link → Redirect über mail-tracking-api → MailLog.clickedAt
  → Bounce-Webhook von Provider → MailLog.status=bounced
```

## Google-Ads (sub-modul `ads`)

Google-Ads v23 Integration unter `ads-api.ayoune.app`:

- `ads.campaigns` — Campaigns syncen
- `ads.adgroups` — AdGroups
- `ads.keywords` — Keywords + Performance
- `ads.metrics` — Impressions, Clicks, Conversions

Setup via OAuth: `ay exec ads:authorize` öffnet Google-OAuth, persistiert Refresh-Token in Credentials.

## Verbindungen

- [CRM-Module](wiki:api-reference/crm-module) — Empfänger-Auswahl
- [Notifications](wiki:admin-handbook/notifications) — Versand-Channels
- [Webhooks](wiki:developer-portal/webhooks) — Bounces/Opens nach extern

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-09-11 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com