Fazer upload de participantes para um público-alvo

Faça upload de membros para um público-alvo segmentado por lista de clientes enviando um IngestAudienceMembersRequest.

Para configurar e enviar a solicitação, siga estas etapas:

1. Defina o campo termsOfService como uma mensagem TermsOfService com customerMatchTermsOfServiceStatus definido como ACCEPTED para confirmar que o operatingAccount aceitou os Termos de Serviço da Segmentação por Lista de Clientes.

2. Em cada AudienceMember na lista audienceMembers, defina o campo de dados com base no tipo de dados que o upload contém:

   • Se o upload tiver informações de contato, defina o campo compositeData como um objeto CompositeData e o campo userData como um objeto UserData. Adicione uma entrada separada na lista userIdentifiers para cada identificador do membro do público-alvo.

     Embora o userData ainda seja compatível, recomendamos o uso de compositeData para garantir que sua integração esteja preparada para melhorias futuras. Consulte Dados compostos para mais detalhes.

   • Se o upload tiver IDs digitais, defina o campo mobileData como uma mensagem MobileData. Adicione uma entrada separada na lista mobileIds para cada ID digital do membro do público-alvo.

3. Envie dados da Segmentação por Lista de Clientes seguindo as etapas em Enviar membros do público-alvo.

Membros do público-alvo de amostra

Os exemplos a seguir mostram como estruturar um objeto AudienceMember para cada tipo de dados de membro. Cada AudienceMember em uma única solicitação precisa ter o mesmo tipo de conjunto de dados de ID (compositeData, mobileData):

Dados de contato

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

IDs digitais

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}