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 dados de contato, dados de endereço IP ou ambos, defina o campo compositeData como um objeto CompositeData. Para dados de contato, defina o campo userData como um objeto UserData 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 entrada IpData na lista ipData para cada endereço IP 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.

   • Se o upload tiver IDs de usuário, defina o campo userIdData como uma mensagem UserIdData e o campo userId como o ID do usuário 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 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"
  }
}