Troca de dados SFTP

Nossa solução SFTP (protocolo de transferência de arquivos seguro) é uma solução zero-touch, segura end-to-end. Automatiza o envio do arquivo de dados usado para conectar-se à nossa solução de e-mail marketing de geranciamento de relacionamento com o cliente (CRM).

Passos para configurar o one-time

Para configurar o feed de dados de marketing, você realizará um processo de criptografia de arquivos e SFTP one-time para gerar chaves públicas e privadas para transferência segura de arquivos para a Expedia.

Passo 1: Solicite os identificadores do seu site

Você precisará de três valores de identificador de site para configurar a troca de arquivos SFTP:

ID do site: Um identificador exclusivo para o seu site modelo.
tpidO ID do produto de viagem, que, juntamente com o eapid, define um ponto de venda no sistema Expedia.
eapid: O ID de parceiro afiliado da Expedia, que, juntamente com o tpid, define um ponto de venda no sistema da Expedia.

Você deve usar o formulário de suporte em nosso site. Site de Soluções para Parceiros Para solicitar esses valores ao seu gerente de conta.

Passo 2: Crie suas chaves

Utilize o método de sua preferência para gerar as chaves pública e privada para a configuração de criptografia de arquivos e SFTP.

Usando o terminal (MacOS X) ou a linha de comando (Windows)

No terminal do Mac ou na linha de comando do Windows, digite user@localhost: ssh-keygen -t rsa.
Observação: Se o comando falhar, verifique com o seu departamento de TI se você tem permissão suficiente para executá-lo.
Quando solicitado, deixe o campo da senha em branco.
Guarde suas chaves em um local seguro.

Guarde suas chaves em um local seguro. Se você perder sua chave privada, terá que redefinir o SFTP.

Usando um gerador de chaves

Baixe e instale um gerador de chaves.
Utilize o gerador para criar um par de chaves RSA pública/privada.
Copie a chave pública, que começa com ssh-rsa. Isto é o que você enviará para Expedia Group.
Guarde a chave privada em um local seguro. Não a apague — você a usará em vez de uma senha sempre que enviar o arquivo criptografado.

Certifique-se de guardar sua chave privada em um local seguro. Se você perder sua chave, terá que redefinir o SFTP.

Passo 3: Compartilhe sua chave com a Expedia

Você compartilhará sua chave pública SFTP com a Expedia de forma segura. Armazenaremos essa chave com segurança e criaremos uma conta a partir da qual você poderá autenticar a conexão SFTP. Forneceremos um nome de usuário para você usar no processo file-sharing.

Importante

A Expedia utiliza SharePoint como um repositório de chaves seguro. Se a sua organização bloquear o acesso a SharePoint, você também pode enviar a chave pública por e-mail seguro. Se isso for um problema para você, entre em contato com seu gerente de conta.

Envie-nos o nome da sua organização e o endereço de e-mail a partir do qual você fará o upload da chave SFTP pública através do link SharePoint. O seu gestor de lançamento da Expedia irá fornecer-lhe o endereço de e-mail.
Criaremos uma pasta em SharePoint específica para sua organização e enviaremos um link de acesso para o endereço de e-mail que você forneceu. Também enviaremos nossa chave pública, usada para criptografar o arquivo, antes do upload.
Assim que receber o e-mail de acesso, clique no link para gerar o código de acesso necessário. (Observação: verifique sua pasta de spam caso o código de acesso não apareça em sua caixa de entrada em até 2 dias úteis.)
Você deverá carregar a chave pública que gerou para a pasta que criamos e baixar o gpg_encryption_public_key.ascda pasta.
Entraremos em contato quando a conta SFTP estiver pronta para uso.

Formato e estrutura do arquivo

Para que os arquivos de dados do CRM sejam carregados com sucesso, eles devem atender aos seguintes critérios.

