1.1 Conceptos Importantes

Transcripción

1

2 2 1. Índice 1.1 Conceptos Importantes 2. Ejemplo Implementación- Preparación 2.1 Guardar ce_cid y preparar para envío 2.2 Preparar URL S2S y llamar al servidor de Matomy 3. Información Adicional

3 3 1.1 Conceptos Importantes 1. ce_cid = esta variable contiene un valor único alfanumérico que representa el id del clic que se le dio al banner que redirigió al usuario a nuestra campaña. Este valor llega a la Landing page dentro de la URL. Gracias a este valor sabemos que la gente llego a la Landing Page a través de una de nuestras campañas y nuestros materiales multimedia. 2. visitor_cid = variable donde tenemos que agregar el valor de la variable ce_cid, para después ser enviado a nuestro servidor. Este valor es el que le indica a nuestra plataforma que campaña es y genera la conversión exitosa. 3. program_id = contiene el id de su campaña en nuestra plataforma y por lo general debe de venir ya llenado, si no es así hable con su Account Manager para que les indique este valor y se pueda agregar. 4. p1 = Esta variable es opcional pero se recomienda llenarla, esta variable será el id único de nuestro registro. Para llenar esta variable se debe de crear un id alfanumérico único por cada registro nuevo.

4 4 2. Ejemplo implementación Preparación El proceso para implementar un server to server es simple y consta de 4 simples pasos: 1. Guardar la información del ce_cid que se encuentra en nuestra URL. 2. Enviarla a nuestro archivo encargado de conectarse con el servidor. 3. Recibir la información e ingresarla a la URL del server to server. 4. Hacer la llamada al servidor Esta es la carpeta de mi campaña, como pueden ver esta incluye: La página principal de la Landing Page (index.html) Hoja de estilos CSS (styles.css) Mi archivo de conectividad con el servidor (connect.php) Mi Thank You page (thankyou.html) Lo primero que debemos hacer es asegurarnos que podamos usar php en nuestra landing page por lo que se debe de cambiar la extensión de.html a.php. Una vez hecho esto tan simple podemos comenzar a implementar el server to server.

5 5 2.1 Guardar ce_cid y preparar para envío Al dar clic a uno de los banner de la campaña el usuario será redirigido a nuestra página, al llegar a la Landing page podemos ver la URL del sitio con información adicional de la campaña. Un ejemplo sería: Lo que está en letras negras es la información adicional de su campaña y como pueden ver aquí se encuentra la variable de ce_cid que necesitamos. A continuación tomaremos esta variable y la agregaremos en la forma de envío del registro para que de esta manera se guarde el valor y se envié a nuestro archivo encargado de comunicarse con el servidor. Esta es una forma muy simple que e encarga de captar el nombre y teléfono de nuestro usuario y enviarlo a nuestro archivo connect.php. Para guardar el valor de ce_cid y poder enviarlo necesitamos agregar la siguiente línea a la forma (de preferencia antes de el <input type= image ) <input type="hidden" name="ce_cid" value="<?php echo($_get['ce_cid']);?>" /> Esta línea de HTML se encargará de agregar un valor extra llamado ce_cid a nuestra forma, se auto llenará con el valor de ce_cid que se encuentra en la URL gracias al código de php, y estará escondida del usuario. Aquí podemos ver como el valor se ha agregado sólo una vez que se carga la página: Ahora una vez que se envíe la información al archivo php, también se enviará el valor del clic (ce_cid) junto con la información del usuario.

6 6 2.2 Preparar URL S2S y llamar al servidor de Matomy La siguiente parte para implementar el server to server debe de hacerse una vez que ya se haya manejado la información del usuario (guardarla en base de datos, enviarla por mail, etc), ya que de esta manera se puede poner una condición para evitar que se dispare el pixel si la información fue incorrecta o se encontraba incompleta. Crear el valor para p1 El valor de este id es alfanumérico por lo que puede constar de números, letras y caracteres ($%&/) Nuestra recomendación para crear este id único es llamar una función de php que la hará por ustedes y guardarla por el momento en una variable de php. $idunico = uniqid(); Así de sencillo hemos creado un valor único para nuestro registro. Preparar URL para ser enviada Antes de hacer el llamado de servidor a servidor debemos de agregar el p1 y el ce_cid a nuestra URL del servidor, para esto se debe de hacer lo siguiente (si se envió por GET, entonces donde dice POST debe de cambiarse por la palabra GET): $url = " cid]."&p1=".$idunico; Lo que hicimos fue básicamente agregarle a la URL el valor de ce_cid que enviamos de la landing page a este documento, más el valor de p1 que agregamos anteriormente.

7 7 Llamada al servidor Ahora solo queda llamar a nuestro servidor, para ello usaremos una función muy simple de php de la siguiente manera. $answer = file_get_contents($url); Con esta función se hace el llamado a nuestro servidor y la conversión a sido tomada. Si hay algún error podríamos analizar la variable $answer para ver la respuesta que dio el servidor (la explicación del significado de cada respuesta puede ser vista en el otro manual)

8 8 3. Información Adicional Este manual sirve como complemento del Manual Server 2 Server, para encontrar conceptos específicos, variables adicionales e información de códigos de errores revisar el primer manual. Si requieres de mayor asistencia para la implementación del server to server comunícate con tu Account Manager, si es necesario lo comunicaremos con nuestra área de Diseño y Programación. La llamada que se utilizó para comunicarse con el servidor es sólo una de las maneras que se puede hacer esto, existen otros métodos como curl; Éste método fue seleccionado ya que no requiere instalación adicional de programas en tu servidor y funciona a partir de la versión 4 de PHP. Para mayor información sobre este métodos puede consultar: W3Schools file_get_content function() PHP Manual file_get_content