Perché la documentazione API è l'oro per il marketing dei contenuti

Questo va a tutti i miei marketer SaaS B2B che hanno il lusso di provare a vendere a ingegneri e sviluppatori.

Non è un lavoro facile. Non è semplice come pubblicare un annuncio intelligente o eseguire un webinar interessante. Non è semplice come produrre un ebook e pubblicare alcuni post su LinkedIn.

È un po' più complicato... Ma non deve sembrare impossibile.

Molti prodotti SaaS hanno iniziato a creare ecosistemi di sviluppatori e API per offrire dati e ispirare soluzioni personalizzate che generano entrate e crescita aggiuntive per l'azienda.

Se guardi al successo dell'ecosistema AppExchange di Salesforce e del fiorente ecosistema per sviluppatori Shopify, è molto ovvio che questo approccio può offrire entrate straordinarie sia per i partner che per il marchio. Nel 2021, i partner di sviluppo di Shopify hanno guadagnato oltre 230 milioni di dollari e uno studio IDC (International Data Corporation) prevede che Salesforce contribuirà con 1,2 trilioni di dollari alle economie locali di tutto il mondo. Non male eh? Guarda questa crescita di Shopify...

Questo non accade per caso.

Succede investendo nella tua comunità e investendo in contenuti che li supporteranno.

Il canale YouTube di ShopifyDevs è un chiaro esempio di come appare un investimento nella tua community. Il canale è pieno di video divertenti, coinvolgenti e ben progettati che parlano di tutto, dai passaggi tattici per sfruttare l'API a video strategici di alto livello.

La quantità di contenuti caricati su questo canale e la qualità delle modifiche dimostrano che non si tratta di un piccolo investimento da parte di Shopify. È qualcosa che stanno prendendo sul serio e la community ha risposto guardando e iscrivendosi in modo massiccio.

Se sei in questo spazio, non devo parlarti delle opportunità che esistono nella creazione di soluzioni per gli ingegneri. È una strategia potente e i numeri che Shopify e Salesforce stanno facendo nel loro ecosistema ne sono ottimi esempi.

Come marketer, spesso trascuriamo il fatto che questa è un'area in cui dovremmo anche giocare.

Non dovremmo semplicemente lasciare ai nostri team di prodotto il compito di sviluppare la documentazione API. Non dovremmo semplicemente lasciare al CTO il compito di trovare il tempo per creare una grande serie di documentazione.

Dovremmo pensare a come possiamo supportare il nostro team di ingegneri per creare documentazione e contenuto che aggiungeranno effettivamente valore alla vita dei nostri clienti.

Uno dei modi migliori per farlo è abbracciare e investire in un'ottima documentazione.

L'ottima documentazione API è enormemente sottovalutata come strategia di marketing dei contenuti nel SaaS B2B.

Una buona documentazione può:

• Indirizza i collegamenti completi dell'autorità di dominio
• Stabilisci la fiducia con i tuoi clienti
• Mantieni i tuoi clienti a lungo termine
• Aiuta ad elevare il prodotto
• Ispira la copertura mediatica
• Guadagna backlink di qualità

E molto altro ancora... Ecco un'istantanea di alcuni degli hub di documentazione più popolari e dei vantaggi di marketing dei contenuti che offrono ai loro marchi:

Ma devi sapere cosa stai facendo. Ecco sei semplici tecniche da tenere a mente durante la creazione della documentazione SaaS. Spero che tu possa usarlo per assicurarti che la documentazione che stai creando non venga solo utilizzata, ma anche trovata tramite la ricerca e la posta in arrivo dei tuoi clienti quando qualcuno gliela invia via email dicendo "dai un'occhiata".

Andiamo a questo...

Mantieni pulita la tua documentazione

Non è necessario reinventare la ruota qui.

Aziende come Shopify, Stripe, WorkOS e Gitlab ci hanno mostrato che aspetto ha un'ottima documentazione. Il formato non deve essere eccessivamente complicato.

Mantieni la semplicità.

Posiziona la navigazione a sinistra e inserisci il contenuto/codice a destra. Il lato in alto a destra offre alle persone la possibilità di accedere, registrarsi o trovare informazioni sulle novità nei documenti. Assicurati che sia disponibile una barra di ricerca non appena le persone atterrano sui tuoi documenti API e se hai il budget per rendere le cose più interattive, incorpora un video introduttivo sulla tua home page.

Semplifica la navigazione

