Integrar Salesforce Marketing Cloud Usando OAuth 2,0

Integre seu ServiceNow instância com Salesforce Marketing Cloud Usando OAuth 2,0.

Importante:

Minimize os riscos à segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.

Tabela 1. Permissões mínimas do usuário

Processo	Função de usuário necessária no Salesforce Marketing Cloud aplicação	Escopos de autenticação
Download de assinaturas	Usuário	Usuários: Leitura
Extrair atividade do usuário	Usuário	Usuários: Leitura
Recuperar assinatura	Usuário	Usuários: Gravação
Download dos consumos	Usuário	Extensões de dados: Leitura, gravação

Criar Salesforce Marketing Cloud Credenciais do OAuth 2,0

Criar Salesforce Marketing Cloud Credenciais do OAuth 2,0 para obter acesso Salesforce Marketing Cloud APIs.

Por Que e Quando Desempenhar Esta Tarefa

As credenciais devem ser criadas no Salesforce Marketing Cloud Escopo da aplicação Spoke.

Antes de Iniciar

Função necessária: administrador do Salesforce Marketing Cloud

Por Que e Quando Desempenhar Esta Tarefa

Para acessar licenças de usuário e extensão de dados, a configuração de conexão deve ser definida na unidade de negócios primária. Se a configuração estiver definida em uma unidade de negócios secundária, talvez ela não consiga acessar dados da unidade de negócios primária.

Procedimento

1. Faça login no Salesforce Marketing Cloud locatário.
2. Navegar até Página inicial de configuração > Ferramentas da plataforma > Apps > Pacotes Instalados.
3. Selecione Novo para criar um pacote.
4. Na caixa de diálogo Detalhes do novo pacote, preencha Nome e. Descrição campos.
5. Selecione Save (Salvar).
6. Selecione Adicionar componente .
7. Selecione Integração de API para integrar Salesforce Marketing Cloud APIs para sua aplicação.
8. Selecione Avançar.
9. Selecione Servidor para servidor como o tipo de integração.
10. Selecione Avançar.
11. Selecione os escopos a seguir para sua integração.
    • Usuários: Leitura
    • Usuários: Gravação
    • Extensões de dados: Leitura, gravação
12. Selecione Save (Salvar).
    O ID do cliente, o segredo do cliente e o URI de base do SOAP são exibidos no resumo da configuração. Navegue até a seção Componentes em CONFIGURAÇÃO > PACOTES INSTALADOS > DETAILS Para exibir o ID do cliente, o segredo do cliente e o URI de base do SOAP. Copie os valores para usá-los mais tarde.

    Nota:

    Observação: Você deve adicionar /Service.asmx No URI de base do SOAP ao passá-lo no ServiceNow instância.
13. Selecione ACESSO e confirme se sua unidade de negócios está habilitada.

    Se sua unidade de negócios estiver inativa, selecione e habilite-a e selecione Salvar .

Crie um relatório Contagens de contatos em Salesforce Marketing Cloud

Crie um relatório Contagens de contatos para recuperar e exibir o número total de contatos faturáveis em seu Salesforce Marketing Cloud conta.

Antes de Iniciar

Salesforce Marketing Cloud Função necessária: administrador

Procedimento

1. Em um navegador da Web, acesse Salesforce Marketing Cloud instância.
2. Faça login usando suas credenciais de administrador.
3. No cabeçalho da página da sua instância, selecione o ícone de perfil da unidade de negócios e, em seguida, selecione a unidade de negócios primária de nível superior para que o relatório Contagens de contatos inclua dados da unidade de negócios primária e de todas as unidades de negócios secundárias correspondentes.
4. Da lista de disponíveis Salesforce Marketing Cloud aplicações, selecione Construtor de análise ícone do app e selecione Relatórios .
   A visão geral do app Relatórios é aberta.
5. Na seção Catálogo de relatórios, selecione Exibir catálogo .
6. No Catálogo de relatórios, pesquise Contagens de contatos e, em seguida, selecione Criar .
   A caixa de diálogo Criar relatório é aberta.
7. Na caixa de diálogo, selecione o período de tempo para o qual você deseja recuperar e exibir dados do Intervalo de datas lista.
   O valor padrão é Últimos 30 dias .

   Dica:

   Para evitar problemas de desempenho durante a geração de relatório, defina este valor como Últimos 7 dias .
8. Selecione Enviar.
   Seu Salesforce Marketing Cloud A instância gera o relatório e exibe os resultados na página Resultados: Contagens de contatos.
9. Na página Resultados: Contagens de contatos, selecione Salvar .
   A caixa de diálogo Salvar relatório é aberta.
10. Na caixa de diálogo, preencha os campos.

    Tabela 2. Caixa de diálogo Salvar relatório

    Campo	Descrição
    Nome de relatório	Nome do relatório.
    Fonte do relatório	Origem do relatório. Este campo é definido automaticamente como Contagens de contatos .
    Descrição	Descrição do relatório.

