0% encontró este documento útil (0 votos)
200 vistas21 páginas

Guía API de Conversiones para Devs

Cargado por

José Reyes
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como PDF, TXT o lee en línea desde Scribd
0% encontró este documento útil (0 votos)
200 vistas21 páginas

Guía API de Conversiones para Devs

Cargado por

José Reyes
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como PDF, TXT o lee en línea desde Scribd

API de conversiones:

Manual sobre
integración
directa para
desarrolladores
Introducción
La API de conversiones es una herramienta empresarial
de Facebook que te permite compartir eventos web y
offline clave, o acciones de los clientes, directamente
desde tu servidor al de Facebook. Trabaja en conjunto
con el píxel de Facebook para ayudar a mejorar el
rendimiento y la medición de tus campañas publicitarias Tabla de contenidos
de Facebook.
Preparación p. 2

La integración directa de la API de conversiones es una Implementar la API p. 4


excelente opción para las empresas que cuentan con Enviar eventos p. 5
recursos para desarrolladores, tienen acceso a la base de Agregar parámetros a los eventos p. 6
código del servidor, y necesitan personalizar su
Probar eventos p. 9
configuración y controlar qué datos comparten con
Verificar eventos p. 10
Facebook y cuándo lo hacen.
Solución de problemas y configuración óptima p. 12
Como alternativa, las empresas que necesitan Glosario y recursos adicionales p. 19
configuraciones más rápidas y sencillas de la API de
conversiones suelen recurrir a socios comerciales de
Facebook que ofrecen la API de conversiones, entre
otras tantas soluciones empresariales consolidadas.

Obtén más información para comparar estas dos


opciones de integración en el servicio de ayuda de
Facebook para empresas.
API de conversiones: 2
Manual sobre integración directa

1. Preparación
Antes de iniciar la integración directa de la API de conversiones, necesitarás un píxel de Facebook,
el administrador comercial y un token de acceso.

Píxel de Facebook Administrador comercial

• Comprueba que el píxel de Facebook se haya • Para usar la API de conversiones, necesitas una
implementado correctamente en tu sitio web. cuenta del administrador comercial.

• Te recomendamos que uses el mismo píxel • El administrador comercial es una herramienta


para los eventos del navegador y del servidor. de Facebook con la que puedes organizar y
administrar tu empresa.

• Si no tienes una cuenta del administrador


comercial, puedes crear una en
[Link]/overview.

Antes de crear una cuenta del administrador comercial


Asegúrate de tener una cuenta de Facebook personal para confirmar tu identidad.

• Para iniciar sesión en el administrador comercial debes usar tu nombre de usuario y tu contraseña de Facebook.

Cómo crear una cuenta del administrador comercial

• Ve a [Link]/overview.

• Haz clic en "Crear cuenta".


• Ingresa el nombre de la empresa, tu nombre y tu dirección de correo electrónico laboral, y haz clic en "Siguiente".
• Ingresa los datos de tu empresa y haz clic en "Enviar".

Nota
Solo puedes crear dos cuentas del administrador comercial. Si necesitas más, trabaja con otra persona
de tu organización a fin de crear cuentas del administrador comercial adicionales.
API de conversiones: 3
Manual sobre integración directa

Token de acceso
• Para usar la API de conversiones, necesitas un token de acceso, que se pasa como un parámetro en cada
llamada a la API.

• Puedes generar un token de acceso con el administrador de eventos (recomendado) o, si ya tienes tu


propia app y tu propio usuario del sistema, puedes generar un token de acceso en el administrador comercial.

• Para ninguna de estas opciones es necesario someterse a un proceso de revisión de apps ni solicitar
permisos.

Instrucciones para crear un token de acceso:

Opción A (recomendada) Opción B

Generar un token de acceso en el Generar un token de acceso en el


administrador de eventos administrador comercial
1. Elige un píxel (te recomendamos que empieces con el 1. Ve a la configuración del negocio.
píxel y el evento principal que usas para la optimización).
2. Asigna un píxel al usuario del sistema (en este
2. Ve a "Configuración > API de conversiones > momento, también puedes crear un nuevo usuario del
Configurar manualmente" y, luego, al enlace a "Generar sistema).
token de acceso".
3. Selecciona el usuario del sistema correspondiente
y haz clic en "Generar token".

