Integrar Salesforce Marketing Cloud usando OAuth 2.0

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 28 min. de leitura

    • Integre sua instância [ ServiceNow com serviços Salesforce Marketing Cloud usando o OAuth 2.0.

    Importante:
    Minimize os riscos de 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 do usuário necessária na aplicação Salesforce Marketing Cloud Escopos de autenticação
    Baixar assinaturas Usuário Usuários: ler
    Extrair atividade do usuário Usuário Usuários: ler
    Recuperar assinatura Usuário Usuários: gravação
    Consumos de download Usuário Extensões de dados: leitura, gravação

    Criar Salesforce Marketing Cloud credenciais do OAuth 2.0

    Crie Salesforce Marketing Cloud credenciais OAuth 2.0 para obter acesso a Salesforce Marketing Cloud APIs.

    Antes de Iniciar

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

    Procedimento

    1. Faça login no locatário Salesforce Marketing Cloud.
    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 os campos Nome e Descrição.
    5. Selecione Salvar.
    6. Selecione Adicionar componente.
    7. Selecione Integração de API para integrar Salesforce Marketing Cloud APIs à sua aplicação.
    8. Selecione Avançar.
    9. Selecione Servidor a servidor como o tipo de integração.
    10. Selecione Avançar.
    11. Selecione os seguintes escopos para sua integração.
      • Usuários: ler
      • Usuários: gravação
      • Extensões de dados: leitura, gravação
    12. Selecione Salvar.
      Sua ID de cliente, segredo do cliente e URI de base 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 SOAP. Copie os valores para usá-los mais tarde.
      Nota:
      Observação: você deve adicionar /Service.asmx no URI base SOAP ao passá-lo em sua instância ServiceNow.
    13. Selecione a guia ACESSO e confirme se sua unidade de negócios está habilitada.

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

    Criar um relatório de contagens de contatos no Salesforce Marketing Cloud

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

    Antes de Iniciar

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

    Procedimento

    1. Em um navegador da Web, acesse sua instância Salesforce Marketing Cloud.
    2. Faça login usando suas credenciais de administrador.
    3. No cabeçalho da página da instância, selecione o ícone de perfil da unidade de negócios e selecione a unidade de negócios primária de nível superior para que o relatório de Contagens de contatos inclua dados para a unidade de negócios primária e todas as unidades de negócios secundárias correspondentes.
    4. Na lista de aplicações Salesforce Marketing Cloud disponíveis, selecione o ícone do app Analytics Builder 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 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 na lista Intervalo de datas.
      O valor padrão é Últimos 30 dias.
      Dica:
      Para evitar problemas de desempenho durante a geração de relatórios, defina este valor como Últimos 7 dias.
    8. Selecione Enviar.
      Sua instância Salesforce Marketing Cloud 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.
      Origem do Relatório Origem do relatório. Este campo é definido automaticamente como Contagens de contatos.
      Descrição Descrição do relatório.
    11. Selecione 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 a guia Visão geral para retornar à visão geral do app Relatórios.
      2. Na lista de relatórios, abra o relatório de 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 programação
        Iniciar A data e a 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 programado.
        Repetição Frequência na qual você deseja executar o relatório. Configure o relatório para ser executado uma vez por semana aos domingos.
        Fim Data em que você deseja parar de executar o relatório.
        Opções de entrega
        Formato Tipo e extensão de arquivo nos quais você deseja receber os resultados do relatório. Selecione Arquivo de dados (.csv).
        Local Local no qual você deseja salvar ou compartilhar o relatório. Defina este campo como Salvar 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-o no formato Reportname_YYYYMMDD_HHMMSS.

          Nota:
          Anote este nome de 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 dos seus Salesforce Marketing Cloud arquivos de FTP. Selecione ExactTarget Enhanced FTP para que o relatório seja salvo na pasta Relatórios SFTP (SSH File Transfer Protocol).
      5. Selecione Salvar.

    Criar uma extensão de dados para o relatório de Contagens de Contatos

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

    Antes de Iniciar

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

    Por Que e Quando Desempenhar Esta Tarefa

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

    Procedimento

    1. No cabeçalho da página da instância Salesforce Marketing Cloud, passe o mouse sobre o ícone Salesforce para exibir a lista de aplicações Salesforce Marketing Cloud disponíveis.
    2. Selecione o ícone do app Audience Builder e selecione Contact Builder.
      O app Contact Builder é aberto.
    3. Selecione a guia Extensões de dados.
    4. Na caixa de diálogo pop-up, selecione Introdução e, em seguida, 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.
      É enviável? 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 o campo Configuração de retenção como Desativado.
    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 deseja importar dados. Cada nome de atributo deve corresponder exatamente ao nome da coluna do relatório correspondente.

      Para a integração Salesforce Marketing Cloud, são necessários atributos para as seguintes colunas do relatório Contagens de contatos:

      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 ser habilitada para o atributo Count_Date.
      Nome Nome do atributo.

      Este nome deve corresponder exatamente ao nome da coluna do 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 o atributo Sinalizador, defina o valor padrão como 1.

      Nota:
      Não insira um valor padrão para atributos atribuídos como uma chave primária.
      Nome Tipo de Dados
      Contagem_Data Texto
      Total_Contacts_Distinct_Count Texto
      Total_Email_Distinct_Endereços1 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 Criar um perfil de integração Salesforce Marketing Cloud usando autenticação básica ou Criar um perfil de integração Salesforce Marketing Cloud usando OAuth 2.0.
      Os atributos para todas as outras colunas do relatório Contagens de contatos são opcionais. Preencha os campos para cada atributo que você deseja adicionar.
    10. Selecione Concluído.
    11. Na caixa de diálogo Extensão de dados criada, selecione OK.

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

    Crie uma automação para importar automaticamente os dados do relatório de 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 da instância Salesforce Marketing Cloud, passe o mouse sobre o ícone Salesforce para exibir a lista de aplicações Salesforce Marketing Cloud disponíveis.
    2. Selecione o ícone do app Construtor de jornadas e selecione Automation Studio.
      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 uma programação de automação arrastando o ícone Programação da seção Origens Iniciais do painel do menu esquerdo para a seção Origem Inicial da tela do fluxo de trabalho.
    5. Defina uma programação 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. Caixa de diálogo 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 programada.
        Repetir A frequência com que 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 ao criação de um relatório de Contagens de Contatos no Salesforce Marketing Cloud.

        Dica:
        Se você configurar a automação para ser executada no mesmo dia em que o relatório for gerado, selecione uma hora de início que forneça tempo suficiente para que a geração do relatório seja concluída. ServiceNow 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é que a programação de automação termine.

        Se você não quiser que a programação de automação termine, defina este campo como Nunca.

        Este campo não aparece somente quando Nenhum (executar uma vez) é selecionado em Repetir.
      3. Selecione Concluído.
    6. Adicione uma atividade de script para executar o JavaScript do lado do servidor para todas as atividades que o exigem.
      1. Na seção Atividades do painel do menu esquerdo, arraste o ícone Script para a tela do fluxo de trabalho.
        A atividade de script se torna a primeira etapa do fluxo de trabalho de automação.
      2. Selecione Escolher na etapa da 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.
        Local da pasta O local no qual você deseja armazenar seus scripts. Selecione Escolher... 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>

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

      6. Selecione Validar sintaxe 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 de Contagens de Contatos da pasta Relatórios SFTP para a pasta Importação SFTP.
      A instância Salesforce Marketing Cloud usa a pasta Importação 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 de 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 do menu esquerdo, arraste o ícone de extração de dados para a 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 Escolher na etapa da 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 de Contagens de Contatos do qual você deseja extrair dados.

        Se você quiser incluir data e hora no nome do relatório, adicione-as no formato Reportname_YYYYMMDD_HHMMSS selecionando os campos Variável de data e Variável de tempo.

        Este nome deve corresponder exatamente ao nome do arquivo do relatório de Contagens de Contatos que você criou em Criar um relatório de contagens de contatos no Salesforce Marketing Cloud, incluindo a extensão do arquivo.
        Extrair tipo Método de extração de dados.

        Defina este campo como Mover e copiar arquivos de FTP aprimorados.
        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 de 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 de Contagens de Contatos para a extensão de dados.
      1. Na seção Atividades do painel do menu esquerdo, arraste o ícone de Cópia ou Importação de dados para a tela do fluxo de trabalho.
        A atividade Cópia ou importação de dados se torna a terceira etapa do fluxo de trabalho de automação.
      2. Selecione Escolher na etapa de atividade Cópia ou importação de dados.
        A caixa de diálogo Escolher cópia ou importação de dados é aberta.
      3. Selecione Criar nova cópia ou definição de 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 de importação de arquivo.
        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 erro de validação de Contagem de Campos Inválidos 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 da 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 de 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 de Contagens de Contatos do qual você deseja importar dados. Este nome deve corresponder exatamente ao nome do arquivo do relatório de Contagens de Contatos que você criou em Criar um relatório de contagens de contatos no 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.

        Se você quiser habilitar o uso de aspas duplas para separar cada registro, habilite a opção Respeitar aspas duplas (") como um delimitador de texto.
        Comportamento incorreto de dados Opção para ignorar linhas com dados incorretos. 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 Criar uma extensão de dados para o relatório de Contagens de Contatos.
      9. Selecione Avançar.
      10. Na etapa Mapeamento, selecione as opções Adicionar e atualizar e Mapear por ordinal no cabeçalho Ação de dados.
      11. Quando solicitado, habilite a opção Importar arquivo que 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:
        Deixe o atributo Sinalizador não mapeado.
      12. Selecione Avançar.
      13. Na etapa Revisão, verifique se a configuração da atividade de importação de arquivo está correta e selecione Concluir.
    9. Selecione 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 em que você deseja salvar a automação.
    11. Selecione Salvar.
    12. Na seção Origem inicial da tela do fluxo de trabalho, selecione Ativo.
    13. Na caixa de diálogo Confirmação de ativação de programação, selecione Ativar para ativar a programação de automação.

    Recuperar dados do relatório de contagens de contatos manualmente

    Depois de criar o relatório de Contagens de contatos, a extensão de dados e a automação, você pode recuperar dados de relatório entre o relatório programado 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

    Sua instância Salesforce Marketing Cloud 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 de Contagens de contatos antes dos próximos trabalhos agendados de relatório e automação, poderá executar esses trabalhos manualmente.

    Procedimento

    1. Execute o relatório de Contagens de Contatos.
      1. No cabeçalho da página da instância Salesforce Marketing Cloud, passe o mouse sobre o ícone Salesforce para exibir a lista de aplicações Salesforce Marketing Cloud disponíveis.
      2. Selecione o ícone do app Construtor de análise e selecione Relatórios.
        A visão geral do app Relatórios é aberta.
      3. Na lista de relatórios, selecione o relatório de Contagens de Contatos que você criou em Criar um relatório de contagens de contatos no Salesforce Marketing Cloud.
      4. Selecione Executar.
        Sua instância Salesforce Marketing Cloud gera o relatório e exibe os resultados na página Resultados: <report-name>.
      5. Na página Resultados: <report-name>, selecione o ícone de Resultados de download ( Ícone de download).
      6. Na caixa de diálogo, preencha os campos.
        Tabela 13. Caixa de diálogo Resultados do download
        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 Tipo e extensão de arquivo nos quais você deseja receber os resultados do relatório. Selecione Arquivo de dados (.csv).
      7. Selecione 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 da instância Salesforce Marketing Cloud, passe o mouse sobre o ícone Salesforce para exibir a lista de aplicações Salesforce Marketing Cloud disponíveis.
      2. Selecione o ícone do app Audience Builder e selecione Contact Builder.
      3. Abra a extensão de dados criada recentemente que você criou ao criar uma extensão de dados para o relatório de contagens de contatos.
      4. Selecione Importar.
      5. Na caixa de diálogo Confirmação de importação de dados, selecione Importar para extensão de dados e, em seguida, OK.
      6. Na etapa Importar para extensão de dados, escolha o arquivo que você baixou na Etapa 1 anterior.
      7. Selecione Delimitador como vírgula.
      8. Selecione Tipo de importação como Adicionar e atualizar.
      9. Selecione Opções de importação como Ignorar linhas no arquivo de importação com dados inválidos.
      10. Selecione Avançar.
      11. Na caixa de diálogo Configurar mapeamento, selecione Mapear manualmente.
      12. Corresponda as colunas de extensão de dados disponíveis às colunas de relatório importadas e deixe a coluna Sinalizador em branco.
      13. Selecione Avançar.
      14. Na caixa de diálogo Revisar e criar, insira o ID de e-mail no qual você deseja notificação 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 de Contagens de Contatos mais recentes são importados para a extensão de dados.

    Criar um perfil de integração Salesforce Marketing Cloud usando OAuth 2.0

    Crie um perfil de integração Salesforce Marketing Cloud usando o OAuth 2.0 para rastrear assinaturas de software e otimizar licenças obsoletas para o serviço Salesforce Marketing Cloud.

    Antes de Iniciar

    Para criar um perfil de integração Salesforce Marketing Cloud, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (com.sn_sam_saas_int) na ServiceNow Store.

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

    ServiceNow Função necessária: sam_integrator ou administrador

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

    Por Que e Quando Desempenhar Esta Tarefa

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

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Salesforce Marketing Cloud.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Salesforce Marketing Cloud na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 14. Formulário Perfil de integração
      Campo Descrição
      Nome de visualizaçã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.
      • Autorização básica
      • OAuth 2.0: selecione este valor.
      Nota:
      Para um novo perfil Salesforce Marketing Cloud, o tipo de autenticação é definido como Autenticação básica por padrão.
      Conexão e Credencial Alias de credencial e conexão para Salesforce Marketing Cloud. Este campo é definido automaticamente como sn_sforce_mc_spoke.SalesforceMarketingCloudSoapConnection.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou 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.
      Baixar Subfluxo de Assinatura
      Subfluxo Este campo é definido automaticamente como Assinaturas de download do Salesforce Marketing Cloud.
      Você pode exibir eventos realizados por usuários individuais até um ano antes da data atual. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a baixar assinaturas de usuário, independentemente da data de criação do perfil.
      Recuperar Subfluxo de Assinatura
      Subfluxo Este campo é definido automaticamente como Assinatura de recuperação do Salesforce Marketing Cloud.
      Fazer download do subfluxo de assinatura
      Subfluxo Este campo é definido automaticamente como Consumo de contatos de download do Salesforce Marketing Cloud.
      Atributos de integração
      Atributos Os atributos de 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.

      Você pode adicionar ou remover os atributos com base em seus requisitos.

      Nota:
      O nome do atributo deve corresponder ao cabeçalho da coluna do relatório na instância Salesforce Marketing Cloud. Para obter mais informações, consulte Criar uma extensão de dados para o relatório de Contagens de Contatos.
    3. Selecione Salvar.
      Sua instância ServiceNow cria um perfil de integração de rascunho. O perfil de integração usa os subfluxos Salesforce Marketing Cloud de download de assinaturas, Salesforce Marketing Cloud de recuperação de assinatura e Salesforce Marketing Cloud de consumo de contatos de download para recuperar dados do usuário de seus serviços Salesforce Marketing Cloud.
    4. Abra o registro de aliases de conexão e credencial selecionando o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial e selecionando Abrir registro na visualização do registro.
    5. No formulário Aliases de conexão e credencial, selecione o link relacionado Criar nova conexão e credencial.
    6. 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 O nome da conexão. Por exemplo, Conexão SOAP SFMC.
      URL de conexão SOAP URL do endpoint da conexão SOAP. Insira https://<subdomain>.soap.marketingcloudapis.com/Service.asmx, em que <subdomain> é o seu subdomínio Salesforce Marketing Cloud.
      Informações de credencial
      ID do cliente OAuth ID de cliente que você gerou ao criar um Salesforce Marketing Cloud Credencial do OAuth.
      Segredo do cliente OAuth Segredo do cliente que você recuperou ao criar uma 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 da sua instância ServiceNow.
      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 dados do relatório de Contagens de Contatos. Este nome deve corresponder exatamente ao nome da extensão de dados que você criou em Criar uma extensão de dados para o relatório de Contagens de Contatos.
    7. Selecione Criar e obter um Token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    8. Selecione Salvar.
    9. Retorne ao perfil de integração e selecione Publicar.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar 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 de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.

    Criar perfis de integração Salesforce Marketing Cloud adicionais

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

    Antes de Iniciar

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

    Função necessária: sam_integrator ou administrador

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

    Por Que e Quando Desempenhar Esta Tarefa

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

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Salesforce Marketing Cloud.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Salesforce Marketing Cloud na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 16. Formulário Perfil de integração
      Campo Descrição
      Nome de visualizaçã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.
      • Autorização básica
      • OAuth 2.0: selecione este valor.
      Nota:
      Para um novo perfil Salesforce Marketing Cloud, o tipo de autenticação é definido como Autenticação básica por padrão.
      Conexão e Credencial Alias de credencial e conexão para Salesforce Marketing Cloud. Este campo é definido automaticamente como sn_sforce_mc_spoke.SalesforceMarketingCloudSoapConnection.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou 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.
      Baixar Subfluxo de Assinatura
      Subfluxo Este campo é definido automaticamente como Assinaturas de download do Salesforce Marketing Cloud.
      Você pode exibir eventos realizados por usuários individuais até um ano antes da data atual. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a baixar assinaturas de usuário, independentemente da data de criação do perfil.
      Recuperar Subfluxo de Assinatura
      Subfluxo Este campo é definido automaticamente como Assinatura de recuperação do Salesforce Marketing Cloud.
      Fazer download do subfluxo de assinatura
      Subfluxo Este campo é definido automaticamente como Consumo de contatos de download do Salesforce Marketing Cloud.
      Atributos de integração
      Atributos Os atributos de 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.
      Você pode adicionar ou remover os atributos com base em seus requisitos.
      Nota:
      O nome do atributo deve corresponder ao cabeçalho da coluna do relatório na instância Salesforce Marketing Cloud. Para obter mais informações, consulte Criar uma extensão de dados para o relatório de Contagens de Contatos.
    3. Selecione o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial para abrir o registro de aliases de conexão e credencial.
    4. Selecione Abrir registro na visualização do registro.
    5. No formulário Aliases de conexão e credencial, crie um alias secundário que possa identificar exclusivamente a conexão e as credenciais para este 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 perfil de integração Salesforce Marketing Cloud adicional 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 > Parentalidade = *** 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 campo Nome.
      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.
    6. 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 O nome da conexão. Por exemplo, Conexão SOAP SFMC.
      URL de conexão SOAP URL do endpoint da conexão SOAP. Insira https://<subdomain>.soap.marketingcloudapis.com/Service.asmx, em que <subdomain> é o seu subdomínio Salesforce Marketing Cloud.
      Informações de credencial
      ID do cliente OAuth ID de cliente que você gerou ao criar um Salesforce Marketing Cloud Credencial do OAuth.
      Segredo do cliente OAuth Segredo do cliente que você recuperou ao criar uma 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 da sua instância ServiceNow.
      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 dados do relatório de Contagens de Contatos. Este nome deve corresponder exatamente ao nome da extensão de dados que você criou em Criar uma extensão de dados para o relatório de Contagens de Contatos.
    7. Selecione Criar e obter um Token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    8. Selecione Salvar.
    9. Retorne ao perfil de integração e selecione Publicar.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar 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 de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.