11. Selecione Save (Salvar).
12. Crie uma programação para executar o relatório Contagens de contatos automaticamente.
    1. No cabeçalho da página do app Relatórios, selecione Visão geral Para retornar à visão geral do app Relatórios.
    2. Na sua lista de relatórios, abra o relatório Contagens de contatos recém-criado.
    3. Na seção Opções de programação, selecione Editar .
    4. Na caixa de diálogo, preencha os campos.

       Tabela 3. Caixa de diálogo Editar opções de programação

       Campo	Descrição
       Opções de cronograma
       Início	A data e hora a partir das quais você deseja iniciar a execução do relatório.
       Fuso horário	Fuso horário no qual o relatório está sendo agendado.
       Repetir	Frequência na qual você deseja executar o relatório. Configure o relatório para ser executado uma vez por semana aos domingos.
       Término	Data em que você deseja parar de executar o relatório.
       Opções de entrega
       Formato	O tipo de arquivo e a extensão de arquivo nos quais você deseja receber os resultados do relatório. Selecione Arquivo de dados (.csv) .
       Local	Local em que você deseja salvar ou compartilhar o relatório. Defina este campo como Salve relatório para FTP e preencha os campos correspondentes: Nome do relatório : O nome do arquivo do relatório, excluindo a extensão do arquivo. Se você quiser incluir data e hora no nome do relatório, adicione-os ao Nome_AAAAAAMMDD_HHMMSS formato. Nota: Anote o nome deste arquivo para uso posterior. Opção exclusiva : Opção para criar um registro de relatório em vez de substituir o registro de relatório existente no SFTP. Deixe esta caixa de seleção desmarcada. Local do FTP : Local do seu Salesforce Marketing Cloud Arquivos de FTP. Selecione ExactTarget Enhanced FTP Para que o relatório seja salvo na sua pasta Relatórios de SFTP (Protocolo de transferência de arquivos SSH). Nota: Você pode configurar uma conta de usuário de SFTP em Salesforce Marketing Cloud Para exibir os arquivos salvos em um local de FTP específico. Para obter mais informações, consulte Configurando uma conta de usuário de SFTP em Salesforce Marketing Cloud.

    5. Selecione Save (Salvar).

Crie uma extensão de dados para o relatório Contagens de contatos

Crie uma extensão de dados para armazenar os dados do relatório Contagens de contatos no Salesforce Marketing Cloud instância.

Antes de Iniciar

Salesforce Marketing Cloud Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

As extensões de dados são tabelas que contêm atributos que representam os dados do relatório. Quando seu ServiceNow a instância se conecta ao Salesforce Marketing Cloud, recupera dados desta extensão de dados.

Procedimento

1. No cabeçalho da página do Salesforce Marketing Cloud passe o mouse em Salesforceícone para exibir a lista de disponíveis Salesforce Marketing Cloud aplicações.
2. Selecione Construtor de público ícone do app e selecione Construtor de contatos .
   O app Construtor de contatos é aberto.
3. Selecione Extensões de dados .
4. Na caixa de diálogo pop-up, selecione Começar e, em seguida, selecione Criar .
   A caixa de diálogo Criar nova extensão de dados é aberta.
5. Na etapa Propriedades, preencha os campos.

   Tabela 4. Campos de propriedades

   Campo	Descrição
   Método de criação	Método no qual você deseja criar a extensão de dados. Selecione Criar a partir de Novo .
   Nome	Nome da extensão de dados.
   Chave Externa	Chave opcional que identifica exclusivamente a extensão de dados. Você pode inserir uma chave de sua escolha.
   Descrição	Descrição da extensão de dados.
   Tipo	Tipo de extensão de dados. Este campo é definido automaticamente como Padrão .
   Local	Local no qual você deseja armazenar a extensão de dados. Este campo é definido automaticamente como Extensões de dados . Selecione Mudar local para selecionar um local diferente.
   Pode ser enviado?	Opção para indicar se a extensão de dados pode ser enviada para seus assinantes.

6. Selecione Avançar.
7. Na etapa Política de retenção de dados, defina Configuração de retenção campo para Desat .
8. Selecione Avançar.
9. Na etapa Atributos, adicione os atributos que você deseja incluir na extensão de dados.
   Os atributos são usados para mapear e importar dados de um relatório para uma extensão de dados. Você deve criar um atributo para cada coluna de relatório da qual você deseja importar dados. Cada nome de atributo deve corresponder exatamente ao nome da coluna de relatório correspondente.

   Para Salesforce Marketing Cloud Os atributos para as seguintes colunas do relatório Contagens de contatos são obrigatórios:

   Tabela 5. Campos de atributos

   Campo	Descrição
   Chave primária	Opção para o atributo incluir um identificador exclusivo para todos os registros na extensão de dados. Esta opção deve estar habilitada para Count_Date atributo.
   Nome	Nome do atributo. Este nome deve corresponder exatamente ao nome da coluna de relatório correspondente.
   Tipo de dados	Tipo de dados do atributo.
   Necessários	Opção que indica se o atributo requer um valor para cada registro na extensão de dados.
   Comprimento	Número máximo de caracteres permitidos no valor do atributo.
   Valor Padrão	Valor padrão opcional para o atributo. Para Sinalizador atributo, defina o valor padrão como 1 . Nota: Não insira um valor padrão para atributos atribuídos como chave primária.

   Nome	Tipo de dados
   Count_Date	Texto
   Total_Distinct_Contacts_Count	Texto
   Total_Distinct_Email_Addresses1	Texto
   Total_Distinct_Mobile_Addresses_Count	Texto
   Sinalizador	Texto

   Nota:

   Você pode adicionar atributos adicionais e o nome deve ser igual aos atributos de integração. Para mais informações, confira Crie um Salesforce Marketing Cloud perfil de integração usando autenticação básica ou Crie um Salesforce Marketing Cloud Perfil de integração usando OAuth 2,0.

   Os atributos para todas as outras colunas do relatório Contagens de contatos são opcionais. Preencha os campos de cada atributo que você deseja adicionar.
