Integrations

Über Integrationen veröffentlicht Mediastilo Ihre fertigen Entwürfe dort, wo Ihr Publikum tatsächlich liest. Sie verbinden ein Ziel einmal pro Marke und können danach jeden fertigen Entwurf direkt dorthin übertragen. Verbindungen verwalten Sie im Bereich Integrations Ihres Dashboards.

Unterstützte Ziele

Mediastilo bietet derzeit drei Veröffentlichungsziele:

Jedes Ziel ist eine Verbindung pro Marke: Wenn Sie WordPress für eine Marke verbinden, ist es für die anderen nicht verbunden. Siehe Workspaces & Brands.

Veröffentlichen ist tarifabhängig. Wenn Sie Integrations oder die Aktion Push nicht sehen, prüfen Sie Ihren Tarif unter Credits & Billing.

Ein Ziel verbinden

1. Öffnen Sie Integrations und wählen Sie einen Zieltyp.
2. Füllen Sie die Felder aus (siehe unten). Geheime Felder (Passwörter, API-Schlüssel, Signatur-Secrets) werden verschlüsselt gespeichert und maskiert, wann immer Sie die Verbindung erneut ansehen.
3. Mediastilo führt einen Verbindungstest durch, um vor dem Speichern zu bestätigen, dass die Zugangsdaten funktionieren.
4. Die Verbindung wird als Active angezeigt, wenn alles passt, oder als Error, wenn eine spätere Prüfung fehlschlägt (etwa weil Sie beim Ziel einen Schlüssel erneuert haben).

Sie können den Test jederzeit wiederholen, sich mit neuen Zugangsdaten erneut verbinden oder ein Ziel ganz trennen.

WordPress

WordPress bietet eine geführte Einrichtung. Klicken Sie auf Set up with guide, geben Sie die Adresse Ihrer Website ein, und Mediastilo prüft die Website und schlägt den einfachsten Weg vor:

• Autorisierung mit einem Klick (empfohlen). Unterstützt Ihre Website das, leitet Mediastilo Sie zu Ihrem eigenen WordPress weiter, wo Sie den Zugriff freigeben, ohne Passwörter kopieren zu müssen. WordPress erzeugt ein Application Password und übergibt es automatisch.
• Manuelle Eingabe (Ausweichlösung). Ist die Ein-Klick-Variante nicht verfügbar, erstellen Sie in WordPress ein Application Password (Users → Profile → Application Passwords) und fügen es zusammen mit Ihrer Website-URL und Ihrem Benutzernamen ein.

Nach dem Verbinden legen Sie im Assistenten die Standardwerte für Veröffentlichungen fest (den Beitragstyp, Standard-Kategorien und ob Beiträge veröffentlicht oder als Entwurf übertragen werden) und können optional Ihre Markenstimme auffrischen, indem die Website neu analysiert wird (das kostet einen Analyse-Credit). Diese Einstellungen können Sie später in der WordPress-Verbindung ändern (Edit publishing defaults).

Ghost

Mediastilo nutzt die Ghost Admin API. Legen Sie in Ghost eine Custom Integration an (Settings → Integrations → Add custom integration), um einen Admin API Key im Format id:secret sowie die Admin API URL zu erhalten. Fügen Sie beides hier ein.

Webhook / Custom REST

Für alles andere richten Sie Mediastilo auf eine Endpunkt-URL unter Ihrer Kontrolle. Beim Veröffentlichen sendet Mediastilo einen JSON-POST, der den Inhalt beschreibt, signiert mit einem Header X-Mediastilo-Signature: sha256=…, der aus Ihrem Signatur-Secret abgeleitet ist, damit Ihr Empfänger prüfen kann, dass die Anfrage echt ist. Beim Testen der Verbindung wird ein ping-Ereignis gesendet.

Einen Entwurf veröffentlichen

