Cos'è un post documento su LinkedIn e come LinkedIn elabora il file

Che cos'è un post documento su LinkedIn?

Un post documento su LinkedIn è un post del feed il cui contenuto è un file PDF, PowerPoint o Word caricato, che il feed mostra come una serie di pagine da sfogliare direttamente dentro il post. La documentazione per sviluppatori di LinkedIn lo tratta come un tipo di contenuto a sé. Il riferimento dell'API Posts afferma: "Per creare un post con un documento è necessario caricare un asset documento e ottenere un Document URN (urn:li:document:{id}) da usare nel post." Prima viene il file, poi il post.

LinkedIn fissa i limiti del file nella pagina dell'API Documents: "Il file non può superare 100MB e 300 pagine. Sono supportati questi tipi di file: PPT, PPTX, DOC, DOCX e PDF." Queste due frasi sono l'intera specifica che LinkedIn pubblica per il file.

Proprietà	Valore	Fonte
Tipi di file	PPT, PPTX, DOC, DOCX, PDF	API Documents
Dimensione massima del file	100MB	API Documents
Numero massimo di pagine	300	API Documents
Identificatore dell'asset	urn:li:document:{id}	API Posts
Pubblicazione organica	Supportata	API Posts
Pubblicazione sponsorizzata	Supportata	API Posts
Dimensione o proporzioni della pagina	Non documentate	Nessuna delle due pagine

L'ultima riga conta per il design. Le pagine per sviluppatori di LinkedIn non indicano né le dimensioni delle pagine né le proporzioni dei documenti. Qualsiasi misura in pixel che trovi per le pagine di un documento nasce dai test di qualcuno, non dalla specifica di LinkedIn.

Un post documento su LinkedIn è la stessa cosa di un carosello su LinkedIn?

Un post documento su LinkedIn è ciò che la maggior parte delle persone intende con "carosello LinkedIn", ma l'API di LinkedIn usa la parola carosello per un formato diverso, che i post organici non possono usare. Il riferimento dell'API Posts contiene una tabella dei tipi di contenuto con una colonna per i post organici e una per quelli sponsorizzati, e le righe non concordano proprio su questo punto.

Tipo di contenuto	Organico (non sponsorizzato)	Sponsorizzato
Documents	Sì	Sì
Carousels	No	Sì
MultiImage	Sì	No
Images	Sì	Sì
Videos	Sì	Sì

Leggi con attenzione la riga Carousels. Nel vocabolario di LinkedIn, un carosello è un formato pubblicitario sponsorizzato. Un post organico che si scorre di lato è un post documento, mentre un post organico con più foto è un post MultiImage. Sono due formati separati, con due flussi di caricamento separati.

Se uno scheduler dichiara di supportare i "caroselli LinkedIn" organici, intende post documento o post MultiImage, perché LinkedIn non consente il tipo Carousel fuori dagli annunci. La nostra guida generale ai caroselli spiega come funziona il formato a scorrimento sugli altri social, dove "carosello" indica un insieme di immagini.

Quale file conviene caricare per un post documento su LinkedIn?

Per un post documento su LinkedIn carica un PDF, perché il PDF blocca font e impaginazione prima che LinkedIn tocchi il file. LinkedIn accetta anche PPT, PPTX, DOC e DOCX, ma deve elaborare ogni caricamento prima che il file possa comparire in un post. L'API Documents descrive lo stato PROCESSING così: "L'asset è in elaborazione per generare gli artefatti mancanti." La risposta di esempio su quella pagina restituisce un downloadUrl il cui percorso contiene ads-document-pdf-analyzed, un nome che lascia pensare che LinkedIn conservi una versione PDF di qualsiasi cosa tu invii.

Se carichi un file PowerPoint, l'eventuale conversione avviene sul lato di LinkedIn, con i font che LinkedIn ha a disposizione. Se carichi un PDF, la conversione è già avvenuta sul tuo computer, dove hai visto il risultato. LinkedIn non documenta come gestisca i font mancanti in un DOCX o in un PPTX.

Dei due limiti, quello dei 100MB è il primo che raggiungono le slide piene di immagini, perché un PDF esportato in qualità di stampa mantiene ogni immagine alla piena risoluzione. Il tetto di 300 pagine sta ben sopra qualsiasi cosa un lettore sfoglierà in un feed.

PDF oppure PowerPoint e Word

PDF

• Font e impaginazione sono bloccati prima del caricamento
• Quello che vedi nel file è ciò con cui LinkedIn lavora
• Corrisponde al nome di percorso del downloadUrl ads-document-pdf-analyzed

PPT, PPTX, DOC, DOCX

• LinkedIn converte il file dal proprio lato
• Il rendering dei font mancanti non è documentato
• Restano comunque i limiti di 100MB e 300 pagine

Come si pubblica un post documento tramite l'API di LinkedIn?

