Ingesta y uso de públicos de Experience Platform

En la interfaz de usuario de Experience Platform, haga lo siguiente:

1. Seleccione Cliente > Audiencias.

2. Seleccione Examinar y busque las audiencias que desee introducir y utilizar en Customer Journey Analytics. Tenga en cuenta ID de audiencia para cada una de las audiencias que se usarán más adelante.

   

Solicitud

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
   "name": "{DATASET_NAME}",
   "schemaRef": {
      "id": "_xdm.context.profile__union",
      "contentType": "application/vnd.adobe.xed+json;version=1"
   },
   "fileDescription": {
      "persistet": true,
      "containerFormat": "parquet",
      "format": "parquet"
   }
}'

Donde:

• DATASET_NAME es el nombre descriptivo del conjunto de datos. Por ejemplo, Segment Export Job Dataset for CJA.

Respuesta

["@/dataSets/{DATASET_ID}"]

Donde:

• DATASET_ID es el identificador del conjunto de datos creado.

curl -X POST https://platform.adobe.io/data/core/ups/export/jobs \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "fields": "{COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES}",
    "filter": {
        "segments": [
            {
                "segmentId": "{AUDIENCE_ID_1}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_2}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_3}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ]
             }
        ]
    },
    "destination":{
        "datasetId": "{DATASET_ID}",
        "segmentPerBatch": false
    },
    "schema":{
        "name": "_xdm.context.profile"
    }
}'

Donde

• COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES podría ser algo así como _demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName. Asegúrese de incluir al menos los campos relevantes (como personID (correo electrónico)) que desee utilizar en el análisis de Recorrido del cliente.
• AUDIENCE_ID_x son los identificadores de audiencia de las audiencias que desea exportar.
• DATASET_ID es el conjunto de datos que creó.

Respuesta

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
}

Donde

• EXPORT_JOB_ID es el identificador del trabajo de exportación.

Solicitud

curl -X GET https://platform.adobe.io/data/core/ups/export/jobs/{EXPORT_JOB_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
  "status": "SUCCEEDED",
  "..."
}

En la interfaz de usuario de Experience Platform, haga lo siguiente:

1. Seleccione Administración de datos > Conjuntos de datos.

2. Seleccione el conjunto de datos que creó, por ejemplo: Conjunto de datos del trabajo de exportación de segmentos para CJA.

   

3. Compruebe los lotes ingeridos. Si el conjunto de datos contiene lotes con errores, use Administración de datos > Supervisión para ver cuál es el motivo. Por ejemplo, se ha utilizado un nombre de campo que no existe en el esquema.

4. Copie el nombre de tabla del conjunto de datos. Por ejemplo: segment_export_job_dataset_for_cja. Ese nombre se utiliza en el paso siguiente.

Utilice un cliente SQL que se conecte a Experience Platform Query Service.

En la interfaz de usuario de Experience Platform, haga lo siguiente:

1. Seleccione Administración de datos > Consultas.
2. Seleccione Credenciales.

Utilice las credenciales para configurar el cliente PSQL para conectarse al servicio de consultas de Customer Journey Analytics.

Consulta

Ejecute esta consulta para recuperar los datos de audiencia del conjunto de datos:

SELECT ROW_NUMBER() OVER (ORDER BY key)::text as _id, personID, key as audienceMembershipId
FROM (
   SELECT {IDENTITY_TO_USE_AS_PERSON_ID} AS personID, explode(segmentMembership.ups)
   FROM {DATASET_TABLE_NAME}
)
WHERE value.status = 'realized' AND (key = '{AUDIENCE_ID_1}' OR key = 'AUDIENCE_ID_2' OR key = 'AUDIENCE_ID_3')

Donde:

• IDENTITY_TO_USE_AS_PERSON_ID es uno de los campos que definió como parte del trabajo de exportación. Por ejemplo: _demoemea.identification.core.email.
• DATASET_TABLE_NAME es el nombre de tabla del conjunto de datos.
• AUDIENCE_ID_x son las audiencias que definió como parte del trabajo de exportación. Debe especificar estas audiencias una vez más, ya que la especificación en el trabajo de exportación es un filtro de nivel de fila. Ese filtro de nivel de fila devuelve perfiles para los segmentos especificados con todas las suscripciones a segmentos para cada uno de los perfiles.

Resultados

El resultado de la consulta, en formato JSON, debería tener un aspecto similar al siguiente:

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   },
   {
      "_id": "2",
      "personID": "PERSON_ID_y",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   }

]

