Preguntas frecuentes

¿Hay alguna restricción sobre lo que puedo subir?

Debes tener en cuenta algunas restricciones:

  • Las solicitudes individuales de batchinsert y batchupdate está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.
¿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?

batchinsert y batchupdate procesan las conversiones de la mejor manera posible: una solicitud por lotes puede devolver una respuesta HTTP 200 OK, mientras que las conversiones individuales dentro del lote fallan. Siempre verifica hasFailures en la respuesta y, luego, inspecciona la lista errors[] en cada objeto ConversionStatus:

  • 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 de ordinal, timestampMicros, floodlightActivityId y el identificador de usuario o de clic.
  • NOT_FOUND (Reintentar con retraso): Aún no se pudo encontrar el identificador (gclid, dclid, matchId o mobileDeviceId) 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 de NOT_FOUND de forma periódica (por ejemplo, cada 1 a 3 horas, durante un máximo de 6 horas). Si el error NOT_FOUND persiste después de 6 horas, consulta las siguientes secciones para conocer las causas comunes por tipo de identificador.
  • INVALID_ARGUMENT y PERMISSION_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 5xx o un error de cuota o límite de frecuencia 429, 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 INTERNAL o NOT_FOUND (o después de un tiempo de espera de HTTP 5xx en el que el resultado es desconocido), envía siempre los mismos ordinal y timestampMicros. Si ya se registró una conversión, Campaign Manager 360 la desduplica automáticamente según el ordinal, el identificador de usuario, la actividad de Floodlight y la fecha de conversión.

¿Qué significa cuando falla una carga de mobileDeviceId debido a un error de NOT_FOUND?

Las causas más comunes de este error son las siguientes:

  • El mobileDeviceId no 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.
¿Qué significa cuando falla una carga de gclid debido a un error de NOT_FOUND?

Las causas más comunes de este error son las siguientes:

  • El gclid no es válido.
  • El gclid no 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 el gclid se 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 gclid ocurrió 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 gclid ocurrió hace muy poco tiempo. Te recomendamos retrasar 1 hora las cargas de conversiones basadas en gclid para asegurarte de que el gclid se procese y esté disponible para la coincidencia.
¿Qué significa cuando falla una carga de dclid debido a un error de NOT_FOUND?

Las causas más comunes de este error son las siguientes:

  • El dclid no es válido.
  • El clic asociado al dclid ocurrió 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 dclid ocurrió hace muy poco tiempo. Te recomendamos retrasar 1 hora las cargas de conversiones basadas en dclid para asegurarte de que el dclid se procese y esté disponible para la coincidencia.
¿Qué significa cuando falla una carga de matchId debido a un error de NOT_FOUND?

Las causas más comunes de este error son las siguientes:

  • Campaign Manager 360 no conoce el matchId. Esto puede ocurrir si el matchId se 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 etiqueta matchId).
  • La llamada de Floodlight asociada con el matchId no contenía una cookie. La llamada de Floodlight debe contener una cookie o un identificador para que Campaign Manager 360 almacene el matchId correctamente (es decir, es posible que el usuario haya bloqueado las cookies o inhabilitado la opción).
  • La llamada de Floodlight asociada con el matchId se 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 el matchId.
  • La llamada de Floodlight asociada con el matchId se produjo hace muy poco tiempo. Te recomendamos que retrases 2 horas las cargas de conversiones basadas en matchId para asegurarte de que el matchId se procese y esté disponible para la coincidencia.
¿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 nonPersonalizedAd se debe establecer explícitamente en false para habilitar la creación de listas de público.