Il mio consiglio più grande per gli esperti di marketing che cercano di creare una sezione di documentazione del loro sito sarebbe quello di trattare la home page della documentazione come una pagina di destinazione. L'obiettivo della prima pagina del tuo hub di documentazione è (i) indirizzarli al percorso o al risultato più comune e (ii) istruirli su ciò che troveranno nella documentazione di un'azienda.

Troveranno guide di avvio rapido? Troveranno definizioni? C'è un posto dove possono andare per più supporto 1-1? Prova a rispondere a tutte queste domande nella home page creando un'esperienza intuitiva e facile da seguire. Ricorda:

Non è qui che vinci il tuo viaggio a Cannes.

È qui che vinci la tua promozione.

Un altro approccio interessante che ho visto implementato dalle persone di WorkOS è stata la possibilità di navigare in base al caso d'uso. Stripe lo fa bene avendo una pagina Documenti prima di una pagina API. Puoi selezionare se stai cercando documenti operativi aziendali o documenti sui servizi finanziari...

Un altro prodotto che lo fa davvero bene è Twilio:

Se disponi di un solido set di prodotti, consenti ai tuoi utenti di accedere facilmente alla documentazione in base ai casi d'uso. Utilizza dati analitici e di prodotto per informare sulla definizione delle priorità della documentazione e dimostrare di aver compreso i punti deboli dei tuoi clienti.

Struttura i tuoi URL con eccellenza

Vuoi vedere la magia digitale? Visita la documentazione di Stripe, guarda l'URL e scorri...

Mentre scorri l'URL cambia da docs/ api a /api/authentication a /api/metadata e così ogni altra estensione che hanno. È una cosa di bellezza. Come mai?

Perché ciascuno di questi URL è collegabile e indirizza le persone a questa sezione specifica. È l'esperienza utente ideale (scorrimento infinito) pur offrendo a Stripe la possibilità di indicizzare queste singole sezioni in Google tramite il proprio dominio. È la cosa di cui sono fatti i sogni di un SEO...

Non solo puoi consumare il contenuto senza passare a una nuova pagina, ma puoi condividere sezioni specifiche utilizzando l'URL. Oggi Stripe ha più di 45.000 domini di riferimento che si collegano alla loro documentazione. La strategia di rendere ogni sezione chiave un URL collegabile è un ottimo modo per garantire che scrittori, ingegneri e sviluppatori si colleghino ad essa quando appropriato.

Non cercare di "commercializzare" nella tua documentazione

Il marketing ha una relazione di amore-odio con la documentazione.

Principalmente perché i marketer AMANO cercare di trovare modi per ravvivare le cose e aggiungere la loro "essenza del marchio" in tutto. Non è necessario con la documentazione. Taglia la lanugine e non cercare di vendere il tuo prodotto o varie caratteristiche. Attenersi a ciò che le persone vogliono: codice e direzione.

Non lasciare che le persone "assumano i loro errori"

Questo è un consiglio piuttosto tattico, ma gli sviluppatori vogliono scoprire PERCHÉ le cose non funzionano.

Crea documentazione che mostri PERCHÉ ci sono errori nel tuo prodotto e quando provi a costruire sulla tua piattaforma. È una delle cose più frequentemente cercate quando si tratta di documenti tecnici, ma l'ho vista esclusa da molti documenti API. Fai un elenco degli errori che le persone possono incontrare e collega alla documentazione su come prevenire questi errori.

Il mio ultimo consiglio quando si tratta di creare un'ottima documentazione è questo...

Scrivi prima per gli umani, poi per i robot

Questa potrebbe essere la parte più importante della documentazione.

Devi dare la priorità all'esperienza dello sviluppatore quando si tratta di documentazione prima ancora di iniziare a pensare a come Google visualizzerà i tuoi contenuti. L'indicizzabilità, la struttura dell'URL e i titoli che utilizzi per la tua documentazione sono importanti? Senza dubbio.

Ma la capacità di catturare il volume di ricerca è la ciliegina sulla torta DOPO aver risolto problemi reali e offerto chiarezza nei tuoi documenti. Crea prima per le persone. Ottimizza secondo.

Spero che tu abbia una settimana fantastica e l'hai trovato utile. Sono convinto che la documentazione sia uno degli elementi più importanti e sottovalutati del marketing mix per le aziende incentrate su ingegneri/sviluppatori. Se lavori in questi spazi e desideri supporto nella creazione di contenuti che aiuteranno la tua comunità di ingegneri ad amarti, contattaci!

Sono sempre pronto a parlare di come i contenuti possono essere usati per plasmare la cultura.