Integrations

Z integracijami Mediastilo objavlja vaše dokončane osnutke tam, kjer vaše občinstvo dejansko bere. Cilj povežete enkrat za vsako znamko, nato pa lahko vsak pripravljen osnutek neposredno pošljete tja. Povezave upravljate v razdelku Integrations na nadzorni plošči.

Podprti cilji

Mediastilo danes ponuja tri cilje objave:

Vsak cilj je povezava za posamezno znamko: če WordPress povežete za eno znamko, za druge ni povezan. Glejte Workspaces & Brands.

Objavljanje je odvisno od paketa. Če ne vidite Integrations ali dejanja Push, preverite svoj paket v Credits & Billing.

Povezovanje cilja

1. Odprite Integrations in izberite vrsto cilja.
2. Izpolnite polja (glejte spodaj). Skrivna polja (gesla, ključi API, skrivnosti za podpis) so šifrirana v mirovanju in zakrita, kadar koli znova pogledate povezavo.
3. Mediastilo izvede preizkus povezave, da pred shranjevanjem potrdi, da poverilnice delujejo.
4. Povezava je prikazana kot Active, ko je vse v redu, ali kot Error, če poznejše preverjanje ne uspe (na primer, ker ste na cilju zamenjali ključ).

Preizkus lahko kadar koli ponovite, se znova povežete z novimi poverilnicami ali cilj povsem odklopite.

WordPress

WordPress ima vodeno nastavitev. Kliknite Set up with guide, vnesite naslov spletnega mesta, Mediastilo pa ga preveri in predlaga najpreprostejšo pot:

• Avtorizacija z enim klikom (priporočeno). Če vaše mesto to podpira, vas Mediastilo preusmeri v vaš WordPress, kjer odobrite dostop, brez kopiranja gesel. WordPress ustvari Application Password in ga samodejno vrne.
• Ročni vnos (nadomestna možnost). Če avtorizacija z enim klikom ni na voljo, v WordPressu ustvarite Application Password (Users → Profile → Application Passwords) in ga prilepite skupaj z URL-jem spletnega mesta in uporabniškim imenom.

Po povezavi v čarovniku izberete privzete nastavitve objave (vrsto prispevka, privzete kategorije in ali prispevki gredo ven objavljeni ali kot osnutek) ter po želji osvežite glas znamke s ponovno analizo spletnega mesta (to porabi en kredit za analizo). Te nastavitve lahko pozneje spremenite v povezavi WordPress (Edit publishing defaults).

Ghost

Mediastilo uporablja Ghost Admin API. V Ghostu ustvarite Custom Integration (Settings → Integrations → Add custom integration), da dobite Admin API key v obliki id:secret in Admin API URL. Oboje prilepite sem.

Webhook / Custom REST

Za vse drugo Mediastilo usmerite na URL končne točke, ki jo upravljate. Ob objavi Mediastilo pošlje JSON POST, ki opisuje vsebino, podpisan z glavo X-Mediastilo-Signature: sha256=…, izpeljano iz vaše skrivnosti za podpis, da lahko prejemnik preveri, ali je zahteva pristna. Ob preizkusu povezave se pošlje dogodek ping.

Objava osnutka

Ko je cilj povezan in je osnutek Ready, ga pošljite z gumbom Push v urejevalniku ali pogledu osnutka. Z izbiro več ciljev lahko objavite na več ciljev hkrati. Za izbrani cilj WordPress lahko kar tam natančno nastavite vrsto prispevka, kategorije, oznake in status; polja so vnaprej izpolnjena s shranjenimi privzetimi vrednostmi in jih lahko spremenite pri vsaki objavi. Mediastilo:

• Pošlje naslov in besedilo kot objavljen prispevek (ali načrtovan, če nastavite čas objave), z izbrano vrsto prispevka, kategorijami in oznakami.
• Zabeleži rezultat: ID prispevka na cilju in povezavo za ogled.
• Objavo označi kot published ali failed, ob težavi z napako, da lahko povezavo popravite in poskusite znova.

Celoten življenjski cikel osnutka je opisan v Drafts & Publishing.

Kaj povezava bere

Povezava deluje v obe smeri. Poleg pošiljanja osnutkov Mediastilo prebere tudi, kaj je spletno mesto že objavilo (naslov, datum, avtorja, kategorije in oznake), da lahko vašo lastno produkcijo merimo enako kot produkcijo vseh drugih. Od vas ne potrebujemo ničesar dodatnega: branje uporablja poverilnice, ki ste jih že dali za objavljanje, in bere samo objavljene prispevke. Osnutki, zasebni prispevki in vse, kar je še v uredniškem postopku, ostanejo, kjer so.

To je razlika med mestom, na katerem objavljate, in mestom, ki ga spremljate: povezan CMS da prave datume in prave kategorije, ne tistega, kar javna stran slučajno prikaže, zato je zanesljiva osnova vaših primerjav. Odklopite cilj in branje se ustavi.

Kaj se vrne: Google Search Console

