# Ordio Contextual Promotion Guide

**Last Updated:** 2026-02-23

Best practices for promoting Ordio in blog content, FAQs, and other text. Match the promoted feature to the content topic instead of defaulting to Zeiterfassung and Dienstplanung.

## Problem

Ordio offers 12+ product features (Zeiterfassung, Schichtplanung, Abwesenheiten, Lohnabrechnung, Dokumentenmanagement, Digitale Personalakte, Checklists, Events, App Store, Nano AI). Content often promotes only Zeiterfassung and Dienstplanung, even when other features fit the topic better.

## Principles

### 1. Contextual Relevance

Match the Ordio feature to the content topic. When the post discusses Urlaub, promote Abwesenheiten—not Zeiterfassung.

| Topic | Promote | Not |
|-------|---------|-----|
| Urlaub, Krankmeldung | Abwesenheiten | Zeiterfassung |
| Lohnabrechnung, Lohnarten | Ordio Payroll (/payroll) | Zeiterfassung |
| Personalakte, Stammdaten | Digitale Personalakte | Zeiterfassung |
| Dokumente, Verträge | Dokumentenmanagement | Zeiterfassung |
| Checklisten, HACCP | Checklists | Zeiterfassung |
| Events, Festivals, Messen | Events | Schichtplanung |

### 2. Section-Level Context (Not Post-Level)

Different sections of the same post can promote different features. Match each section to the feature that fits its topic.

- **Urlaub section** → Abwesenheiten link
- **Lohnarten section** → Ordio Payroll link
- **Arbeitszeiten section** → Zeiterfassung link
- **Dienstplan section** → Schichtplanung link

Do not force one feature per post. A post about "Personalplanung in der Gastronomie" might have a Urlaub paragraph (→ Abwesenheiten), a Lohnabrechnung paragraph (→ Ordio Payroll), and a Schichtplan paragraph (→ Schichtplanung). Each section gets the link that fits.

### 3. Natural Integration (No AI Tells)

Integrate Ordio mentions naturally. Avoid repetitive patterns, forced phrases, or over-promotion.

**Do:**
- Vary sentence structure and anchor text (not "Mit Ordio kannst du..." every time)
- Use 1–2 mentions per section max, only when it adds value
- Let the link flow from the sentence ("Urlaubsanträge verwalten" → Abwesenheiten)
- Read aloud: if it sounds forced or repetitive, rewrite

**Don't:**
- Repeat the same phrase pattern ("Mit Ordio kannst du X", "Mit Ordio kannst du Y")
- Add links in every paragraph
- Use generic anchor text ("hier", "mehr erfahren", "klicken Sie hier")
- Over-promote – educate first, mention product when it naturally fits

**Good:**
- "Mit Ordio verwaltest du Urlaubsansprüche zentral – ohne Excel und WhatsApp."
- "Ordio Payroll bereitet die Lohnabrechnung aus den erfassten Zeiten vor."
- "Digitale Checklisten sorgen für HACCP-konforme Abläufe."

**Bad:**
- "Mit Ordio Zeiterfassung kannst du..." (in a Urlaub section)
- "Ordio unterstützt dich bei der Zeiterfassung und Dienstplanung." (in a Lohnarten section)
- Repetitive "Mit Ordio kannst du..." in three consecutive paragraphs

### 4. Feature Diversity

Vary features across posts and within posts. Avoid Zeiterfassung/Dienstplan in every section. When a post covers multiple topics, each relevant section can link to its matching feature. No single-feature-per-post rule—context wins.

### 5. Educate First, Sell Second

Content should solve problems; the product mention follows naturally. Don't pitch too soon—let the value be demonstrated.

### 6. Body-First Placement (Not FAQ-Only)

**Place Ordio mentions in the main post content (body), not only in FAQ answers.** Per shared-patterns: "Ordio mentioned naturally once per major section." The body should carry the primary product mentions; FAQs can supplement but must not be the only place Ordio appears.

- **Do:** Add 2–4 contextual Ordio mentions in the body (intro, relevant H2 sections, Fazit)
- **Don't:** Put all Ordio promotions in FAQ answers and leave the body without any mentions
- **Balance:** If the body has 2–3 mentions, 1–2 in FAQs is fine. Avoid 5+ in FAQs and 0 in body

## Topic-to-Feature Quick Reference

| Topic Keywords | Ordio Feature | URL |
|----------------|----------------|-----|
| Zeiterfassung, Arbeitszeiten, Zeiterfassungspflicht | Zeiterfassung | /arbeitszeiterfassung |
| Dienstplan, Schichtplan, Personaleinsatz | Schichtplanung | /schichtplan |
| Urlaub, Abwesenheit, Krankmeldung, Verfügbarkeit | Abwesenheiten | /abwesenheiten |
| Lohnabrechnung, Lohnarten, Gehalt, Zuschläge | Ordio Payroll | /payroll |
| Dokumente, Arbeitsvertrag | Dokumentenmanagement | /dokumentenmanagement |
| Personalakte, Stammdaten, Mitarbeiterdaten | Digitale Personalakte | /digitale-personalakte |
| Checkliste, HACCP, Reinigungsplan | Checklists | /checklisten |
| Event, Festival, Messe, Veranstaltung | Events | /events |
| Integration, POS, Kassensystem | App Store | /app-store |
| Nano, KI-Assistent | Nano AI | /nano-ai |

