Solución de problemas

Si tienes problemas mientras usas la API de Search Ads 360, consulta esta sección de solución de problemas.

Si hay un problema que no puedes resolver después de leer los recursos de este sitio, comunícate con el equipo de asistencia y ten lista la siguiente información:

  • ID de agencia y de anunciante de Search Ads 360 a los que intentas acceder

  • Número de proyecto de la Consola de APIs de Google

  • Es el nombre de usuario de la Cuenta de Google que usas para acceder a la API.
    Esta es la cuenta a la que se le otorgó permiso para acceder a Search Ads 360, que es la misma que usas para configurar la autorización.

  • Fragmento de código de tu solicitud

  • Respuesta JSON
    Si la respuesta es un error, asegúrate de incluir el mensaje de error, no solo el código de error numérico.

Errores de autorización

Estos son algunos de los errores de autorización más comunes:

Mensaje Descripción

Access Not Configured. Please use Google API Console to activate the API for your project.

Este error se produce si no habilitaste la API de Search Ads 360 para tu cuenta. Asegúrate de haber hecho lo siguiente:

  1. Ve a la Consola de API de Google.

  2. Elige tu proyecto. Si aún no creaste un proyecto, consulta Crea un proyecto para tu cliente.

  3. En la barra lateral izquierda, expande API y autenticación. Luego, haz clic en APIs. En la lista de APIs, asegúrate de que el estado de la API de Search Ads 360 sea ACTIVADO.

Invalid grant

Este error se produce cuando tu token de actualización no es válido. Puedes obtener un token de actualización invocando la secuencia de comandos de utilidad de Search Ads 360 de la siguiente manera:

sa360Api.py --login

Obtén más información sobre el flujo de trabajo recomendado para la autorización.

Invalid client
no application name

Este error se produce si no especificaste un nombre de producto cuando configuraste tu proyecto en la Consola de APIs de Google. Para corregir este error, ingresa el nombre de tu producto en la pantalla de consentimiento de la Consola de APIs de Google.

Otros tipos de errores de autorización

Asegúrate de usar una Cuenta de Google a la que se le haya otorgado acceso a Search Ads 360 cuando accedas a la Consola de APIs de Google para recuperar tu ID de cliente y el secreto de cliente, y cuando obtengas un token de actualización.

Errores de carga de conversiones

En la siguiente tabla, se indican los errores que puedes encontrar cuando subes conversiones. Ten en cuenta que los códigos de error hexadecimales son inmutables, por lo que puedes usarlos en tus propias secuencias de comandos para identificar errores.

Código de error Mensaje Descripción
0x00000101

Click ID '{ID}' is not found

El ID de clic que especificaste en una solicitud insert o update no es válido. Vuelve a subir las conversiones después de hacer lo siguiente:

  • Verificaste que el ID de clic se haya generado 6 horas antes de que se subieran las conversiones.

  • Haber activado el servicio de la API de conversiones

  • Si atribuyes conversiones a visitas específicas, espera al menos 6 horas después de la visita antes de subir la conversión. Es posible que Search Ads 360 no reconozca el ID de clic de la visita si lo subes antes de que transcurran 6 horas desde la visita. En raras ocasiones, es posible que debas esperar hasta 24 horas antes de que Search Ads 360 pueda reconocer el ID de clic.

  • Se confirmó que el clic proviene de una fuente válida, como lo indica el parámetro gclsrc.

  • Verificaste que tu ID de clic se haya generado en los últimos 90 días.

0x00000106 Either a click ID or keyword ID is required

La conversión no especifica a qué se atribuye. Especifica la columna clickId o las columnas customerId, campaignId, adGroupId y criterionId que identifican una palabra clave.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

Especifica segmentationType: "FLOODLIGHT" y la actividad de Floodlight en la columna segmentationName o segmentationId.

Cuando edites una conversión que Search Ads 360 registró a través de una etiqueta de Floodlight, se requerirá la actividad de Floodlight para identificar la conversión.

0x0000010E Floodlight activity name '{name}' is not found

El nombre de la actividad de Floodlight especificado en la columna segmentationName es incorrecto o aún no está disponible. Si ves este error, verifica si se producen los siguientes problemas habituales:

  • Los nombres distinguen mayúsculas de minúsculas, así que asegúrate de que tu solicitud coincida exactamente con las mayúsculas y minúsculas.
  • Asegúrate de no haber incluido ningún carácter Unicode que no se pueda imprimir ni espacios dobles en el nombre de la actividad de Floodlight.
  • Asegúrate de haber especificado el nombre de una actividad de Floodlight, no una columna de Floodlight.
  • Verifica que la actividad de Floodlight exista para el anunciante al que pertenece el ID de clic o la palabra clave de tu solicitud.
  • Después de crear o editar una actividad de Floodlight, espera un par de horas antes de subir las conversiones de la actividad.
0x00000115 Custom dimension '{name}' is not found

Asegúrate de que la variable personalizada de Floodlight que especificaste se haya configurado como una dimensión (no como una métrica) para el anunciante asociado con el clickId, criterionId o productGroupId que estás atribuyendo para la conversión.

0x00000116 Custom metric '{name}' is not found