Sobald ein Ziel verbunden und ein Entwurf Ready ist, senden Sie ihn mit Push im Editor oder in der Entwurfsansicht. Durch Auswahl mehrerer Ziele können Sie an mehrere Ziele gleichzeitig veröffentlichen. Für ein ausgewähltes WordPress-Ziel können Sie Beitragstyp, Kategorien, Schlagwörter und Status direkt dort feinjustieren; die Felder sind mit Ihren gespeicherten Standardwerten vorbelegt und lassen sich pro Veröffentlichung überschreiben. Mediastilo:

• Sendet Titel und Text als veröffentlichten Beitrag (oder als geplanten, wenn Sie einen Veröffentlichungszeitpunkt festlegen), mit dem gewählten Beitragstyp, den Kategorien und Schlagwörtern.
• Speichert das Ergebnis: die Beitrags-ID beim Ziel und einen Link zur Ansicht.
• Markiert die Veröffentlichung als published oder failed, bei einem Problem mit der Fehlermeldung, damit Sie die Verbindung korrigieren und es erneut versuchen können.

Den vollständigen Lebenszyklus eines Entwurfs beschreibt Drafts & Publishing.

Was eine Verbindung liest

Eine Verbindung funktioniert in beide Richtungen. Mediastilo sendet nicht nur Entwürfe, sondern liest auch zurück, was die Website bereits veröffentlicht hat (Titel, Datum, Autor, Kategorien und Schlagwörter), damit Ihre eigene Produktion genauso gemessen werden kann wie die aller anderen. Von Ihnen wird dafür nichts zusätzlich verlangt: Gelesen wird mit den Zugangsdaten, die Sie ohnehin fürs Veröffentlichen angegeben haben, und immer nur veröffentlichte Beiträge. Entwürfe, private Beiträge und alles, was noch in einem redaktionellen Ablauf steckt, bleiben, wo sie sind.

Das ist der Unterschied zwischen einer Website, auf der Sie veröffentlichen, und einer, die Sie beobachten: Ein verbundenes CMS liefert echte Daten und echte Kategorien statt dessen, was eine öffentliche Seite zufällig zeigt. Darauf beruhen Ihre Benchmarks. Trennen Sie das Ziel, endet auch das Lesen.

Was zurückkommt: Google Search Console

Ziele sind der Ort, an den Ihre Inhalte gehen. Die Search Console ist die andere Hälfte: was passiert ist, nachdem sie dort angekommen sind. Wenn Sie sie verbinden, sieht Mediastilo die Suchbegriffe, die Menschen eingegeben haben, bevor sie Ihre Website fanden, auf welchen Seiten sie gelandet sind und wie oft. So beruhen die Ideen, die wir vorschlagen, auf dem, wonach tatsächlich gesucht wird, und nicht nur auf dem, was Sie uns als Ihre Themen nennen.

Sie finden sie im Bereich What comes back der Integrations-Seite, unter Ihren Zielen.

Was wir lesen und was wir nicht können

• Wir lesen Suchbegriffe, Zielseiten, Klicks, Impressionen und die durchschnittliche Position, für bis zu 16 Monate rückwirkend.
• Die Berechtigung ist nur lesend. Mediastilo kann weder in der Search Console noch sonst irgendwo in Ihrem Google-Konto etwas ändern.
• Wir sehen nie Ihr Google-Passwort, und Sie können die Verbindung jederzeit trennen.

Sie können auch einfach fragen

Sobald eine der beiden Verbindungen besteht, können Ask und der Entwurfsassistent sie im Gespräch auslesen, etwa „Was tippen Menschen ein, um uns zu finden?“, „Wie lief der Beitrag von letzter Woche?“ oder „Was haben wir diesen Monat tatsächlich veröffentlicht?“. Die Werkzeuge stehen einem Gespräch nur zur Verfügung, wenn die Verbindung besteht, sodass eine Antwort zu Ihren Suchbegriffen nie aus Allgemeinwissen zusammengesetzt wird. Solange keine Verbindung besteht, sagt Ask, was fehlt, und kann Ihnen eine Karte zeigen, die Sie auf diese Seite führt. Die Verbindung selbst stellen immer Sie her, mit Ihrem eigenen Konto.

Bevor Sie verbinden

