Fazer upload de participantes para um público-alvo

Envie um IngestAudienceMembersRequest para fazer o upload de membros para um público-alvo segmentado por lista de clientes.

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

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

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

   • Se o upload contiver dados de contato, dados de endereço IP, ou ambos, defina o campo compositeData como um CompositeData objeto. Para dados de contato, defina o campo userData como um UserData objeto e adicione uma entrada separada na lista userIdentifiers para cada identificador do membro do público-alvo. Para dados de endereço IP, adicione uma IpData entrada na ipData lista para cada endereço IP do membro do público-alvo.

     Embora 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 contiver IDs digitais, defina o mobileData campo como uma MobileData mensagem. Adicione uma entrada separada na lista mobileIds para cada ID digital do membro do público-alvo.

   • Se o upload contiver User-IDs, defina o userIdData campo como uma UserIdData mensagem, e defina o campo userId como o User-ID 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.

Exemplos de membros do público-alvo

Os exemplos a seguir mostram como estruturar um AudienceMember objeto 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 ou userIdData):

Dados de contato

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

Dados de endereço IP

{
  "compositeData": {
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

Dados de contato e IP

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    },
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

IDs digitais

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

User-IDs

{
  "userIdData": {
    "userId": "user_987654321"
  }
}