Definizione della configurazione di visualizzazione

Le opzioni di dati e stile per una visualizzazione della community sono definite in un file JSON di configurazione. La configurazione data imposta il numero di dimensioni e metriche supportate dalla visualizzazione. La configurazione style definisce i selettori di stile disponibili nel riquadro delle proprietà.

Configurazione dati

La configurazione data definisce gli elementi DIMENSION e METRIC che Looker Studio visualizza nel riquadro delle proprietà. Ogni elemento corrisponde ai campi di dimensione ed elemento che l'utente finale fornisce come input per la visualizzazione.

Elemento di dati di esempio:

{
  "id": "twoDimensionsPlease",
  "label": "Dimension Element Heading",
  "type": "DIMENSION",
  "options": {
    "min": 2,
    "max": 2,
  }
}

Il id che definisci nell'elemento di dati è incluso nelle informazioni con cui risponde Looker Studio. label definisce il testo visualizzato dagli utenti sopra la sezione dei dati, mentre type definisce se si tratta di una dimensione o di una metrica. L'oggetto options definisce il numero minimo e massimo di campi che un utente può aggiungere all'elemento di dati.

In un elemento di dati DIMENSION, l'oggetto options supporta una chiave supportedTypes facoltativa. Se definito, Looker Studio limita il tipo di campi dimensione che possono essere aggiunti all'elemento. Il valore di supportedTypes è un array che può contenere qualsiasi combinazione di "DEFAULT", "TIME" e "GEO".

Una sezione di dati raggruppa più elementi di dati. Looker Studio esegue il rendering di label come intestazione per più elementi di dati.

Sezione Dati di esempio:

{
  "id": "dimensionSection1",
  "label": "Dimension Section Heading",
  "elements":[
    // array of data elements
  ]
}

Questo screenshot mostra come Looker Studio esegue il rendering della sezione dei dati e dell'elemento di dati sopra:

Screenshot dell'elemento di dati nel riquadro delle proprietà

Configurazione dello stile

La configurazione dello stile definisce i selettori di stile visualizzati nel riquadro delle proprietà.

Un elemento di stile di esempio:

{
  "id": "linkOpacity",
  "label": "Link opacity",
  "type": "OPACITY",
  "defaultValue": "0.2"
}

label definisce il testo visualizzato dagli utenti come descrizione comando, mentre type definisce il tipo di selettore di stile visualizzato da Looker Studio. Facoltativamente, defaultValue definisce un valore predefinito per ogni elemento di stile.

Analogamente agli elementi di dati, gli elementi di stile sono definiti all'interno di sezioni, che forniscono intestazioni e raggruppamenti logici. Per visualizzare l'elenco completo dei selettori disponibili, consulta il riferimento alla configurazione.

Una sezione Stile di esempio:

{
  "id": "styleGroup1",
  "label": "Header for style group",
  "elements": [
    // insert Style Elements here
  ]
}

Lo screenshot seguente mostra un esempio di riquadro dello stile con un selettore di opacità, con la descrizione comando "Opacità link" corrispondente a label nell'elemento di stile.

Screenshot del selettore di stile

Configurazione dell'interazione

La configurazione interaction definisce il funzionamento delle interazioni con i grafici per una visualizzazione della community. Questa opzione è facoltativa.

Esempio:

{
  "id": "onClick",
  "supportedActions": ["FILTER"]
}

Al momento è supportato solo FILTER. Se configuri le interazioni, nel riquadro delle proprietà viene visualizzata una casella di controllo.

Screenshot del selettore di stile

Configurazione delle funzionalità

La configurazione features può attivare o disattivare varie funzionalità nella visualizzazione della community. Questa sezione è facoltativa. Un elenco delle funzionalità è disponibile nei riferimenti alla configurazione.

Esempio:

  "features": {
    "enableComparisonDateRange": true
  }

Esempio

Per visualizzare un esempio di configurazione della visualizzazione, consulta la configurazione di esempio.

Passaggi successivi

Dopo aver definito la configurazione, scrivi la visualizzazione.