Sie müssen in der Search Console bereits als Inhaber oder Nutzer der Website bestätigt sein, und zwar mit dem Google-Konto, das Sie verbinden wollen. Verbinden Sie ein Konto, das für Ihre Website nicht bestätigt ist, gelingt die Verbindung zwar, aber es gibt nichts zu messen. Mediastilo weist Sie darauf hin und bietet an, ein anderes Konto zu versuchen.

Die zu messende Website wählen

Nach der Autorisierung wählen Sie eine Property. Die Search Console kennt zwei Arten, und sie liefern nicht dieselben Daten:

Das ist der häufigste Grund, warum eine Search-Console-Verbindung stillschweigend nichts liefert: eine Website unter example.com, gemessen mit einer Property für https://www.example.com/. Mediastilo vergleicht jede Property mit der Website, auf der Sie bereits veröffentlichen, und markiert die wahrscheinliche mit Matches your site. In den meisten Fällen steht die richtige Antwort also schon oben in der Liste.

Properties, die Sie sehen, aber nicht lesen können (die Search Console nennt das nicht bestätigter Nutzer), werden ausgegraut und mit Begründung angezeigt. Bitten Sie den Inhaber der Website um vollständigen oder eingeschränkten Zugriff, dann werden sie auswählbar.

Es wird nie etwas für Sie ausgewählt, auch wenn es nur eine Option gibt, denn diese Wahl bestimmt, was jede spätere Zahl bedeutet.

Während sich der Verlauf füllt

Die jüngsten Tage kommen zuerst, sodass der letzte Monat fast sofort nutzbar ist. Frühere Monate werden in den folgenden Tagen im Hintergrund abgerufen, und die Karte zeigt, wie viele der sechzehn Monate bereits vorliegen.

Die Search Console veröffentlicht ihre Daten mit einigen Tagen Verzögerung, daher hinken die neuesten Zahlen dem heutigen Tag immer etwas hinterher. Diese Verzögerung liegt bei Google, nicht bei uns.

Erneut verbinden und trennen

• Needs reconnecting bedeutet, dass Google die Verbindung nicht mehr akzeptiert, meist weil der Zugriff im Google-Konto entfernt wurde oder die Person, die ihn erteilt hat, nicht mehr dabei ist. Nichts Erfasstes geht verloren: Verbinden Sie erneut, und die Messung läuft dort weiter, wo sie aufgehört hat.
• Disconnect entfernt die Verbindung und löscht die darüber erfassten Suchdaten.

Fehlerbehebung

• Verbindung zeigt Error: Wiederholen Sie den Test. Die häufigsten Ursachen sind ein erneuerter API-Schlüssel, ein abgelaufenes Application Password oder eine geänderte Website-URL. Verbinden Sie sich mit neuen Zugangsdaten erneut.
• WordPress schlägt fehl: Prüfen Sie, ob Sie das Application Password verwenden (nicht das Anmeldepasswort) und ob die REST-API unter …/wp-json/ erreichbar ist.
• Ghost schlägt fehl: Prüfen Sie, ob der Schlüssel der vollständige Admin API Key im Format id:secret ist und die URL auf Ihre Ghost-Admin-Domain zeigt.
• Webhook schlägt fehl: Prüfen Sie, ob Ihr Endpunkt auf das ping-Ereignis mit einem 2xx-Status antwortet und den Header X-Mediastilo-Signature prüft.

Wie es mit Integrationen weitergeht

Das Verbindungsmodell ist auf Wachstum ausgelegt: Ziele sind austauschbar, und die Autorisierung mit einem Klick ist für WordPress bereits verfügbar. Dieselbe Anmeldung ohne Kopieren von Zugangsdaten auf weitere Plattformen zu bringen, steht auf der Roadmap. Neue Ziele erscheinen automatisch in der Integrations-Liste, sobald sie verfügbar sind.

Siehe auch

• Drafts & Publishing: Entwürfe erstellen und übertragen.
• Workspaces & Brands: Verbindungen gelten pro Marke.
• Account & Settings: wo Integrations zu finden sind.
• Credits & Billing: welche Tarife Veröffentlichen enthalten.