Donde:

• PERSON_ID_x son los valores del identificador que desea usar como ID de persona. Por ejemplo, john.doe@gmail.com cuando utiliza el correo electrónico.
• AUDIENCE_ID_x son los identificadores de audiencia.

El JSON final debería tener un aspecto similar al siguiente:

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_x}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_x}"
      }
  },
  {
      "_id": "2",
      "personID": "{PERSON_ID_y}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_y}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_y}"
      }
    }
  }

]

Donde:

• TENANT_NAME es el nombre del usuario. Por ejemplo: _demoemea.
• PERSON_ID_x son los valores de identificador del identificador que desea usar como ID de persona. Por ejemplo, john.doe@gmail.com cuando utiliza el correo electrónico.
• AUDIENCE_ID_x son los identificadores de audiencia.
• AUDIENCE_FRIENDLY_NAME_x son nombres descriptivos de la audiencia para los id de audiencia. Por ejemplo: Luma - Blue+ Members.

Utilice su herramienta favorita para transformar el JSON original a este formato.

Para crear el esquema:

En la interfaz de usuario de Experience Platform, haga lo siguiente:

1. Seleccione Administración de datos > Esquemas.

2. Seleccione Crear esquema. Seleccione Estándar en el menú desplegable.

3. Seleccione Manual en el cuadro de diálogo Crear un esquema y use Seleccionar para continuar.

4. En el asistente Crear esquema, en el paso Seleccionar una clase:

   1. Seleccione Perfil individual.
   2. Seleccione Siguiente.

5. En el asistente Crear esquema, en el paso Nombre y revisión:

   1. Escriba un nombre para mostrar del esquema. Por ejemplo: Audience Export for CJA Schema.
   2. (opcional) Escriba Descripción.
   3. Seleccione Finalizar.

6. Configure el esquema para que contenga un grupo de campos personalizados (por ejemplo, Pertenencia a la audiencia) que contenga dos campos llamados audienceMembershipId y audienceMembershipName.

7. Asegúrese de que el campo personID sea una identidad, identidad principal y que tenga Correo electrónico como el área de nombres de ID​identidad.

   

8. Aplicar todos los cambios. Seleccione Guardar para guardar el esquema.

En la interfaz de usuario de Experience Platform, haga lo siguiente:

1. Seleccione Administración de datos > Conjuntos de datos.

2. Seleccione Crear conjunto de datos.

3. Seleccione Crear conjunto de datos a partir de esquema.

4. En el asistente Crear conjunto de datos a partir del esquema, en el paso Seleccionar esquema:

   1. Seleccione el esquema recién creado. Por ejemplo: Exportación de audiencias para el esquema de CJA.
   2. Seleccione Siguiente.

5. En el asistente Crear conjunto de datos a partir de esquema, en el paso Configurar conjunto de datos:

   1. Escriba un Nombre para el conjunto de datos.
   2. (opcional) Escriba una Descripción para el conjunto de datos.
   3. Seleccione Finalizar.

6. En Conjuntos de datos > nombre del conjunto de datos, arrastre el archivo de datos JSON transformado y suelte el archivo en Arrastrar y soltar archivos. Esta acción inicia la ingesta de los datos JSON exportados en el conjunto de datos.

7. Compruebe los lotes ingeridos. Si el conjunto de datos contiene lotes con errores, use Administración de datos > Supervisión para ver cuál es el motivo. Por ejemplo, ha definido un nombre de campo en el JSON que no existe en el esquema.

En la IU de Customer Journey Analytics:

1. Seleccione Administración de datos > Conexiones.

2. Crear una nueva conexión/ Definir configuración de conexión y configuración de datos. O bien, seleccione una conexión existente y use Editar conexión para editar la conexión.

3. Seleccione Agregar conjuntos de datos.

4. Seleccione el conjunto de datos que ha creado y en el que ha introducido los datos JSON transformados.

5. Configure el conjunto de datos. Por ejemplo:

   

6. Guarde la conexión.

1. Seleccione Administración de datos > Vistas de datos.

2. Edite una vista de datos existente o cree una nueva vista de datos.

3. En la ficha Componentes de la vista de datos, asegúrese de que Id. de pertenencia a audiencia y Nombre de pertenencia a audiencia se agregan como componentes de dimensión.

   

4. Seleccione Guardar y continuar para guardar la vista de datos.