Solución de problemas
Si tienes problemas mientras usas la API de Search Ads 360, consulta esta sección para solucionarlos.
Si tienes un problema que no puedes resolver después de leer los recursos de este sitio, comunícate con el equipo de asistencia y ten a mano la siguiente información:
El ID de agencia y el ID del anunciante de Search Ads 360 a los que intentas acceder
Número de proyecto de la Consola de APIs de Google
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 cuenta 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:
Ve a la Consola de API de Google.
Elige tu proyecto. Si aún no creaste un proyecto, consulta
Crea un proyecto para tu cliente. En la barra lateral izquierda, expande APIs y autenticación. A continuación,
haz clic en APIs. En la
lista de APIs, asegúrate de que el estado de la API de Search Ads 360 sea ACTIVADA.
|
Invalid grant
|
Este error se produce cuando tu token de actualización no es válido. Para obtener un token de actualización, invoca 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 la API 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 la API de Google para recuperar tu ID de cliente y 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 subas 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
update no es válido. Vuelve a subir las conversiones después de realizar lo siguiente:
Verificamos que el ID de clic se haya generado 6 horas antes de que se subieran las conversiones. Activaste
el servicio de conversiones de la API. Si
attribues 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 clickID de la visita si lo subes antes de 6 horas después de la visita. En casos excepcionales, es posible que debas esperar hasta 24 horas para que Search Ads 360 reconozca el clickId. Se confirmó que el clic proviene de una fuente válida, como lo indica el parámetro gclsrc. Confirmamos que especificaste el anunciante correcto en la columna
advertiserId. Verificamos que tu ID de clic se haya generado en los últimos 90 días.
|
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 los siguientes problemas comunes:
- Los nombres distinguen mayúsculas de minúsculas, así que asegúrate de que tu solicitud coincida exactamente con el caso.
- Asegúrate de no haber incluido caracteres Unicode no imprimibles ni espacios dobles en el nombre de la actividad de Floodlight.
- Asegúrate de haber especificado el nombre de una
actividad de Floodlight, no de una
columna de Floodlight.
- Verifica que exista la actividad de Floodlight para el anunciante que especificaste en la columna
advertiserId. (Es posible que hayas especificado el anunciante incorrecto).
- 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 una métrica) para el anunciante asociado con el
clickId,
criterionId o
productGroupId
que atribuyes 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 una dimensión) para el anunciante asociado con el clickId, criterionId o productGroupId que atribuyes a la conversión.
|
0x0000011A |
The advertiser conversion ID is already specified for a conversion with Search Ads 360
conversion ID {ID} |
Ya se subió una conversión para el mismo alcance y el mismo ID de conversión del anunciante
especificado en la columna
conversionId.
El "ID de conversión del anunciante" es un ID que generas. Search Ads 360 requiere que este ID sea único para un ámbito determinado. Search Ads 360 genera el
ID de conversión de 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 del anunciante que no existe. Asegúrate de haber especificado el ID correcto. |
0x0000011D |
User does not have permission to view advertiser {advertiser ID} |
La Cuenta de Google que usa tu cliente no tiene permiso para ver al anunciante
especificado en la solicitud.
Cuando accedas a la Consola de APIs de Google para recuperar tu ID de cliente y secreto de 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 al anunciante que especificaste.
|
0x0000011F |
Advertiser conversion ID is already specified in this request |
Dos o más conversiones en la solicitud especifican el mismo ID de conversión del anunciante y el mismo ámbito.
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 ámbito 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 coinciden con el tipo de conversión que especificaste.
|
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: 2024-12-17 (UTC)
[null,null,["Última actualización: 2024-12-17 (UTC)"],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"]]
