De ce documentația API este Content Marketing Gold

Acesta se adresează tuturor agenților mei de marketing B2B SaaS care au luxul de a încerca să vândă inginerilor și dezvoltatorilor.

Nu este o treabă ușoară. Nu este la fel de simplu ca publicarea unui anunț inteligent sau desfășurarea unui webinar interesant. Nu este la fel de simplu ca să produci o carte electronică și să scrii câteva postări pe LinkedIn.

Este puțin mai complicat... Dar nu trebuie să pară imposibil.

O mulțime de produse SaaS au început să creeze ecosisteme pentru dezvoltatori și API-uri pentru a oferi date și a inspira soluții personalizate care generează venituri suplimentare și creștere pentru afacere.

Când te uiți la succesul Ecosistemului AppExchange al Salesforce și al ecosistemului înfloritor al dezvoltatorilor Shopify – este foarte evident că această abordare poate oferi venituri uimitoare atât pentru parteneri, cât și pentru brand. În 2021, partenerii dezvoltatori ai Shopify au câștigat peste 230 de milioane de dolari, iar un studiu IDC (International Data Corporation) prezice că Salesforce va contribui cu 1,2 trilioane de dolari la economiile locale din întreaga lume. Nu-i rău nu? Priviți această creștere de la Shopify...

Acest lucru nu se întâmplă întâmplător.

Se întâmplă investind în comunitatea ta și investind în conținut care îi va sprijini.

Canalul YouTube ShopifyDevs este un exemplu clar al cum arată o investiție în comunitatea ta. Canalul este plin de videoclipuri distractive, captivante și frumos concepute, care vorbesc despre orice, de la pași tactici la utilizarea API-ului până la videoclipuri strategice de nivel înalt.

Cantitatea de conținut încărcat pe acest canal și calitatea editărilor demonstrează că aceasta nu este o investiție mică din partea Shopify. Este ceva pe care îl iau în serios și comunitatea a răspuns vizionându-se și abonându-se într-un mod masiv.

Dacă vă aflați în acest spațiu, nu trebuie să vă vorbesc despre oportunitățile care există în crearea de soluții pentru ingineri. Este o strategie puternică, iar cifrele pe care Shopify și Salesforce le fac în ecosistemul lor sunt exemple grozave ale acesteia.

În calitate de marketeri, deseori trecem cu vederea faptul că acesta este un domeniu în care ar trebui să ne jucăm.

Nu ar trebui să lăsăm echipelor noastre de produse să iasă și să dezvolte documentația API. Nu ar trebui să lăsăm doar CTO să găsească timp pentru a crea un set grozav de documentație.

Ar trebui să ne gândim la modul în care ne putem sprijini propria echipă de ingineri pentru a crea documentație și conținut care să adauge efectiv valoare vieții clienților noștri.

Una dintre cele mai bune modalități de a face acest lucru este îmbrățișarea și investirea în documentație excelentă.

Documentația excelentă API este masiv subestimată ca strategie de marketing de conținut în B2B SaaS.

O documentare excelentă poate:

• Generați linkuri complete ale autorităților de domeniu
• Stabiliți încredere cu clienții dvs
• Păstrați-vă clienții pe termen lung
• Ajută la ridicarea produsului
• Inspirați media
• Câștigați backlink-uri de calitate

Și multe altele... Iată un instantaneu al unora dintre cele mai populare centre de documentare și a beneficiilor de marketing de conținut pe care le oferă mărcilor lor:

Dar trebuie să știi ce faci. Iată șase tehnici simple de reținut atunci când creați documentația SaaS. Sper că puteți folosi acest lucru pentru a vă asigura că documentația pe care o creați este nu numai folosită, ci și găsită prin căutare și în căsuța de e-mail a clienților dvs. atunci când cineva le trimite un e-mail spunând „verificați asta”.

Să trecem la asta…

Păstrați-vă documentația curată

Nu trebuie să reinventezi roata aici.

Companii precum Shopify, Stripe, WorkOS și Gitlab ne-au arătat cum arată documentația grozavă. Formatul nu trebuie să fie prea complicat.

Nu te complica.

Plasați navigarea în stânga și puneți conținutul/codul în dreapta. Partea din dreapta sus oferă oamenilor posibilitatea de a se autentifica, de a se înscrie sau de a afla informații despre noutățile din documente. Asigurați-vă că există o bară de căutare disponibilă de îndată ce oamenii ajung pe documentele dvs. API și dacă aveți bugetul necesar pentru a face lucrurile mai interactive - includeți un videoclip introductiv pe pagina dvs. de pornire.

Faceți-l ușor de navigat

