This repository is deprecated and is no longer maintained.

Adobe I/O Audience Manager Customer Data SDK

Node Javascript SDK wrapping the Audience Manager Customer Data API.

More details on the API can be found here.

Installing

$ npm install

Usage

1. Initialize the SDK

const sdk = require('@adobe/aio-lib-audience-manager-cd')

async function sdkTest() {
  //initialize sdk
  const client = await sdk.init('<orgId>', 'x-api-key', '<valid auth token>')
}

2. Call methods using the initialized SDK

const sdk = require('@adobe/aio-lib-audience-manager-cd')

async function sdkTest() {
  // initialize sdk
  const audienceManagerCDClient = await sdk.init('<orgId>', 'x-api-key', '<valid auth token>')

  // call methods
  try {
    // Get profiles
    const result = await client.audienceManagerCDClient.getProfile({})
    console.log(result)

  } catch (e) {
    console.error(e)
  }
}

All methods available under the SDK are documented here

Classes

Functions

AudienceManagerCDCoreApi

This class provides methods to call Adobe Audience Manager Customer Data APIs. Before calling any method initialize the instance by calling the init method on it with valid values for orgId, apiKey and accessToken.

Kind: global class

• AudienceManagerCDCoreApi
  • .orgId : string
  • .apiKey : string
  • .accessToken : string
  • .init(orgId, apiKey, accessToken) ⇒ Promise.<AudienceManagerCDCoreApi>
  • .updateStream(streamId, body)
  • .updateProfile(dStreamId, [params], [body])
  • .getProfile(dataSourceId, id, [filter])

audienceManagerCDCoreApi.orgId : string

the organization id.

Kind: instance property of AudienceManagerCDCoreApi

audienceManagerCDCoreApi.apiKey : string

the API key for your integration.

Kind: instance property of AudienceManagerCDCoreApi

audienceManagerCDCoreApi.accessToken : string

the access token for your integration.

Kind: instance property of AudienceManagerCDCoreApi

audienceManagerCDCoreApi.init(orgId, apiKey, accessToken) ⇒ Promise.<AudienceManagerCDCoreApi>

Initializes a AudienceManagerCDCoreApi object and returns it.

Kind: instance method of AudienceManagerCDCoreApi
Returns: Promise.<AudienceManagerCDCoreApi> - AudienceManagerCDCoreApi object

| Param | Type | Description | | --- | --- | --- | | orgId | string | the organization id | | apiKey | string | the API key for your integration | | accessToken | string | the access token for your integration |

audienceManagerCDCoreApi.updateStream(streamId, body)

Data streaming: Allows multiple profile updates on the same call.

Ingest profile updates related to a given data stream.

Kind: instance method of AudienceManagerCDCoreApi

| Param | Type | Description | | --- | --- | --- | | streamId | string | the streamID is an alphanumeric identifier. | | body | string | the POST body. |

audienceManagerCDCoreApi.updateProfile(dStreamId, [params], [body])

GET/POST a Data Collection: Update a single Audience Manager profile via a GET or POST request. If the body is left out the update is performed via a GET request using the params object. Otherwise, to enforce a POST request, please set the required parameters into the body object

Kind: instance method of AudienceManagerCDCoreApi

| Param | Type | Default | Description | | --- | --- | --- | --- | | dStreamId | string | | the alphanumeric identifier for this stream. | | [params] | object | {} | optional request parameters. | | [params.dSid] | Array | | unique ID for a trait or a segment. | | [params.dTDpid] | Array | | data source for trait evaluation. Only traits from this data source are evaluated. | | [params.dUuid] | string | | unique Audience Manager user ID. | | [params.dMid] | string | | specifies the Experience Cloud ID set and used by the Experience Cloud ID service. | | [params.dCid] | string | | contains a pair of data provider ID and data provider user ID separated by %01. | | [params.dWs] | string | | write Style indicator: how the provided signals and/or trait IDs act upon the given profile(s). | | [params.dLocationId] | Array | | one or more location id that correspond to the region where we've previously seen this user interacting with the adobe services. | | [body] | object | | optional request parameters, use this instead of params to enforce a POST request. |

audienceManagerCDCoreApi.getProfile(dataSourceId, id, [filter])

Get Audience Manager profile: Returns aggregated information for a profile from all Audience Manager regions, including trait and segment qualification information. You can filter the requests by region to return qualification information from certain regions only.

Kind: instance method of AudienceManagerCDCoreApi

| Param | Type | Default | Description | | --- | --- | --- | --- | | dataSourceId | string | | the unique identifier of the Audience Manager data source that this identity is part of. | | id | string | | {integer} profile viewer id. | | [filter] | Array | [] | one or more location Ids, separated by comma, that correspond to the region(s) where profile information should be fetched from. |

init(orgId, apiKey, accessToken) ⇒ Promise.<AudienceManagerCDCoreApi>

Returns a Promise that resolves with a new AudienceManagerCDCoreApi object.

Kind: global function
Returns: Promise.<AudienceManagerCDCoreApi> - a Promise with a AudienceManagerCDCoreApi object.

| Param | Type | Description | | --- | --- | --- | | orgId | string | the organization id. | | apiKey | string | the API key for your integration. | | accessToken | string | the access token for your integration. |

Debug Logs

LOG_LEVEL=debug <your_call_here>

Prepend the LOG_LEVEL environment variable and debug value to the call that invokes your function, on the command line. This should output a lot of debug data for your SDK calls.

Contributing

Contributions are welcome! Read the Contributing Guide for more information.

Licensing

This project is licensed under the Apache V2 License. See LICENSE for more information.