Piani e componenti aggiuntivi

Livelli Listings e Social: cosa includono, prezzi dei componenti aggiuntivi, calcolo proporzionale e limiti di crescita degli account self-service.

Listings API vende due prodotti. Listings gestisce le sedi delle attività e la loro presenza nelle directory. Social gestisce i brand e pubblica sui loro account social. Hanno prezzi separati, vengono fatturati separatamente e hanno limiti separati.

Listings

Il prezzo dei livelli di Listings dipende dal numero di sedi che puoi avere.

Ogni sede del piano dispone dell'intera rete di directory, della gestione delle recensioni, dei post e delle analisi. Il livello determina quante sedi puoi avere e il tuo budget di richieste, non quali endpoint puoi chiamare.

Social

Il prezzo dei livelli di Social dipende dal numero di connessioni che puoi avere. Una connessione è un account social — una Pagina Facebook, un account Instagram Business, un account X, un'organizzazione LinkedIn, una bacheca Pinterest — collegato a un brand su un social network tramite un link di connessione.

I brand sono illimitati e non vengono conteggiati ai fini della fatturazione in nessun livello. Un brand è semplicemente il contenitore a cui appartengono gli account collegati e i post pubblicati da questi; crearne uno non costa nulla e la sua creazione non viene mai rifiutata a causa di un limite. POST /social/brands non prevede alcun limite al numero di brand con un piano API.

Ciò che acquisti sono le connessioni. Con i 5 social network supportati, un brand collegato a tutti utilizza 5 connessioni, quindi 20 connessioni corrispondono a circa 4 brand collegati ovunque e 125 a circa 25, ma nulla impone questa distribuzione. Puoi distribuire 125 connessioni tra 60 brand su 2 social network ciascuno, oppure concentrarle su pochi brand.

Componenti aggiuntivi

I componenti aggiuntivi hanno prezzi pubblici e possono essere acquistati in qualsiasi momento, senza cambiare livello.

I pacchetti di connessioni sono cumulabili. Si acquistano in base alla quantità, quindi 2 pacchetti costano $50/mese per 10 connessioni aggiuntive, 3 costano $75/mese per 15 e così via. Non esistono componenti aggiuntivi per singolo brand e non è possibile acquistare una singola connessione: l'unità di acquisto è di 5 connessioni. Un pacchetto non è vincolato a una tipologia: aggiunge 5 connessioni al totale disponibile e decidi tu a quali social network e brand assegnarle.

Le connessioni costituiscono un pool condiviso a livello di account

Le connessioni non sono assegnate per brand. Il tuo livello e i tuoi pacchetti si sommano in un unico pool a livello di account da cui qualsiasi brand può attingere:

maxConnections = tier connections + (5 × connection packs)

Con Social Growth e due pacchetti, un account ha 125 + 10 = 135 connessioni disponibili e un brand può occuparne 12 mentre un altro ne occupa una. Non esiste un limite di connessioni per brand: conta solo il pool.

Uno slot viene consumato per l'intero periodo di fatturazione, non solo finché la connessione è attiva. L'utilizzo del pool viene misurato in base alle connessioni distinte che un account ha utilizzato durante il periodo corrente, quindi scollegare un canale lo porta immediatamente offline, ma il suo slot rimane consumato fino al rinnovo del periodo. È la stessa regola che si applica a ogni altra riduzione sull'account — vedi Ripartizione proporzionale — e significa che il pool non può essere riutilizzato all'interno di un ciclo: se attivi 20 connessioni e poi le scolleghi, il conteggio rimane comunque a 20 fino al rinnovo.

Ne derivano due conseguenze. Ricollegare lo stesso account social allo stesso brand è gratuito, perché riutilizza lo slot che quell'account occupa già per quel brand. Uno slot appartiene a una coppia specifica di brand e account, quindi collegare lo stesso account a un brand diverso occupa un secondo slot e il primo rimane occupato fino all'inizio del ciclo successivo. Inoltre, acquistare un pacchetto è l'unico modo per aggiungere capacità durante il periodo, poiché i componenti aggiuntivi vengono addebitati e resi disponibili immediatamente, mentre gli slot liberati devono attendere l'inizio del ciclo successivo.

GET /social/limits riporta il quadro completo:

La capacità residua è maxConnections - usage.connections. Quando il pool è esaurito, il collegamento della connessione restituisce SY95042: ecco perché uno sviluppatore che ha appena scollegato diversi account può comunque vedersi rifiutare la richiesta. Con un piano API, la creazione di un brand non prevede un errore equivalente.

Limiti massimi per gli account self-service

Si applicano due limiti inderogabili, indipendentemente dal numero di componenti aggiuntivi acquistati:

• 100 sedi su un account Listings self-service.
• 250 connessioni su un account Social self-service.

Non esiste un limite massimo di brand: i brand sono illimitati e un account può averne quanti ne desidera, purché le connessioni utilizzate da quei brand rimangano entro la capacità del pool.