10. Selecione Concluído.
11. Na caixa de diálogo Extensão de dados criada, selecione OK .

Crie uma automação para importar dados do relatório Contagens de contatos em sua extensão de dados

Crie uma automação para importar automaticamente os dados do relatório Contagens de contatos para sua extensão de dados depois que o relatório for gerado.

Antes de Iniciar

Salesforce Marketing Cloud Função necessária: administrador

Procedimento

1. No cabeçalho da página do Salesforce Marketing Cloud passe o mouse em Salesforceícone para exibir a lista de disponíveis Salesforce Marketing Cloud aplicações.
2. Selecione Criador de jornadas ícone do app e selecione Estúdio de automação .
   A visão geral do app Automation Studio é aberta.
3. Selecione Nova automação .
   O fluxo de trabalho da nova automação é aberto.
4. Crie um cronograma de automação arrastando o. Programação Ícone da seção Origens iniciais do painel de menu esquerdo até a seção Origem inicial da tela do fluxo de trabalho.
5. Defina um cronograma para a automação.
   1. Na seção Origem inicial da tela do fluxo de trabalho, selecione Configurar .
   2. Na caixa de diálogo, preencha os campos.

      Tabela 6. Definir programação

      Campo	Descrição
      Data de início	A data a partir da qual você deseja iniciar a execução da automação.
      Hora de início	A hora a partir da qual você deseja iniciar a execução da automação.
      Fuso horário	Fuso horário no qual a automação está sendo agendada.
      Repetir	A frequência na qual você deseja executar a automação. Configure a automação para ser executada depois que o relatório Contagens de contatos for gerado. Selecione a mesma frequência que você selecionou durante Criando um relatório Contagens de contatos em Salesforce Marketing Cloud. Dica: Se você configurar a automação para ser executada no mesmo dia em que o relatório é gerado, selecione uma hora de início que forneça tempo suficiente para que o relatório termine de gerar. ServiceNow a recomenda uma hora de início de pelo menos duas horas após a hora de início do relatório.
      Término	Número de vezes que a automação pode ser executada até o término do cronograma de automação. Se você não quiser que o cronograma de automação termine, defina este campo como Nunca . Este campo não aparece somente quando Nenhum (executar uma vez) selecionado de Repita .

   3. Clique em Done (Concluído).
6. Adicione uma atividade de script para executar o JavaScript do lado do servidor para todas as atividades que exigem isso.
   1. Na seção Atividades do painel de menu esquerdo, arraste o. Script na tela do fluxo de trabalho.
      A atividade de script se torna a primeira etapa do fluxo de trabalho de automação.
   2. Selecione Escolha na etapa de atividade de script.
      A caixa de diálogo Escolher atividade de script é aberta.
   3. Selecione Criar nova atividade de script .
      A caixa de diálogo Criar nova atividade de script é aberta.
   4. Na etapa Propriedades, preencha os campos.

      Tabela 7. Campos de propriedades

      Campo	Descrição
      Nome	Nome da atividade de script.
      Chave Externa	Chave opcional que identifica exclusivamente a atividade de script. Você pode inserir uma chave de sua escolha.
      Pasta local	O local em que você deseja armazenar seus scripts. Selecione Escolha... para selecionar um local diferente. Este campo é definido automaticamente como Scripts .
      Descrição	Descrição da atividade de script.

   5. Copie e cole o seguinte JavaScript do lado do servidor na caixa de texto JavaScript do lado do servidor:

      <script runat="server"> 
      var rows = Platform.Function.DeleteData('*<data-extension-name>*',['Flag'],['1']);
      </script>
      

      . *<data-extension-name>*Deve corresponder exatamente ao nome do arquivo da Extensão de dados que você criou em Crie uma extensão de dados para o relatório Contagens de contatos.

   6. Selecione Sintaxe de validação Para verificar se a sintaxe JavaScript do lado do servidor é válida.
   7. Selecione Avançar.
   8. Na etapa Resumo, verifique se a configuração da atividade de script está correta e selecione Concluir .
