Crea un píxel
Nómbrelo por producto, sitio o embudo.
CAPA DE SEÑALES DE PIXORA ADS
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.
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.
Nómbrelo por producto, sitio o embudo.
Publique el archivo de token exacto en ese host a través de HTTPS.
Abra el sitio directamente e inspeccione PageView, ViewContent y Lead.
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.
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.
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>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.
PageView, Lead, CompleteRegistration y Purchase comparten una forma, un eventId estable y un registro de eventos legible.
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,
});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.
El píxel muestra el embudo; un postback firmado con HMAC confirma las acciones objetivo para el análisis.
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.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.
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.
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.
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.
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
Cree un píxel, ejecute el flujo de prueba y conéctelo a una campaña cuando la señal esté en buen estado.