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. In der style-Konfiguration werden die im Eigenschaftenbereich verfügbaren Stilselektoren definiert.
Datenkonfiguration
Die data-Konfiguration definiert die DIMENSION- und METRIC-Elemente, die in Looker Studio im Eigenschaftenbereich 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 Looker 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 minimale und maximale Anzahl 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 Looker 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 Looker Studio wird die 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 der Datenbereich und das Datenelement oben in Looker Studio gerendert werden:
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 der Typ der Stilauswahl definiert, die in Looker Studio gerendert wird. Optional: defaultValue definiert einen Standardwert für jedes Stilelement.
Ähnlich wie Datenelemente 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 Tooltip „Link Opacity“ (Linkdeckkraft) entspricht dem label im Stilelement.
Interaktionskonfiguration
In der interaction-Konfiguration wird definiert, 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.