7. Adicione uma atividade de extração de dados para copiar o relatório Contagens de contatos da pasta Relatórios de SFTP para a pasta Importação de SFTP.
   . Salesforce Marketing Cloud A instância usa a pasta Importação de SFTP para localizar e importar dados de relatório para suas extensões de dados. Para permitir que sua instância importe dados do relatório Contagens de contatos para a extensão de dados correspondente, você deve copiar o relatório para a pasta Importação de SFTP.
   1. Na seção Atividades do painel de menu esquerdo, arraste o. Extração de dados na tela do fluxo de trabalho.
      A atividade de extração de dados se torna a segunda etapa do fluxo de trabalho de automação.
   2. Selecione Escolha na etapa de atividade de extração de dados.
      A caixa de diálogo Escolher atividade de extração de dados é aberta.
   3. Selecione Criar nova atividade de extração de dados .
      A caixa de diálogo Criar nova atividade de extração de dados é aberta.
   4. Na etapa Propriedades, preencha os campos.

      Tabela 8. Campos de propriedades

      Campo	Descrição
      Nome	Nome da atividade de extração de dados.
      Chave Externa	Chave opcional que identifica exclusivamente a atividade de extração de dados. Você pode inserir uma chave de sua escolha.
      Padrão de nomenclatura de arquivo	O nome do arquivo do relatório Contagens de contatos do qual você deseja extrair dados. Este nome deve corresponder exatamente ao nome do arquivo do relatório Contagens de contatos que você criou em Crie um relatório Contagens de contatos em Salesforce Marketing Cloud, incluindo a extensão do arquivo.
      Tipo de extração	Método de extração de dados. Defina este campo como Movimentação e cópia de arquivo de FTP aprimorado .
      Descrição	Descrição da atividade de extração de dados.

   5. Selecione Avançar.
   6. Na etapa Configuração, preencha os campos.

      Tabela 9. Campos de configuração

      Campo	Descrição
      Pasta de entrada	Local em que você salvou o relatório Contagens de contatos. Insira relatórios .
      Pasta de saída	Local para o qual você deseja copiar o relatório. Insira Importar .
      Copiar para pasta	Opção para copiar em vez de mover o relatório da pasta de entrada para a pasta de saída. Esta opção permite que você mantenha o relatório em ambos os locais. Marque a caixa de seleção para habilitar esta opção.

   7. Selecione Avançar.
   8. Na etapa Resumo, verifique se a configuração da atividade de extração de dados está correta e selecione Concluir .
