Configuração em lote batch-configuration

Use as opções de configuração em lote no Destination SDK para permitir que os usuários personalizem os nomes dos arquivos exportados e configurem o agendamento de exportação de acordo com suas preferências.

Ao criar destinos baseados em arquivo por meio do Destination SDK, você pode configurar a nomenclatura de arquivo padrão e os agendamentos de exportação ou pode dar aos usuários a opção de definir essas configurações na interface do usuário da Platform. Por exemplo, você pode configurar comportamentos como:

  • Incluindo informações específicas no nome do arquivo, como IDs de público-alvo, IDs de destino ou informações personalizadas.
  • Permitir que os usuários personalizem a nomeação de arquivos na interface do usuário da Platform.
  • Configure as exportações de arquivos para que ocorram em intervalos de tempo definidos.
  • Defina quais opções de nomenclatura de arquivo e personalização de agendamento de exportação os usuários podem ver na interface do usuário da Platform.

As definições de configuração em lote fazem parte da configuração de destino para destinos baseados em arquivo.

Para entender onde esse componente se encaixa em uma integração criada com o Destination SDK, consulte o diagrama no opções de configuração ou consulte o guia sobre como usar o Destination SDK para configurar um destino baseado em arquivo.

É possível definir as configurações de nomenclatura de arquivo e programação de exportação por meio da /authoring/destinations terminal. Consulte as seguintes páginas de referência de API para obter exemplos detalhados de chamadas de API, onde é possível configurar os componentes mostrados nesta página.

Este artigo descreve todas as opções de configuração em lote compatíveis que você pode usar para o seu destino e mostra o que os clientes verão na interface do usuário da Platform.

IMPORTANT
Todos os nomes e valores de parâmetros compatíveis com o Destination SDK são diferencia maiúsculas de minúsculas. Para evitar erros de diferenciação entre maiúsculas e minúsculas, use os nomes e valores dos parâmetros exatamente como mostrado na documentação.

Tipos de integração compatíveis supported-integration-types

Consulte a tabela abaixo para obter detalhes sobre quais tipos de integrações suportam a funcionalidade descrita nesta página.

Tipo de integração
Suporte à funcionalidade
Integrações em tempo real (streaming)
Não
Integrações baseadas em arquivo (lote)
Sim

Parâmetros compatíveis supported-parameters

Os valores configurados aqui são exibidos na variável Agendar exportação de público etapa do fluxo de trabalho de ativação dos destinos baseados em arquivo.

"batchConfig":{
   "allowMandatoryFieldSelection":true,
   "allowDedupeKeyFieldSelection":true,
   "defaultExportMode":"DAILY_FULL_EXPORT",
   "allowedExportMode":[
      "DAILY_FULL_EXPORT",
      "FIRST_FULL_THEN_INCREMENTAL"
   ],
   "allowedScheduleFrequency":[
      "DAILY",
      "EVERY_3_HOURS",
      "EVERY_6_HOURS",
      "EVERY_8_HOURS",
      "EVERY_12_HOURS",
      "ONCE"
   ],
   "defaultFrequency":"DAILY",
   "defaultStartTime":"00:00",
   "filenameConfig":{
         "allowedFilenameAppendOptions":[
            "SEGMENT_NAME",
            "DESTINATION_INSTANCE_ID",
            "DESTINATION_INSTANCE_NAME",
            "ORGANIZATION_NAME",
            "SANDBOX_NAME",
            "DATETIME",
            "CUSTOM_TEXT"
         ],
         "defaultFilenameAppendOptions":[
            "DATETIME"
         ],
         "defaultFilename":"%DESTINATION%_%SEGMENT_ID%"
      },
   "segmentGroupingEnabled": true
   }
Parâmetro
Tipo
Descrição
allowMandatoryFieldSelection
Booleano
Defina como true para permitir que os clientes especifiquem quais atributos de perfil são obrigatórios. O valor padrão é false. Consulte Atributos obrigatórios para obter mais informações.
allowDedupeKeyFieldSelection
Booleano
Defina como true para permitir que os clientes especifiquem chaves de desduplicação. O valor padrão é false. Consulte Chaves de desduplicação para obter mais informações.
defaultExportMode
Enum

Define o modo de exportação de arquivo padrão. Valores compatíveis:

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL

O valor padrão é DAILY_FULL_EXPORT. Consulte a documentação de ativação em lote para obter detalhes sobre o agendamento de exportações de arquivos.

allowedExportModes
Lista

Define os modos de exportação de arquivo disponíveis para clientes. Valores compatíveis:

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
allowedScheduleFrequency
Lista

Define a frequência de exportação de arquivos disponível para os clientes. Valores compatíveis:

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
defaultFrequency
Enum

Define a frequência de exportação de arquivo padrão. Valores compatíveis:

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY

O valor padrão é DAILY.

defaultStartTime
String
Define a hora de início padrão da exportação de arquivos. Usa o formato de arquivo de 24 horas. O valor padrão é "00:00".
filenameConfig.allowedFilenameAppendOptions
String

Obrigatório. Lista de macros de nome de arquivo disponíveis para os usuários escolherem. Isso determina quais itens são anexados a nomes de arquivo exportados (ID de público-alvo, nome da organização, data e hora da exportação e outros). Ao definir defaultFilename, evite a duplicação de macros.

