Documentación · v1

CAPA DE SEÑALES DE PIXORA ADS

Píxel de conversión.
Del clic al evento.

Instálelo una vez, mantenga visible la ruta desde el clic en el anuncio hasta la conversión y haga que sea fácil confiar en cada señal importante.

01crear02verificar03Instalar04prueba05Vincular campaña06Activar

Del clic a la primera conversión

Cree un píxel, verifique su dominio HTTPS, verifique los eventos de prueba y selecciónelo durante la creación de la campaña del sitio web o en su configuración.

01

Crea un píxel

Nómbrelo por producto, sitio o embudo.

02

Verificar el origen

Publique el archivo de token exacto en ese host a través de HTTPS.

03

Comprobar modo de prueba

Abra el sitio directamente e inspeccione PageView, ViewContent y Lead.

04

Vincular una campaña de sitio web

En Promocionar → Tráfico del sitio web, elija Píxel en el paso Audiencia; las campañas existentes tienen la misma configuración.

Para una verificación de atribución en vivo, abra el sitio mediante una visita de campaña al sitio web real. Esa transición crea px_click; una URL directa no. Ver el aterrizaje de demostración de LENTO.

Instala sin complicaciones

Usa el mismo SDK ligero en HTML, React, WordPress o una SPA y envía eventos desde los estados de éxito de tu aplicación.

Fragmento de instalación

Agrégalo una sola vez en head o en la plantilla. Las instalaciones nuevas esperan el consentimiento explícito para el análisis: llama a consent desde tu CMP, incluso antes de que se cargue el script asíncrono.

<script>
  window.PixorAdsPixel = window.PixorAdsPixel || { q: [] };
  window.PixorAdsPixel.track = window.PixorAdsPixel.track || function (name, options) {
    window.PixorAdsPixel.q.push([name, options]);
  };
  window.PixorAdsPixel.consent = window.PixorAdsPixel.consent || function (value) {
    window.PixorAdsPixel.q.push(["consent", value]);
  };
</script>
<script async data-consent="required" src="https://pixora-ads.com/sdk/pixorads-pixel.js?pixel_id=px_your_id"></script>
Conecte su administrador de consentimiento

Desconocido es el valor predeterminado. Una actualización denegada detiene la recopilación y elimina la atribución almacenada. Las instalaciones existentes mantienen su comportamiento hasta que usted opte por usar data-consent=required.

// Llame desde su devolución de llamada de consentimiento CMP real, nunca automáticamente:
function onAnalyticsConsentChanged(granted) {
  window.PixorAdsPixel.consent(granted ? "granted" : "denied");
}

Después del consentimiento, SDK envía PageView una vez y admite tanto px_click como px_tclick. Mantenga la clave del servidor fuera de esta página. Los orígenes del navegador en vivo deben coincidir con un host HTTPS verificado.

Un contrato en el que su equipo puede confiar

PageView, Lead, CompleteRegistration y Purchase comparten una forma, un eventId estable y un registro de eventos legible.

Envía tu primer evento

Envía Lead solo después de que tu servidor acepte la solicitud. Usa el mismo event_id estable tanto en el navegador como en el postback.

// After the lead request succeeds:
window.PixorAdsPixel.track("Lead", {
  eventId: acceptedLead.event_id,
});
PageViewPágina abierta; SDK lo envía automáticamente
ViewContentSe vio un producto
LeadEl servidor aceptó una solicitud.
PurchaseSe confirmó un pedido real.

Los eventos del navegador describen la actividad; no confirman una conversión de servidor ni cambian la facturación. No envíe Compra para una solicitud de demostración.

Análisis del navegador más prueba del servidor

El píxel muestra el embudo; un postback firmado con HMAC confirma las acciones objetivo para el análisis.

Confirma el resultado desde tu backend

El servidor firma los bytes exactos del JSON original: timestamp + punto + JSON original. Usa el event_id del navegador y consérvalo en cada reintento.

// Node.js 22+, YOUR SERVER. Keep the signing key out of the browser.
import { createHmac } from "node:crypto";

