Importação e uso de públicos externos

O Adobe Experience Platform oferece suporte à capacidade de importar público externo, que pode ser usado posteriormente como componentes para um novo público. Este documento fornece um tutorial para configurar o Experience Platform para importar e usar públicos externos.

Introdução

Este tutorial requer um entendimento prático dos vários Adobe Experience Platform serviços envolvidos na criação de públicos. Antes de iniciar este tutorial, revise a documentação dos seguintes serviços:

Definições de públicos versus segmentos

Antes de começar a importar e usar públicos externos, é importante entender a diferença entre públicos e definições de segmento.

Os públicos-alvo se referem ao grupo de perfis no qual você está tentando filtrar. Ao usar definições de segmento, você pode criar um público-alvo criando uma definição de segmento que filtre seus perfis para o subconjunto que atende aos critérios de qualificação de segmento.

As definições de segmento incluem informações como nome, descrição, expressão (se aplicável), data de criação, data da última modificação e uma ID. A ID vincula os metadados do segmento aos perfis individuais que atendem à qualificação do segmento e fazem parte do público-alvo resultante.

Criar um namespace de identidade para o público externo

A primeira etapa para usar públicos-alvo externos é criar um namespace de identidade. Os namespaces de identidade permitem que a Platform associe de onde um público-alvo se origina.

Para criar um namespace de identidade, siga as instruções na guia de namespace de identidade. Ao criar o namespace de identidade, adicione os detalhes de origem ao namespace de identidade e marque sua Tipo as a Identificador não pessoal.

Criar um esquema para os metadados do segmento

Depois de criar um namespace de identidade, é necessário criar um novo esquema para o segmento que você criará.

Para começar a compor um esquema, primeiro selecione Esquemas na barra de navegação à esquerda, seguido pelo botão Criar esquema no canto superior direito do espaço de trabalho Esquemas. Aqui, selecione Procurar para ver uma seleção completa dos Tipos de esquema disponíveis.

Como você está criando uma definição de segmento, que é uma classe predefinida, selecione Usar classe existente. Agora, selecione a variável Definição de segmento classe, seguida por Atribuir classe.

Agora que o esquema foi criado, será necessário especificar qual campo conterá a ID do segmento. Este campo deve ser marcado como a identidade primária e atribuído aos namespaces criados anteriormente.

Depois de marcar o _id como a identidade primária, selecione o título do esquema, seguido da alternância rotulada como Perfil. Selecionar Ativar para ativar o esquema para Real-Time Customer Profile.

Agora, esse esquema é ativado para Perfil, com a identificação principal atribuída ao namespace de identidade que não é de pessoa que você criou. Como resultado, isso significa que os metadados de segmento importados para a Platform usando esse esquema serão assimilados no Perfil sem serem mesclados com outros dados de perfil relacionados às pessoas.

Criar um conjunto de dados para o esquema

Depois de configurar o esquema, será necessário criar um conjunto de dados para os metadados do segmento.

Para criar um conjunto de dados, siga as instruções na guia do usuário do conjunto de dados. Você deve seguir o Criar conjunto de dados a partir do esquema opção, usando o schema criado anteriormente.

Depois de criar o conjunto de dados, continue seguindo as instruções na guia do usuário do conjunto de dados para ativar esse conjunto de dados para o Perfil de cliente em tempo real.

Configurar e importar dados de público

Com o conjunto de dados ativado, os dados agora podem ser enviados para a Platform por meio da interface do usuário ou usando as APIs de Experience Platform. Você pode assimilar esses dados por meio de uma conexão em lote ou de transmissão.

Assimilar dados usando uma conexão em lote

Para criar uma conexão em lote, siga as instruções na guia genérica guia da interface do usuário de upload de arquivo local. Para obter uma lista completa de fontes disponíveis com as quais você pode usar a assimilação de dados, leia a visão geral das origens.

Assimilar dados usando uma conexão de transmissão

Para criar uma conexão de transmissão, siga as instruções em Tutorial de API ou o Tutorial de interface do usuário.

Depois de criar a conexão de streaming, você terá acesso ao terminal de streaming exclusivo para o qual poderá enviar seus dados. Para saber como enviar dados para esses endpoints, leia o tutorial sobre transmissão de dados de registro.

Estrutura de metadados de público

Depois de criar uma conexão, você pode assimilar seus dados na Platform.

Uma amostra dos metadados da carga do público-alvo externo pode ser vista abaixo:

