Nota de aplicación

Anunciantes: Consejos para la integración de los tags Reactivpub en osCommerce Versión 1.0.2

Introducción Objeto Reactivpub, plataforma de afiliación basada en la tecnología R-ADServer desarrollada por la sociedad R, permite que los afiliados (o difusores) se pongan en contacto: portales de Internet que deseen rentabilizar su espacio publicitario), y portales de anunciantes que deseen vender o promover sus productos. Existen diferentes modelos técnicos y económicos de difusión publicitaria, que difieren entre sí principalmente a nivel de su implantación. El presente documento expone las recomendaciones técnicas de R acerca de la integración de los marcadores (o tags) de la plataforma de difusión de Reactivpub en el marco de las campañas de publicidad de tipo venta, para un portal ubicado en osCommerce 2.2-MS2 o en osCommerce 2.2RCA.

¿A quién va dirigido este documento? El presente documento se dirige a los webmasters, administradores o programadores que deseen utilizar la tecnología de Reactivpub en su portal de Internet implantado en osCommerce.

Advertencias Como osCommerce constituye un producto que Vd. puede haber modificado y adaptado a sus propias necesidades, le aconsejamos que: -

realice copias de seguridad de los archivos implicados por los cambios descritos en el presente documento,

-

realice dichos cambios primeramente en una plataforma de desarrollo, con vistas a comprobar su funcionamiento correcto en su configuración, antes de pasarlos a la producción.

Pese a todos los cuidados consagrados a su comprobación, este documento puede incluir determinados errores. Le invitamos a enviarnos cualquier observación o comentario a la dirección [email protected]. La información incluida en este documento podrá ser modificada sin previo aviso.

Anunciantes : consejos para la integración de los tags Reactivpub en osCommerce

2

Principio Aspectos generales El dispositivo de trazabilidad Reactivpub es compatible con las soluciones principales de pago del mercado. En el portal del anunciante, se deberán incluir dos tags: un tag para marcar la transacción (lead o venta) y un tag para validar dicha transacción.

Tag de marcado de la transacción: tracking.php El recurso a este primer tag debe implantarse antes de acudir al dispositivo de pago, en la primera página Web visualizada por el visitante (por ejemplo, en la página de confirmación del pedido). La forma general de dicho tag es la siguiente:

Anunciantes : consejos para la integración de los tags Reactivpub en osCommerce

3

Tag de validación de la transacción: tracking_transaction.php El recurso a este segundo tag debe realizarse en un script PHP del portal, una vez que se haya realizado el pago. Por ejemplo, el recurso puede realizarse en el script de validación del pedido solicitado por el dispositivo de pago, o en un script encargado del envío de un correo electrónico de confirmación del pedido. A diferencia del primer tag, el recurso a dicho tag puede realizarse fuera de cualquier navegador. La forma general de dicho tag es la siguiente: http://nodes.reactivpub.fr/scripts/tracking_transaction.php? params=P1|P2&id_transaction=P3 Los parámetros P1, P2 y P3 deben tener los mismos valores que cuando se acuda a tracking.php. Importante: todos los parámetros (P1 a P3) deberán indicarse cuando acuda a tracking_transaction.php.

Por ejemplo: http://nodes.reactivpub.fr/scripts/tracking_transaction.php? params=123|4567&id_transaction=ABCDE12345Z Observaciones: -

el recurso al tag tracking_transaction.php conlleva el registro de la transacción en el estado “en espera” en su interfaz de administración Reactivpub. Por lo tanto, podrá aceptarla o rechazarla definitivamente.

-

El recurso al tag tracking_transaction.php tan sólo debe realizarse cuando se haya aceptado el pago. En caso contrario, este tag no deberá ser solicitado.

Anunciantes : consejos para la integración de los tags Reactivpub en osCommerce

4

