Pasos para usar la herramienta de Código de sincronización de DataCrush.

Muchas veces existe la necesidad de importar a DataCrush contactos que se generan en formularios no creados desde la plataforma.

Para el uso de esta herramienta debemos seleccionar qué propiedades del contacto vamos a utilizar para enviar la información desde nuestro sitio web.

Los pasos a seguir para la creación de un código de sincronización son:

1. Acceder a la herramienta Sincronización desde el menú Herramientas.
   
2. Crear un nombre para el evento Sincro.
   
3. En el caso de ser necesario, podremos asociar este código de sincronización a una campaña existente o bien, crear una nueva desde aquí y asociarlo.
   
4. Seleccionar las propiedades del contacto que serán utilizadas para enviar los datos hacia Datacrush.
5. Clickear en el botón Obtener código Sincro.
6. Copiar el código javascript que genera la plataforma. Este código debe ser adaptado a las necesidades de uso para el envío de los datos desde el sitio web.

¿Cómo utilizar el código de sincronización en mi sitio web?

El código de sincronización constan de dos partes. La primera hace referencia a los datos que van a ser enviados hacia DataCrush, estos datos corresponden a las propiedades del contacto en DataCrush, y deben ser completadas con la información del contacto que se desea enviar.

var dcDataContact = {
"first_name": "Juan",
"last_name": "Gutierrez",
"email": "juan.gutierrez@dominio.com",
};

Existen varias maneras de realizar esta operación y depende de cómo se encuentra desarrollado mi sitio web.

1) Generar los datos desde el servidor: Esta opción implica que los datos se generan utilizando variables que contengan los valores, el código de sincronización debe encontrarse dentro del código HTML y se debe imprimir las variables correspondientes.

Este es un ejemplo utilizando como lenguaje de programación PHP.

var dcDataContact = {
"first_name": "<?php echo $first_name?>",
"last_name": "<?php echo $last_name?>",
"email": "<?php echo $email?>",
};

Esta forma de incorporar el código de sincronización generalmente es utilizada en las páginas de "thank you page", en donde los datos ya se recibieron desde un formulario.

2) Generar los datos desde variables de javascript: Esta opción se utiliza por medio de código javascript, en donde los valores a ser enviados son tomados de variables globales o cargadas a partir del contenido de un elemento del formulario.

var_first_name = "Juan";
var_first_name = "Gutierrez";
var_first_name = "juan.gutierrez@dominio.com";

var dcDataContact = {
"first_name": var_first_name,
"last_name":var_last_name,
"email": var_email,
};

var first_name = document.getElementById("first_name").value;
var last_name =document.getElementById("last_name").value;
var email =document.getElementById("email").value;

var dcDataContact = {
"first_name": first_name,
"last_name": last_name,
"email":  email,
};

La segunda parte del código de sincronización corresponde al método de envío de los datos hacia Datacrush. Este código es generado por DataCrush y no debe ser alterado.

(function(d,s,i,r) {
if (d.getElementById(i)){return;}
var n=d.createElement(s),e=d.getElementsByTagName(s)[0];
n.id=i;n.src='//tr.datacrush.la/synchro/synchro.js?'+(Math.ceil(new Date()/r)*r);
e.parentNode.insertBefore(n, e);
})(document,"script","synchro",300000);

var dcDataSynchro = {portalID: 'MI ID DE PORTAL',synchroKey: 'MI CÓDIGO DE SINCRONIZACIÓN'};

‼️ IMPORTANTE: Una vez personalizado el código de sincronización con los datos a ser enviados debe ser colocado en el sitio web.

<!-- Start of Async DataCrush Synchro Code -->
var_first_name = "Juan";
var_first_name = "Gutierrez";
var_first_name = "juan.gutierrez@dominio.com";

var dcDataContact = {
"first_name": var_first_name,
"last_name":var_last_name,
"email": var_email,
};

