Guida introduttiva a Reconnect

Reconnect è un'app Experience OS che consente di inviare in automatico messaggi personalizzati agli utenti in base al loro comportamento, creando comunicazioni multicanale, attivate dalle campagne. Grazie a Reconnect, puoi testare diversi canali di messaggistica e varianti di contenuto per determinare la campagna ottimale per ciascun segmento di utenti.

Prima di poter creare delle campagne Reconnect, è necessario completare i seguenti passaggi. Questi passaggi sono tecnici e potrebbero richiedere l'intervento di uno sviluppatore.

1. Segnala lo stato aggiornato del carrello
2. Identifica i tuoi visitatori dal sito
3. Gestisci gli utenti che hanno acconsentito esplicitamente
4. Integra le attività con l'ESP
5. Tieni traccia delle tue notifiche push

1. Segnala lo stato aggiornato del carrello

Puoi segnalare a Dynamic Yield lo stato del tuo carrello utilizzando i seguenti eventi:

• implementando gli eventi Aggiungi al carrello e Rimuovi dal carrello con i parametri corrispondenti, 
• implementando un evento Sincronizza stato del carrrello per segnalare lo stato più aggiornato del carrello per ogni utente.

2. Identifica i tuoi visitatori 

Puoi identificare i visitatori del sito per associare un ID utente Dynamic Yield a tutti gli utenti (DYID) con un indirizzo e-mail con hash o un ID esterno come ID cliente cross-channel (CUID). 

Puoi identificare gli utenti utilizzando uno qualsiasi dei nostri eventi di identificazione: login, registrazione, iscrizione alla newsletter e identificazione dell'utente.  

Attenzione: per il canale SMS, gli utenti devono essere identificati tramite indirizzo e-mail/hash e il numero di telefono deve essere indicato come identificatore secondario.

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. Gestisci gli utenti che hanno acconsentito esplicitamente

Non tutti gli utenti acconsentono a ricevere messaggi. È necessario indicare a Dynamic Yield quali utenti hanno acconsentito. Ci sono due modi per farlo:

• per gli SMS, puoi caricare un feed: ogni giorno puoi caricare un elenco di indirizzi e-mail o numeri di telefono degli utenti che hanno aderito. Scopri di più sugli Indirizzi e-mail per cui hai il consenso e sui Numeri SMS per cui hai il consenso con i relativi feed.
• Per le notifiche push, puoi attivare gli eventi sul lato client: comunica a Dynamic Yield i nuovi utenti che aderiscono o rinunciano in tempo reale.
  • Consenso esplicito per i messaggi: contrassegna gli indirizzi email dei singoli utenti e i loro numeri di telefono che vogliono ricevere messaggi con attivazione. L'elenco dei destinatari è gestito da Dynamic Yield.
  • Rifiuto esplicito del consenso per i messaggi: contrassegnare gli indirizzi email dei singoli utenti e i numeri di telefono che non vogliono ricevere e-mail attivate. 
  Parametri e codice dell'evento di consenso esplicito

  DYID, DYID_server e session dy sono obbligatori. Se il cookie _dyid esiste, ne dovrai trasferire il valore qui. In caso contrario, se entrambi i parametri citati e dyid_server non vengono trasferiti, un nuovo ID utente verrà creato in Dynamic Yield e indicato nella risposta.

  https://dy-api.com/v2/collect/user/event (data center negli Stati Uniti)

  https://dy-api.eu/v2/collect/user/event (data center nell'UE)

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

  Per le sezioni di API-type

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

  Parametri e codice dell'evento di rifiuto esplicito

  DYID, DYID_server e session dy sono obbligatori. Se il cookie _dyid esiste, ne dovrai trasferire il valore qui. In caso contrario, se entrambi i parametri citati e dyid_server non vengono trasferiti, un nuovo ID utente verrà creato in Dynamic Yield e indicato nella risposta.

  https://dy-api.com/v2/collect/user/event (data center negli Stati Uniti)

  https://dy-api.eu/v2/collect/user/event (data center nell'UE)

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

  Per le sezioni di API-type

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

Tieni presente che quando si sincronizzano i feed e-mail e SMS ad attivazione, sostituiranno qualsiasi informazione di opt-in e opt-out ricevuta in precedenza.

4. Integrazione con i fornitori di messaggistica

Puoi eseguire l'integrazione al massimo con uno dei seguenti tipi di provider di messaggistica (1 per tipo):

• Presto disponibile! Email (ESP),
• SMS,
• Notifiche push.

5. Monitoraggio delle notifiche push

Salvare i dati dal payload delle notifiche push

Quando inserisci la variabile Push Tracking nel payload JSON del messaggio Push, verrà sostituita, al momento dell'invio, con un oggetto univoco. I valori degli attributi saranno dinamici e univoci in ogni notifica push.

Puoi salvare queste informazioni in locale, in quanto sarà necessario inserirle nelle chiamate API di coinvolgimento. Puoi usare il codice di esempio nella sezione seguente. 

Monitorare la pubblicazione e i clic

Puoi notificare a Dynamic Yield l'invio di notifiche push per la reportistica e il testing utilizzando un Endpoint di coinvolgimento.

{
"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" } ] }
    }
  ]
}