Nota

Solo pueden ver el enlace a "Generar token de acceso" los


usuarios que tienen privilegios de desarrollador en la
empresa. El enlace se ocultará para los demás usuarios.

3. Sigue las instrucciones de las ventanas emergentes.

4. Cuando tengas el token, navega hacia la pestaña


"Implementación" y sigue las instrucciones que
aparezcan en la pantalla. De esta manera, crearemos
automáticamente una app y un usuario del sistema de
la API de conversiones para ti.
API de conversiones: 4
Manual sobre integración directa

2. Implementar la API
1 Ve al administrador de eventos.

2 Para empezar, envía un evento de prueba a la API.

¿Primera vez que usas la API?


Empieza con una llamada de prueba. Necesitarás una carga y un método de llamada a la API:

Generar carga Hacer una llamada a la API con la carga

Para crear tu carga a partir de la herramienta del Cuando estés conforme con la carga, decide cómo harás
asistente de carga, agrega tu identificador del píxel en el la llamada.
campo "Probar esta carga" y haz clic en "Enviar a 'Probar
eventos'". • Puedes usar nuestro explorador de la API Graph o cURL.

• El evento debería aparecer en "Administrador de • Independientemente del método que uses para la
eventos > Tu píxel > Probar eventos". llamada, debes llamar al punto de conexión
/{pixel_id}/events y adjuntar los datos JSON
• Obtén más información sobre la herramienta "Probar generados por la herramienta del asistente de carga.
eventos".

Si necesitas más ayuda para realizar tu primera llamada a la API, mira este tutorial en video.
API de conversiones: 5
Manual sobre integración directa

3. Enviar eventos
Los eventos que es más importante enviar a través Prácticas recomendadas para la fecha y hora de
subida, la creación de lotes y los tiempos de
de la API de conversiones son los de optimización espera:
(en general, un evento de conversión como
"Comprar"). No obstante, te recomendamos que El parámetro event_time debe enviarse como una
envíes los eventos a través de su embudo de compra marca de tiempo* de UNIX en segundos que indique el
(como suelen hacer los anunciantes con el píxel). momento en que realmente ocurrió el evento.

• * Nota: Las marcas de tiempo de UNIX se usan para


cualquier zona horaria.
• Para enviar eventos desde tu servidor, haz una
solicitud POST al perímetro /events de esta API, a • La demora entre el parámetro event_time y el
partir de esta ruta: momento en que lo envías a Facebook debe ser lo más
[Link] cercana posible a cero, y no debe superar los siete días
/{PIXEL_ID}/events?access_token={TOKEN}. (si supera los siete días, devolveremos un error para
toda la solicitud y no procesaremos ningún evento).

• Cuando realizas una solicitud POST a este


perímetro, Facebook crea nuevos eventos del Puedes agrupar hasta 1.000 eventos en data.
servidor.
• Sin embargo, te recomendamos que envíes los
eventos en tiempo real, lo antes posible una vez que
• Asocia a la solicitud el token de acceso seguro estos ocurren o, idealmente, en el transcurso de una
generado, que usa el parámetro de consulta hora.
"access_token".
• Si alguno de los eventos que envías en un lote no es
• También puedes usar el explorador de la API válido, rechazaremos el lote entero.

Graph para realizar una solicitud POST al punto de


conexión /<pixel_id>/events para realizar Los errores de red o las solicitudes con formato
pruebas. incorrecto pueden generar que se omitan eventos.

• Si la respuesta HTTP indica un error ajeno al cliente,


por ejemplo, de tiempo de espera, te recomendamos
También puedes usar el editor de código abierto
que vuelvas a enviar la solicitud.
Swagger para generar un código de API del
cliente para la API de conversiones. • Para contemplar las demoras de la red, te
recomendamos que configures un tiempo de espera de
• Con el código que se genera se administran 1.500 milisegundos en la solicitud.
las llamadas a la API, y se manejan las
excepciones y los reintentos. • Para la mayoría de las solicitudes, el tiempo de
respuesta será inferior a 600 milisegundos.

• Para usar Swagger, debes tener Java


(versión 7 o posterior).

• Obtén más información sobre nuestra


integración de Swagger a la API en GitHub.
API de conversiones: 6
Manual sobre integración directa