Un post documento si pubblica in due fasi: carichi il file con l'API Documents e ottieni un URN del documento, poi crei un post che fa riferimento a quell'URN. La pagina dell'API Documents illustra ogni chiamata.

1. Chiama POST /rest/documents?action=initializeUpload con un initializeUploadRequest che indica l'owner, cioè un URN di persona o di organizzazione.
2. Leggi la risposta. Restituisce un uploadUrl, un timestamp uploadUrlExpiresAt e l'URN document nella forma urn:li:document:{id}.
3. Carica il file sull'uploadUrl. L'esempio di LinkedIn usa curl --upload-file con un bearer token e ottiene HTTP/2 201.
4. Chiama GET /rest/documents/{document URN} e leggi status finché non dice AVAILABLE.
5. Chiama POST /rest/posts con content.media.id impostato sull'URN del documento e content.media.title impostato sul titolo che vuoi sul documento, più commentary, visibility, distribution e lifecycleState del post.

La pagina aggiunge una restrizione: "SYNCHRONOUS_UPLOAD non è supportato nell'API Documents." Il flusso rispecchia quello delle immagini, e la nostra guida su come LinkedIn initializeUpload trasforma un file in un URN immagine mostra lo stesso schema con le tabelle degli errori.

La pagina di LinkedIn non dice se un post possa fare riferimento a un documento ancora in elaborazione. Aspettare AVAILABLE al passaggio 4 è l'ordine che non dipende mai da quella risposta.

Cosa significano gli stati dei documenti LinkedIn?

Un documento su LinkedIn passa attraverso quattro stati, che ti dicono se il file può già essere inserito in un post. L'API Documents definisce ciascuno di essi nella sua tabella dello schema.

Stato	Definizione di LinkedIn
WAITING_UPLOAD	"In attesa che il client carichi il file sorgente o che il processo di caricamento venga completato."
PROCESSING	"L'asset è in elaborazione per generare gli artefatti mancanti."
AVAILABLE	"Tutti gli artefatti richiesti dalla ricetta sono pronti. L'asset è disponibile per essere servito."
PROCESSING_FAILED	"Elaborazione non riuscita per un errore del client, come file troppo grande, formato non supportato, errore interno (ad es. problema di prestazioni, errore del database, guasto di rete) o altro problema."

PROCESSING_FAILED è lo stato su cui devi organizzarti. La sua definizione mette nello stesso valore i tuoi errori, come un file da 120MB o un formato non supportato, e i malfunzionamenti di LinkedIn. Lo stato da solo non ti dice da che parte sia l'errore. Controlla prima il file rispetto ai limiti. Se rientra nei limiti, caricalo di nuovo. Quando un post con documento programmato non va online, la distinzione tra problemi del file e problemi della piattaforma è la prima cosa da verificare, e la nostra guida su post programmati su LinkedIn che non funzionano tratta le altre cause.

Chi può pubblicare un post con documento su LinkedIn?

Un membro di LinkedIn può pubblicare un post con documento sul proprio profilo, e un amministratore di una pagina aziendale può pubblicarne uno sulla pagina. L'API Documents verifica i permessi rispetto al proprietario indicato al momento del caricamento. "Per i documenti con proprietari di tipo URN aziendale, chi effettua la chiamata deve avere i permessi ADMIN o DSC per la pagina aziendale." Per i proprietari persona, "chi effettua la chiamata deve corrispondere al proprietario del documento."

Gli ambiti (scope) seguono la stessa divisione. w_member_social pubblica per conto del membro autenticato, mentre w_organization_social pubblica per conto di un'organizzazione, ed è riservato da LinkedIn a "l'amministratore dell'azienda, il DSC poster o il content admin." Chi effettua la chiamata senza il permesso giusto riceve un errore 403 con il messaggio "Accessing this document resource is forbidden. Please check your permissions for this resource."

Decidi il proprietario prima di caricare il file. Il controllo dei permessi viene eseguito sul proprietario indicato in initializeUpload, quindi un file destinato a un post sulla pagina aziendale va caricato con l'URN dell'organizzazione come proprietario, non con l'URN del membro che esegue il caricamento.

Come prepari un file per un post con documento su LinkedIn?

Per preparare un file per un post con documento su LinkedIn, esportalo in PDF, verificalo rispetto ai due limiti di LinkedIn e scegli il titolo del documento prima di programmare la pubblicazione.

1. Esporta la presentazione o il documento in PDF dall'app in cui l'hai creato.
2. Controlla che il file pesi meno di 100MB. Se non è così, comprimi le immagini all'interno del PDF.
3. Controlla che il numero di pagine sia inferiore a 300.
4. Apri il PDF e sfoglialo una volta. Quello che vedi è ciò che LinkedIn avrà a disposizione.
5. Scrivi il titolo del documento separatamente dal testo del post. L'API lo salva in content.media.title, separato da commentary.
6. Metti nella prima pagina il motivo per aprire il documento, perché la prima pagina è ciò che si vede prima che qualcuno inizi a scorrere.

