Integracije su način na koji Mediastilo objavljuje vaše gotove nacrte na mjesta koja vaša publika doista čita. Odredište povežete jednom po brendu, i od tada možete poslati (push) bilo koji spreman nacrt izravno na njega. Veze se uređuju u odjeljku Integracije na nadzornoj ploči.
<!-- screenshot: Stranica Integracije s popisom dostupnih odredišta i njihovim statusom -->Podržana odredišta
Mediastilo danas dolazi s tri odredišta za objavljivanje:
| Odredište | Što povezujete | Što vam treba |
|---|---|---|
| WordPress | Samostalno hostanu ili WordPress.com stranicu putem REST API-ja | URL stranice, korisničko ime i Application Password |
| Ghost | Ghost stranicu putem Admin API-ja | Admin API URL i Admin API ključ (id:secret) |
| Webhook / Custom REST | Bilo koju HTTP krajnju točku kojom upravljate | URL krajnje točke i tajni potpis (signing secret) |
Svako odredište je veza po brendu, povezivanje WordPressa za jedan brend ne povezuje ga za ostale. Pogledajte Radni prostori i brendovi.
Objavljivanje je značajka ovisna o planu. Ako ne vidite Integracije ili akciju Pošalji (Push), provjerite svoj plan u Krediti i naplata.
Povezivanje odredišta
- Idite na Integracije i odaberite vrstu odredišta.
- Ispunite njegova polja (vidi niže). Tajna polja, lozinke, API ključevi, tajni potpisi, šifrirana su u mirovanju i maskirana svaki put kada ponovno pregledate vezu.
- Mediastilo pokreće test veze kako bi potvrdila da vjerodajnice rade prije spremanja.
- Veza se prikazuje kao Aktivna kada je ispravna, ili Greška ako kasnija provjera ne uspije (primjerice, ako rotirate ključ na odredištu).
Test možete ponovno pokrenuti u bilo kojem trenutku, povezati se s novim vjerodajnicama ili u potpunosti odspojiti odredište.
<!-- screenshot: Dijalog za povezivanje WordPressa s maskiranim poljem Application Password -->WordPress
WordPress ima vođeno postavljanje. Kliknite Vođeno postavljanje, unesite adresu stranice, a Mediastilo provjeri stranicu i ponudi najjednostavniji put:
- Odobravanje jednim klikom (preporučeno). Ako vaša stranica to podržava, Mediastilo vas preusmjeri na vaš WordPress da odobrite pristup, bez kopiranja lozinki. WordPress sam generira Application Password i vraća ga.
- Ručni unos (rezerva). Ako odobravanje jednim klikom nije dostupno, izradite Application Password u WordPressu (Korisnici → Profil → Application Passwords) i zalijepite ga zajedno s URL-om stranice i korisničkim imenom.
Nakon povezivanja, čarobnjak omogućuje odabir zadanih postavki objavljivanja (vrste objave, zadanih kategorija i hoće li objave izlaziti kao objavljene ili kao skica) te po želji osvježavanje glasa vašeg Brenda ponovnom analizom stranice (troši jedan kredit za analizu). Ovo kasnije možete promijeniti na WordPress vezi (Uredi zadane postavke objavljivanja).
Ghost
Mediastilo koristi Ghost Admin API. U Ghostu izradite Custom Integration
(Settings → Integrations → Add custom integration) kako biste dobili Admin API
ključ u obliku id:secret, te Admin API URL. Zalijepite oboje ovdje.
Webhook / Custom REST
Za sve ostalo, usmjerite Mediastilo na URL krajnje točke kojom upravljate. Pri
objavljivanju Mediastilo šalje JSON POST koji opisuje sadržaj, potpisan zaglavljem
X-Mediastilo-Signature: sha256=… izvedenim iz vašeg tajnog potpisa, kako bi
vaš primatelj mogao provjeriti da je zahtjev autentičan. Pri testiranju veze šalje se
događaj ping.
Objavljivanje nacrta
Kada je odredište povezano i nacrt je Spreman, koristite Pošalji (Push) u uređivaču ili prikazu nacrta da ga pošaljete. Možete objaviti na više odredišta odjednom tako da ih odaberete. Za odabrano WordPress odredište možete odmah prilagoditi vrstu objave, kategorije, oznake i status (unaprijed popunjeno iz vaših zadanih postavki i promjenjivo za svaku objavu). Mediastilo:
- Šalje naslov i tijelo, kao objavljenu objavu (ili zakazanu, ako postavite vrijeme objave), s odabranom vrstom objave, kategorijama i oznakama.
- Bilježi rezultat, ID objave na odredištu i poveznicu za pregled.
- Označava objavu objavljeno ili neuspjelo, uz grešku ako nešto pođe po zlu, kako biste mogli popraviti vezu i pokušati ponovno.
Cijeli životni ciklus nacrta pogledajte u Nacrti i objavljivanje.
Što veza čita
Veza je dvosmjerna. Osim što šalje nacrte, Mediastilo čita natrag ono što je ta stranica već objavila — naslov, datum, autora, kategorije i oznake — kako bi se vaš vlastiti učinak mogao mjeriti jednako kao i tuđi. Od vas se ne traži ništa dodatno: čitanje koristi vjerodajnice koje ste već dali za objavljivanje i čita isključivo objavljene objave. Nacrti, privatne objave i sve što je u uredničkom postupku ostaju gdje jesu.
To je razlika između stranice na koju objavljujete i stranice koju pratite: povezani CMS daje stvarne datume i stvarne kategorije umjesto onoga što javna stranica slučajno prikazuje, pa je on temelj na kojem se grade vaše usporedbe. Prekinete li vezu s odredištem, prestaje i čitanje.
Što se vraća: Google Search Console
Odredišta su mjesta na koja ide vaš sadržaj. Search Console je druga polovica: što se dogodilo nakon što je tamo stigao. Povezivanjem Mediastilo vidi pojmove koje su ljudi upisali prije nego što su pronašli vašu stranicu, na koje su stranice došli i koliko često, kako bi se ideje koje predlažemo temeljile na onome što ljudi doista traže, a ne samo na onome što nam kažete da pokrivate.
Nalazi se u odjeljku Što se vraća na stranici Integracije, ispod vaših odredišta.
<!-- screenshot: stranica Integracije, odjeljak "Što se vraća" sa Search Consoleom -->Što čitamo, a što ne možemo
- Čitamo pojmove pretraživanja, odredišne stranice, klikove, prikaze i prosječnu poziciju, za posljednjih do 16 mjeseci.
- Dopuštenje je samo za čitanje. Mediastilo ne može promijeniti ništa u Search Consoleu ni bilo gdje drugdje na vašem Google računu.
- Nikad ne vidimo vašu Google lozinku, a vezu možete prekinuti u bilo kojem trenutku.
Možete i jednostavno pitati
Kad veza postoji, Pitaj i asistent za nacrte mogu je pročitati u razgovoru — „što ljudi upisuju da bi nas našli?”, „kako je prošao tekst od prošlog tjedna?”, „što smo zapravo objavili ovaj mjesec?”. Alati se razgovoru nude samo kad veza postoji, pa se odgovor o vašim pojmovima pretrage nikad ne sastavlja iz općeg znanja. Dok ne povežete, Pitaj će reći što mu nedostaje i može vam ponuditi karticu koja vas vodi na ovu stranicu; samu vezu uvijek uspostavljate vi, pod svojim računom.
Prije povezivanja
Već morate biti potvrđeni kao vlasnik ili korisnik stranice u Search Consoleu, i to s Google računom koji ćete povezati. Ako povežete račun koji nije potvrđen za vašu stranicu, veza će uspjeti, ali neće biti ničega za mjeriti; Mediastilo će vam to reći i ponuditi da pokušate s drugim računom.
Odabir stranice koju mjerimo
Nakon odobrenja odabirete jednu stranicu (property). Search Console ima dvije vrste i to nisu isti podaci:
| Vrsta | Pokriva |
|---|---|
Domena (example.com) | Sve poddomene te http i https |
URL prefiks (https://www.example.com/) | Samo adrese koje počinju točno tako |
Ovo je najčešći način na koji Search Console veza tiho ne vrati ništa: stranica
koja poslužuje example.com, a mjeri se property za https://www.example.com/.
Mediastilo uspoređuje svaku stranicu s onom na koju već objavljujete i označava
vjerojatnu s Odgovara vašoj stranici, pa je u većini slučajeva točan odgovor
već na vrhu popisa.
Stranice koje vidite, ali ne možete čitati (Search Console to zove neprovjereni korisnik) prikazane su zasivljeno, s razlogom. Zatražite od vlasnika puni ili ograničeni pristup i postat će odabirljive.
Ništa se ne odabire umjesto vas, čak ni kad postoji samo jedna opcija, jer taj odabir određuje što znači svaki kasniji broj.
Dok se povijest popunjava
Najnoviji dani stižu prvi, pa je posljednji mjesec upotrebljiv gotovo odmah. Raniji mjeseci prikupljaju se u pozadini tijekom sljedećih dana, a kartica pokazuje koliko od šesnaest mjeseci već ima.
Search Console objavljuje podatke s nekoliko dana odgode, pa najnovije brojke uvijek malo kasne. To je Googleovo kašnjenje, ne naše.
Ponovno povezivanje i prekid veze
- Treba ponovno povezati znači da Google više ne prihvaća vezu, obično zato što je pristup uklonjen na Google računu ili je osoba koja ga je odobrila otišla. Ništa prikupljeno nije izgubljeno: povežite ponovno i mjerenje se nastavlja ondje gdje je stalo.
- Prekini vezu uklanja vezu i briše podatke o pretraživanju prikupljene pod njom.
Rješavanje problema
- Veza prikazuje Greška: ponovno pokrenite test. Najčešći uzroci su rotirani API ključ, istekla Application Password ili promijenjen URL stranice. Povežite se s novim vjerodajnicama.
- WordPress ne uspijeva: potvrdite Application Password (ne lozinku za
prijavu) i da je REST API dostupan na
…/wp-json/. - Ghost ne uspijeva: potvrdite da je ključ cijeli
id:secretAdmin API ključ i da URL upućuje na vašu Ghost admin domenu. - Webhook ne uspijeva: potvrdite da vaša krajnja točka vraća
2xxstatus za događajpingi da provjerava zaglavljeX-Mediastilo-Signature.
Što je sljedeće za integracije
Model veze izgrađen je tako da raste, odredišta su modularna (pluggable), a odobravanje jednim klikom već je dostupno za WordPress. Donošenje iste prijave bez lijepljenja ključeva na više platformi na je planu razvoja. Nova odredišta automatski se pojavljuju na popisu Integracija kako se isporučuju.
Pogledajte i
- Nacrti i objavljivanje: generiranje i slanje nacrta.
- Radni prostori i brendovi: veze su po brendu.
- Račun i postavke: gdje se Integracije nalaze.
- Krediti i naplata: koji planovi uključuju objavljivanje.