Integrar Salesforce Marketing Cloud usando OAuth 2.0

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 27 min. de leitura

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

    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. Selecione Adicionar componente.
    5. Selecione Integração de API para integrar APIs Salesforce Marketing Cloud à sua aplicação.
    6. Selecione Avançar.
    7. Selecione Servidor para servidor como o tipo de integração.
    8. Selecione Avançar.
    9. Selecione os escopos necessários para sua integração.
    10. Selecione Salvar.
      Seu ID de cliente e o segredo do cliente 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 e o segredo do cliente. Copie os valores para usá-los mais tarde.

    Como 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, vá para 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 da aplicação Construtor de análise e, em seguida, 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 para o qual você deseja recuperar e exibir os 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, ServiceNow recomenda que você 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 1. 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, selecione 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 2. Caixa de diálogo Editar opções de programação
        Campo Descrição
        Opções de programação
        Início 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 de arquivo e 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 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. 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 ExactTargetEnhancedFTP 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 na sua instância Salesforce Marketing Cloud.

    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 sua instância ServiceNow se conecta ao serviço Salesforce Marketing Cloud, ela recupera dados desta extensão de dados.
    Aviso:
    Não configure esta extensão de dados como uma população. Se você configurá-lo como uma população, todos os registros na extensão de dados contribuirão para a contagem de contatos.

    Procedimento

    1. No cabeçalho da página da sua instância Salesforce Marketing Cloud, aponte para 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 Construtor de contato é aberto.
    3. Selecione a guia Extensões de dados e selecione Criar.
      A caixa de diálogo Criar nova extensão de dados é aberta.
    4. Na etapa Propriedades, preencha os campos.
      Tabela 3. 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 usar a chave predefinida ou 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? A opção que indica se a extensão de dados pode ser enviada para seus assinantes.
    5. Selecione Avançar.
    6. Na etapa Política de retenção de dados, defina o campo Configuração de retenção como Desativado.
    7. Selecione Avançar.
    8. 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:
      • Contagem_Data
      • Total_Contacts_Distinct_Contact
      • Total_Email_Addresses_Distinct1
      • Total_Distinct_Mobile_Addresses_Count
      • Sinalizador
      Nota:
      Você pode adicionar atributos adicionais, e o nome deve ser igual aos atributos de integração. Para obter mais informações, consulte 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 de todas as outras colunas do relatório Contagens de contatos são opcionais.

      Preencha os campos para cada atributo que você deseja adicionar.

      Tabela 4. 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 chave primária.
    9. Selecione Concluído.
    10. Na caixa de diálogo Extensão de dados criada, selecione OK.

    Crie 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 sua instância Salesforce Marketing Cloud, aponte para o ícone Salesforce para exibir a lista de aplicações Salesforce Marketing Cloud disponíveis.
    2. Selecione o ícone do app Journey Builder 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 de início do painel de menu esquerdo para a seção Origem de início da tela do fluxo de trabalho.
    5. Defina uma programação para a automação.
      1. Na seção Origem de inicialização da tela do fluxo de trabalho, selecione Configurar.
      2. Na caixa de diálogo, preencha os campos.
        Tabela 5. Caixa de diálogo Definir programação
        Campo Descrição
        Data de início A data e a hora a partir das quais 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 a ser executada depois que o relatório Contagens de contatos for gerado.
        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 dê tempo suficiente para o relatório terminar de ser gerado. ServiceNow recomenda uma hora de início de pelo menos duas horas após a hora de início do relatório.
        Fim 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.
    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 í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 de atividade do 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 6. Campos de propriedades
        Campo Descrição
        Nome Nome da atividade do script.
        Chave Externa Chave opcional que identifica exclusivamente a atividade do script. Você pode usar a chave predefinida ou inserir uma chave de sua escolha.
        Pasta local O local no qual você deseja armazenar seus scripts. Este campo é definido automaticamente como Scripts. Selecione Escolher... para selecionar um local diferente.
        Descrição Descrição da atividade do 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>
      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 do 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 de importação SFTP para localizar e importar dados de relatório para suas extensões de dados. Para habilitar sua instância para importar 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 SFTP.
      1. Na seção Atividades do painel de menu esquerdo, arraste o ícone 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 7. 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 usar a chave predefinida ou 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. Este nome deve corresponder exatamente ao nome do arquivo do relatório de Contagens de Contatos que você criou em Como criar um relatório de contagens de contatos no Salesforce Marketing Cloud, incluindo a extensão do arquivo.
        Tipo de extração Método de extração de dados. Defina este campo como Mover e copiar 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 8. Campos de configuração
        Campo Descrição
        Pasta de entrada Local em que você salvou o relatório de contagens de contatos. Insira \reports\.
        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 importação de arquivo para importar os dados do relatório de Contagens de Contatos para a extensão de dados.
      1. Na seção Atividades do painel de menu esquerdo, arraste o ícone Importar arquivo para a tela do fluxo de trabalho.
        A atividade de importação de arquivo se torna a terceira etapa do fluxo de trabalho de automação.
      2. Selecione Escolher na etapa de atividade do arquivo de importação.
        A caixa de diálogo Escolher atividade de importação de arquivo é aberta.
      3. Selecione Criar nova atividade de arquivo de importação.
        A caixa de diálogo Criar nova atividade de importação de arquivo é aberta.
      4. Na etapa Informações da atividade, preencha os campos.
        Tabela 9. 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 usar a chave predefinida ou 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 contendo 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álida 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 Importar arquivo, preencha os campos.
        Tabela 10. Campos para Importar arquivo
        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 Como 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 uma 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 de dados incorretos 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 para Adicionar e Atualizar e Mapear por Ordinal.
      11. Quando solicitado, habilite a opção Importar arquivo com 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 Revisar, verifique se a configuração da atividade do arquivo de importação está correta e selecione Concluir.
    9. Selecione Salvar.
    10. Na caixa de diálogo, preencha os campos.
      Tabela 11. 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 Ativar confirmaçã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 o relatório e os trabalhos de automação automaticamente com base nas programações que você define. Se você quiser recuperar dados do relatório de Contagens de contatos antes do próximo relatório programado e trabalhos de automação, poderá executar esses trabalhos manualmente.

    Procedimento

    1. Execute o relatório Contagens de contatos.
      1. No cabeçalho da página da sua instância Salesforce Marketing Cloud, aponte para o ícone Salesforce para exibir a lista de aplicações Salesforce Marketing Cloud disponíveis.
      2. Selecione o ícone da aplicação Construtor de análise e selecione Relatórios.
        A visão geral do app Relatórios é aberta.
      3. Na sua lista de relatórios, selecione o relatório Contagens de contatos que você criou em Como 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 Resultados do FTP ( ícone Resultados do FTP).
      6. Na caixa de diálogo, preencha os campos.
        Tabela 12. Caixa de diálogo Resultados do relatório de FTP
        Campo Descrição
        Nome do arquivo O nome do arquivo do relatório, excluindo a extensão do arquivo.
        Local do FTP Localização 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).
        Origem do Relatório Origem do relatório. Este campo é definido automaticamente como Contagens de contatos.
        Formato Tipo de arquivo e extensão de arquivo nos quais você deseja receber os resultados do relatório. Selecione Arquivo de dados (.csv).
      7. Selecione Salvar.
    2. Execute sua automação.
      1. No cabeçalho da página da sua instância Salesforce Marketing Cloud, aponte para o ícone Salesforce para exibir a lista de aplicações Salesforce Marketing Cloud disponíveis.
      2. Selecione o ícone do app Journey Builder e selecione Automation Studio.
        O fluxo de trabalho da automação que você criou em Crie uma automação para importar dados do relatório de contagens de contatos em sua extensão de dados é aberto no app Automation Studio.
      3. Na seção Origem de início da tela do fluxo de trabalho, selecione Pausado.
      4. Na caixa de diálogo Confirmação de programação de pausa, pause a programação de automação selecionando Pausar.
      5. Depois que a caixa de diálogo fechar, selecione Executar uma vez.
      6. Quando solicitado a selecionar as atividades que você deseja executar, marque a caixa de seleção das atividades de script, extração de dados e importação de arquivo.
      7. Selecione Executar.
      8. Na caixa de diálogo Confirmação de execução única, selecione Executar agora.

    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 adicionais de assinatura, 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 admin

    Salesforce Marketing Cloud Função necessária: sn_sforce_mc_spoke.Administrador do 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 ficará 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 13. Formulário de 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ê inicia o download de assinaturas de usuário, independentemente da data de criação do perfil.
      Recuperar Subfluxo de Assinatura
      Subfluxo Este campo é definido automaticamente como Recuperar assinatura do Salesforce Marketing Cloud.
      Fazer download do subfluxo de assinatura
      Subfluxo Este campo é definido automaticamente como Consumo de download de contatos 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 Baixar assinaturas, Salesforce Marketing Cloud Recuperar assinatura e Salesforce Marketing Cloud Baixar subfluxos de consumo de contatos 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 14. 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 SOAP do SFMC.
      URL da conexão SOAP URL do endpoint da Conexão SOAP. Insira https://<subdomain>.soap.marketingcloudapis.com/Service.asmx, em que <subdomain> é o 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 de OAuth.
      Segredo do cliente OAuth Segredo do cliente que você recuperou ao criar uma Salesforce Marketing Cloud credencial 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 de OAuth.
      O fluxo de token OAuth foi concluído com sucesso.
    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 sua propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho programado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licença (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 para 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 para o qual 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 admin

    Salesforce Marketing Cloud Função necessária: sn_sforce_mc_spoke.Administrador do 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 ficará 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 15. Formulário de 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ê inicia o download de assinaturas de usuário, independentemente da data de criação do perfil.
      Recuperar Subfluxo de Assinatura
      Subfluxo Este campo é definido automaticamente como Recuperar assinatura do Salesforce Marketing Cloud.
      Fazer download do subfluxo de assinatura
      Subfluxo Este campo é definido automaticamente como Consumo de download de contatos 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 () ao lado do campo Conexão e credencial para abrir o registro dos 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 para o 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 16. 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 SOAP do SFMC.
      URL da conexão SOAP URL do endpoint da Conexão SOAP. Insira https://<subdomain>.soap.marketingcloudapis.com/Service.asmx, em que <subdomain> é o 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 de OAuth.
      Segredo do cliente OAuth Segredo do cliente que você recuperou ao criar uma Salesforce Marketing Cloud credencial 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 de OAuth.
      O fluxo de token OAuth foi concluído com sucesso.
    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 sua propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho programado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licença (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 para corrigir qualquer não conformidade.