Recommendations e limitações limitations
Permissões e segurança permissions
Mapeamento de perfis de produto
No Campaign Standard, você recebeu acesso elevado à função de administrador para APIs, independentemente do perfil de produto atribuído. O Campaign v8 apresenta um conjunto diferente de perfis de produto, exigindo o mapeamento de perfis de produto do Campaign Standard para o Campaign v8.
Com a migração, dois perfis de produto são adicionados às suas contas técnicas existentes ou pré-criadas: Administrador e Centro de mensagens (para acessar APIs transacionais). Revise o mapeamento do perfil de produto e atribua o perfil de produto necessário se não quiser que o perfil de produto do administrador seja mapeado com sua conta técnica.
ID do locatário
Após a migração, para qualquer integração futura, é recomendável usar sua ID de locatário do Campaign v8 em URLs REST, substituindo sua ID de locatário do Campaign Standard anterior.
Uso da chave
O gerenciamento de valores de PKey difere entre o Campaign Standard e o Campaign v8. Se você estava armazenando PKeys com Campaign Standard, certifique-se de que sua implementação formará dinamicamente chamadas de API subsequentes usando PKeys ou hrefs obtidos de chamadas de API anteriores.
APIs disponíveis deprecated
Por enquanto, as APIs REST listadas abaixo estão disponíveis para uso:
- Perfis
- Serviços e assinaturas
- Recursos personalizados
- Fluxos de trabalhos
- Mensagens transacionais
- Histórico de marketing
- Unidades organizacionais
- Gerenciamento de privacidade
Filtragem
-
Para usar os filtros em cargas da API REST, é necessário editá-los no Campaign v8 e fornecer um nome para usar em suas cargas. Para fazer isso, acesse os parâmetros adicionais do filtro na guia Parâmetros e forneça o nome desejado no campo Nome do filtro na API REST.
-
O prefixo "by" necessário para usar filtros personalizados não é mais necessário. O nome do filtro deve ser usado como está em suas solicitações.
Exemplo:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
Campos de banco de dados descartados
Alguns campos do banco de dados estão sendo removidos durante a migração. Ao usar um campo solto, as APIs REST retornarão valores em branco. No futuro, todos os campos ignorados serão descontinuados e removidos.
POST com recursos vinculados
Ao usar o seguinte formato de corpo de solicitação, com "vehicleOwner" representando o link para "nms:recipient":
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
As informações do link são ignoradas. Consequentemente, um novo registro é gerado em "cusVehicle" contendo apenas valores de "vehicleNumber" e "vehicleName". No entanto, o link permanece nulo, resultando em "vehicleOwner" sendo definido como nulo.
No Campaign v8, quando a mesma estrutura de corpo de solicitação é usada e o "veículo" é vinculado a um perfil, ocorre um erro. Este erro ocorre porque a propriedade "firstName" não é reconhecida como válida para "cusVehicle". No entanto, um corpo de solicitação que inclui apenas os atributos sem o link funciona sem problemas.
operações de PATCH
- O Campaign v8 não oferece suporte ao PATCH com um corpo de solicitação vazio: ele retorna um status 204 Sem conteúdo.
- Embora o Campaign Standard seja compatível com PATCH em elementos/atributos em um esquema, observe que as operações de PATCH no local não são compatíveis com o Campaign v8. Tentar um PATCH no local resultará em um Erro interno do servidor 500 com uma mensagem de erro indicando que a propriedade 'zipCode' não é válida para o recurso 'profile'.
Respostas REST
A seção abaixo lista pequenas diferenças entre as respostas REST do Campaign Standard e do v8.
- Para registros de GET únicos, a resposta inclui o href na resposta.
- Quando consultado com o atributo, o Campaign v8 fornece Count e Pagination na resposta.
- Após as operações POST, os valores dos recursos vinculados são retornados na resposta.
Códigos de erro e mensagens
A seção abaixo lista as diferenças entre códigos de erro e mensagens do Campaign Standard e do Campaign v8.
Perfil - Fuso horário
Com o Campaign Standard, o fuso horário é exibido como parte da resposta JSON de profileAndServices/profile chamadas de API REST.
Com o Campaign v8, o fuso horário é exibido somente para o usuário como parte das chamadas de API REST profileAndServicesExt/profile. Não faz parte das chamadas REST API profileAndServices/profile porque está sendo adicionado em um esquema estendido.
Fluxos de trabalho - Acionamento de sinal externo
A API de GET do fluxo de trabalho do Campaign Standard retorna nomes de parâmetros como as variáveis de instância do fluxo de trabalho e seus tipos de dados (booleano, string etc.). Isso é usado para criar o corpo da solicitação JSON formatado corretamente ao acionar o sinal por meio de uma chamada de API POST.
O Campaign v8 não é compatível com variáveis de instância de fluxo de trabalho de publicidade, mas espera que os desenvolvedores saibam o que são. Dessa forma, após a migração, as informações de parâmetros no corpo da solicitação do POST precisarão ser construídas sem a disponibilidade de informações de parâmetros na resposta da API do GET.