Acceder a los datos de campaña de Personyze en el lado del cliente

Cuando una campaña de Personyze se muestra en la página, expone su identidad mediante variables globales de JavaScript. Puede leerlas para enviar el contexto de la campaña y de la acción a su plataforma de analítica, depurar qué variación está viendo un usuario o activar lógica personalizada cuando se ejecuta una campaña concreta.

Variables disponibles

Cuándo están disponibles

Las variables se definen después de que Personyze termine de evaluar las audiencias y de mostrar la acción ganadora. Leerlas en la carga inicial de la página — antes de que Personyze haya terminado — devuelve undefined. Dos patrones fiables:

Esperar al hook ready de Personyze

(window.personyze = window.personyze || []).push(['ready', function() {
  console.log('Campaign:',   window.personyzeCampaign);
  console.log('Action:',     window.personyzeAction);
  console.log('Group:',      window.personyzeActiongroup);
  console.log('Campaign ID:', window.personyzeCampaignId);
  console.log('Action ID:',   window.personyzeActionId);
}]);

O comprobarlo tras un breve retraso

setTimeout(function() {
  if (window.personyzeCampaign) {
    // campaign rendered
  }
}, 500);

Casos de uso habituales

Enviar a Google Analytics o GTM

(window.personyze = window.personyze || []).push(['ready', function() {
  if (!window.personyzeCampaign) return;
  // GA4 example
  gtag('event', 'personyze_campaign_view', {
    campaign_name: window.personyzeCampaign,
    action_name:   window.personyzeAction,
    campaign_id:   window.personyzeCampaignId,
  });
}]);

Atribución de conversiones personalizada

// On purchase, record which Personyze campaign the user saw
function trackPurchase(orderId) {
  myAnalytics.send('purchase', {
    order_id:           orderId,
    personyze_campaign: window.personyzeCampaign || null,
    personyze_action:   window.personyzeAction || null,
  });
}

Depuración

En la consola del navegador, en cualquier página donde debería estar ejecutándose una campaña de Personyze, escriba cualquiera de los nombres de variable. Si los valores están vacíos o son undefined, la campaña no ha coincidido — revise la segmentación de la audiencia en el paso QA del asistente.