Piano Analytics Enrichment API

Piano Analytics is the successor of AT Internet Analytics Suite 2 (AS2). It's a user-centric tool that simplifies product & marketing analytics, while ensuring data quality. Using this destination you can update and/or enrich your data using Piano Analytics Enrichment API.

Key features

The Piano Analytics Enrichment API destination provides the following key features:

• Events structure: our Events reference model covers Piano Analytics's templates, meaning that your data is properly bridged to the expected fields in an optimized way.

• Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.

• Smart mapping: data mapping can be readjusted using your datalayer defined fields.

Destination setup

Before you get started with this destination, ensure your user has administrator or data supervisor rights and you have created and configured an enrichment.

You can create/access enrichments by going to Piano Analytics interface following ➜ SETTINGS ➜ Data Management ➜ Enrichment.

Configuration

Settings	Description
Organization Id	Required Your organization identifier. This can be found in Piano Analytics interface following ➜ SETTINGS➜ Data Management ➜ Enrichment ➜ Edit your enrichment ➜ Import Data then look for the bold string in your URL: https://import.atinternet.io/[ORGANIZATION ID]/[ENRICHMENT ID]/[ENRICHMENT KEY]
Enrichment Id	Required Your enrichment identifier. This can be found in Piano Analytics interface following ➜ SETTINGS ➜ Data Management ➜ Enrichment ➜ Edit your enrichment ➜ Import Data then look for the bold string in your URL: https://import.atinternet.io/[ORGANIZATION ID]/[ENRICHMENT ID]/[ENRICHMENT KEY]
Enrichment Key	Required Your enrichment key. This can be found in "Piano Analytics" interface following ➜ SETTINGS ➜ Data Management ➜ Enrichment ➜ Edit your enrichment ➜ Import Data then look for the bold string in your URL: https://import.atinternet.io/[ORGANIZATION ID]/[ENRICHMENT ID]/[ENRICHMENT KEY]
Access Key	Required Your access key. This can be found or created by following this LINK.
Secret Key	Required Your secret key. This can be created by following this LINK and it's only shown at creation time.
One Hit for Each Item	This will instruct the destination to send one hit for each item in your "Item list". This is usefull when using the Piano Analytics "E-COMMERCE/product_id" template.
Enrichment Configuration	Map your properties to be enriched. Your Enrichment Key must me included and mapped. In Enrichment property name set your property name in Piano Analytics to be enriched and in Your value your matching value. In Your value path you can select the level where Your value is located. This includes: Default (root), In "items" {items.X} and In "product" {items.X.product}.

Quick reference

Commanders Act Events	Piano Analytics Templates
[Any Event]	[Any Template] [1]

[1] Use Destination filters to match your events with Piano Analytics' templates.

Field mappings

Most properties can be remapped using our "Smart Mapping" feature.

Your selected enrichment/reconciliation key must me included and mapped.

Commanders Act Properties	Piano Analytics Properties
[Any Property]	[Any Property] [1]

[1] See Enrichment Configuration for more details.