4. Agregar parámetros a todos los eventos


Para relacionar eventos con una cuenta de Facebook se necesitan parámetros de información del cliente. Algunos de
estos parámetros también se usan como claves de deduplicación para eventos redundantes del navegador y del
servidor.

• Para la atribución de anuncios y la optimización de la entrega de anuncios solo se pueden usar eventos
coincidentes y procesados.

• Cuantos más parámetros de información del cliente agregues, más eficaz podrá ser la información del cliente
para relacionar el evento del servidor con una cuenta de Facebook, y esto puede mejorar el rendimiento de la
campaña.

Más adelante en esta guía (en la sección Puntuación de calidad de coincidencias de eventos), se describe cómo los
parámetros que envías pueden mejorar la calidad de coincidencias de eventos: cuanto más alta es dicha puntuación,
mayor puede ser la eficacia de tu evento para relacionarse con una cuenta de Facebook. Para la segmentación y la
optimización solo pueden usarse eventos coincidentes.

Nota

"Se requiere cifrado" indica que estos campos incluyen información de identificación personal.
Estos datos se deben cifrar mediante SHA256 y con codificación UTF-8. No aceptaremos estos
datos sin cifrado y rechazaremos todo el evento.

A continuación, enumeramos parámetros de eventos del servidor obligatorios y recomendados:

Parámetros obligatorios (los eventos que no incluyan estos parámetros no se procesarán):


• client_user_agent (para eventos web): no cifrar
El parámetro user_agent es un campo que identifica el navegador web (p. ej., Safari, Chrome, Firefox, etc.) en el que
ocurrió un evento del sitio web.

• event_source_url (para eventos web)


El parámetro event_source_url es un campo que identifica la URL del sitio web en el que ocurrió un evento.
Concretamente, se trata de la página específica de un sitio web determinado donde ocurrió dicho evento.

• action_source (para eventos web y no web)


El parámetro action_source es un campo que identifica dónde ocurrió el evento (p. ej., un sitio web, un correo
electrónico, una llamada telefónica, una tienda, etc.).
API de conversiones: 7
Manual sobre integración directa

Parámetros recomendados (los eventos que no incluyan estos parámetros también se procesarán,
pero es posible que no se los relacione y deduplique de manera eficaz):
• external_id
El identificador externo es una cadena que representa a un usuario en el sistema de un anunciante, como
los identificadores de membresía de fidelidad, los identificadores de usuario y los identificadores de cookies externas.
Puedes enviar un parámetro "external_ID" o más para un evento determinado. Intentaremos relacionarlo con alguien
en Facebook.

• event_id
Este identificador puede ser cualquier cadena única que el anunciante elija. El parámetro event_id se usa para
deduplicar eventos enviados por el píxel de Facebook y la API de conversiones. El parámetro event_name también
se usa para la deduplicación.

Si hay información de identificación personal cifrada disponible, agrega estos parámetros

Parámetros adicionales que se pueden agregar para mejorar las coincidencias de eventos:

Dirección de correo electrónico (em): se Código postal (zp): se requiere cifrado


requiere cifrado País (country): se requiere cifrado
Número de teléfono (ph): se requiere cifrado Dirección IP del cliente (client_ip_address): no cifrar
Sexo (ge): se requiere cifrado Identificador de clic (fbc): no cifrar
Fecha de nacimiento (db): se requiere cifrado Identificador del navegador (fbp): no cifrar
Nombre (fn): se requiere cifrado Identificador externo (external_id): cifrado recomendado
Apellido (ln): se requiere cifrado Identificador de suscripción (subscription_id): no cifrar
Ciudad (ct): se requiere cifrado Identificador de cliente potencial (lead_id): no cifrar
Estado (st): se requiere cifrado Identificador de inicio de sesión con Facebook (fb_login_id):
no cifrar

Si NO hay información de identificación personal cifrada disponible, agrega estos parámetros

Parámetros adicionales que se pueden agregar para mejorar las coincidencias de eventos:

Dirección IP (client_ip_address): no cifrar


Identificador de clic (fbc): no cifrar
Identificador del navegador (fbp): no cifrar
Identificador externo (external_id): cifrado recomendado

Uso limitado de datos:

La función "Uso limitado de datos" les ofrece a las empresas más control sobre la manera en que se usan sus datos en
nuestros sistemas, por ejemplo, las ayuda a cumplir la Ley de Privacidad del Consumidor de California (CCPA).

Obtén más información sobre las opciones de procesamiento de datos para usuarios de California en Facebook for
Developers.
API de conversiones: 8
Manual sobre integración directa

Parámetros que se usan como


claves de deduplicación
Como recomendamos usar una conexión de píxel
+ API de conversiones para la mayor cantidad
posible de eventos, dichos eventos redundantes
requieren una deduplicación mediante una
convención coherente para la denominación de
los eventos y uno de los siguientes conjuntos de
claves de deduplicación:

Opción A (recomendada)

Nombre e identificador del evento duplicado

Método de deduplicación
Los eventos que contienen el mismo parámetro
event_name y el mismo parámetro event_id, que
se envían al mismo identificador del píxel y que se reciben
dentro de un plazo de 48 horas entre sí se consideran
duplicados, y descartamos el último de ellos.

Claves de deduplicación
event_name
event_id

Opción B

Nombre del evento duplicado e identificador


del navegador de Facebook o identificador
externo

Método de deduplicación
Debes usar el parámetro event_name junto con el
fbp o external_id de manera coherente en todos
los eventos del navegador y del servidor. El evento del
navegador debe llegar primero y, si se recibe el evento del
servidor antes que el evento del navegador
correspondiente, es posible que se lo cuente dos veces.
Por estas limitaciones, recomendamos la Opción A.

Claves de deduplicación
event_name
fbp o external_id
event_time
API de conversiones: 9
Manual sobre integración directa

5. Probar eventos
Usa la herramienta Probar eventos para comprobar que los eventos se estén procesando y deduplicando
correctamente.

• Ve a "Administrador de eventos > Orígenes de datos > Tu píxel > Probar eventos".
• La herramienta "Probar eventos" genera un identificador de prueba.
• Envía el identificador de prueba como un parámetro test_event_code para empezar a ver la actividad
del evento en la ventana "Probar eventos".

Tus eventos de prueba deben aparecer en la herramienta "Probar eventos" en un plazo de 30 segundos una vez que
los envías.

• Si no aparecen, comprueba que tu carga tenga la estructura correcta con la herramienta Asistente de carga.
• La información de prueba permanece en la herramienta "Probar eventos" durante 24 horas o hasta que haces
clic en "Borrar actividad" para eliminarla.

Nota
Los eventos que se envían con test_event_code se procesan y utilizan para segmentación y medición de anuncios.
API de conversiones: 10
Manual sobre integración directa

6. Verificar eventos
Una vez que empiezas a enviar eventos, debes poder verificarlos en un plazo de 20 minutos.

• Ve a "Administrador de eventos > Orígenes de datos" y haz clic en el píxel correspondiente al


parámetro PIXEL_ID en tu solicitud POST.
• Para cada píxel, ve a "Información general > Eventos > Método de conexión".
• En "Método de conexión", verás "Navegador", "Servidor" o "Navegador + servidor".

Práctica recomendada

Te recomendamos que uses un método de conexión de "navegador + servidor" para la mayor cantidad posible
de eventos. Los eventos que solo incluyen una conexión de navegador son más propensos a perderse o no
atribuirse si la conexión a internet del cliente es mala, si hay errores al cargar la página o si las cookies de
terceros quedan obsoletas para los navegadores web.

Ejemplo: solo con fines ilustrativos.


API de conversiones: 11
Manual sobre integración directa

Práctica recomendada

Haz clic en cada evento para ver más detalles y la actividad reciente, por ejemplo:

• Parámetros de eventos agrupados


• Porcentaje de eventos recibidos, y con cuál método de conexión (píxel o API de conversiones)
• Eventos procesados o ignorados de cada método de conexión
• Puntuación de calidad de coincidencias de eventos (hasta diez), incluido cómo se calculó y usó el valor, y consejos
para mejorarlo (por ejemplo, al especificar más parámetros de información del cliente para agregar al evento)

Ejemplo: solo con fines ilustrativos.


API de conversiones: 12
Manual sobre integración directa

7. Solución de problemas y configuración óptima


La API de conversiones devuelve una cantidad mínima de datos para ahorrar ancho de banda de red. Si la carga
del evento es válida, se devuelve un código de respuesta 2xx HTTP.