Valores compatíveis:

  • DESTINATION
  • SEGMENT_ID
  • SEGMENT_NAME
  • DESTINATION_INSTANCE_ID
  • DESTINATION_INSTANCE_NAME
  • ORGANIZATION_NAME
  • SANDBOX_NAME
  • DATETIME
  • CUSTOM_TEXT

Independentemente da ordem em que você define as macros, a interface do Experience Platform sempre as exibirá na ordem apresentada aqui.

Se defaultFilename estiver vazio, a variável allowedFilenameAppendOptions a lista deve conter pelo menos uma macro.

filenameConfig.defaultFilenameAppendOptions
String
Obrigatório. Macros de nome de arquivo padrão pré-selecionadas que os usuários podem desmarcar.

As macros desta lista são um subconjunto das definidas em allowedFilenameAppendOptions.
filenameConfig.defaultFilename
String
Opcional. Define as macros de nome de arquivo padrão para os arquivos exportados. Eles não podem ser substituídos por usuários.

Qualquer macro definida por allowedFilenameAppendOptions será anexado após a variável defaultFilename macros.

Se defaultFilename estiver vazio, você deve definir pelo menos uma macro em allowedFilenameAppendOptions.
segmentGroupingEnabled
Booleano

Define se os públicos ativados devem ser exportados em um único arquivo ou em vários arquivos, com base no público política de mesclagem. Valores compatíveis:

  • true: exporta um arquivo por política de mesclagem.
  • false: exporta um arquivo por público-alvo, independentemente da política de mesclagem. Esse é o comportamento padrão. Você pode obter o mesmo resultado omitindo esse parâmetro totalmente.

Configuração do nome do arquivo file-name-configuration

Use macros de configuração de nome de arquivo para definir o que os nomes de arquivo exportados devem incluir. As macros na tabela abaixo descrevem os elementos encontrados na interface do usuário do configuração do nome do arquivo tela.

TIP
Como prática recomendada, inclua sempre a variável SEGMENT_ID em seus nomes de arquivo exportados. As IDs de segmento são exclusivas, portanto, incluí-las no nome do arquivo é a melhor maneira de garantir que os nomes de arquivo também sejam exclusivos.
Macro
Rótulo da interface
Descrição
Exemplo
DESTINATION
Destino
Nome do destino na interface do usuário.
Amazon S3
SEGMENT_ID
ID do segmento
ID de público-alvo exclusiva gerada pela Platform
ce5c5482-2813-4a80-99bc-57113f6acde2
SEGMENT_NAME
Nome do segmento
Nome de público definido pelo usuário
Assinante do VIP
DESTINATION_INSTANCE_ID
ID de destino
ID exclusiva gerada pela Platform da instância de destino
7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME
Nome do destino
Nome definido pelo usuário da instância de destino.
Meu destino de publicidade de 2022
ORGANIZATION_NAME
Nome da Organização
Nome da organização do cliente no Adobe Experience Platform.
Nome da Minha Organização
SANDBOX_NAME
Nome da sandbox
Nome da sandbox usada pelo cliente.
prod
DATETIME / TIMESTAMP
Data e hora

DATETIME e TIMESTAMP ambos definem quando o arquivo foi gerado, mas em formatos diferentes.

  • DATETIME O usa o seguinte formato: AAAAMMDD_HHMMSS.
  • TIMESTAMP O usa o formato Unix de 10 dígitos.

DATETIME e TIMESTAMP são mutuamente exclusivas e não podem ser usadas simultaneamente.

  • DATETIME: 20220509_210543
  • TIMESTAMP: 1652131584
CUSTOM_TEXT
Texto personalizado
Texto personalizado definido pelo usuário a ser incluído no nome do arquivo. Não pode ser usado em defaultFilename.
Meu_Texto_Personalizado
TIMESTAMP
Data e hora
Carimbo de data e hora de 10 dígitos da hora em que o arquivo foi gerado, no formato Unix.
1652131584
MERGE_POLICY_ID
ID da política de mesclagem
A ID do política de mesclagem usado para gerar o público exportado. Use essa macro quando estiver agrupando públicos exportados em arquivos, com base na política de mesclagem. Use esta macro juntamente com segmentGroupingEnabled:true.
e8591fdb-2873-4b12-b63e-15275b1c1439
MERGE_POLICY_NAME
Nome da política de mesclagem
O nome do política de mesclagem usado para gerar o público exportado. Use essa macro quando estiver agrupando públicos exportados em arquivos, com base na política de mesclagem. Use esta macro juntamente com segmentGroupingEnabled:true.
Minha política de mesclagem personalizada

Exemplo de configuração do nome do arquivo

O exemplo de configuração abaixo mostra a correspondência entre a configuração usada na chamada de API e as opções mostradas na interface do usuário.

"filenameConfig":{
   "allowedFilenameAppendOptions":[
      "CUSTOM_TEXT",
      "SEGMENT_ID",
      "DATETIME"
   ],
   "defaultFilenameAppendOptions":[
      "SEGMENT_ID",
      "DATETIME"
   ],
   "defaultFilename": "%DESTINATION%"
}

Imagem da interface do usuário mostrando a tela de configuração de nome de arquivo com macros pré-selecionadas

Próximas etapas next-steps

Depois de ler este artigo, você deverá entender melhor como configurar a nomenclatura de arquivos e os cronogramas de exportação para seus destinos baseados em arquivo.

Para saber mais sobre os outros componentes de destino, consulte os seguintes artigos:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6