YOURDESTINATION

As you go through this template, replace or delete all the paragraphs in italics (starting with this one).

Start by updating the metadata (title and description) at the top of the page. Please ignore all instances of UICONTROL on this page. This is a tag that helps our machine translation processes correctly translate the page into the multiple languages that we support. We will add tags to your documentation after you submit it.

Overview

Provide a short overview for your company, including the value it provides to customers. Include a link to your product documentation homepage, for further reading.

IMPORTANT

This documentation page was created by the YOURDESTINATION team. For any inquiries or update requests, please contact them directly at Insert link or email address where you can be reached for updates

Prerequisites

Add information in this section about anything that customers need to be aware of before starting to set up the destination in the Adobe Experience Platform user interface. This can be about:

  • needing to be added to an allow list
  • requirements for email hashing
  • any account specifics on your side
  • how to obtain an API key to connect to your platform

You can link out to your relevant documentation if that would be useful to customers.

Supported identities

Add information in this section about the identities supported by your destination. We have prefilled the table with some standard values. Delete the values that don’t apply to your destination and any values that are not prefilled.

YOURDESTINATION supports the activation of identities described in the table below. Learn more about identities.

Target Identity Description Considerations
GAID Google Advertising ID Select the GAID target identity when your source identity is a GAID namespace.
IDFA Apple ID for Advertisers Select the IDFA target identity when your source identity is an IDFA namespace.
ECID Experience Cloud ID A namespace that represents ECID. This namespace can also be referred to by the following aliases: “Adobe Marketing Cloud ID”, “Adobe Experience Cloud ID”, “Adobe Experience Platform ID”. See the following document on ECID for more information.
phone_sha256 Phone numbers hashed with the SHA256 algorithm Both plain text and SHA256 hashed phone numbers are supported by Adobe Experience Platform. When your source field contains unhashed attributes, check the Apply transformation option, to have Platform automatically hash the data on activation.
email_lc_sha256 Email addresses hashed with the SHA256 algorithm Both plain text and SHA256 hashed email addresses are supported by Adobe Experience Platform. When your source field contains unhashed attributes, check the Apply transformation option, to have Platform automatically hash the data on activation.
extern_id Custom user IDs Select this target identity when your source identity is a custom namespace.

Export type

Segment Export - you are exporting all members of a segment (audience) with the identifiers (name, phone number, or others) used in the YOURDESTINATION destination.

Use cases

To help you better understand how and when you should use the YOURDESTINATION destination, here are sample use cases that Adobe Experience Platform customers can solve by using this destination.

Use case #1

For mobile messaging platforms:

A home rental and sales platform wants to push mobile notifications to customers’ Android and iOS devices to let them know that there are 100 updated listings in the area where they previously searched for a rental.

Use case #2

For social network platforms:

An athletic apparel brand wants to reach existing customers through their social media accounts. The apparel brand can ingest email addresses from their own CRM to Adobe Experience Platform, build segments from their own offline data, and send these segments to YOURDESTINATION, to display ads in their customers’ social media feeds.

Connect to the destination

To connect to this destination, follow the steps described in the destination configuration tutorial.

Connection parameters

While setting up this destination, you must provide the following information:

Add the fields that customers must fill in when configuring a new destination. These fields are destination-specific and depend on your configuration in Destination SDK. Your destination’s fields may not be the same as the ones listed below.

  • Name: A name by which you will recognize this destination in the future.
  • Description: A description that will help you identify this destination in the future.
  • Account ID: Your YOURDESTINATION account ID.

Activate segments to this destination

Read Activate profiles and segments to streaming segment export destinations for instructions on activating audience segments to this destination.

Exported data

Add a note about how data is exported to your destination. This would help the customer make sure that they have correctly integrated with your destination. For example, you could provide a sample JSON like the one below.

{
  "person": {
    "email": "yourstruly@adobe.con"
  },
  "segmentMembership": {
    "ups": {
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93": {
        "lastQualificationTime": "2020-05-25T21:24:39Z",
        "status": "exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae": {
        "lastQualificationTime": "2020-05-25T23:37:33Z",
        "status": "existing"
      }
    }
  },
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

Data usage and governance

All Adobe Experience Platform destinations are compliant with data usage policies when handling your data. For detailed information on how Adobe Experience Platform enforces data governance, read the Data Governance overview.

Additional resources

You can provide further links to your product documentation or any other resources you consider important for the customer to be successful.

On this page