Fazer upload de participantes para um público-alvo

Envie um IngestAudienceMembersRequest para fazer o upload de membros de 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 informações de contato, defina o compositeData campo como um CompositeData objeto, e defina seu userData campo como um UserData objeto. Adicione uma entrada separada na lista userIdentifiers para cada identificador 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.

3. Envie os 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):

Dados de contato

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

IDs digitais

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