Integracije

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.

Podržana odredišta

Mediastilo danas dolazi s tri odredišta za objavljivanje:

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

1. Idite na Integracije i odaberite vrstu odredišta.
2. 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.
3. Mediastilo pokreće test veze kako bi potvrdila da vjerodajnice rade prije spremanja.
4. 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.

Prekid veze i 30 dana nakon njega

Prekini vezu najprije traži potvrdu, a zatim prestaje objavljivati na stranici i čitati je. Ništa se ne briše odmah: veza i arhiva objava te stranice koju smo pročitali (vidi Što veza čita) čuvaju se 30 dana, a stranica ih prikazuje pod Uklonjeno, s datumom kada se brišu.

• Vrati vraća vezu kakva je bila, zajedno s arhivom. Nedostupno je dok je povezana druga stranica iste vrste; najprije prekinite vezu s njom.
• Ponovno povezivanje iste stranice unutar 30 dana čini isto, s vjerodajnicama koje unesete.
• Povezivanje druge stranice iste vrste odmah briše uklonjenu vezu i njezinu arhivu, kako nova stranica ne bi naslijedila objave stare.
• Izbriši odmah briše vezu i njezinu arhivu odmah, bez čekanja 30 dana. To se ne može poništiti.

Nakon 30 dana veza i njezina arhiva trajno se brišu.

Povezivanje je zasebna stranica u četiri koraka: odaberete platformu, povežete je, odaberete kako se šalju objave i prođete provjeru koja se prijavi na stranicu bez objavljivanja ičega. Na kraju dolazite na vlastitu stranicu te veze. Svaka povezana stranica ima svoju: Pregled (koliko je poslano i koliko nije uspjelo u zadnjih 30 dana, što onamo šalje, vi ručno i svaka automatizacija, te najnovije objave), Objave (zadnjih 10 slanja, s razlogom za svako neuspjelo) i Postavke (zadane postavke objavljivanja, ponovno povezivanje, prekid veze).

WordPress

WordPress ima vođeno postavljanje. Kliknite Prijava na vašoj stranici, 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 (Postavke).

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.

Svaka objava šalje polje action: "created" kad se nacrt šalje prvi put, "updated" kad se isti nacrt šalje ponovno. Pri ažuriranju previousExternalId sadrži id koji je vaš primatelj vratio prošli put (inače je null), kako biste mogli ažurirati taj zapis umjesto da dodate novi. Vratite JSON s poljem id (i po želji url) kako bi ga Mediastilo zapamtio.

Objava nosi i polje dek: podnaslov nacrta (redak ispod naslova) kao običan tekst, ili null ako ga nema. Tijelo se šalje bez njega, pa vaš primatelj odlučuje gdje ide.

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.
• Stavlja podnaslov nacrta (redak ispod naslova) onamo gdje ga drži vaša stranica, a šalje ga i kao sažetak (excerpt) objave. Vidi niže.
• 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.

Popisi autora, kategorija, oznaka i prilagođenih taksonomija (na primjer taksonomije grad) dolaze s vaše stranice. Mediastilo čuva posljednji popis koji mu je stranica dala, pa se opcije otvaraju odmah, a u pozadini ga osvježava najviše jednom u 10 minuta. Ako vašoj stranici nije moguće pristupiti, nastavljate raditi sa spremljenim popisom, uz napomenu s datumom kada je spremljen. Prvi put, dok još nema spremljenog popisa, opcije čekaju odgovor vaše stranice.

Gdje ide podnaslov

WordPress nema polje za podnaslov, pa ga svaka stranica drži negdje drugdje: neke otvaraju objavu podnaslovom (H2), druge prvim odlomkom. Kad prvi put objavite nacrt s podnaslovom, Mediastilo pročita nedavne objave vaše stranice, prepozna što ona radi i to zapamti za tu vezu. Ako je objava premalo da bi se to prepoznalo, koristi prvi odlomak. Ako tijelo već počinje podnaslovom, ne dodaje ga drugi put.

Ako želite sami odabrati, otvorite Postavke na vezi i postavite Gdje ide podnaslov: kao na mojoj stranici (prepoznaj), prvi odlomak, podnaslov (H2) ili samo sažetak. Na Ghostu podnaslov ide u sažetak objave.

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.

Š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:

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:secret Admin 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 2xx status za događaj ping i da provjerava zaglavlje X-Mediastilo-Signature.
• „Ta stranica odbija zahtjeve našeg poslužitelja”: stranica se odazvala, ali je njezin vatrozid ili hosting odbio naš poslužitelj (ili nije dopustio da zahtjev završi). To nije pogreška u adresi i vjerodajnice to ne mogu zaobići. Automatski dobivamo obavijest i javljamo se; ako upravljate stranicom, rješenje je propustiti naš poslužitelj kroz vatrozid ili sigurnosni dodatak.

Š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.