Integración con analíticas

Es importante saber cómo interactuan los usuarios con tu página y desde dónde contactan más por WhatsApp. Para eso Joinchat reconoce automáticamente si están presentes en tu sitio Google Analytics, Google Tag Manager y Facebook Pixel y envía un evento con toda la información disponible cuando el usuario lanza WhatsApp.

Google Analytics

Es compatible con Global Site Tag (gtag.js) y Universal Analtics (analytics.js).

Si se detecta Universal Analytics se enviará el evento personalizado "JoinChat":

// Universal Analytics JoinChat event
ga('send', 'event', 'JoinChat', 'whatsapp: 99999999999', destination_url);

Si se detecta Google Analytics 4 se enviará el evento recomendado "generate_lead":
🌟 En versiones anteriores a la 4.4 se enviaba el evento «JoinChat» igual que en UA.

// GA4 generate_lead event
gtag('event', 'generate_lead', {
  event_category: 'JoinChat',
  event_action: 'whatsapp: 99999999999',
  event_label: destination_url,
  chat_channel: 'whatsapp',
  chat_id: '99999999999',
  is_mobile: 'yes' | 'no',
});

Si el objeto global de Universal Analytics no usa el nombre por defecto ‘ga’, a través del filtro PHP 'joinchat_get_settings' puedes pasar el parámetro ‘ga_tracker’ con el nombre personalizado.
🌟 Desde la versión 4.1.5 es compatible con el plugin de MonsterInsights que usa el objeto global ‘__gaTracker’.
🌟 Desde la versión 4.5.10 se puede personalizar el evento de GA4 y usar otro distinto a "generate_lead".

add_filter( 'joinchat_get_settings', function( $settings ){
  $settings['ga_tracker'] = 'my_custom_GA_name';
  $settings['ga_event'] = 'my_GA4_event';
  return $settings;
} );

Google Tag Manager

Si se detecta GTM se lanzará un evento personalizado "JoinChat" con los siguientes parámetros:

// GTM JoinChat event
dataLayer.push({
  event: 'JoinChat',
  event_action: 'whatsapp: 99999999999',
  event_label: destination_url,
  chat_channel: 'whatsapp',
  chat_id: '99999999999',
  is_mobile: 'yes' | 'no',
  page_location: current_url,
  page_title: page_title,
});

Si tu sitio no utiliza el nombre estándar para la capa de datos (‘dataLayer’) puedes establecer tu nombre personalizado con este filtro:

add_filter( 'joinchat_get_settings', function( $settings ){
  $settings['data_layer'] = 'dataLayerCustom';
  return $settings;
} );

Google Ads

Desde la versión 4.4 puedes configurar una conversión de Google Ads directamemte desde los ajustes de Joinchat. Solo debes indicar el Identificador de conversión y la Etiqueta de conversión previamente definida en tu panel de Google Ads.

Píxel de Facebook

Si se detecta Facebook Pixel se envía un «Custom Event» con el nombre "JoinChat" y los parámetros:

// Facebook Pixel JoinChat event
fbq('trackCustom', 'JoinChat', {
  event_action: 'whatsapp: 99999999999',
  event_label: destination_url,
  chat_channel: 'whatsapp',
  chat_id: '99999999999',
  is_mobile: 'yes' | 'no',
  page_location: current_url,
  page_title: page_title,
}); 

Presonalización / Otras integraciones

Joinchat dispara el evento 'joinchat:event' antes de lanzar los eventos de analíticas y antes de abrir WhatsApp. Éste puede usarse para añadir un código personalizado de seguimiento (u otras necesidades).

El evento envía un array con los parámetros de los eventos que se enviarán a las distintas plataformas. Se pueden añadir nuevos parámetros, modificarlos o eliminar algunos.

// Parámetros por defecto de Joinchat
{
  event_category: 'JoinChat', // Name
  event_label: 'https://wa.me/999...', // Destination url
  event_action: 'whatsapp: 999999', // "chanel: id"
  chat_channel: 'whatsapp', // Channel name
  chat_id: '999999', // Contact (phone, username...)
  is_mobile: 'yes' | 'no',
  page_location: location.href,
  page_title: document.title || 'no title',
}

Ejemplo, enviar webhook a Zapier:

// Send webhook to Zapier
jQuery(document).on('joinchat:event', function (event, params) {
  jQuery.post('https://hooks.zapier.com/hooks/catch/123456/xxxxxx/', params );
});

Ejemplo, añadir un parámetro para diferenciar usuarios logueados:

// Add custom param "user_logged"
jQuery(document).on('joinchat:event', function (event, params) {
  params.user_logged = jQuery('body').hasClass('logged-in') ? 'yes' : 'no';
});

El evento también puede cancelarse si se devuelve false, por ejemplo para desactivar analytics para usuarios logeados:

// Cancel analytics events if user is logged
jQuery(document).on('joinchat:event', function (event, params) {
  if (document.body.classList.contains('logged-in')) return false;
});