Integración de los tags Etapa 1: colocación del tag tracking.php En el script “catalog\checkout_confirmation.php”, coloque el código siguiente justo antes de la etiqueta (en la parte inferior del script, hacia la línea 380) cuidando en sustituir los valores de los parámetros P1 y P2 por los correspondientes a su campaña: Nota: este código determina el valor del parámetro P3 (id_transaction) como la concatenación del ID de la sesión PHP del visitante y la fecha actual.

Anunciantes : consejos para la integración de los tags Reactivpub en osCommerce

5

Etapa 2: método “order_total ->total()” Edite el script “catalog\includes\classes\order_total.php” e introduzca el código siguiente al final del archivo, justo antes del corchete que cierra la definición de la clase order_total , es decir antes de: } ?>

Código a introducir: // // Function order_total->total() // Input : // Output : order total price // // Reactivpub – 1.0.0 // function total() { $reac_tot = 0; if (is_array($this->modules)) { reset($this->modules); if ($GLOBALS['ot_shipping']->enabled) { // Récupération des frais $size = sizeof($GLOBALS['ot_shipping']->output); for ($i=0; $ioutput[$i]['value']; } } if ($GLOBALS['ot_tax']->enabled) { // Récupération des taxes $size = sizeof($GLOBALS['ot_tax']->output); for ($i=0; $ioutput[$i]['value']; } } if ($GLOBALS['ot_subtotal']->enabled) { // Récupération du sous total $size = sizeof($GLOBALS['ot_subtotal']->output); for ($i=0; $ioutput[$i]['value']; } } } return $reac_tot; }

Anunciantes : consejos para la integración de los tags Reactivpub en osCommerce

6

Etapa 3: colocación del tag tracking_transaction.php Edite el archivo “catalog\checkout_process.php” y añada el código siguiente, en la parte superior del script, y justo por debajo de la 1ª instrucción “incluye” (hacia la línea 13): // Get session ID and date $reac_date = $_SESSION["date"]; $reac_session_id = tep_session_id($sessid); $reac_session_id .= "-".$reac_date; // Cleaning $reac_session_id = str_replace(" ", "", $reac_session_id); $reac_session_id = str_replace("/", "", $reac_session_id); $reac_session_id = str_replace(";", "", $reac_session_id); // Build second tag (server to server tag) // (Warning : replace P1 P2 with campaign specific IDs // given by Reactivpub) $reac_url = "http://nodes.reactivpub.fr/scripts/"; $reac_url .= "tracking_transaction.php?"; $reac_url .= "params=P1|P2"; $reac_url .= "&id_transaction=". $reac_session_id; // Call Reactivpub tag file($reac_url); tep_session_unregister('orders_total'); tep_session_unregister('orders_id'); Nota: la instrucción “file(..)” tan sólo funciona con una URL cuando la opción PHP “fopen wrappers” haya sido activada (php.ini: allow_url_fopen = On). Acuda a http://fr.php.net/manual/es/function.fopen.php para obtener más información al respecto.

Anunciantes : consejos para la integración de los tags Reactivpub en osCommerce

7

Fin de la operación Pruebas y validación Una vez realizados los cambios, deberá realizar algunas transacciones de prueba, como por ejemplo: -

Añada productos a la cesta, confirme el pedido, y a continuación, realice un pago que será aceptado .

-

Añada productos a la cesta, confirme el pedido, y a continuación, realice un pago que será rechazado .

Cuide en anotar, para cada transacción, el importe del pedido y la dirección de correo electrónico utilizada. Durante estas pruebas, no deberá aparecer ningún error ni advertencia de PHP o Javascript. A continuación, conéctese a la interfaz de administración de Reactivpub, y compruebe que las transacciones de pruebas para las cuales ha sido aceptado el pago aparecen correctamente en la lista de transacciones a esperas de validación. Así pues, podrá rechazarlas para hacer que desaparezcan de la lista. Tenga en cuenta que las transacciones de pruebas pueden tardar un poco en aparecer en la lista de transacciones a validar. SI lo desea, póngase en contacto con su gestor de cuenta con vistas a que compruebe en su lugar, si las transacciones se han registrado correctamente.

Anunciantes : consejos para la integración de los tags Reactivpub en osCommerce

8