Metric Mapping API

To map metrics from Adobe Analytics to a Customer Journey Analytics data view within an XDM schema, follow these steps:

In Customer Journey Analytics, create the metrics that you want to be mapped from the existing Adobe Analytics metrics.
Collect the metric ID information to be used in the mappings. If you have a csv file that defines your XDM schema for a data view, it may be helpful to reference it. You can also use the GET metrics endpoint to see a list of metrics and their IDs for a data view.

Create a csv file that contains the mappings for your metrics. Refer to the csv example above for dimensions mappings and use the same format for your metrics.

aaId	cjaId	note
evar5	cja.evar5	organization
evar7	cja.evar7	page
evar8	cja.evar8	product
evar9	cja.evar9	day

The aaId label, as shown in the example mapping csv file above, has different meanings, depending upon endpoint or API service. In the example csv above, it is the metric name in Analytics. In the related Component Migration API service, aaId is a parameter with a different function. For more information on the difference, see the description for the aaId parameter in the Component Migration API guide.

Use the metric mapping APIs below to upload (or create), update, or retrieve the mappings.
Use the Component Migration API to migrate the metrics to CJA.

Use these endpoints to map metrics to CJA within an XDM schema:

POST mapping metrics csv: Create metrics mappings with a csv file
GET mapping metrics csv: Retrieve metrics mappings with a csv file
PUT mapping metrics csv: Update metrics mappings with a csv file
DELETE mapping metric all: Delete all metrics mapping

POST mapping metrics csv

Use this endpoint to upload a csv file that maps Analytics metrics to CJA metrics for a specified data view.

POST https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/map/csv

Request and Response Examples

Click the Request tab in the following example to see a cURL request for this endpoint. Click the Response tab to see a successful JSON response for the request.

Request

Response

curl -X 'POST' \
  "https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/map/csv?rsid=examplersid&dataId=exampledv" \
  -H "accept: application/json" \
  -H "x-api-key: {CLIENT_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -F 'file=examplecsv'
Copied to your clipboard
curl -X 'POST' \
  "https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/map/csv?rsid=examplersid&dataId=exampledv" \
  -H "accept: application/json" \
  -H "x-api-key: {CLIENT_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -F 'file=examplecsv'

{
  "result": "success",
  "method": "POST",
  "message": "Metrics mapped successfully"
}
Copied to your clipboard
{
  "result": "success",
  "method": "POST",
  "message": "Metrics mapped successfully"
}

Request example details

The POST example above shows the rsid and dataId values as examplersid and exampledv respectively in the URL of the cURL request. These values are added as query parameters. The file examplefilecsv is included so that it is uploaded as the body of the request. This file should contain the metrics mappings as described above in the example template.

Request parameters

This endpoint includes request parameters described in previous sections.

Response Parameters

This endpoint includes response parameters described in previous sections.

GET mapping metrics csv

Use this endpoint to retrieve a csv file of metrics mappings associated with a data view. You can also use this endpoint to retrieve a csv file with metrics filtered by metric IDs.

GET https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/csv

Request and Response Examples

Click the Request tab in the following example to see a cURL request for this endpoint. Click the Response tab to see a successful JSON response for the request.

Request

Response

curl -X 'GET' \
  "https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/csv?rsid=examplersid&dataId=exampledv&metricIds=cja1%2C%20cja2%2C%20cja3" \
  -H "accept: application/json" \
  -H "x-api-key: {CLIENT_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"
Copied to your clipboard
curl -X 'GET' \
  "https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/csv?rsid=examplersid&dataId=exampledv&metricIds=cja1%2C%20cja2%2C%20cja3" \
  -H "accept: application/json" \
  -H "x-api-key: {CLIENT_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

{
  "result": "success",
  "method": "GET",
  "message": "examplecsv retrieved successfully",
  "data": "dimension1,dimension2,dimension3\nvalue1,value2,value3"
}
Copied to your clipboard
{
  "result": "success",
  "method": "GET",
  "message": "examplecsv retrieved successfully",
  "data": "dimension1,dimension2,dimension3\nvalue1,value2,value3"
}

Request example details

The GET example above shows the following:

The rsid and dataId values are included as examplersid and exampledv respectively in the URL of the cURL request. These values are added as query parameters.
The request includes a list of metrics mappings filtered for only the metrics with IDs: cja1, cja2, and cja3.

