Video: Mira la charla sobre prácticas recomendadas del taller de 2019
En esta guía, se presentan algunas prácticas recomendadas que puedes implementar para optimizar la eficiencia y el rendimiento de tus apps.
Mantenimiento continuo
Para asegurarte de que tu app se ejecute sin interrupciones, haz lo siguiente:
Mantén actualizado tu correo electrónico de contacto de desarrollador en el Centro de API. Este es el alias que usamos para contactarnos contigo. Si no podemos comunicarnos contigo con respecto al cumplimiento de los Términos y Condiciones de la API, es posible que se revoque tu acceso a la API sin tu conocimiento previo. Evita usar una dirección de correo electrónico personal vinculada a una cuenta individual o no supervisada.
Para recibir información sobre problemas como cambios de productos, tiempo de inactividad por mantenimiento,
El equipo de la API de Google Ads supervisa periódicamente el foro, por lo que es el lugar ideal para publicar preguntas sobre la API.
- Asegúrate de que tu app cumpla con los Términos y Condiciones (T&C) de la API de Google Ads. Si es necesario, el equipo de revisión y cumplimiento de tokens se comunicará contigo mediante tu correo electrónico de contacto. Si tienes preguntas o inquietudes sobre los Términos y Condiciones, puedes comunicarte con el equipo de revisión. Para ello, responde el correo electrónico que te enviaron cuando revisaste tu aplicación de token de desarrollador.
Optimización
Operaciones por lotes
Hacer una solicitud a la API implica una serie de costos fijos, como la latencia de red de ida y vuelta, el procesamiento de serialización y deserialización, y las llamadas a los sistemas de backend. Para disminuir el impacto de estos costos fijos y aumentar el rendimiento general, la mayoría de los métodos de mutación en la API están diseñados para aceptar un array de operaciones. Si agrupas varias operaciones en lotes en cada solicitud, puedes reducir la cantidad de solicitudes que realizas y los costos fijos asociados. Si puedes, evita hacer solicitudes con una sola operación.
Por ejemplo, supongamos que agregas 50,000 palabras clave a una campaña en varios grupos de anuncios. En lugar de realizar 50,000 solicitudes con 1 palabra clave cada una, realiza 100 solicitudes con 500 palabras clave cada una o incluso 10 solicitudes con 5,000 palabras clave cada una. Existen límites sobre la cantidad de operaciones permitidas en una solicitud, por lo que es posible que debas ajustar el tamaño del lote para lograr un rendimiento óptimo.
Enviar objetos dispersos
Cuando se envían objetos a la API, los campos se deben deserializar, validar y almacenar en la base de datos. Pasar objetos completos cuando solo deseas actualizar algunos campos puede generar un tiempo de procesamiento adicional y una disminución del rendimiento.
Para mitigar esto, la API de Google Ads admite actualizaciones dispersas, lo que te permite propagar solo los campos de un objeto que necesitas cambiar o que son obligatorios. Las actualizaciones dispersas se procesan más rápido y tienen menos probabilidades de producir errores.
Los campos que no están en update_mask (también conocidos como FieldMask) no se modifican.
Por ejemplo, una app que actualiza ofertas a nivel de palabra clave puede beneficiarse del uso de actualizaciones dispersas, ya que solo se deberían propagar los campos ID del grupo de anuncios, ID del criterio y ofertas.
Manejo y administración de errores
Durante el desarrollo, es probable que se produzcan errores. En esta sección, se describen las consideraciones y las estrategias para compilar la administración de errores en tu app. Además de esta sección, visita la Guía de solución de problemas para obtener más información sobre la administración de errores.
Distingue las fuentes de las solicitudes
Algunas apps son principalmente interactivas y emiten llamadas a la API directamente en respuesta a acciones iniciadas por el usuario en una IU. Otros trabajan principalmente sin conexión y emiten llamadas a la API como parte de un proceso periódico de backend. Muchas apps combinan ambas. Cuando se piensa en la administración de errores, puede ser útil distinguir estos diferentes tipos de solicitudes.
En el caso de las solicitudes iniciadas por el usuario, tu preocupación principal debe ser brindarles una buena experiencia. Usa el error específico que se produjo para proporcionarle al usuario todo el contexto que puedas en la IU. Ofrece pasos sencillos que puedan seguir para resolver el error (consulta las sugerencias a continuación).
En el caso de las solicitudes iniciadas en el backend, implementa controladores para los diferentes tipos de errores que puede encontrar tu app. Siempre incluye un controlador predeterminado para abordar errores poco frecuentes o no encontrados. Un buen enfoque para un controlador predeterminado es agregar la operación con errores y el error a una cola a fin de que un operador humano los revise y determine una resolución adecuada.
Distingue los tipos de errores
Conocer las diferencias entre los tipos de errores en la API de Google Ads es fundamental para crear un manejo de errores sólido. Algunos de los tipos de errores más comunes son los siguientes:
- Errores de autenticación
- Errores que se pueden reintentar
- Errores de validación
- Errores relacionados con la sincronización
Consulta Tipos de error y Errores comunes para obtener más detalles.
Sincronizar backends
Si los usuarios de tu app tienen acceso manual a las cuentas de Google Ads, es posible que realicen cambios que la app no tenga en cuenta, lo que causará que la base de datos local se desincroniza. Como se indica en nuestra guía Tipos de errores, puedes abordar los errores relacionados con la sincronización de manera reactiva cuando se producen, pero también puedes intentar evitarlos de manera proactiva. Una estrategia proactiva consiste en ejecutar un trabajo de sincronización nocturno en todas tus cuentas para recuperar los objetos de Google Ads de estas y compararlos con tu base de datos local.
Errores de registro
Se deben registrar todos los errores para facilitar la depuración y la supervisión. Como mínimo, registra el ID de solicitud, las operaciones que causaron el error y el error en sí. Otra información para registrar incluye el ID de cliente, el servicio de API, la latencia de solicitudes de ida y vuelta, la cantidad de reintentos y la solicitud y respuesta sin procesar.
Supervisa las tendencias
Asegúrate de supervisar las tendencias en los errores de la API para poder detectar y abordar los problemas de tu app. Considera compilar tu propia solución o emplear una de las muchas herramientas comerciales disponibles que puedan usar tus registros para producir paneles interactivos y enviar alertas automáticas.
Desarrollo
Usa cuentas de prueba.
Las cuentas de prueba son cuentas de Google Ads que, en realidad, no publican anuncios. Puedes usar una cuenta de prueba para experimentar con la API de Google Ads y comprobar si la conectividad de tu app, la lógica de administración de campañas o algún otro tipo de procesamiento funcionan según lo previsto. No es necesario que tu token de desarrollador esté aprobado para usarse en una cuenta de prueba. Por lo tanto, puedes comenzar a desarrollar con la API de Google Ads inmediatamente después de solicitar un token de desarrollador, incluso antes de que se revise tu aplicación.