A configuração do SDK é feita com a variável configure
comando.
configure
é always o primeiro comando chamado.
alloy("configure", {
"edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
"orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});
Há muitas opções que podem ser definidas durante a configuração. Todas as opções podem ser encontradas abaixo, agrupadas por categoria.
edgeConfigId
As configurações de borda foram remarcadas para Datastreams. Uma ID de armazenamento de dados é a mesma ID de configuração.
Tipo | Obrigatório | Valor padrão |
---|---|---|
String | Sim | None |
Sua ID de configuração atribuída, que vincula o SDK às contas e configurações apropriadas. Ao configurar várias instâncias em uma única página, você deve configurar um edgeConfigId
para cada instância.
context
Tipo | Obrigatório | Valor padrão |
---|---|---|
Matriz de cadeias de caracteres | Não | ["web", "device", "environment", "placeContext"] |
Indica quais categorias de contexto coletar automaticamente, conforme descrito em Informações automáticas. Se essa configuração não for especificada, todas as categorias serão usadas por padrão.
debugEnabled
Tipo | Obrigatório | Valor padrão |
---|---|---|
Booleano | Não | false |
Indica se a depuração está ativada. Configurar essa configuração como true
habilita os seguintes recursos:
Recurso | Função |
---|---|
Registro do console | Permite que mensagens de depuração sejam exibidas no console JavaScript do navegador |
edgeDomain
Preencha este campo com seu domínio primário. Para obter mais detalhes, consulte a documentação.
O domínio é semelhante a data.{customerdomain.com}
para um site em www.{customerdomain.com}.
edgeBasePath
Caminho após o edgeDomain usado para se comunicar e interagir com os serviços da Adobe. Geralmente, isso só seria alterado quando não fosse usado o ambiente de produção padrão.
Tipo | Obrigatório | Valor padrão |
---|---|---|
String | Não | ee |
orgId
Tipo | Obrigatório | Valor padrão |
---|---|---|
String | Sim | Nenhum |
Atribuído Experience Cloud ID da organização. Ao configurar várias instâncias em uma página, você deve configurar um orgId
para cada instância.
clickCollectionEnabled
Tipo | Obrigatório | Valor padrão |
---|---|---|
Booleano | Não | true |
Indica se os dados associados aos cliques em links são coletados automaticamente. Consulte Rastreamento automático de links para obter mais informações. Os links também são rotulados como links de download se incluírem um atributo de download ou se o link terminar com uma extensão de arquivo. Os qualificadores de link de download podem ser configurados com uma expressão regular. O valor padrão é "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"
onBeforeEventSend
Tipo | Obrigatório | Valor padrão |
---|---|---|
Função | Não | () => indefinido |
Configure um retorno de chamada que seja chamado para cada evento antes de ele ser enviado. Um objeto com o campo xdm
é enviado para o retorno de chamada. Para alterar o que é enviado, modifique o xdm
objeto. Dentro do retorno de chamada, a variável xdm
O objeto já tem os dados passados no comando event e as informações coletadas automaticamente. Para obter mais informações sobre o tempo desse retorno de chamada e um exemplo, consulte Modificar eventos globalmente.
defaultConsent
Tipo | Obrigatório | Valor padrão |
---|---|---|
Objeto | Não | "in" |
Define o consentimento padrão do usuário. Use essa configuração quando não houver preferência de consentimento já salva para o usuário. Os outros valores válidos são "pending"
e "out"
. Esse valor padrão não é persistente no perfil do usuário. O perfil do usuário é atualizado somente quando setConsent
é chamado.
"in"
: Quando essa configuração é definida ou nenhum valor é fornecido, o trabalho continua sem as preferências de consentimento do usuário."pending"
: Quando essa configuração é definida, o trabalho é enfileirado até que o usuário forneça as preferências de consentimento."out"
: Quando essa configuração é definida, o trabalho é descartado até que o usuário forneça as preferências de consentimento.prehidingStyle
Tipo | Obrigatório | Valor padrão |
---|---|---|
String | Não | Nenhum |
Usado para criar uma definição de estilo CSS que oculta as áreas de conteúdo da página da Web, enquanto o conteúdo personalizado é carregado do servidor. Se essa opção não for fornecida, o SDK não tentará ocultar nenhuma área de conteúdo enquanto o conteúdo personalizado for carregado, resultando potencialmente em "oscilação".
Por exemplo, se um elemento em sua página da Web tiver uma ID de container
, cujo conteúdo padrão você deseja ocultar enquanto o conteúdo personalizado é carregado do servidor, use o seguinte estilo de pré-ocultação:
prehidingStyle: "#container { opacity: 0 !important }"
cookieDestinationsEnabled
Tipo | Obrigatório | Valor padrão |
---|---|---|
Booleano | Não | true |
Habilitar Audience Manager destinos de cookies, que permitem a configuração de cookies com base na qualificação de segmentos.
urlDestinationsEnabled
Tipo | Obrigatório | Valor padrão |
---|---|---|
Booleano | Não | true |
Habilitar Audience Manager Destinos de URL, que permitem o acionamento de URLs com base na qualificação de segmento.
idMigrationEnabled
Tipo | Obrigatório | Valor padrão |
---|---|---|
Booleano | Não | true |
Se verdadeiro, o SDK lê e define cookies AMCV antigos. Essa opção ajuda na transição para o uso do SDK da Web da Adobe Experience Platform, enquanto algumas partes do site ainda podem usar o Visitor.js. Se a API de visitante for definida na página, o SDK consultará a API de visitante para a ECID. Essa opção permite adicionar duas tags a páginas com o SDK da Web da Adobe Experience Platform e ainda ter a mesma ECID.
thirdPartyCookiesEnabled
Tipo | Obrigatório | Valor padrão |
---|---|---|
Booleano | Não | true |
Ativa a configuração de cookies de terceiros do Adobe. O SDK pode manter a ID de visitante em um contexto de terceiros para permitir que a mesma ID de visitante seja usada em sites. Use essa opção se você tiver vários sites ou quiser compartilhar dados com parceiros; no entanto, às vezes, essa opção não é desejada por motivos de privacidade.