Integrar Salesforce Marketing Cloud usando autenticação básica

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

    • Integre sua instância [ ServiceNow com Salesforce Marketing Cloud usando a autenticação básica.

    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
    • E-mail > Administrador > Acesso de API > API WebService
    • Administração > Usuários > Exibir
    		 Nenhum(a)
    Extrair atividade do usuário
    • E-mail > Administrador > Acesso de API > API WebService
    • Administração > Usuários > Exibir
    		 Nenhum(a)
    Recuperar assinatura
    • E-mail > Administrador > Acesso de API > API WebService
    • Administração > Usuários > Exibir
    • Administração > Usuários > Atualizar
    		 Nenhum(a)
    Consumos de download
    • E-mail > Administrador > Acesso de API > API WebService
    • E-mail > Assinantes > Extensão de dados > Exibir
    • E-mail > Assinantes > Extensão de dados > Gerenciar dados
    		 Nenhum(a)

    Criar um usuário para acessar a Salesforce Marketing Cloud SOAP API

    Crie um usuário com o qual você possa acessar a Salesforce Marketing Cloud SOAP API. A SOAP API permite que você recupere registros de suas extensões de dados Salesforce Marketing Cloud e obtenha informações sobre seus usuários Salesforce Marketing Cloud.

    Antes de Iniciar

    Salesforce Marketing Cloud Função necessária: usuário administrador com privilégios para criar usuários e funções

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:

    Para usar os serviços web, navegue até Página inicial de configuração > Configurações > Segurança > Configurações de segurança. Na seção Nome de usuário e logins, marque a caixa de seleção Habilitar nome de usuário e senha para serviços web.

    Para acessar uma extensão de dados, o usuário da API deve ser criado diretamente na mesma unidade de negócios da extensão de dados.

    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 sua instância, selecione o ícone do seu perfil e selecione Configuração.
    4. Crie um usuário Salesforce Marketing Cloud.
      1. Navegar até Administração > Usuários > Usuários.
      2. Selecione Criar.
      3. No formulário, preencha os campos.
        Tabela 2. Formulário Configurações gerais
        Campo Descrição
        Nome Nome do usuário.
        Endereço de e-mail de resposta Endereço de e-mail do qual você deseja enviar e responder a mensagens de e-mail. Salesforce Marketing Cloud também envia solicitações de senhas esquecidas para este endereço de e-mail.

        Depois de inserir um endereço de e-mail, selecione Verificar para verificar o endereço de e-mail.
        Adicionar ao menu suspenso Nome de origem Opção para enviar o endereço de e-mail de resposta por meio de um processo de verificação de domínio antes que o endereço de e-mail seja preenchido em um e-mail.
        Endereço de E-mail da Notificação O endereço de e-mail para o qual você deseja enviar Salesforce Marketing Cloud notificações.
        Nome de usuário Nome de usuário para o usuário.
        Chave Externa Chave que identifica exclusivamente o usuário durante as chamadas de API.
        Fuso horário Fuso horário em que o usuário está localizado.
        Código de cultura Idioma usado na interface do usuário Salesforce Marketing Cloud para este usuário.
        Usuário da API A opção que indica se o usuário pode acessar a Salesforce Marketing Cloud SOAP API. Marque a caixa de seleção para habilitar esta opção.
        Senha Temporária Uma senha temporária com a qual você pode fazer login pela primeira vez. Você será solicitado a alterar esta senha no primeiro login.
        Verificar senha Campo para verificar a senha temporária.
      4. Selecione Salvar.
    5. Crie uma função de usuário que permita que usuários atribuídos acessem a Salesforce Marketing Cloud SOAP API e também gerenciem usuários e extensões de dados.
      1. Navegar até Administração > Usuários > Funções.
      2. Selecione Criar.
      3. No formulário, preencha os campos.
        Tabela 3. Formulário de propriedades
        Campo Descrição
        Nome Nome da função do usuário.
        Chave Externa Chave que identifica exclusivamente a função do usuário.
        Descrição Descrição da função do usuário.
      4. Na seção de formulário Permissões, expanda o E-mail > Assinantes > Extensão de data categoria de permissão e marque a caixa de seleção Permitir para as permissões de acesso Exibir e Gerenciar dados.
      5. Expandir o E-mail > Administrador > Acesso à API categoria de permissão e marque a caixa de seleção Permitir para a permissão de acesso da API WebService.
      6. Expandir o Administração > Usuários categoria de permissão e marque a caixa de seleção Permitir para as seguintes permissões de acesso:
        • Exibição
        • Atualizar
        • Desativar
      7. Selecione Salvar.
    6. Atribua a função do usuário ao usuário Salesforce Marketing Cloud.
      1. Navegar até Administração > Usuários > Usuários.
      2. Na lista de usuários disponíveis, marque a caixa de seleção do usuário que você criou na etapa 4.
      3. Selecione Gerenciar funções.
        O formulário Funções do usuário selecionado é aberto.
      4. Na seção de formulário Funções, selecione Editar funções.
      5. Quando a lista de funções disponíveis for exibida, marque a caixa de seleção da função do usuário que você criou na etapa 5.
      6. 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 4. 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 5. 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 6. 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 7. 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 8. 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 9. 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 10. 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 11. 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 12. 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 13. 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 14. 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 15. 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 autenticação básica

    Crie um perfil de integração usando a autenticação básica 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

    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.
      • Autenticação básica: selecione este valor.
      • OAuth 2.0
      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.SalesforceMarketingCloud.
      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 17. Caixa de diálogo Criar conexão e credencial
      Campo Descrição
      Insira as Informações de Conexão
      Nome da conexão O nome da conexão.
      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.
      Insira as Informações de Credencial
      Nome do perfil de nome de usuário Nome das suas credenciais.
      Nome de usuário Nome de usuário do usuário com o qual você pode acessar a Salesforce Marketing Cloud SOAP API. Insira o nome de usuário do usuário que você criou em Criar um usuário para acessar a Salesforce Marketing Cloud SOAP API.
      Senha Senha do usuário com o qual você pode acessar a Salesforce Marketing Cloud SOAP API. Insira a senha do usuário que você criou em Criar um usuário para acessar a Salesforce Marketing Cloud SOAP API.
      Insira 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.
      A caixa de diálogo é fechada.
    8. No cabeçalho do formulário Aliases de conexão e credencial, selecione o botão Voltar para retornar ao formulário Perfil de integração.
    9. Selecione Publicar.
    10. Na caixa de diálogo Confirmação de publicação, selecione OK.

    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.