Asegúrate de que la variable personalizada de Floodlight que especificaste se haya configurado como una métrica (no como una dimensión) para el anunciante asociado con el clickId, criterionId o productGroupId que atribuyes a la conversión.

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

Tu solicitud de update no especificó la columna conversionId. Se requiere conversionId para identificar la conversión que deseas editar. Consulta Baja de dsConversionId.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

Alguien ya subió una conversión para el mismo alcance y el mismo ID de conversión del anunciante especificados en la columna conversionId.

El "ID de conversión del anunciante" es un ID que tú generas. Search Ads 360 requiere que este ID sea único para un alcance determinado. El ID de conversión de Search Ads 360 lo genera Search Ads 360 y se garantiza que sea único.

0x0000011B Advertiser conversion ID '{ID}' is not found

Tu solicitud de update intentó actualizar un ID de conversión de anunciante que no existe. Verifica si se producen los siguientes problemas habituales:

  • Asegúrate de haber especificado el ID correcto en la columna conversionId. En el caso de las conversiones subidas a través de la API, este es el conversionId que especificaste cuando insertaste la conversión. En el caso de las conversiones registradas a través de etiquetas de Floodlight, este es el ID de pedido de Floodlight.
  • Asegúrate de que el parámetro conversionTimestamp sea la marca de tiempo de la conversión existente, en milisegundos de la época UTC. Una marca de tiempo que se convirtió de una zona horaria local o que se especifica en segundos en lugar de milisegundos no coincide con la conversión existente.
  • En el caso de las conversiones registradas a través de etiquetas de Floodlight, asegúrate de haber especificado la actividad de Floodlight de la conversión en la columna segmentationName o segmentationId, y de que la conversión se haya producido en los últimos 28 días.
0x0000011D User does not have permission to view advertiser {advertiser ID}

La Cuenta de Google que usa tu cliente no tiene permiso para ver el anunciante al que pertenece el ID de clic o la palabra clave de la solicitud.

Cuando accedas a la Consola de APIs de Google para recuperar tu ID de cliente y secreto del cliente, y cuando obtengas un token de actualización, asegúrate de usar una Cuenta de Google a la que se le haya otorgado acceso a ese anunciante.

0x0000011F Advertiser conversion ID is already specified in this request

Dos o más conversiones de la solicitud especifican el mismo alcance y el mismo ID de conversión del anunciante.

El ID de conversión del anunciante es un ID que generas y especificas en la columna conversionId. Search Ads 360 requiere que este ID sea único para un alcance determinado.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

El ID o el nombre de la actividad de Floodlight que proporcionaste no coincide con el tipo de conversión que especificaste.

0x00000124 Conversion timestamp is before click timestamp

El valor de conversionTimestamp es anterior a la hora del clic que especificaste en la columna clickId. Asegúrate de que la marca de tiempo se especifique en milisegundos de época UTC, no en segundos ni en una zona horaria local.

0x00000125 Conversion age is older than the max supported age

Tu solicitud de update intentó editar una conversión que es demasiado antigua para editarla. Las conversiones que Search Ads 360 registró a través de las etiquetas de Floodlight solo se pueden editar en un plazo de 28 días a partir de la conversionTimestamp.

0x00000126 Service internal error

Vuelve a enviar la solicitud más tarde. Es probable que se trate de un error transitorio. Comunícate con el equipo de asistencia de SA360 si el error persiste.

0x00000129 Invalid customer ID: {ID}

Search Ads 360 no puede encontrar el ID de cliente que especificaste en la columna customerId . Especifica el ID de cliente de la nueva experiencia de Search Ads 360 de la cuenta de cliente que contiene la palabra clave, por ejemplo, 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

Search Ads 360 no puede encontrar la palabra clave que identifican las columnas customerId, campaignId, adGroupId y criterionId. Asegúrate de que los cuatro IDs sean IDs de la nueva experiencia de Search Ads 360 y de que la palabra clave pertenezca al grupo de anuncios, la campaña y la cuenta de cliente que especificaste.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

Una conversión que se atribuye a una palabra clave debe especificar customerId, campaignId, adGroupId y criterionId. En el mensaje, se indica el ID que falta. Consulta Atribuye una conversión solo a una palabra clave.

0x0000012F Editing a click ID older than 60 days is not supported.

Tu solicitud update especificó un clickId que se generó hace más de 60 días. Las conversiones solo se pueden editar en un plazo de 60 días a partir del clic.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

Tu solicitud update especificó la columna dsConversionId obsoleta o pasó un ID de conversión de Search Ads 360 en la columna conversionId. En su lugar, identifica la conversión por su ID de conversión del anunciante. Consulta Baja de dsConversionId.

Códigos de respuesta y mensajes de error de los informes

Si solicitas un informe y la respuesta es un mensaje de error, consulta los códigos de respuesta en la API de Search Ads 360 y las respuestas de error estándar para obtener más información sobre el error.

Los datos de la IU de Search Ads 360 no coinciden con un informe que muestra la API

De forma predeterminada, los datos de la IU de Search Ads 360 deben coincidir con los que devuelve la API. Si configuras includeRemovedEntities como true en una solicitud de informe, asegúrate de que la casilla de verificación Mostrar eliminados también esté seleccionada en la IU.