Assimilar e use públicos-alvo da Experience Platform

Na interface da Experience Platform:

1. Selecione Cliente > Públicos.

2. Selecione Procurar e procure os públicos que você deseja assimilar e usar no Customer Journey Analytics. Anote a ID de público-alvo para cada um dos públicos-alvo para uso posterior.

   

Solicitação

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"
   }
}'

Onde:

• DATASET_NAME é o nome amigável do conjunto de dados. Por exemplo, Segment Export Job Dataset for CJA.

Resposta

["@/dataSets/{DATASET_ID}"]

Onde:

• DATASET_ID é o identificador do conjunto de dados criado.

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"
    }
}'

Em que

• COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES pode ser algo como _demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName. Certifique-se de incluir pelo menos os campos relevantes (como a personID (email)) que deseja usar na Análise de Jornada do cliente.
• AUDIENCE_ID_x são os identificadores de público-alvo dos públicos que você deseja exportar.
• DATASET_ID é o conjunto de dados que você criou.

Resposta

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

Em que

• EXPORT_JOB_ID é o identificador do trabalho de exportação.

Solicitação

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}'

Resposta

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

Na interface da Experience Platform:

1. Selecione Gerenciamento de Dados > Conjuntos de Dados.

2. Selecione o conjunto de dados criado, por exemplo: Conjunto de dados do trabalho de exportação de segmento para o CJA.

   

3. Verifique os lotes assimilados. Se o conjunto de dados contiver lotes com falha, use Gerenciamento de Dados > Monitoramento para ver qual é o motivo. Por exemplo, você usou um nome de campo que não existe no esquema.

4. Copie o Nome da tabela do conjunto de dados. Por exemplo: segment_export_job_dataset_for_cja. Use esse nome na próxima etapa.

Use um cliente PSQL que se conecta ao Serviço de consulta Experience Platform.

Na interface da Experience Platform:

1. Selecione Data Management > Queries.
2. Selecione Credentials.

Use as credenciais para configurar o cliente PSQL para conexão com o Serviço de Consulta Customer Journey Analytics.

Consulta

Execute esta consulta para recuperar os dados de público-alvo do conjunto de dados:

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')

Onde:

• IDENTITY_TO_USE_AS_PERSON_ID é um dos campos que você definiu como parte do trabalho de exportação. Por exemplo: _demoemea.identification.core.email.
• DATASET_TABLE_NAME é o nome da tabela do conjunto de dados.
• AUDIENCE_ID_x são os públicos-alvo definidos como parte do trabalho de exportação. Você precisa especificar esses públicos-alvo mais uma vez, pois a especificação no trabalho de exportação é um filtro em nível de linha. Esse filtro em nível de linha retorna perfis para os segmentos especificados com todas as associações de segmento para cada um dos perfis.

Resultados

O resultado da consulta, no formato JSON, deve ser semelhante a:

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

]

Onde:

• PERSON_ID_x são os valores do identificador que você deseja usar como a ID de pessoa. Por exemplo, john.doe@gmail.com quando você usa email.
• AUDIENCE_ID_x são os identificadores de público.

O JSON final deve ser semelhante a:

[
   {
      "_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}"
      }
    }
  }

]

Onde:

• TENANT_NAME é o nome do locatário. Por exemplo: _demoemea.
• PERSON_ID_x são os valores do identificador que você deseja usar como a ID de pessoa. Por exemplo, john.doe@gmail.com quando você usa email.
• AUDIENCE_ID_x são os identificadores de público.
• AUDIENCE_FRIENDLY_NAME_x são nomes de público amigáveis para as IDs de público. Por exemplo: Luma - Blue+ Members.

Use sua ferramenta favorita para transformar o JSON original neste formato.

Para criar o esquema:

Na interface da Experience Platform:

1. Selecione Gerenciamento de Dados > Esquemas.

2. Selecione Criar esquema. Selecione Padrão no menu suspenso.

3. Selecione Manual na caixa de diálogo Criar um esquema e use Selecionar para continuar.

4. No assistente Criar esquema, na etapa Selecionar uma classe:

   1. Selecione Perfil Individual.
   2. Selecione Próximo.

5. No assistente Criar esquema, na etapa Nome e revisão:

   1. Insira um nome para exibição do esquema. Por exemplo: Audience Export for CJA Schema.
   2. (opcional) Insira uma Descrição.
   3. Selecione Concluir.

6. Configure seu esquema para conter um grupo de campos personalizado (chamado, por exemplo, Associação de público-alvo) que contém dois campos chamados audienceMembershipId e audienceMembershipName.

7. Verifique se o campo personID é uma Identidade, Identidade primária e se tem Email como o I​namespace de identidade.

   

8. Aplicar todas as alterações. Clique em Salvar para salvar o esquema.

Na interface da Experience Platform:

1. Selecione Gerenciamento de Dados > Conjuntos de Dados.

2. Selecione Criar conjunto de dados.

3. Selecione Criar conjunto de dados a partir do esquema.

4. No assistente Criar conjunto de dados a partir do esquema, na etapa Selecionar esquema:

   1. Selecione o schema que acabou de criar. Por exemplo: Exportação de público-alvo para esquema do CJA.
   2. Selecione Próximo.

5. No assistente Criar conjunto de dados do esquema, na etapa Configurar conjunto de dados:

   1. Insira um Nome para o conjunto de dados.
   2. (opcional) Insira uma Descrição para o conjunto de dados.
   3. Selecione Concluir.

6. Em Conjuntos de Dados > nome do conjunto de dados, arraste o arquivo de dados JSON transformado e solte-o em Arraste e solte arquivos. Essa ação inicia a assimilação dos dados JSON exportados no conjunto de dados.

7. Verifique os lotes assimilados. Se o conjunto de dados contiver lotes com falha, use Gerenciamento de Dados > Monitoramento para ver qual é o motivo. Por exemplo, você definiu um nome de campo no JSON que não existe no esquema.

Na interface do Customer Journey Analytics:

1. Selecione Gerenciamento de Dados > Conexões.

2. Criar uma nova conexão/ Definir configurações da conexão e configurações de dados. Ou selecione uma conexão existente e use Editar Conexão para editar a conexão.

3. Selecione Adicionar conjuntos de dados.

4. Selecione o conjunto de dados criado e no qual você assimilou os dados JSON transformados.

5. Configure o conjunto de dados. Por exemplo:

   

6. Salve a conexão.

1. Selecione Gerenciamento de dados > Visualizações de dados.

2. Edite uma visualização de dados existente ou crie uma nova visualização de dados.

3. Na guia Componentes da visualização de dados, verifique se a Id de Associação de Público-Alvo e o Nome de Associação de Público-Alvo foram adicionados como componentes de dimensão.

   

4. Selecione Salvar e Continuar para salvar a visualização de dados.