{
    "header": {
        "schemaRef": {
            "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
            "contentType": "application/vnd.adobe.xed-full+json;version=1"
        },
        "imsOrgId": "{ORG_ID}",
        "datasetId": "{DATASET_ID}",
        "source": {
            "name": "Sample External Audience"
        }
    },
    "body": {
        "xdmMeta": {
            "schemaRef": {
                "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
                "contentType": "application/vnd.adobe.xed-full+json;version=1"
            }
        },
        "xdmEntity": {
            "_id": "{SEGMENT_ID}",
            "description": "Sample description",
            "identityMap": {
                "{IDENTITY_NAMESPACE}": [{
                    "id": "{}"
                }]
            },
            "segmentName" : "{SEGMENT_NAME}",
            "segmentStatus": "ACTIVE",
            "version": "1.0"
        }
    }
}

Criação de segmentos usando públicos importados

Após configurar os públicos-alvo importados, eles podem ser usados como parte do processo de segmentação. Para encontrar públicos externos, acesse o Construtor de segmentos e selecione Públicos-alvo na guia Campos seção.

Próximas etapas

Agora que você pode usar públicos-alvo externos nos segmentos, pode usar o Construtor de segmentos para criar segmentos. Para saber como criar segmentos, leia o tutorial sobre a criação de segmentos.

Apêndice

Além de usar metadados de público-alvo externo importados e usá-los para criar segmentos, você também pode importar associações de segmento externo para a Platform.

Configurar um esquema de destino de associação de segmento externo

Para começar a compor um esquema, primeiro selecione Esquemas na barra de navegação à esquerda, seguido pelo botão Criar esquema no canto superior direito do espaço de trabalho Esquemas. Aqui, selecione Perfil individual XDM.

Agora que o esquema foi criado, será necessário adicionar o grupo de campos de associação de segmento como parte do esquema. Para fazer isso, selecione Detalhes da associação do segmento, seguido por Adicionar grupos de campos.

Além disso, verifique se o esquema está marcado para Perfil. Para fazer isso, será necessário marcar um campo como a identidade principal.

Configurar o conjunto de dados

Depois de criar seu esquema, será necessário criar um conjunto de dados.

Para criar um conjunto de dados, siga as instruções na guia do usuário do conjunto de dados. Você deve seguir o Criar conjunto de dados a partir do esquema opção, usando o schema criado anteriormente.

Depois de criar o conjunto de dados, continue seguindo as instruções na guia do usuário do conjunto de dados para ativar esse conjunto de dados para o Perfil de cliente em tempo real.

Configurar e importar dados de associação de público externo

Com o conjunto de dados ativado, os dados agora podem ser enviados para a Platform por meio da interface do usuário ou usando as APIs de Experience Platform. Você pode assimilar esses dados por meio de uma conexão em lote ou de transmissão.

Assimilar dados usando uma conexão em lote

Para criar uma conexão em lote, siga as instruções na guia genérica guia da interface do usuário de upload de arquivo local. Para obter uma lista completa de fontes disponíveis com as quais você pode usar a assimilação de dados, leia a visão geral das origens.

Assimilar dados usando uma conexão de transmissão

Para criar uma conexão de transmissão, siga as instruções em Tutorial de API ou o Tutorial de interface do usuário.

Depois de criar a conexão de streaming, você terá acesso ao terminal de streaming exclusivo para o qual poderá enviar seus dados. Para saber como enviar dados para esses endpoints, leia o tutorial sobre transmissão de dados de registro.

Estrutura de associação de segmento

Depois de criar uma conexão, você pode assimilar seus dados na Platform.

Um exemplo da carga de associação do público-alvo externo pode ser visto abaixo:

{
    "header": {
        "schemaRef": {
            "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
            "contentType": "application/vnd.adobe.xed-full+json;version=1"
        },
        "imsOrgId": "{ORG_ID}",
        "datasetId": "{DATASET_ID}",
        "source": {
            "name": "Sample External Audience Membership"
        }
    },
    "body": {
        "xdmMeta": {
            "schemaRef": {
                "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
                "contentType": "application/vnd.adobe.xed-full+json;version=1"
            }
        },
        "xdmEntity": {
            "_id": "{UNIQUE_ID}",
            "description": "Sample description",
            "{TENANT_NAME}": {
                "identities": {
                    "{SCHEMA_IDENTITY}": "sample-id"
                }
            },
            "personId" : "sample-name",
            "segmentMembership": {
                "{IDENTITY_NAMESPACE}": {
                    "{EXTERNAL_IDENTITY}": {
                        "status": "realized",
                        "lastQualificationTime": "2022-03-14T:00:00:00Z"
                    }
                }
            }
        }
    }
}