• Si no es válida, se devuelve un código de respuesta "4xx HTTP", con una cantidad mínima de información
sobre el error en el cuerpo de la respuesta.
• Haz una solicitud POST a /events/?trace= en el explorador de la API Graph para obtener información
más detallada sobre cómo depurar una solicitud.
• Estas son algunas opciones para el parámetro trace:
1 - Error
2 - Información
3 - Depuración

Práctica recomendada
Consulta la pestaña "Diagnóstico" del administrador de eventos con regularidad para supervisar tu
conexión a la API de conversiones. Pasa el mouse por el icono "!" para obtener más información sobre un
problema y recomendaciones para mejorarlo.

Estos son algunos mensajes de diagnóstico frecuentes


de la API de conversiones:

Mensaje de diagnóstico en el
Contexto Resolución propuesta
administrador de eventos

Faltan parámetros de datos de Faltan parámetros de datos de Todos los eventos recibidos
usuario para <EVENT>. usuario en un evento o más. deben incluir los parámetros
obligatorios (consulta el
Nota: Incluso un solo evento con diagnóstico para determinar
Falta el parámetro <KEY> en el cuál es el evento con
problemas puede hacer que
evento del servidor. problemas).
aparezca un diagnóstico.

El servidor envía parámetros de


Faltan parámetros de datos de
clave de coincidencia no válidos
usuario en un evento o más. Corrige el formato de los
para los eventos.
parámetros (consulta el
Nota: Incluso un solo evento con diagnóstico para determinar cuál
El evento envía un parámetro es el evento con problemas).
problemas puede hacer que
<KEY> no válido.
aparezca un diagnóstico.
API de conversiones: 13
Manual sobre integración directa

El servidor envía eventos más de Envía los eventos lo más cerca


Retraso del evento del servidor. 24 horas después de que ocurre el posible del tiempo real.
evento real.

Se recibió el mismo identificador de


Tu píxel o servidor usó el mismo Usa identificadores únicos para cada
evento para muchas instancias de
identificador de evento varias veces. evento.
eventos.

El identificador externo que se


El identificador externo del servidor Usa un identificador externo
proporcionó en el píxel no coincide
no coincide con el identificador uniforme en todos los eventos del
con ninguno de los que se enviaron a
externo del píxel para el evento. navegador y del servidor.
través del servidor.

Criterios de configuración óptima

La proporción de eventos del navegador que se comparten con un método


Redundancia de eventos
de conexión de "navegador + servidor" (idealmente, 90% o más).

La proporción de eventos redundantes que se identifican de manera eficaz con


Deduplicación de eventos nombres e identificadores de evento, identificadores externos o identificadores
del navegador de Facebook idénticos (idealmente, 50% o más).

Tiempo que pasó desde que ocurrió el evento (idealmente, cero minutos, es
Actualización de los datos
decir, en tiempo real, y no más de siete días).

Una puntuación que indica qué tan eficaz puede ser la información del
Calidad de coincidencias
cliente de tu evento para relacionarlo con una cuenta de Facebook
de eventos
(idealmente, seis o más).

Nota
A continuación, te ofrecemos más información sobre cómo usar estos criterios para lograr una configuración
óptima de la API de conversiones.
API de conversiones: 14
Manual sobre integración directa

Configuración óptima
Sigue estas recomendaciones para optimizar tu configuración. Esto puede mejorar el rendimiento de los anuncios.

Redundancia de eventos

Para establecer una conexión de datos más confiable, te recomendamos que uses un método de conexión de
"navegador + servidor" para todos los eventos.

Para comprobarlo, consulta la sección Método de conexión:


i. Ve a "Administrador de eventos > Orígenes de datos > Método de conexión":

Ejemplo: solo con fines ilustrativos.


API de conversiones: 15
Manual sobre integración directa

Deduplicación de eventos

Siguiendo las recomendaciones, los eventos se comparten de forma redundante mediante una "conexión de
navegador + servidor" y, por lo tanto, nuestro sistema tiene que entender que estos eventos redundantes
describen una única acción del cliente (instancia de evento) y deduplicarlos.

Para comprobarlo, consulta la sección Resumen del evento.


