Daten- und Stiloptionen für eine Community-Visualisierung werden in einer Konfigurations-JSON definiert. Mit der data-Konfiguration wird die Anzahl der Dimensionen und Messwerte festgelegt, die in der Visualisierung unterstützt werden. Mit der style-Konfiguration werden die im Eigenschaftenbereich verfügbaren Stilauswahlen definiert.
Datenkonfiguration
In der data-Konfiguration werden die DIMENSION- und METRIC-Elemente definiert, die in der Eigenschaftenleiste in Looker Studio gerendert werden. Jedes Element entspricht den Dimensionen und Elementfeldern, die der Endnutzer als Eingaben für die Visualisierung bereitstellt.
Beispieldatenelement:
{
"id": "twoDimensionsPlease",
"label": "Dimension Element Heading",
"type": "DIMENSION",
"options": {
"min": 2,
"max": 2,
}
}
Die id, die Sie im Datenelement definieren, sind in den Informationen enthalten, mit denen Data Studio antwortet. Mit label wird der Text definiert, der Nutzern über dem Datenbereich angezeigt wird, und mit type wird festgelegt, ob es sich um eine Dimension oder einen Messwert handelt. Das options-Objekt definiert die Mindest- und Höchstanzahl von Feldern, die ein Nutzer dem Datenelement hinzufügen kann.
Im Datenelement DIMENSION unterstützt das options-Objekt einen optionalen supportedTypes-Schlüssel. Falls definiert, schränkt Data Studio den Typ der Dimensionsfelder ein, die dem Element hinzugefügt werden können. Der Wert von supportedTypes ist ein Array, das eine beliebige Kombination aus „DEFAULT“, „TIME“ und „GEO“ enthalten kann.
In einem Datenabschnitt werden mehrere Datenelemente gruppiert. In Data Studio wird label als Überschrift für mehrere Datenelemente gerendert.
Abschnitt „Beispieldaten“:
{
"id": "dimensionSection1",
"label": "Dimension Section Heading",
"elements":[
// array of data elements
]
}
Auf diesem Screenshot sehen Sie, wie Data Studio den oben gezeigten Datenabschnitt und das Datenelement rendert:
Stilkonfiguration
In der Stilkonfiguration werden die Stilselektoren definiert, die im Eigenschaftenbereich gerendert werden.
Beispiel für ein Stilelement:
{
"id": "linkOpacity",
"label": "Link opacity",
"type": "OPACITY",
"defaultValue": "0.2"
}
Mit label wird der Text definiert, der Nutzern als Kurzinfo angezeigt wird, und mit type wird die Art der Stilselektoren definiert, die in Data Studio gerendert werden. Optional: defaultValue definiert einen Standardwert für jedes Stilelement.
Ähnlich wie bei Datenelementen werden Stilelemente in Abschnitten definiert, die Überschriften und logische Gruppierungen enthalten. Eine vollständige Liste der verfügbaren Selektoren finden Sie in der Konfigurationsreferenz.
Beispiel für einen Stilbereich:
{
"id": "styleGroup1",
"label": "Header for style group",
"elements": [
// insert Style Elements here
]
}
Der folgende Screenshot zeigt ein Beispiel für ein Stilfeld mit einer Auswahl für die Deckkraft. Der entsprechende Kurzinfo-Text „Link Opacity“ (Linkdeckkraft) entspricht dem label im Stilelement.
Interaktionskonfiguration
In der interaction-Konfiguration wird festgelegt, wie Diagramminteraktionen für eine Community-Visualisierung funktionieren. Dies ist optional.
Beispiel:
{
"id": "onClick",
"supportedActions": ["FILTER"]
}
Derzeit wird nur FILTER unterstützt. Wenn Sie Interaktionen konfigurieren, wird im Eigenschaftenbereich ein Kästchen angezeigt.
Funktionen konfigurieren
Mit der features-Konfiguration können verschiedene Funktionen in Ihrer Community-Visualisierung aktiviert oder deaktiviert werden. Dieser Abschnitt ist optional. Eine Liste der Funktionen finden Sie in der Konfigurationsreferenz.
Beispiel:
"features": {
"enableComparisonDateRange": true
}
Beispiel
Ein Beispiel für eine Visualisierungskonfiguration finden Sie in der Beispielkonfiguration.
Nächste Schritte
Nachdem Sie die Konfiguration definiert haben, schreiben Sie die Visualisierung.