(function(d,s,i,r) {
if (d.getElementById(i)){return;}
var n=d.createElement(s),e=d.getElementsByTagName(s)[0];
n.id=i;n.src='//tr.datacrush.la/synchro/synchro.js?'+(Math.ceil(new Date()/r)*r);
e.parentNode.insertBefore(n, e);
})(document,"script","synchro",300000);

var dcDataSynchro = {portalID: 'MI ID DE PORTAL',synchroKey: 'MI CÓDIGO DE SINCRONIZACIÓN'};

</script>
<!-- End of Async DataCrush Synchro Code -->

¿Cómo ejecutar el código de sincronización desde funciones de programación?

Sí el código de sincronización debe ser ejecutado desde dentro de funciones de Javascript, se deben realizar los siguientes pasos:

1) Colocar dentro de mi código html la función principal de sincronización. Esto nos va a permitir que las funciones de DataCrush se encuentran listas para ser utilizadas desde dentro de mis funciones de javascript.

<script>
(function(d,s,i,r) {
if (d.getElementById(i)){return;}
var n=d.createElement(s),e=d.getElementsByTagName(s)[0];
n.id=i;n.src='//tr.datacrush.la/synchro/synchro.js?'+(Math.ceil(new Date()/r)*r);
e.parentNode.insertBefore(n, e);
})(document,"script","synchro",300000);
</script>

2) Dentro de la función en donde se desea ejecutar el envío de los datos hacia DataCrush, colocar la asignación de propiedades del contacto mencionados en los puntos anteriores.

function mi_funcion() {
var first_name = document.getElementById("first_name").value;
var last_name =document.getElementById("last_name").value;
var email = document.getElementById("email").value;

var dcDataContact = {
"first_name": first_name,
"last_name": last_name,
"email": email,
};
var dcDataSynchro = {portalID: 'MI ID DE PORTAL',synchroKey: 'MI CÓDIGO DE SINCRONIZACIÓN'};

dcS.synchro.init(dcDataSynchro, dcDataContact);
}

3) Si es necesario que la ejecución de la función utilizada no continúe hasta que los datos hayan sido enviados, se puede incorporar una llamada a una función de Javascript para que sea ejecutada una vez finalizado el envío de los datos.

function mi_funcion() {
var first_name = document.getElementById("first_name").value;
var last_name =document.getElementById("last_name").value;
var email = document.getElementById("email").value;

var dcDataContact = {
"first_name": first_name,
"last_name": last_name,
"email": email,
};

var dcDataSynchro = {portalID: 'MI ID DE PORTAL',synchroKey: 'MI CÓDIGO DE SINCRONIZACIÓN'};

dcS.synchro.init(dcDataSynchro, dcDataContact, mi_funcion_finalizar);

}

function mi_funcion_finalizar() {
alert("gracias");
}

 
Acá pueden visualizar el ejemplo completo:
 
<!-- Start of Async DataCrush Synchro Code -->
<script>

(function(d,s,i,r) {
if (d.getElementById(i)){return;}
var n=d.createElement(s),e=d.getElementsByTagName(s)[0];
n.id=i;n.src='//tr.datacrush.la/synchro/synchro.js?'+(Math.ceil(new Date()/r)*r);
e.parentNode.insertBefore(n, e);
})(document,"script","synchro",300000);
function mi_funcion() {

var first_name = document.getElementById("first_name").value;
var last_name =document.getElementById("last_name").value;
var email = document.getElementById("email").value;

var dcDataContact = {
"first_name": first_name,
"last_name": last_name,
"email": email,
};

var dcDataSynchro = {portalID: 'MI ID DE PORTAL',synchroKey: 'MI CÓDIGO DE SINCRONIZACIÓN'};

dcS.synchro.init(dcDataSynchro, dcDataContact, mi_funcion_finalizar);
}

function mi_funcion_finalizar() {
alert("gracias");
}

</script>
<!-- End of Async DataCrush Synchro Code -->