O formato do arquivo deve ser .csvinicialmente. Ao criptografar o arquivo, você alterará a extensão do arquivo para .gpg.
Use barras verticais (|), não vírgulas, para delimitar os campos.
A convenção de nomenclatura de arquivos não deve incluir caracteres especiais além de sublinhados (_). O nome do arquivo deve começar com eps_crm_marketing, seguido pelo nome da sua organização; os tpid, eapide site_idcompartilhados pelo seu gerente de conta; e a data de upload. Por exemplo: eps_crm_marketing_<PartnerName>_<tpid>_<eapid>_<site_id>_YYYYMMDD.csv.
Os dados do arquivo devem conter todas as colunas da tabela abaixo, na ordem indicada, e devem incluir valores em todos os campos obrigatórios.

Nome da coluna	Definição	Exemplo do valor	Tipo	Obrigatório
`first_name`	Nome do cliente	Chris	Varchar	—
`last_name`	Sobrenome do cliente	Smith	Varchar	—
`email`	E-mail para clientes	chris.smith@hotmail.com	Varchar	Sim
`mer_flag`	Marketing-eligible indicador de registro; a decisão do cliente de optar por receber (SIM) ou não (NÃO) comunicações de marketing por e-mail.	Sim	Varchar	Sim
`mer_timestamp`	Registro de data e hora em que o cliente decidiu participar ou não.	2021-06-12 20:14:23.000000	Varchar	Sim
`lang_id`	O idioma do site (consulte a tabela de detalhes de localidade); este valor não é case-sensitive	en_US en_FR	Varchar	Sim
`tpid`	ID do produto de viagem fornecido pelo seu gerente de conta da Expedia.	0000	Número	Sim
`eapid`	ID de parceiro afiliado da Expedia fornecido pelo gerente de contas da Expedia.	1234	Número	Sim
`site_id`	Identificador único para o site modelo fornecido pelo gerente de contas da Expedia.	5678	Número	Sim
`points_balance`	Saldo de pontos de fidelidade do cliente	100000	Número (máximo de 13 dígitos)	—
`points_cash_value`	O valor em dinheiro dos pontos de fidelidade do cliente.	250	Varchar (máximo de 10 caracteres)	—
`cash_value_currency`	A moeda na qual os pontos de fidelidade são avaliados.	US$	Texto (máximo de 3 caracteres)	—
`credit_card_type`	O tipo de cartão de crédito usado na transação.	YourBrand cartão	Texto (máximo de 25 caracteres)	—
`loyalty_tier`	O nível de fidelidade do cliente dentro do seu programa.	Platinum	Texto (máximo de 25 caracteres)	—
`attribute1` `attribute2` `attribute3`	3 campos utilizados para compartilhar informações adicionais sobre o cliente	Viajante frequente	Varchar (máximo de 25 caracteres)	—

Conteúdo de exemplo de um arquivo CSV

O arquivo .csv incluirá cada elemento da informação, separado por caracteres de barra vertical (|). Os pipes funcionam como divisores de coluna, sendo cada campo o cabeçalho da coluna com as informações abaixo dele.

Conexão SFTP e upload

Antes de enviar seus dados, você deve criptografar o arquivo.

Criptografia

Utilizamos criptografia PGP para proteger informações de identificação pessoal (PII). Você usará nossa chave pública (que forneceremos) para criptografar seu.csv arquivo. Você pode usar as ferramentas de criptografia que preferir, mas geralmente trabalhamos com ferramentas de criptografia GPG.

Solicite ao seu gerente de lançamento da Expedia o endereço de e-mail a ser usado como destino de importação para a chave pública da Expedia.
Não criptografe com uma senha — você usará sua chave privada para isso.
Salve o arquivo criptografado com um.gpg extensão

Envio de arquivo

O próximo passo é enviar seu arquivo criptografado — você pode usar qualquer ferramenta de conectividade SFTP. Certifique-se de selecionar SFTP como protocolo e inserir estes detalhes:

Servidor: s-b1b59c1d2afa43cba.server.transfer.us-west-2.amazonaws.com
Porta: 22
Nome de usuário: <partnername-username> (por exemplo, BestTravel-CRMteam ou BestTravel-Asmith)
Chave privada SSH: a chave privada que você gerou.

Você pode automatizar a frequência com que seus arquivos SFTP são enviados, dependendo das necessidades de negócios da sua organização.