Per superare uno dei due limiti, l'account deve passare a Enterprise, dove i limiti vengono concordati: contatta il team commerciale anziché acquistare altri pacchetti. Un account senza alcun piano Listings non può creare sedi e riceve SY10155; l'equivalente per Social è semplicemente non avere un abbonamento Social, nel qual caso tutti gli endpoint /social/* sono indisponibili.

Aggiungere il secondo prodotto

Un account che dispone di un prodotto può acquistare l'altro dalla dashboard, senza parlare con il team commerciale e senza creare un nuovo account. Ogni prodotto mantiene il proprio abbonamento, la propria data di rinnovo e la propria disdetta, esattamente come se li avessi acquistati separatamente.

Ogni prodotto include la propria prova gratuita. Il livello Launch di un prodotto che non hai mai avuto inizia con 14 giorni gratuiti, anche se sei già un cliente pagante dell'altro prodotto. Un cliente Listings Growth che aggiunge Social Launch ottiene i 14 giorni di prova di Social con una data di rinnovo dedicata, mentre la fatturazione di Listings prosegue invariata. Lo stesso vale, a parti invertite, per un cliente Social che aggiunge Listings Launch.

Tutti i livelli superiori a Launch vengono fatturati il giorno dell'acquisto e, per entrambi i prodotti, le condizioni di Enterprise vengono definite con noi anziché tramite un acquisto self-service.

La prova è disponibile una sola volta per prodotto. Se hai già provato un prodotto, acquistarlo nuovamente comporta un addebito immediato: non è previsto un secondo periodo gratuito per lo stesso prodotto. L'acquisto di un componente aggiuntivo mentre un abbonamento è ancora in prova termina la prova e avvia la fatturazione a pagamento, un passaggio che la dashboard conferma prima che avvenga.

Riproporzionamento

I componenti aggiuntivi vengono addebitati immediatamente. L'acquisto di una sede aggiuntiva o di un pacchetto di connessioni ha effetto immediato e viene fatturato subito, con un importo proporzionale al tempo rimanente nel ciclo di fatturazione corrente. Non devi attendere l'inizio del ciclo successivo per utilizzare la capacità appena acquistata.

Le riduzioni hanno effetto alla fine del ciclo di fatturazione. Non ricevi alcun rimborso per il periodo rimanente per ciò a cui rinunci, e nulla di ciò a cui rinunci libera capacità prima della chiusura del ciclo. Questa unica regola si applica a ogni riduzione su entrambi i prodotti:

Uno slot di connessione rilasciato si comporta quindi esattamente come un componente aggiuntivo disdetto: l'effetto si verifica alla fine del periodo, non al momento della chiamata API. Durante l'attesa viene indicato come usage.connectionsReleased in GET /social/limits, che rappresenta la tua previsione della capacità che tornerà disponibile.

Questa asimmetria è intenzionale: puoi sempre aumentare subito la capacità e pagare esattamente per ciò che hai utilizzato, e non perdi mai la capacità per cui hai già pagato, né puoi riutilizzarla due volte nello stesso periodo.

La regola dell'anzianità minima di 90 giorni

Una sede o un brand deve esistere da almeno 90 giorni prima di poter essere archiviato. Sia POST /locations/archive sia POST /social/brands/archive applicano questa regola; l'endpoint del brand la segnala come status: "TENURE_NOT_MET" con SY95051.

La regola esiste perché l'archiviazione è il meccanismo con cui si riduce un abbonamento e, altrimenti, una risorsa creata e archiviata all'interno dello stesso ciclo non avrebbe alcun costo. Ha una conseguenza pratica di cui tenere conto nella progettazione: un brand o una sede creato per errore non può essere rimosso per 90 giorni. Esegui le verifiche prima della creazione.

Ciò che accade una volta raggiunta l'anzianità minima varia in base al prodotto:

• I brand vengono archiviati immediatamente, ma i loro slot di connessione non tornano subito disponibili. Il brand e tutte le connessioni collegate vengono archiviati nella stessa richiesta e vanno offline immediatamente; ciascuno di questi slot rimane quindi occupato fino alla fine del ciclo di fatturazione, esattamente come avverrebbe con una disconnessione diretta. GET /social/limits mostra la diminuzione di usage.connectionsActive e il corrispondente aumento di usage.connectionsReleased alla lettura successiva, mentre il valore fatturabile usage.connections rimane invariato fino al rinnovo. L'archiviazione in sé non prevede uno stato pianificato e non c'è nulla da annullare.
• L'archiviazione delle sedi viene pianificata per la fine del ciclo di fatturazione. La sede rimane attiva e continua a essere conteggiata ai fini del tuo limite Listings fino alla chiusura del ciclo; fino a quel momento puoi annullare la decisione con annulla l'archiviazione di una sede.

Consultare i tuoi limiti

Controlla il limite pertinente prima di un'operazione di creazione anziché dopo un errore: questo ti consente di mostrare al cliente un'opzione di upgrade invece di un codice di errore.