Troca de dados SFTP

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

Etapas para configuração do one-time

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

Etapa 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 de modelo.
tpid: O ID do produto de viagem que, juntamente com eapid, define um ponto de venda no sistema Expedia.
eapid: O ID do parceiro afiliado da Expedia, que, juntamente com tpid, define um ponto de venda no sistema Expedia.

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

Etapa 2: Crie suas chaves

Use seu método preferido para gerar a chave pública e privada para configuração de SFTP e criptografia de arquivos.

Usando terminal (MacOS X) ou 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 seu departamento de TI para garantir que você tenha permissão suficiente para executá-lo.
Quando solicitado, deixe a solicitação de 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.
Use o gerador para criar um par de chaves pública/privada RSA.
Copie a chave pública, que começa com ssh-rsa. Isto é o que você enviará para Expedia Group.
Salve a chave privada em um local seguro. Não o exclua — você o usará em vez de uma senha sempre que enviar o arquivo criptografado.

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

Etapa 3: compartilhe sua chave com a Expedia

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

Importante

O Expedia usa SharePoint como um repositório de chaves seguro. Se sua organização bloquear o acesso a SharePoint, você também poderá enviar a chave pública por e-mail seguro. Fale com seu gerente de conta se isso for um problema para você.

Envie-nos o nome da sua organização e o endereço de e-mail do qual você fará o upload da chave SFTP pública via SharePoint. O gerente de lançamento da Expedia fornecerá 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 fornecido. Também carregaremos nossa chave pública que é usada para criptografar o arquivo antes do upload.
Depois de 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 se o código de acesso não aparecer na sua caixa de entrada em até 2 dias úteis.)
Você carregará a chave pública gerada na 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 carregar com sucesso os arquivos de dados do CRM, eles devem atender aos seguintes critérios.

O formato do arquivo deve ser .csvpara começar. Ao criptografar o arquivo, você alterará a extensão do arquivo para .gpg.
Use barras verticais (|), não vírgulas, para delimitar 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; 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 ter todas as colunas da tabela abaixo, em ordem, 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`	Sinalizador de registro Marketing-eligible; a decisão do cliente de optar por (SIM) ou não (NÃO) pelo marketing por e-mail	Sim	Varchar	Sim
`mer_timestamp`	Carimbo 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 exclusivo 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 em que 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 para a transação	Cartão YourBrand	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 usados para compartilhar informações adicionais sobre o cliente	Viajante frequente	Varchar (máximo de 25 caracteres)	—

Conteúdo de arquivo CSV de exemplo

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

Conexão e upload SFTP

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

Criptografia

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

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

Upload de arquivo

O próximo passo é carregar seu arquivo criptografado — você pode usar qualquer ferramenta de conectividade SFTP. Certifique-se de selecionar SFTP como protocolo e insira 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 carregados dependendo das necessidades comerciais da sua organização.