Il punto 6 si collega a come LinkedIn misura l'attenzione. Il dwell time nel feed di LinkedIn inizia a essere conteggiato quando "almeno metà di un aggiornamento del feed è visibile mentre un membro scorre il proprio feed", secondo il team di ingegneria di LinkedIn, e un post con documento è un aggiornamento del feed come tutti gli altri. La prima pagina è la parte del documento che si trova sullo schermo quando questo conteggio parte.

Puoi programmare un post con documento su LinkedIn con AdaptlyPost?

AdaptlyPost programma i post con documento LinkedIn sui profili e sulle pagine aziendali LinkedIn collegati. Nel compositore, Documento è uno dei tipi di contenuto accanto ai post di testo, immagine, video e carosello, e il caricamento accetta "PDF, PPT, PPTX, DOC o DOCX, fino a 100MB", che corrisponde ai tipi di file e al limite di dimensione di LinkedIn. Le opzioni per LinkedIn includono un campo per il titolo del documento, descritto nel compositore come "Mostrato sopra il carosello nel feed di LinkedIn". Il testo di AdaptlyPost non indica un limite di pagine a parte, quindi vale il tetto di 300 pagine di LinkedIn. La pagina dedicata allo strumento per programmare i post su LinkedIn spiega come collegare un profilo o una pagina tramite OAuth e mettere in coda i post, mentre la nostra guida su come programmare i post su LinkedIn confronta le opzioni di programmazione.

Domande frequenti

Quali tipi di file può usare un post documento su LinkedIn?

LinkedIn accetta file PPT, PPTX, DOC, DOCX e PDF per i post documento. La Documents API elenca questi cinque formati e nessun altro. Il PDF è la scelta più sicura, perché blocca font e impaginazione prima che LinkedIn elabori il file.

Quanto può pesare un documento LinkedIn?

LinkedIn limita un documento a 100 MB e 300 pagine. Entrambi i limiti vengono dalla documentazione della Documents API. La definizione dello stato PROCESSING_FAILED indica "file size too large" tra le sue cause.

Un carosello LinkedIn è la stessa cosa di un post documento?

Per i post organici, il carosello da scorrere di cui si parla è un post documento. L'API di LinkedIn riserva il tipo di contenuto Carousel agli annunci sponsorizzati e lo segna come non disponibile per i post organici. Un post organico con più foto è un post MultiImage, un'altra cosa.

Si può pubblicare un post documento su LinkedIn tramite API?

Sì. Carichi il file con l'azione initializeUpload della Documents API, che restituisce un URN del documento, poi crei il post con POST /rest/posts e imposti quell'URN come content.media.id. La Documents API non supporta SYNCHRONOUS_UPLOAD, quindi il file passa sempre dall'URL di caricamento prima della creazione del post.

Che cos'è il titolo in un post documento su LinkedIn?

Il titolo è un campo separato, content.media.title, che appartiene al documento e non al testo del post. La richiesta di esempio di LinkedIn lo imposta su "Example.pdf". Il composer di AdaptlyPost descrive il campo del titolo del documento come "Shown above the carousel in the LinkedIn feed".

Una pagina aziendale può pubblicare un post documento su LinkedIn?

Sì. Per un post documento da una pagina aziendale, chi effettua la chiamata deve avere i permessi ADMIN o DSC sulla pagina, e il documento va caricato con l'URN dell'organizzazione come proprietario. Un membro senza questi permessi riceve un errore 403 dalla Documents API.

Cosa devi controllare prima di ricaricare un documento LinkedIn che ha dato errore?

Verifica il file rispetto ai due limiti di LinkedIn, i 100 MB di peso e le 300 pagine, perché PROCESSING_FAILED mette sotto un unico stato sia gli errori del file sia quelli di LinkedIn. Se il file rispetta entrambi i limiti, caricalo di nuovo.

Quali scope dell'API di LinkedIn coprono i post documento?

w_member_social pubblica un documento per conto del membro autenticato, mentre w_organization_social pubblica per conto di una pagina aziendale, ed è limitato ad admin dell'azienda, DSC poster o content admin. Lo scope che ti serve dipende dall'URN del proprietario che imposti al caricamento.

Il dwell time vale anche per i post documento su LinkedIn?

Un post documento è un aggiornamento del feed come gli altri, quindi il timer del dwell time di LinkedIn parte quando almeno metà del post è visibile mentre un membro scorre. La prima pagina del documento è ciò che si vede sullo schermo quando il timer parte, ed è per questo che il testo del post dice di metterci il motivo per aprire il documento.

AdaptlyPost applica il limite di 300 pagine di LinkedIn per i post documento?

Il composer di AdaptlyPost non indica un limite di pagine proprio per i documenti caricati, quindi vale il tetto di 300 pagine di LinkedIn. Il composer rispetta invece i tipi di file e il limite di 100 MB di LinkedIn.