Cilji so kraj, kamor gre vaša vsebina. Search Console je druga polovica: kaj se je zgodilo, ko je vsebina prispela tja. Ko jo povežete, Mediastilo vidi iskalne izraze, ki so jih ljudje vtipkali, preden so našli vaše mesto, na katere strani so prišli in kako pogosto. Tako ideje, ki jih predlagamo, temeljijo na tem, kar ljudje dejansko iščejo, ne le na tem, kar nam poveste o svojih temah.

Najdete jo v razdelku What comes back na strani Integrations, pod vašimi cilji.

Kaj beremo in česa ne moremo

• Beremo iskalne izraze, ciljne strani, klike, prikaze in povprečni položaj, za največ zadnjih 16 mesecev.
• Dovoljenje je samo za branje. Mediastilo ne more ničesar spremeniti v Search Console ali kje drugje v vašem Googlovem računu.
• Vašega gesla za Google nikoli ne vidimo, povezavo pa lahko kadar koli prekinete.

Lahko tudi preprosto vprašate

Ko obstaja katera koli od obeh povezav, jo lahko Ask in pomočnik za osnutke uporabita v pogovoru: »kaj ljudje vtipkajo, da nas najdejo?«, »kako se je odrezal prispevek prejšnjega tedna?«, »kaj smo ta mesec dejansko objavili?«. Orodja so pogovoru na voljo le, ko povezava obstaja, zato odgovor o vaših iskalnih izrazih nikoli ni sestavljen iz splošnega znanja. Dokler povezave ni, Ask pove, kaj manjka, in vam lahko ponudi kartico, ki vas pripelje na to stran; povezavo pa vedno vzpostavite sami, s svojim računom.

Preden povežete

V Search Console morate biti že potrjeni kot lastnik ali uporabnik spletnega mesta, in sicer z Googlovim računom, ki ga boste povezali. Če povežete račun, ki za vaše mesto ni potrjen, povezava uspe, a ni česa meriti: Mediastilo vas na to opozori in ponudi poskus z drugim računom.

Izbira mesta za merjenje

Po avtorizaciji izberete eno lastnost. Search Console pozna dve vrsti, ki nimata enakih podatkov:

To je najpogostejši razlog, da povezava s Search Console tiho ne vrne ničesar: mesto na example.com, merjeno z lastnostjo za https://www.example.com/. Mediastilo vsako lastnost primerja z mestom, na katerem že objavljate, in verjetno pravo označi z Matches your site, zato je v večini primerov pravi odgovor že na vrhu seznama.

Lastnosti, ki jih vidite, a jih ne morete brati (Search Console temu pravi nepotrjen uporabnik), so prikazane sivo z razlogom. Lastnika mesta prosite za poln ali omejen dostop in postale bodo izbirne.

Nikoli ničesar ne izberemo namesto vas, tudi če je možnost ena sama, ker ta izbira določa, kaj pomeni vsaka poznejša številka.

Medtem ko se zgodovina polni

Najnovejši dnevi pridejo prvi, zato je zadnji mesec uporaben skoraj takoj. Starejši meseci se v naslednjih dneh zbirajo v ozadju, kartica pa pokaže, koliko od šestnajstih mesecev je že na voljo.

Search Console objavlja podatke z nekajdnevnim zamikom, zato najnovejše številke vedno nekoliko zaostajajo za današnjim dnem. Zamik je Googlov, ne naš.

Ponovna povezava in odklop

• Needs reconnecting pomeni, da Google povezave ne sprejema več, običajno zato, ker je bil dostop odstranjen v Googlovem računu ali ker je oseba, ki ga je odobrila, odšla. Nič zbranega se ne izgubi: znova se povežite in merjenje se nadaljuje, kjer se je ustavilo.
• Disconnect odstrani povezavo in izbriše iskalne podatke, zbrane prek nje.

Odpravljanje težav

• Povezava kaže Error: ponovite preizkus. Najpogostejši vzroki so zamenjan ključ API, potekel Application Password ali spremenjen URL spletnega mesta. Znova se povežite s svežimi poverilnicami.
• WordPress ne deluje: preverite, ali uporabljate Application Password (ne gesla za prijavo) in ali je REST API dosegljiv na …/wp-json/.
• Ghost ne deluje: preverite, ali je ključ celoten Admin API key v obliki id:secret in ali URL kaže na vašo skrbniško domeno Ghost.
• Webhook ne deluje: preverite, ali vaša končna točka na dogodek ping vrne status 2xx in preverja glavo X-Mediastilo-Signature.

Kaj prihaja pri integracijah

Model povezav je zasnovan za rast: cilji so zamenljivi, avtorizacija z enim klikom pa za WordPress že deluje. Enako prijavo brez kopiranja poverilnic želimo prenesti na več platform, kar je v načrtu razvoja. Novi cilji se ob izidu samodejno pojavijo na seznamu Integrations.

Glejte tudi

• Drafts & Publishing: ustvarjanje in pošiljanje osnutkov.
• Workspaces & Brands: povezave veljajo za posamezno znamko.
• Account & Settings: kje so Integrations.
• Credits & Billing: kateri paketi vključujejo objavljanje.