Cel mai mare sfat pentru marketerii care încearcă să creeze o secțiune de documentare a site-ului lor ar fi să trateze pagina de pornire a documentației ca pe o pagină de destinație. Scopul primei pagini a centrului dumneavoastră de documentare este să (i) să îi direcționați către calea sau cel mai comun rezultat și (ii) să-i educați cu privire la ceea ce vor găsi în documentația unei companii.

Vor găsi ghiduri de pornire rapidă? Vor găsi ei definiții? Există undeva unde pot merge pentru mai mult suport 1-1? Încercați să răspundeți la toate aceste întrebări în pagina principală, creând o experiență intuitivă și ușor de urmărit. Tine minte:

Nu aici îți câștigi călătoria la Cannes.

Aici vei câștiga promoția.

O altă abordare interesantă pe care am văzut-o implementată de cei de la WorkOS a fost capacitatea de a naviga în funcție de caz de utilizare. Stripe face acest lucru bine, având o pagină Docs înaintea unei pagini API. Puteți alege dacă căutați Documente pentru operațiuni de afaceri sau Documente pentru servicii financiare...

Un alt produs care face acest lucru foarte bine este Twilio:

Dacă aveți un set solid de produse, faceți mai ușor pentru utilizatorii dvs. navigarea la documentație în funcție de cazuri de utilizare. Folosiți analizele și datele despre produse pentru a informa prioritizarea documentației și pentru a arăta că înțelegeți punctele dureroase ale clienților dvs.

Structurați-vă adresele URL cu excelență

Vrei să vezi magia digitală? Vizitați documentația Stripe, urmăriți adresa URL și derulați...

Pe măsură ce derulați, adresa URL se schimbă de la docs/ api la /api/authentication la /api/metadata și astfel orice altă extensie pe care o au. Este o chestie de frumusețe. De ce?

Deoarece fiecare dintre aceste adrese URL poate fi conectată și conduce oamenii către această secțiune specifică. Este experiența ideală pentru utilizator (defilare infinită), oferind în același timp lui Stripe posibilitatea de a indexa aceste secțiuni individuale în Google prin domeniul lor. Este lucrul din care sunt făcute visele unui SEO...

Nu numai că puteți consuma conținutul fără a accesa o pagină nouă, ci și puteți partaja anumite secțiuni folosind adresa URL. Astăzi, Stripe are peste 45.000 de domenii de referință care se leagă la documentația lor. Strategia de a face din fiecare secțiune cheie o adresă URL care poate fi conectată este o modalitate excelentă de a vă asigura că scriitorii, inginerii și dezvoltatorii fac link la aceasta atunci când este cazul.

Nu încercați să „comercializați” în documentația dvs

Marketingul are o relație de dragoste-ura cu documentația.

În principal pentru că marketerii adoră să încerce să găsească modalități de a condimenta lucrurile și de a adăuga „esența mărcii” lor în orice. Nu este necesar cu documentație. Tăiați puful și nu încercați să vă vindeți produsul sau diversele caracteristici. Respectați ceea ce își doresc oamenii: cod și direcție.

Nu lăsați oamenii să-și „asume erorile”

Acesta este un sfat destul de tactic, dar dezvoltatorii vor să afle DE CE lucrurile nu funcționează.

Creați documentație care arată DE CE există erori în produsul dvs. și când încercați să construiți pe platforma dvs. Este unul dintre cele mai frecvent căutate lucruri când vine vorba de documente tehnice, dar am văzut că este exclus din multe documente API. Faceți o listă cu erorile cu care se pot întâlni oamenii și faceți un link către documentația despre cum pot fi prevenite aceste erori.

Ultimul meu sfat atunci când vine vorba de crearea unei documentații grozave este acesta...

Scrieți pentru oameni în primul rând, în al doilea rând pentru roboți

Aceasta ar putea fi cea mai importantă parte a documentației.

Trebuie să acordați prioritate experienței dezvoltatorului când vine vorba de documentare, înainte de a începe chiar să vă gândiți la modul în care Google vă va vedea conținutul. Sunt importante indexabilitatea, structura URL-ului și titlurile pe care le utilizați pentru documentația dvs.? Fără îndoială.

Dar capacitatea de a capta volumul de căutare este cireașa de pe tort DUPĂ ce rezolvați probleme reale și oferiți claritate în documentele dvs. Creați mai întâi pentru oameni. Optimizați secunda.

Sper să aveți o săptămână minunată și că ați găsit acest lucru util. Sunt convins că documentația este unul dintre cele mai importante și subestimate elemente ale mixului de marketing pentru companiile axate pe inginer/dezvoltator. Dacă lucrați în aceste spații și doriți sprijin în crearea de conținut care vă va ajuta comunitatea de ingineri să vă iubească – Luați legătura!

Sunt mereu dispus să vorbesc despre modul în care conținutul poate fi folosit pentru a modela cultura.