Introdução ao Reconnect

O Reconnect é um app do Experience OS que permite que você envie mensagens personalizadas automaticamente aos usuários com base em seus comportamentos, criando campanhas multicanais e com gatilhos. Ao utilizar o Reconnect, você pode testar diferentes canais de mensagens e variações de conteúdo, para determinar a melhor campanha para cada segmento de usuário.

Antes de poder criar campanhas do Reconnect, Você deve concluir os passos a seguir. Tratam-se de passos técnicos, e um desenvolvedor pode ser necessário.

1. Relatando o estado atual do carrinho
2. Identificando os visitantes do site
3. Gerenciando usuários inscritos
4. Integrando com sua ESP
5. Monitorando suas notificações push

1. Relatando o estado atual do carrinho

Reporte à Dynamic Yield o estado do seu carrinho usando os eventos a seguir:

• Implemente eventos Add to Cart e Remove from Cart com os parâmetros do carrinho.
• Implemente um evento de Sync Cart State para relatar o estado mais recente do carrinho para cada usuário.

2. Identificando seus visitantes

Identifique os visitantes do site para associar um ID de usuário da Dynamic Yield para todos os visitantes (DYID) com um endereço de e-mail criptografado ou um ID externo, como um ID de cliente de múltiplos canais (CUID). 

Você pode identificar usuários usando qualquer um dos eventos de identificação: Login, Signup, Newsletter Subscription e Identify user.  

Note que, para o canal de SMS, os usuários devem ser identificados por endereço de e-mail/e-mail criptografado, e o número de telefone deve ser informado como um identificador secundário.

DY.API(“event”, {
  name: “Login”,
  properties: {
    dyType: “login-v1”,
    cuid: “[value]“,
    cuidType: “EcommerceID”
    phoneNumber: “+91743549524"
  }
});

DY.API(“event”, {
  name: “Login”,
  properties: {
    dyType: “login-v1”,
    hashedEmail: “56468465165468464546546546"
    phoneNumber: “+91743549524”
  }
});

3. Gerenciando usuários inscritos

Nem todos os usuários aceitam receber mensagens. Você precisar informar à Dynamic Yield quais usuários se inscreveram. Existem duas formas de fazer isso:

• Para os SMS, envie um feed: todos os dias, faça o upload de uma lista de endereços de e-mail ou números de telefone dos usuários que se inscreveram. Saiba mais sobre feeds de Endereços de e-mail de inscritos e Números de SMS de inscritos.
• Para notificações push, envie eventos no front-end: informe à Dynamic Yield sobre novos usuários que se inscreveram ou cancelaram sua inscrição em tempo real.
  • Mensagem para inscritos: marque endereços de e-mail e números de telefone de usuários individuais para que recebam mensagens automáticas. A lista de destinatários é gerenciada pela Dynamic Yield.
  • Mensagem para não inscritos: marque endereços de e-mail e números de telefone de usuários individuais para que não recebam e-mails automáticos.
  Parâmetros e código do evento de inscrição

  DYID, DYID_server e session dy são obrigatórios. Se o cookie _dyid existir, informe seu valor aqui. Caso contrário, se nem esse parâmetro nem o dyid_server forem informados, um novo ID de usuário será criado pela Dynamic Yield e retornado na resposta.

  https://dy-api.com/v2/collect/user/event (Datacenter nos EUA)

  https://dy-api.eu/v2/collect/user/event (Datacenter na União Europeia)

  {
  "user": {
  "dyid": "-4350463893986789401",
  "dyid_server": "-4350463893986789401"
  },
  "session": {
    "dy": "ohyr6v42l9zd4bpinnvp7urjjx9lrssw"
  },
    "events": [
      {
        "name": "Push Opt-In",
        "properties": {
          "dyType": "message-optin-v1",
          "pushID": "100"
        }
      }
    ]
  }

  Para sessões de API-type

  {
    "user": {
      "id": "john_123"
    },
    "sessionId": "iquahngaishe2koh",
    "events": [
      {
        "name": "Push Opt-In",
        "properties": {
          "dyType": "message-optin-v1",
          "pushID": "100"
        }
      }
    ]
  }

  Parâmetros e código do evento de recusa de inscrição

  DYID, DYID_server e session dy são obrigatórios. Se o cookie _dyid existir, informe seu valor aqui. Caso contrário, se nem esse parâmetro nem o dyid_server forem informados, um novo ID de usuário será criado pela Dynamic Yield e retornado na resposta.

  https://dy-api.com/v2/collect/user/event (Datacenter nos EUA)

  https://dy-api.eu/v2/collect/user/event (Datacenter na União Europeia)

  {
  "user": {
    "dyid": "-4350463893986789401",
    "dyid_server": "-4350463893986789401"
  },
  "session": {
    "dy": "ohyr6v42l9zd4bpinnvp7urjjx9lrssw"
  },
    "events": [
      {
        "name": "Push Opt-Out",
        "properties": {
          "dyType": "message-optout-v1",
          "pushID": "100"
        }
      }
    ]
  }

  Para sessões de API-type

  {
    "user": {
      "id": ""john_123"
    },
    "sessionId": "iquahngaishe2koh",
    "events": [
      {
        "name": "Push Opt-Out",
        "properties": {
          "dyType": "message-optout-v1",
          "pushID": "100"
        }
      }
    ]
  }

Note que, quando os feeds de SMS e e-mail inscritos estão sincronizados, eles se sobressaem a qualquer informação recebida previamente sobre ativação ou desativação de inscrição.

4. Integrando com seus mensageiros

Faça a integração com até 1 de cada um dos tipos de provedores de mensagens a seguir:

• Em breve! E-mail (ESP)
• SMS
• Notificações push

5. Monitorando notificações push

Salve os dados de conteúdo das notificações push

Quando você aplica a variável Push Tracking no conteúdo do JSON da mensagem push, ela será substituída, após o envio, por um objeto único. Os valores dos atributos são dinâmicos e únicos em cada notificação push.

Salve essas informações localmente, pois você precisará informá-las nas suas chamadas de API de engajamento. Veja o código de exemplo na seção a seguir.

Monitore a entrega e os cliques

Notifique a Dynamic Yield quanto à entrega de notificações push para propósitos de relatório e testes usando o terminal de engajamento.

{
"user": {
"dyid": "-4350463893986789401",
"dyid_server": "-4350463893986789401"
},
"session": {
     "dy": "ohyr6v42l9zd4bpinnvp7urjjx9lrssw"
},
 "engagements" [
    {
      "type": "PN_IMP",
      "trackingData": { "rri": "987001424", "sectionID": "9878785", "reqTs": 
         "1652622484055", "userID": "4656722918296846673", "version": "2", "events": 
         [ { "ver": "101482916", "expVisitId": "4032971100745578591", "smech": "", 
         "vars": [101098971], "exp": "1296028", "mech": "1" } ] }
    }
  ]
}

{
"user": {
"dyid": "-4350463893986789401",
"dyid_server": "-4350463893986789401"
},
"session": {
     "dy": "ohyr6v42l9zd4bpinnvp7urjjx9lrssw"
},
  "engagements": [
    {
      "type": "PN_CLICK",
      "trackingData": { "rri": "987001424", "sectionID": "9878785", "reqTs": 
         "1652622484055", "userID": "4656722918296846673", "version": "2", "events": 
         [ { "ver": "101482916", "expVisitId": "4032971100745578591", "smech": "", 
         "vars": [101098971], "exp": "1296028", "mech": "1" } ] }
    }
  ]
}