Piano Analytics Catalogs API

Piano Analytics is the successor of AT Internet Analytics Suite 2 (AS2) and a user-centric tool that simplifies product & marketing analytics, while ensuring data quality. Using this destination you can connect your catalogs to your behavioral data in Piano Analytics by using Piano Catalogs API.

Catalogs are the natural evolution of Piano Analytics's enrichments. If you have already configured enrichments in the past, these were seamlessly migrated to catalogs.

Key features

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

• Events structure: our Events reference model supports Piano Analytics catalog's data structure, 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 catalog/enrichment.

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

Configuration

Settings	Description
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.
Catalog Id	Required Your catalog (import) identifier. This can be found in Piano Analytics interface following ➜ SETTINGS➜ Data Management ➜ Catalogs (left menu) → Click you catalog in the list → Click the Import data tab → Catalog ID.
Catalog Key	Required Your catalog (reconciliation) key. This can be found in Piano Analytics interface following ➜ SETTINGS➜ Data Management ➜ Catalogs (left menu) ➜ Click you catalog in the list ➜ Click the Structure tab ➜ look for the line with Role equals to Reconciliation key and use the value in the column Property key.
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 updated/enriched. Your Catalog Key must me included and mapped. In Your value path, when selecting a value different from "Default (root)", you need to set a property name in Your value.

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

Properties can be remapped using our Smart Mapping feature.

Your selected catalog key must me included and mapped.

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

1. See Enrichment Configuration for more details.