Full mapping: `docs/data/blog-product-feature-mapping.json`

## FAQ-Specific Guidance

When generating or editing FAQ answers:

- **Topic-to-feature mapping:** Use the question text to infer the matching feature. Urlaub/Abwesenheit questions → Abwesenheiten; Lohnabrechnung/Lohnarten → Ordio Payroll; etc.
- **Max 1 Ordio mention per FAQ answer** – optional, only when it adds value.
- **Match feature to question topic** – avoid promoting Zeiterfassung in a FAQ about Urlaubsentgelt.
- **generate-faq-answers-optimized.php** now injects topic-feature hints per question when keywords match the mapping.

## Section Briefs

Before writing content, run `generate-section-briefs.php` to get per-H2 guidance:

```bash
php v2/scripts/blog/generate-section-briefs.php --post=slug --category=lexikon
```

Each section brief now includes **Ordio-Feature (wenn relevant):** with the matching feature, URL, and anchor examples when the H2 topic matches the mapping. Use this when drafting each section.

## Automated Integration

| Script | Purpose |
|--------|---------|
| `generate-faq-answers-optimized.php` | Injects topic-feature hints into FAQ prompts; per-question hint when question matches mapping |
| `generate-section-briefs.php` | Adds Ordio-Feature guidance per H2 from topic mapping |
| `suggest-ordio-feature.php` | Post-level and section-level (H2) suggestions; run before or after content |
| `validate-new-post.php` | Warns if Ordio only in FAQs (body-first); suggests product links when topics discussed but not linked |
| `audit-ordio-promotion.php` | Topic-feature gaps; FAQ topic-feature mismatch (e.g. FAQ about Urlaub links to Zeiterfassung) |

## Examples by Feature

### Abwesenheiten

- **Urlaubsantrag:** "Mit Ordio verwaltest du Urlaubsanträge zentral – Mitarbeiter stellen Anträge per App, du genehmigst mit einem Klick."
- **Krankmeldung:** "Abwesenheiten in Ordio erfassen automatisch Krankmeldungen und verbinden sie mit der Dienstplanung."

### Lohnabrechnung

- **Lohnarten:** "Mit Ordio verwaltest du Lohnarten zentral und erstellst Lohnabrechnungen direkt aus den erfassten Arbeitszeiten."
- **Zuschläge:** "Ordio berechnet Zuschläge automatisch – von der Zeiterfassung bis zur Lohnabrechnung."

### Digitale Personalakte

- **Personalakte:** "Mit Ordio führst du die digitale Personalakte zentral – alle Dokumente und Stammdaten an einem Ort."
- **Onboarding:** "Ordio unterstützt dich beim Onboarding mit automatisierten Personalfragebogen und Dokumentenabfragen."

### Dokumentenmanagement

- **Arbeitsvertrag:** "Ordio fragt Dokumente automatisch ab – einmal definiert, nie wieder etwas vergessen."
- **Compliance:** "Mit Ordio verwaltest du Dokumente und Fristen zentral – ideal für Arbeitsverträge und Zertifikate."

### Checklists

- **HACCP:** "Digitale Checklisten in Ordio sorgen für HACCP-konforme Abläufe – mit Foto-Nachrichten und Fristen."
- **Reinigungsplan:** "Ordio Checklisten ersetzen Papier-Reinigungspläne – Mitarbeiter bestätigen per App."

### Events

- **Festival:** "Plane Eventpersonal mit Ordio – egal ob 20 oder 2.000 Mitarbeitende. Für Festivals, Messen, Konzerte."
- **Veranstaltung:** "Ordio Events unterstützt dich bei der Personalplanung für Veranstaltungen – von der Schichtzuweisung bis zur Abrechnung."

## Validation

Run the audit script to find gaps:

```bash
php v2/scripts/blog/audit-ordio-promotion.php
```

Output: `docs/data/ordio-promotion-audit.json` – posts with topic-feature mismatches.

For suggestions when writing content:

```bash
php v2/scripts/blog/suggest-ordio-feature.php --post=slug --category=lexikon
```

## Next Steps (Manual Rework)

1. **Prioritized rework list:** See [ORDIO_PROMOTION_REWORK_LIST.md](ORDIO_PROMOTION_REWORK_LIST.md) for top 20 posts with topic-feature mismatches.
2. **Per-post workflow:** Run `suggest-ordio-feature.php` (includes section-level H2 suggestions) → add 1–2 contextual product links per relevant H2 → re-run audit to verify.
3. **High-value additions:** Focus on Ordio Payroll (/payroll), Abwesenheiten, Events.
4. **validate-new-post.php** suggests product links when content discusses topics but lacks matching links—review warnings before publishing.
5. **audit-ordio-promotion.php** reports `faq_topic_feature_mismatch` when FAQ discusses a topic but links to a non-matching feature—fix these for contextual alignment.

## Related Documentation

- [ORDIO_PROMOTION_REWORK_LIST](ORDIO_PROMOTION_REWORK_LIST.md) – Prioritized posts for rework
- [INTERNAL_LINKING_GUIDE](guides/INTERNAL_LINKING_GUIDE.md) – Product links section
- [blog-product-feature-mapping.json](../../data/blog-product-feature-mapping.json) – Full topic mapping
- [.cursor/rules/ordio-promotion-contextual.mdc](../../../.cursor/rules/ordio-promotion-contextual.mdc) – Cursor rule for AI