1. Ve a "Administrador de eventos > Orígenes de datos > Tu píxel > Ver detalles > Resumen del evento".

Ejemplo: solo con fines ilustrativos.

2. Usa la tabla Desglose del evento para supervisar el volumen del evento:
i Eventos recibidos: número total de eventos recibidos de un navegador (es decir, del píxel) y de un servidor

(es decir, de la API de conversiones). Es posible que algunos eventos no se tengan en cuenta aquí debido a
errores.
El número de eventos recibidos mediante la API de conversiones debe ser igual o mayor que el número
de eventos recibidos mediante el píxel del navegador.
i Eventos procesados: número de eventos recibidos mediante navegadores y servidores, sin incluir los

duplicados. Estos eventos se usan para tareas de medición y optimización (eventos procesados = eventos
recibidos – eventos deduplicados).
i Eventos deduplicados: número de eventos recibidos e identificados como duplicados y que, por lo tanto,

no se procesan.
API de conversiones: 16
Manual sobre integración directa

Para mejorar la deduplicación de eventos, revisa las


claves de deduplicación.

1. Ve a "Administrador de eventos > Orígenes de datos >


Tu píxel > Ver detalles > Deduplicación de eventos >
Claves de deduplicación".

En la parte inferior de la ventana "Deduplicación de


eventos" se visualiza:muestra:

2. Porcentaje de la clave de deduplicación (por método


de conexión):
• En el ejemplo, el 100% de los eventos del navegador
provenientes del píxel incluyen el identificador del
evento y el 100% de los eventos del servidor
provenientes de la API de conversiones incluyen el
identificador del evento.
• Cuanto más alto es el porcentaje, mejor.
• Te recomendamos que envíes claves de
deduplicación para todos los eventos (idealmente, el
100%).

3. Porcentaje de superposición:
• La superposición representa el porcentaje de claves
de deduplicación que se recibieron al usar tanto el
píxel como la API de conversiones.

4. En esta captura de pantalla, el 93,79% de los eventos


provenientes del píxel y la API de conversiones incluyen
identificadores del evento idénticos.

5. Por ejemplo, si envías 80 eventos de compra desde el


Ejemplo: solo con fines ilustrativos.
píxel y 100 desde la API de conversiones, idealmente,
tendrías una superposición del 100% u 80 claves de
deduplicación: una por cada par de eventos de compra
redundantes.
• Superposición del 100% = 80 claves de
deduplicación únicas/80 pares de eventos
redundantes.
• Un porcentaje bajo de superposición (p. ej., en el
ejemplo anterior, si la superposición fuera del 40%)
indica que estás compartiendo menos claves de
deduplicación que los pares de eventos redundantes
que envías.
Superposición del 40% = 32 claves de
deduplicación únicas/80 pares de eventos
redundantes.
API de conversiones: 17
Manual sobre integración directa

Actualización de los datos

• La demora entre el momento en que se compartió


cada evento con Facebook y el momento en que este
ocurrió realmente es importante para la eficacia con
que nuestro sistema aprende y optimiza la entrega
para tu campaña.

• Para comprobar esta demora, consulta la sección


Actualización de los datos.
1. Ve a "Administrador de eventos > Orígenes de
datos > Tu píxel > Ver detalles > Actualización de
los datos".

2. Recomendamos que el valor sea lo más cercano Ejemplo: solo con fines ilustrativos.
posible al tiempo real.

Puntuación de calidad de coincidencias


de eventos

La calidad de coincidencias de eventos se puntúa


del uno al diez para indicar qué tan eficaces pueden
ser los parámetros de información del cliente de tu
evento del servidor para relacionarlo con una cuenta
de Facebook.

Para la atribución de anuncios y la optimización de la


entrega de anuncios solo se pueden usar eventos
coincidentes, y cuanto más alta sea la calidad de
coincidencias, mejor.

Para comprobarlo, consulta la sección "Calidad de


coincidencias de eventos":
1. Ve a "Administrador de eventos > Orígenes de
datos > Tu píxel > Ver detalles > Coincidencias de
eventos".
2. Analiza cada tipo de información del cliente
recibida y el porcentaje de eventos que la
recibieron: cuantos más tipos de información del Ejemplo: solo con fines ilustrativos.
cliente se hayan recibido y más alto sea el
porcentaje de eventos que recibieron cada uno
de esos tipos, mejor.
API de conversiones: 18
Manual sobre integración directa