Request parameters

This endpoint includes request parameters described in previous sections.

Response Parameters

This endpoint includes response parameters described in previous sections.

PUT mapping dimensions csv

Use this endpoint to update a csv file that maps Analytics metrics to CJA metrics for a specified data view.

PUT https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/csv

Request and Response Examples

Click the Request tab in the following example to see a cURL request for this endpoint. Click the Response tab to see a successful JSON response for the request.

Request

Response

curl -X 'PUT' \
  "https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/csv?rsid=examplersid&dataId=exampledv" \
  -H "accept: application/json" \
  -H "x-api-key: {CLIENT_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"
  -F 'file=examplecsv'
Copied to your clipboard
curl -X 'PUT' \
  "https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/csv?rsid=examplersid&dataId=exampledv" \
  -H "accept: application/json" \
  -H "x-api-key: {CLIENT_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"
  -F 'file=examplecsv'

{
      "cjaid": "cja.evar5",
      "dataId": "exampledv",
      "xdmMapped": "true",
      "aaId": "evar5",
      "rsid": "examplersid",
      "xdmNotes": "organization"
}

Copied to your clipboard

{
      "cjaid": "cja.evar5",
      "dataId": "exampledv",
      "xdmMapped": "true",
      "aaId": "evar5",
      "rsid": "examplersid",
      "xdmNotes": "organization"
}

Request example details

The PUT example above shows the following:

The rsid and dataId values are included as examplersid and exampledv respectively in the URL of the cURL request. These values are added as query parameters.
The file updated examplefilecsv is included so that it is uploaded as the body of the request. This file should contain the metrics mappings as described above in the example template.

Response example details

The successful PUT example above shows the updated values for the parameter associated with the request. Note that the xdmMapped parameter also includes a true value, indicating a successful mapping.

Request Parameters

This endpoint includes request parameters described in previous sections.

Response Parameters

The following table describes the PUT mapping metrics response parameters not previously defined in other sections:

Name	Type	Description
`cjaId`	string	The metric ID in CJA
`dataId`	string	The data view ID in CJA
`xdmMapped`	boolean	Whether the metric was mapped in an XDM schema
`xdmNotes`	string	The text of the note for the metric in the uploaded `csv` file

DELETE mapping dimensions all

Use this endpoint to delete all metric mappings for specified report suites and data view IDs. If no mappings exist, this endpoint returns a successful response.

DELETE https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/all

Request and Response Examples

Click the Request tab in the following example to see a cURL request for this endpoint. Click the Response tab to see a successful JSON response for the request.

Request

Response

curl -X 'DELETE' \
  "https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/all?rsid=examplersid&dataId=exampledv" \
  -H "accept: application/json" \
  -H "x-api-key: {CLIENT_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"
Copied to your clipboard
curl -X 'DELETE' \
  "https://analytics.adobe.io/api/{GLOBAL_COMPANY_ID}/cjamigration/mapping/metrics/all?rsid=examplersid&dataId=exampledv" \
  -H "accept: application/json" \
  -H "x-api-key: {CLIENT_ID}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

{
  "result": "success",
  "method": "DELETE",
  "message": "Metrics mappings deleted successfully"  
}
Copied to your clipboard
{
  "result": "success",
  "method": "DELETE",
  "message": "Metrics mappings deleted successfully"  
}

Request example details

The DELETE example above shows the following:

The rsid and dataId values are included as examplersid and exampledv respectively in the URL of the cURL request. These values are added as query parameters.
All of the metrics in the specified report suite and CJA data view are to be deleted with this request.

Request Parameters

This endpoint includes request parameter described in previous sections.

Dimension mapping

Component Meta Data

Last updated 4/30/2025

Was this helpful?

Yes

Metric Mapping API

POST mapping metrics csv.css-83mclq{margin-left:var(--spectrum-global-dimension-size-100);}

Request and Response Examples.css-jmmyhj{margin-left:var(--spectrum-global-dimension-size-50);}

Request example details

Request parameters

Response Parameters

GET mapping metrics csv

Request and Response Examples

Request example details

Request parameters

Response Parameters

PUT mapping dimensions csv

Request and Response Examples

Request example details

Response example details

Request Parameters

Response Parameters

DELETE mapping dimensions all

Request and Response Examples

Request example details

Request Parameters

POST mapping metrics csv

Request and Response Examples