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:

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? |

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:

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

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