- ¿Hay alguna restricción sobre lo que puedo subir?
Debes tener en cuenta algunas restricciones:
- Las solicitudes individuales de
batchinsertybatchupdateestán limitadas a 1,000 conversiones. - La marca de tiempo de una conversión puede tener, como máximo, 28 días de antigüedad desde el momento del envío.
- Solo puedes enviar conversiones a una configuración de Floodlight a la que tenga acceso tu perfil de usuario de Campaign Manager 360.
- Las solicitudes individuales de
- ¿Debería usar Campaign Manager 360 o Search Ads 360 para subir conversiones?
Consulta el Centro de ayuda de Search Ads 360 para obtener una comparación detallada de las funciones que ofrecen ambos productos.
- ¿Qué sucede si inserto la misma conversión en Campaign Manager 360 y Search Ads 360?
Si insertas la misma conversión en Campaign Manager 360 y Search Ads 360, no se quitarán los duplicados de las entradas. En este caso, usa actividades de Floodlight independientes.
- ¿Qué API debo usar para subir conversiones sin conexión?
Te recomendamos usar la API de Data Manager para mejorar la experiencia del desarrollador y el acceso a funciones adicionales.
- ¿Qué es un valor ordinal y cómo se usa?
Los valores ordinales controlan cómo se procesan las conversiones duplicadas. Si se insertan varias conversiones con la misma actividad de Floodlight, el mismo ID de configuración de Floodlight, el mismo identificador de usuario y la misma marca de tiempo de conversión, se usa el ordinal para determinar lo siguiente:
- Se anula la duplicación de las conversiones y solo se conserva una. Esto sucede si todas las conversiones tienen el mismo valor ordinal.
- Las conversiones se procesan de forma individual y todas se completan. Esto sucede si todas las conversiones tienen un valor ordinal diferente.
No es necesario que los valores en sí sean significativos. En general, usar un valor fijo (como
1) para todas las conversiones habilitará la anulación de duplicaciones. Si usas un valor aleatorio o único para cada conversión, se inhabilitará.- ¿Cómo debo controlar los errores en la respuesta de la API y qué errores debo reintentar?
batchinsertybatchupdateprocesan las conversiones de la mejor manera posible: una solicitud por lotes puede devolver una respuesta HTTP200 OK, mientras que las conversiones individuales dentro del lote fallan. Siempre verificahasFailuresen la respuesta y, luego, inspecciona la listaerrors[]en cada objetoConversionStatus:INTERNAL(Retry): Se produjo un error transitorio en los sistemas de Google mientras se procesaba la conversión. La conversión no se insertó ni se actualizó. Vuelve a intentar las conversiones con errores usando la retirada exponencial (por ejemplo, comenzando después de unos minutos y volviendo a intentarlo durante varias horas), manteniendo exactamente los mismos valores deordinal,timestampMicros,floodlightActivityIdy el identificador de usuario o de clic.NOT_FOUND(Reintentar con retraso): Aún no se pudo encontrar el identificador (gclid,dclid,matchIdomobileDeviceId) ni la conversión existente que se está editando. Debido a que los clics en línea, las etiquetas de Floodlight y las conversiones pueden tardar entre 1 y 2 horas en procesarse e indexarse, vuelve a intentar las conversiones deNOT_FOUNDde forma periódica (por ejemplo, cada 1 a 3 horas, durante un máximo de 6 horas). Si el errorNOT_FOUNDpersiste después de 6 horas, consulta las siguientes secciones para conocer las causas comunes por tipo de identificador.INVALID_ARGUMENTyPERMISSION_DENIED(No volver a intentar): Los datos de conversión no son válidos (por ejemplo, una marca de tiempo de conversión de más de 28 días o un campo con formato incorrecto) o tu perfil de usuario no tiene permiso para la configuración de Floodlight de destino. No vuelvas a intentar subir estas conversiones sin solucionar el problema subyacente.
Si toda la solicitud HTTP falla con un error de servidor
5xxo un error de cuota o límite de frecuencia429, vuelve a intentar la solicitud con la retirada exponencial.Reintentos seguros y anulación de duplicación: Cuando vuelvas a intentar una conversión que falló con
INTERNALoNOT_FOUND(o después de un tiempo de espera de HTTP5xxen el que el resultado es desconocido), envía siempre los mismosordinalytimestampMicros. Si ya se registró una conversión, Campaign Manager 360 la desduplica automáticamente según elordinal, el identificador de usuario, la actividad de Floodlight y la fecha de conversión.- ¿Qué significa cuando falla una carga de
mobileDeviceIddebido a un error deNOT_FOUND? Las causas más comunes de este error son las siguientes:
- El
mobileDeviceIdno es válido. - Search Ads 360 no conoce el
mobileDeviceId. Esto significa que Campaign Manager 360 aún no publicó un anuncio en el dispositivo.
- El
- ¿Qué significa cuando falla una carga de
gcliddebido a un error deNOT_FOUND? Las causas más comunes de este error son las siguientes:
- El
gclidno es válido. - El
gclidno está asociado a una campaña de Search Ads 360 ni a una línea de pedido de YouTube de Display & Video 360. Esto puede ocurrir si elgclidse recopiló de un redireccionamiento de clics en el anuncio de Google Ads que no pasó por Search Ads 360 (p.ej., clics en extensiones de ubicación) o de un redireccionamiento de clics en el anuncio de YouTube no asociado con una línea de pedido de YouTube de Display & Video 360. - El clic asociado al
gclidocurrió hace demasiado tiempo. Las conversiones solo se pueden insertar para los clics que tengan hasta 60 días de antigüedad. - El clic asociado al
gclidocurrió hace muy poco tiempo. Te recomendamos retrasar 1 hora las cargas de conversiones basadas engclidpara asegurarte de que elgclidse procese y esté disponible para la coincidencia.
- El
- ¿Qué significa cuando falla una carga de
dcliddebido a un error deNOT_FOUND? Las causas más comunes de este error son las siguientes:
- El
dclidno es válido. - El clic asociado al
dclidocurrió hace demasiado tiempo. Las conversiones solo se pueden insertar para los clics que tengan hasta 60 días de antigüedad. - El clic asociado al
dclidocurrió hace muy poco tiempo. Te recomendamos retrasar 1 hora las cargas de conversiones basadas endclidpara asegurarte de que eldclidse procese y esté disponible para la coincidencia.
- El
- ¿Qué significa cuando falla una carga de
matchIddebido a un error deNOT_FOUND? Las causas más comunes de este error son las siguientes:
- Campaign Manager 360 no conoce el
matchId. Esto puede ocurrir si elmatchIdse recopiló de una llamada de Floodlight que no pasó correctamente por Campaign Manager 360 (asegúrate de que tus llamadas de Floodlight funcionen correctamente, incluido el parámetro de etiquetamatchId). - La llamada de Floodlight asociada con el
matchIdno contenía una cookie. La llamada de Floodlight debe contener una cookie o un identificador para que Campaign Manager 360 almacene elmatchIdcorrectamente (es decir, es posible que el usuario haya bloqueado las cookies o inhabilitado la opción). - La llamada de Floodlight asociada con el
matchIdse produjo hace demasiado tiempo. Las cargas de conversiones sin conexión deben realizarse en un plazo de 60 días a partir de la llamada de Floodlight que contiene elmatchId. - La llamada de Floodlight asociada con el
matchIdse produjo hace muy poco tiempo. Te recomendamos que retrases 2 horas las cargas de conversiones basadas enmatchIdpara asegurarte de que elmatchIdse procese y esté disponible para la coincidencia.
- Campaign Manager 360 no conoce el
- ¿Se incluyen en los informes las conversiones sin conexión con una marca de tiempo anterior a la creación de la actividad de Floodlight?
La carga de conversiones sin conexión con una marca de tiempo anterior a la creación de la actividad de Floodlight se podría registrar como impresiones de Floodlight y como conversiones atribuidas o no atribuidas, hasta 28 días antes del momento del envío. Sin embargo, este comportamiento no está garantizado y no se debe confiar en él. La práctica recomendada es crear actividades de Floodlight antes de la marca de tiempo más temprana de una conversión sin conexión.
- ¿Qué consentimiento se necesita para usar la inserción de conversiones sin conexión en la creación de listas de público?
Además del consentimiento para el uso de los datos del usuario de anuncios, el campo
nonPersonalizedAdse debe establecer explícitamente enfalsepara habilitar la creación de listas de público.
Preguntas frecuentes
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2026-10-20 (UTC)
[null,null,["Última actualización: 2026-10-20 (UTC)"],[],[]]