async function sendPixelEvent(event) {
  // Persist this event in your outbox after the real outcome, with its original
  // event_id and px_click (or px_tclick). Reuse the same body on retries.
  const raw = JSON.stringify(event);
  const timestamp = String(Math.floor(Date.now() / 1000));
  const signature = createHmac("sha256", process.env.PIXORADS_PIXEL_KEY)
    .update(timestamp + "." + raw).digest("hex");
  // Public px_... ID, not the internal UUID used in cabinet APIs.
  const pixelId = process.env.PIXORADS_PUBLIC_PIXEL_ID;
  const response = await fetch(
    "https://pixora-ads.com/api/v1/pixels/" + encodeURIComponent(pixelId) + "/postback",
    {
      method: "POST",
      redirect: "error",
      headers: {"Content-Type": "application/json",
        "X-PixorAds-Timestamp": timestamp,
        "X-PixorAds-Pixel-Signature": signature},
      body: raw,
      signal: AbortSignal.timeout(8000)
    }
  );
  if (!response.ok) throw new Error("Pixel postback HTTP " + response.status);
  const result = await response.json();
  // 2xx alone does not mean attribution: inspect status/mode/error_code.
  return result;
}

// Example persisted lead payload (replace with values from your backend):
// {event_id: "lead:123", event_name: "Lead", px_click: "<original click token>"}
// For a Purchase, optional value_minor and currency must be supplied together.
// RUB and XTR use 1000 internal units per unit; USD is not accepted here.
// Retry only transport/5xx/429 failures with bounded backoff. Generate a fresh
// timestamp/signature on each delivery, keeping the event_id and body unchanged.
Los eventos del navegador son análisis

Solo una devolución de datos del servidor firmada puede confirmar una acción objetivo para el análisis. No cambia la facturación. Utilice el mismo event_id para conectar ambas señales y vuelva a intentarlo de forma segura.

Envíe X-PixorAds-Timestamp y X-PixorAds-Pixel-Signature (HMAC-SHA256) desde su backend. Mantenga la clave de firma en el servidor.

Metrica y GA4 en el mismo embudo

Agregue conexiones separadas en la configuración de la campaña. El puente del sitio web lee identificadores de etiquetas reales después del consentimiento del visitante; Los secretos permanecen en el servidor Pixora Ads.

Sitio web o puente GTM

Copie el fragmento completo de su conexión. También funciona sin Pixel. Pueden coexistir múltiples conexiones; ningún token o API secreto pertenece a este código.

<script>
  window.PixorAdsAnalytics = window.PixorAdsAnalytics || {
    q: [],
    consent: function (value) { this.q.push(["consent", value]); }
  };
</script>
<script async src="https://pixora-ads.com/sdk/pixorads-analytics.js?connection_id=YOUR_PUBLIC_CONNECTION_ID"></script>

// Llama sólo desde tu CMP, nunca concedas automáticamente:
function onAnalyticsConsentChanged(granted) {
  window.PixorAdsAnalytics.consent(granted ? "granted" : "denied");
}

El puente utiliza ym(counter, 'getClientID', callback) y gtag('get', MeasurementID, 'client_id'/'session_id', callback). Espera hasta ocho segundos por las etiquetas existentes, omite las identificaciones no disponibles y nunca crea visitantes sustitutos. Las actualizaciones de consentimiento se comparten con un Pixel controlado por consentimiento.

Utilice la verificación de conexión en el panel: contador encontrado → visitante vinculado → solicitud validada → prueba enviada. La validación GA4 es distinta de la entrega y no garantiza la visibilidad en los informes. Los valores de compra y los ID de pedidos estables deben provenir de su backend. Métrica API · Etiqueta de Google API.

Cuando una señal no es verde

El diario muestra los últimos 40 eventos con event_id, fuente, modo, campaña y error_code. Lea esos campos antes de volver a intentarlo.

pruebarecibidoatribuidoduplicarincomparablerechazado

La prueba se almacena sin atribución. recibido se acepta sin una conversión analítica confirmada. atribuido coincidió con un clic; una fila del navegador sigue siendo una señal de actividad, mientras que una devolución de datos firmada del servidor confirma una conversión para análisis sin cambiar la facturación. duplicado no creó otro resultado. inigualable necesita un px_click válido y una campaña coincidente. rechazado falló una regla o entró en conflicto con otro evento.

Si no aparece ninguna fila, inspeccione la respuesta de la red: un dominio de navegador no verificado, un píxel en pausa o una firma no válida se pueden rechazar antes de iniciar sesión.

PRÓXIMA SEÑAL

¿Listo para ver el embudo completo?

Cree un píxel, ejecute el flujo de prueba y conéctelo a una campaña cuando la señal esté en buen estado.

Espacio de trabajo abierto