8. Adicione uma atividade de arquivo de importação para importar os dados do relatório Contagens de contatos para a extensão de dados.
   1. Na seção Atividades do painel de menu esquerdo, arraste o. Importação ou cópia de dados na tela do fluxo de trabalho.
      A atividade de Cópia ou importação de dados se torna a terceira etapa do fluxo de trabalho de automação.
   2. Selecione Escolha Na etapa de atividade Copiar ou Importar dados.
      A caixa de diálogo Escolher cópia ou importação de dados é aberta.
   3. Selecione Criar nova definição de cópia ou importação .
      A caixa de diálogo Criar nova definição de cópia ou importação é aberta.
   4. Na etapa Informações da atividade, preencha os campos.

      Tabela 10. Campos de informações da atividade

      Campo	Descrição
      Nome	Nome da atividade do arquivo de importação.
      Descrição	Descrição da atividade do arquivo de importação.
      Chave Externa	Chave opcional que identifica exclusivamente a atividade do arquivo de importação. Você pode inserir uma chave de sua escolha.
      Enviar e-mail de notificação para	O endereço de e-mail para o qual você deseja enviar notificações quando uma importação for concluída. Se você especificar um endereço de e-mail, um e-mail de notificação que contém o número de linhas inseridas e atualizadas será enviado para esse endereço na importação bem-sucedida. Importante: O e-mail de notificação contém um Contagem de campos inválida Erro de validação devido à presença de linhas vazias no arquivo CSV importado. Essas linhas vazias aparecem automaticamente quando você salva o relatório no FTP. No entanto, eles não têm impacto na integração.

   5. Selecione Avançar.
   6. Na etapa Origem, selecione Local do arquivo No cabeçalho Fonte de dados e preencha os campos.

      Tabela 11. Campos de arquivo de importação

      Campo	Descrição
      Local do arquivo	Local do relatório Contagens de contatos do qual você deseja importar dados. Selecione ExactTarget Enhanced FTP .
      Padrão de nomenclatura de arquivo	O nome do arquivo do relatório Contagens de contatos do qual você deseja importar dados. Se você quiser incluir data e hora no nome do relatório, adicione-os ao Nome_AAAAAAMMDD_HHMMSS selecione Variável de data e. Variável de tempo campos. Este nome deve corresponder exatamente ao nome do arquivo do relatório Contagens de contatos que você criou em Crie um relatório Contagens de contatos em Salesforce Marketing Cloud, incluindo a extensão do arquivo.
      Formato de data	Formato no qual você deseja exibir a data e a hora dos dados do relatório.
      Delimitador	Formato no qual você deseja separar cada registro de relatório. Selecione vírgula para separar cada registro com uma vírgula. Para habilitar o uso de aspas duplas para separar cada registro, habilite o. Respeite aspas duplas (") como delimitador de texto opção.
      Comportamento de dados incorreto	Opção para ignorar linhas com dados inválidos. Marque a caixa de seleção para habilitar esta opção.

   7. Selecione Avançar.
   8. Na etapa Destino, pesquise e selecione a extensão de dados que você criou em Crie uma extensão de dados para o relatório Contagens de contatos.
   9. Selecione Avançar.
   10. Na etapa Mapeamento, selecione as opções Adicionar e atualizar e. Mapeie por ordinal No cabeçalho Ação de dados.
   11. Quando solicitado, habilite o. O arquivo de importação tem cabeçalhos de coluna E mapeie cada atributo de extensão de dados para o número de coluna correspondente no relatório Contagens de contatos.
       Nota:

       Saia do Sinalizador atributo não mapeado.
   12. Selecione Avançar.
   13. Na etapa Revisar, verifique se a configuração da atividade do arquivo de importação está correta e selecione Concluir .
9. Selecione Save (Salvar).
10. Na caixa de diálogo, preencha os campos.

    Tabela 12. Caixa de diálogo Salvar automação

    Campo	Descrição
    Nome	Nome da automação.
    Descrição	Descrição da automação.
    Chave Externa	Chave opcional que identifica exclusivamente a automação.
    Local	Local no qual você deseja salvar a automação.

11. Selecione Save (Salvar).
12. Na seção Origem inicial da tela do fluxo de trabalho, selecione Ativo .
13. Na caixa de diálogo Ativar confirmação de programação, selecione Ativar para ativar a programação de automação.

Recuperar dados do relatório Contagens de contatos manualmente

Depois de criar o relatório Contagens de contatos, a extensão de dados e a automação, você pode recuperar dados do relatório entre o relatório agendado e os trabalhos de automação executando esses trabalhos manualmente.

Antes de Iniciar

Salesforce Marketing Cloud Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Seu Salesforce Marketing Cloud a instância executa os trabalhos de relatório e automação automaticamente com base nos cronogramas que você define. Se você quiser recuperar dados do relatório Contagens de contatos antes do próximo relatório agendado e trabalhos de automação, você pode executar esses trabalhos manualmente.

Procedimento

1. Execute seu relatório Contagens de contatos.
   1. No cabeçalho da página do Salesforce Marketing Cloud passe o mouse em Salesforceícone para exibir a lista de disponíveis Salesforce Marketing Cloud aplicações.
   2. Selecione Construtor de análise ícone do app e selecione Relatórios .
      A visão geral do app Relatórios é aberta.
   3. Em sua lista de relatórios, selecione o relatório Contagens de contatos que você criou em Crie um relatório Contagens de contatos em Salesforce Marketing Cloud.
   4. Selecione Executar.
      Seu Salesforce Marketing Cloud A instância gera o relatório e exibe os resultados nos resultados nome-do-relatório > página.
   5. Nos resultados: > nome-do-relatório > página, selecione o ícone Baixar resultados ( ).
   6. Na caixa de diálogo, preencha os campos.

      Tabela 13. Baixar resultados

      Campo	Descrição
      Nome do arquivo	O nome do arquivo do relatório, excluindo a extensão do arquivo.
      Fonte do relatório	Origem do relatório. Este campo é definido automaticamente como Contagens de contatos .
      Formato	O tipo de arquivo e a extensão de arquivo nos quais você deseja receber os resultados do relatório. Selecione Arquivo de dados (.csv) .

   7. Selecione Save (Salvar).
   8. Salve o arquivo em seu sistema.
2. Importe o arquivo em sua Extensão de dados.
   1. No cabeçalho da página do Salesforce Marketing Cloud passe o mouse em Salesforceícone para exibir a lista de disponíveis Salesforce Marketing Cloud aplicações.
   2. Selecione Construtor de público ícone do app e selecione Construtor de contatos .
   3. Abra a Extensão de dados criada recentemente que você criou durante Criando uma extensão de dados para o relatório Contagens de contatos .
   4. Selecione Importar.
   5. Na caixa de diálogo Confirmação de importação de dados, selecione Importar para a extensão de dados e, em seguida, selecione OK .
   6. Na etapa Importar para extensão de dados, escolha o arquivo que você baixou na etapa anterior 1.
   7. Selecione Delimitador como vírgula .
   8. Selecione Tipo de importação como Adicionar e atualizar .
   9. Selecione Opções de importação como Pular linhas no arquivo de importação com dados inválidos .
   10. Selecione Avançar.
   11. Na caixa de diálogo Configurar mapeamento, selecione Mapeie manualmente .
   12. Combine as colunas de extensão de dados disponíveis com as colunas de relatório importadas e deixe a coluna Sinalizar vazia.
   13. Selecione Avançar.
   14. Na caixa de diálogo Revisar e criar, insira o ID de e-mail no qual você deseja notificar quando a importação for concluída e selecione Concluir .
   15. Na caixa de diálogo Confirmação de execução, selecione Concluído .

Resultado

Os dados do relatório Contagens de contatos mais recentes são importados para a extensão de dados.

Crie um Salesforce Marketing Cloud Perfil de integração usando OAuth 2,0

Crie um Salesforce Marketing Cloud Perfil de integração usando o OAuth 2,0 para rastrear assinaturas de software e otimizar licenças obsoletas para o. Salesforce Marketing Cloud serviço.

Antes de Iniciar

Para criar um Salesforce Marketing Cloud perfil de integração, solicite o. Software Asset Management- Gestão de licenças de SaaS plug-in (sn_sam_saas_int) do ServiceNow Store .

Dica:

Para evitar incorrer em custos adicionais de assinatura, instale o plug-in e crie a integração em uma instância que não seja de produção.

ServiceNow Função necessária: sam_integrator

Salesforce Marketing Cloud Função necessária: sn_sforce_mc_spoke.Administrador do Salesforce Marketing Cloud

Importante:

Você deve selecionar Integração da Gestão de ativos de software com o Salesforce Marketing Cloud caixa de seleção desta integração ao instalar recursos opcionais no Application Manager página. Para obter mais informações sobre como escolher as aplicações SaaS necessárias, consulte Solicitação Gestão de licenças de SaaS.

Por Que e Quando Desempenhar Esta Tarefa

Se você estiver usando Espaço para ativos de software, a opção para criar o. Salesforce Marketing Cloud O perfil de integração na IU principal está inativo.

Procedimento

1. Navegue até o perfil de integração.

   Interface	Ação
   IU principal	Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta. Selecione Novo. Selecione Perfil de integração do Salesforce Marketing Cloud .
   Espaço de ativos de software	Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos. Selecione Novo. Selecione Salesforce Marketing Cloud na lista suspensa. Selecione Continuar.

2. No formulário, preencha os campos.

   Tabela 14. Formulário de perfil de integração

   Campo	Descrição
   Nome de exibição	Nome do perfil de integração. Por exemplo, Perfil de integração do Salesforce Marketing Cloud .
   Tipo de autenticação	Tipo de autenticação para acessar Salesforce Marketing Cloud APIs. Autoriz. básica OAuth 2,0: Selecione este valor. Nota: Para um novo Salesforce Marketing Cloud perfil, o tipo de autenticação está definido como Autenticação básica por padrão.
   Status	Status do perfil de integração. Se você não tiver publicado o perfil de integração, este campo será definido automaticamente como Rascunho . Se você já tiver publicado o perfil de integração, este campo será definido automaticamente como Publicado .
   Tipo de perfil	Tipo de perfil de integração. Este valor é definido automaticamente como Assinatura do Salesforce Marketing Cloud .

3. Revise as funções de usuário necessárias ou as permissões de API especificadas no Configuração do fornecedor campo para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
   Nota:

   Para obter mais informações, consulte Permissões mínimas do usuário tabela.
   1. Na seção Baixar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinaturas de download do Salesforce Marketing Cloud .
      Nota:

      . Baixar assinaturas a caixa de seleção está marcada por padrão e você não pode desmarcá-la.
   2. Na seção Recuperar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinatura de recuperação do Salesforce Marketing Cloud .
      Nota:

      . Recuperar assinaturas a caixa de seleção está marcada por padrão. Se você não quiser recuperar assinaturas, desmarque esta caixa de seleção. Se você limpar, os candidatos a remoção serão criados, mas o subfluxo Recuperar assinatura não será acionado ou o processo de recuperação não será iniciado.
   3. Na seção Baixar subfluxo de consumo, verifique se Subfluxo o campo está definido como Consumo de contatos de download do Salesforce Marketing Cloud .
4. Na seção Atributos de integração, adicione ou remova os atributos com base em seus requisitos.
   Os atributos nome-valor, como Data de contagem , Contatos , Contatos de e-mail e. Contatos móveis são preenchidos automaticamente para o perfil de integração.

   Nota:

   O nome do atributo deve corresponder ao cabeçalho da coluna do relatório em Salesforce Marketing Cloud instância. Para obter mais informações, consulte Crie uma extensão de dados para o relatório Contagens de contatos.
5. Selecione Save (Salvar).
   Seu ServiceNow a instância cria um perfil de integração de rascunho.

   . Conexão e credencial o campo aparece e é definido automaticamente como Conexão sn_sforce_mc_spoke.SalesforceMarketingCloudSOAP .

6. Selecione o ícone de visualização para abrir o registro de aliases de conexão e credencial ao lado de Conexão e credencial e, em seguida, selecionando Abrir registro na visualização do registro.
7. No formulário Aliases de conexão e credencial, selecione Criar nova conexão e credencial link relacionado.
8. Na caixa de diálogo, preencha os campos.

   Tabela 15. Caixa de diálogo Criar conexão e credencial

   Campo	Descrição
   Informação de conexão
   Nome da conexão	Nome da conexão. Por exemplo, Conexão do SFMC SOAP .
   URL de conexão SOAP	URL do endpoint da conexão SOAP. Insira // subdomínio .soap.marketingcloudapis.com/Service.asmx , em que > subdomínio > é seu Salesforce Marketing Cloud subdomínio.
   Informações de credencial
   ID do cliente OAuth	ID do cliente que você gerou ao criar um Salesforce Marketing Cloud Credencial do OAuth.
   Segredo do cliente OAuth	Segredo do cliente recuperado ao criar um Salesforce Marketing Cloud Credencial do OAuth.
   URL de redirecionamento do OAuth	https://<instance_name>/oauth_redirect.do , em que o nome da instância é o nome do seu ServiceNow instância.
   Informações adicionais usadas para pós-processamento
   Extensão de dados de contagens de contatos	Nome da extensão de dados da qual você deseja recuperar os dados do relatório Contagens de contatos. Este nome deve corresponder exatamente ao nome da extensão de dados que você criou em Crie uma extensão de dados para o relatório Contagens de contatos.

9. Selecione Criar e obter um Token do OAuth.
   Nota:

   Para obter a função necessária para executar esta etapa, consulte Permissões mínimas do usuário tabela.
10. Selecione Save (Salvar).
11. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.
    A validação da conexão verifica as APIs de download de assinaturas e consumo de download, mas não as APIs de recuperação de assinaturas.
12. Depois que a conexão for verificada, selecione Publicar .

O que Fazer Depois

Depois que a integração se conectar, seu ServiceNow a instância cria automaticamente modelos de software, regras de recuperação e assinaturas de software que são atualizadas diariamente.

Depois de criar um perfil de integração, exiba informações sobre o perfil no Espaço para ativos de software navegando até Operações de licença > Assinatura de usuário > Perfis de integração diretos. Você pode selecionar um perfil de integração para exibir as listas relacionadas a seguir. Se todas as listas relacionadas a seguir não estiverem visíveis para um perfil de integração na exibição padrão, você poderá selecionar a exibição de integração personalizada na guia Detalhes:

• Modelos de software
• Identificadores de assinatura não reconhecidos
• Trabalhos agendados
• Resultados de trabalhos programados
• Assinaturas de Software
• Regra de exclusão de identificador de assinatura
• Regra de exclusão do usuário de assinatura

Depois de criar um perfil de integração, você pode definir regras de exclusão de assinatura para manter determinadas assinaturas dos cálculos de custo de licença. Para obter mais informações, consulte Exclusões de assinatura para SaaS E aplicações SSO.

Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e configurações para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários perfis de integração.

Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revise uma regra de recuperação de software.

Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software próprio.

• Para obter mais informações sobre como criar direitos de software no Software Asset Management IU principal, consulte Crie direitos em Software Asset Management clássico.
• Para obter mais informações sobre como criar direitos de software no Espaço de ativos de software, consulte Crie direitos no espaço.
• Para obter mais informações sobre como criar direitos de software usando o. Software Asset Management Playbook, consulte Crie direitos usando o passo-a-passo guiado.

A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir seus resultados de reconciliação no Workbench de licença ( Software Asset Management aplicação clássica) ou o. Exibição de uso de licença (Espaço de ativos de software). Use estes resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.

• Para obter mais informações sobre como executar reconciliação no Software Asset Management aplicação clássica, consulte Execute a reconciliação de software em Software Asset Management clássico.
• Para obter mais informações sobre como executar a reconciliação no Espaço de ativos de software, consulte Execute a reconciliação de software no espaço.

Criar adicional Salesforce Marketing Cloud perfis de integração

Crie um perfil de integração para cada adicional Salesforce Marketing Cloud para as quais você deseja rastrear assinaturas de software e otimizar o licenciamento.

Antes de Iniciar

Para criar um Salesforce Marketing Cloud perfil de integração, solicite o. Software Asset Management- Gestão de licenças de SaaS plug-in (sn_sam_saas_int) do ServiceNow Store

Função necessária: sam_integrator

Salesforce Marketing Cloud Função necessária: sn_sforce_mc_spoke.Administrador do Salesforce Marketing Cloud

Importante:

Você deve selecionar Integração da Gestão de ativos de software com o Salesforce Marketing Cloud caixa de seleção desta integração ao instalar recursos opcionais no Application Manager página. Para obter mais informações sobre como escolher as aplicações SaaS necessárias, consulte Solicitação Gestão de licenças de SaaS.

Por Que e Quando Desempenhar Esta Tarefa

Se você estiver usando Espaço para ativos de software, a opção para criar o. Salesforce Marketing Cloud perfil de integração em IU principal está inativo.

Procedimento

1. Navegue até o perfil de integração.

   Interface	Ação
   IU principal	Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta. Selecione Novo. Selecione Perfil de integração do Salesforce Marketing Cloud .
   Espaço de ativos de software	Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos. Selecione Novo. Selecione Salesforce Marketing Cloud na lista suspensa. Selecione Continuar.

2. No formulário, preencha os campos.

   Tabela 16. Formulário de perfil de integração

   Campo	Descrição
   Nome de exibição	Nome do perfil de integração. Por exemplo, Perfil de integração do Salesforce Marketing Cloud .
   Tipo de autenticação	Tipo de autenticação para acessar Salesforce Marketing Cloud APIs. Autoriz. básica OAuth 2,0: Selecione este valor. Nota: Para um novo Salesforce Marketing Cloud perfil, o tipo de autenticação está definido como Autenticação básica por padrão.
   Status	Status do perfil de integração. Se você não tiver publicado o perfil de integração, este campo será definido automaticamente como Rascunho . Se você já tiver publicado o perfil de integração, este campo será definido automaticamente como Publicado .
   Tipo de perfil	Tipo de perfil de integração. Este valor é definido automaticamente como Assinatura do Salesforce Marketing Cloud .

3. Revise as funções de usuário necessárias ou as permissões de API especificadas no Configuração do fornecedor campo para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
   Nota:

   Para obter mais informações, consulte Permissões mínimas do usuário tabela.
   1. Na seção Baixar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinaturas de download do Salesforce Marketing Cloud .
      Nota:

      . Baixar assinaturas a caixa de seleção está marcada por padrão e você não pode desmarcá-la.
   2. Na seção Recuperar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinatura de recuperação do Salesforce Marketing Cloud .
      Nota:

      . Recuperar assinaturas a caixa de seleção está marcada por padrão. Se você não quiser recuperar assinaturas, desmarque esta caixa de seleção. Se você limpar, os candidatos a remoção serão criados, mas o subfluxo Recuperar assinatura não será acionado ou o processo de recuperação não será iniciado.
   3. Na seção Baixar subfluxo de consumo, verifique se Subfluxo o campo está definido como Consumo de contatos de download do Salesforce Marketing Cloud .
      . Download do consumo a caixa de seleção está marcada por padrão. Se você não quiser baixar os consumos de licença, desmarque esta caixa de seleção.
4. Na seção Atributos de integração, adicione ou remova os atributos com base em seus requisitos.
   Os atributos nome-valor, como Data de contagem , Contatos , Contatos de e-mail e. Contatos móveis são preenchidos automaticamente para o perfil de integração.

   Nota:

   O nome do atributo deve corresponder ao cabeçalho da coluna do relatório em Salesforce Marketing Cloud instância. Para obter mais informações, consulte Crie uma extensão de dados para o relatório Contagens de contatos.
5. Selecione Save (Salvar).
   Seu ServiceNow a instância cria um perfil de integração de rascunho.

   . Conexão e credencial o campo aparece e é definido automaticamente como Conexão sn_sforce_mc_spoke.SalesforceMarketingCloudSOAP .

6. Selecione o ícone de visualização ao lado de Conexão e credencial campo para abrir o registro de aliases de conexão e credencial.
7. Selecione Abrir registro na visualização do registro.
8. No formulário Aliases de conexão e credencial, crie um alias secundário que possa identificar exclusivamente a conexão e as credenciais deste perfil de integração.
   O primeiro perfil de integração Salesforce Marketing Cloud que você cria usa o alias de conexão e credencial padrão (primário) para Salesforce. Cada adicional Salesforce Marketing Cloud o perfil de integração que você cria requer um alias secundário exclusivo que ajuda a diferenciar a conexão e as credenciais entre cada perfil de integração.
   1. Selecione o link em Aliases secundários > Parentalias para adicionar aliases secundários.
   2. Selecione Novo.
      O formulário Aliases de conexão e credencial do alias secundário é aberto.
   3. Insira um nome para o alias secundário no Nome campo.
   4. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
   5. Depois que o formulário for recarregado, selecione o link relacionado Criar nova conexão e credencial.
9. Na caixa de diálogo, preencha os campos.

   Tabela 17. Caixa de diálogo Criar conexão e credencial

   Campo	Descrição
   Informação de conexão
   Nome da conexão	Nome da conexão. Por exemplo, Conexão do SFMC SOAP .
   URL de conexão SOAP	URL do endpoint da conexão SOAP. Insira // subdomínio .soap.marketingcloudapis.com/Service.asmx , em que > subdomínio > é seu Salesforce Marketing Cloud subdomínio.
   Informações de credencial
   ID do cliente OAuth	ID do cliente que você gerou ao criar um Salesforce Marketing Cloud Credencial do OAuth.
   Segredo do cliente OAuth	Segredo do cliente recuperado ao criar um Salesforce Marketing Cloud Credencial do OAuth.
   URL de redirecionamento do OAuth	https://<instance_name>/oauth_redirect.do , em que o nome da instância é o nome do seu ServiceNow instância.
   Informações adicionais usadas para pós-processamento
   Extensão de dados de contagens de contatos	Nome da extensão de dados da qual você deseja recuperar os dados do relatório Contagens de contatos. Este nome deve corresponder exatamente ao nome da extensão de dados que você criou em Crie uma extensão de dados para o relatório Contagens de contatos.

10. Selecione Criar e obter um Token do OAuth.
    Nota:

    Para obter a função necessária para executar esta etapa, consulte Permissões mínimas do usuário tabela.
11. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.
    A validação da conexão verifica as APIs de download de assinaturas e consumo de download, mas não as APIs de recuperação de assinaturas.
12. Depois que a conexão for verificada, selecione Publicar .

O que Fazer Depois

Depois que a integração se conectar, seu ServiceNow a instância cria automaticamente modelos de software, regras de recuperação e assinaturas de software que são atualizadas diariamente.

Depois de criar um perfil de integração, exiba informações sobre o perfil no Espaço para ativos de software navegando até Operações de licença > Assinatura de usuário > Perfis de integração diretos. Você pode selecionar um perfil de integração para exibir as listas relacionadas a seguir. Se todas as listas relacionadas a seguir não estiverem visíveis para um perfil de integração na exibição padrão, você poderá selecionar a exibição de integração personalizada na guia Detalhes:

• Modelos de software
• Identificadores de assinatura não reconhecidos
• Trabalhos agendados
• Resultados de trabalhos programados
• Assinaturas de Software
• Regra de exclusão de identificador de assinatura
• Regra de exclusão do usuário de assinatura

Depois de criar um perfil de integração, você pode definir regras de exclusão de assinatura para manter determinadas assinaturas dos cálculos de custo de licença. Para obter mais informações, consulte Exclusões de assinatura para SaaS E aplicações SSO.

Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e configurações para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários perfis de integração.

Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revise uma regra de recuperação de software.

Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software próprio.

• Para obter mais informações sobre como criar direitos de software no Software Asset Management IU principal, consulte Crie direitos em Software Asset Management clássico.
• Para obter mais informações sobre como criar direitos de software no Espaço de ativos de software, consulte Crie direitos no espaço.
• Para obter mais informações sobre como criar direitos de software usando o. Software Asset Management Playbook, consulte Crie direitos usando o passo-a-passo guiado.

A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir seus resultados de reconciliação no Workbench de licença ( Software Asset Management aplicação clássica) ou o. Exibição de uso de licença (Espaço de ativos de software). Use estes resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.

• Para obter mais informações sobre como executar reconciliação no Software Asset Management aplicação clássica, consulte Execute a reconciliação de software em Software Asset Management clássico.
• Para obter mais informações sobre como executar a reconciliação no Espaço de ativos de software, consulte Execute a reconciliação de software no espaço.