Recomendamos agregar a cada evento del servidor


la mayor cantidad posible de parámetros de
información del cliente disponibles para alcanzar
una puntuación de calidad de coincidencias de
eventos de seis o más.

En el lado derecho de esta ventana, verás


recomendaciones para mejorar la puntuación de
calidad de coincidencias de eventos. Esta suele
aumentar al agregar los siguientes parámetros:

1. Agente de usuario del cliente


(client_user_agent)
2. Dirección IP (client_ip_address)

Por ejemplo, con solo agregar el agente de usuario


del cliente y la dirección IP, la puntuación de
calidad de coincidencias de eventos de una
empresa aumentó de cinco a nueve*:

Ejemplo de parámetros de información del cliente


recibidos de un evento con una puntuación de
calidad de coincidencias de eventos de cinco:

Dirección de correo electrónico (em)


Número de teléfono (ph)
Nombre (fn)
Apellido (ln)

Al agregar el parámetro de agente de usuario del


cliente y la dirección IP, la puntuación de calidad
de coincidencias de eventos aumentó a nueve:

Dirección de correo electrónico (em)


Número de teléfono (ph)
Nombre (fn)
Apellido (ln)
Agente de usuario del cliente
(client_user_agent)
Dirección IP (client_ip_address)

* Fuente: datos de Facebook, campaña de 28.000 anuncios


semanales que se optimizaron para los eventos de compra
estándar de la API de conversiones, julio de 2020 a septiembre
de 2020 (consultados en mayo de 2021).
API de conversiones: 19
Manual sobre integración directa

GLOSARIO/RECURSOS ADICIONALES

Condiciones de uso
Condiciones de las herramientas empresariales de Facebook
[Link]

Adoptar la API de conversiones


Información sobre la API de conversiones
[Link]

Decidir si la API de conversiones es adecuada para tu empresa


[Link]

Comparar las opciones de configuración de la API de conversiones


[Link]

Información sobre integraciones con socios para sitio web


[Link]

Casos de éxito de la API de conversiones


[Link]

Prácticas recomendadas
Prácticas recomendadas para la API de conversiones
[Link]

Prácticas recomendadas para la privacidad y el uso de datos con las herramientas empresariales de Facebook
[Link]

Consentimiento de cookies
[Link]
API de conversiones: 20
Manual sobre integración directa

Usar la API de conversiones


Implementar la API de conversiones mediante instrucciones personalizadas en el administrador de eventos
[Link]

Explora el administrador de eventos para ver información sobre el píxel de Facebook y la API de conversiones
[Link]

Uso de la API > Enviar solicitudes


[Link]

Usar la herramienta "Probar eventos"


[Link]

Solicitudes por lotes


[Link]

Información sobre la deduplicación de eventos del píxel de Facebook y la API de conversiones


[Link]

Opciones de deduplicación de eventos


[Link]

Agregar parámetros para la deduplicación


[Link]
entation#add-parameters-for-dedup

Deduplicar los eventos del píxel y del servidor


[Link]
duplication-best-practices

Tiempos de retraso máximos y recomendados para eventos online y offline


[Link]

Tiempo de subida frente a fecha de transacción del evento


[Link]

Parámetros
[Link]

Cifrado
[Link]

Conectar una cuenta de Shopify a Facebook


[Link]
API de conversiones: 21
Manual sobre integración directa

Solución de problemas
Solucionar problemas de la herramienta de configuración de eventos de Facebook para la web
[Link]

Solucionar problemas con los mensajes de error y de advertencia del píxel de Facebook
[Link]

Limitación de frecuencia
[Link]

Códigos de error
[Link]

Errores de limitación
[Link]

Eventos omitidos
[Link]

Capacitación
Facebook Blueprint: Conexiones más sólidas gracias a la API de conversiones
[Link]

Facebook Blueprint: Configura, implementa y verifica la API de conversiones


[Link]

Facebook Blueprint: Soluciona problemas de la API de conversiones


[Link]

Tutorial en video: Prueba la primera llamada a la API de conversiones


[Link]

Ayuda
Ayuda para desarrolladores
[Link]

Foro de la comunidad de desarrolladores


[Link]

También podría gustarte