Video: Mira la charla de prácticas recomendadas del taller de 2019
En esta guía, se abordan 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 de forma continua, haz lo siguiente:
Mantén actualizado el correo electrónico de contacto del desarrollador en el centro de API. Este es el alias que usamos para comunicarnos contigo. Si no podemos comunicarnos contigo con respecto al cumplimiento de las Condiciones del Servicio de la API, es posible que se revoque tu acceso a la API sin previo aviso. Evita usar una dirección de correo electrónico personal vinculada a una cuenta individual o no supervisada. Para ver el Centro de la API, debes haber accedido a tu cuenta de administrador.
Para recibir información sobre problemas, como cambios en los productos, períodos de inactividad por mantenimiento, fechas de baja, etcétera, suscríbete a nuestro
El equipo de la API de Google Ads supervisa el foro con frecuencia, lo que lo convierte en el lugar ideal para publicar preguntas sobre la API.
- Mantén tu app conforme a 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 a través de tu correo electrónico de contacto. Si tienes preguntas o inquietudes sobre las Condiciones del Servicio, puedes comunicarte con el equipo de revisión respondiendo el correo electrónico que te enviaron cuando revisaron tu solicitud de token de desarrollador.
Optimización
Para optimizar tu app, ejecuta operaciones por lotes y, si corresponde, envía objetos dispersos.
Operaciones por lotes
Realizar 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 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 de la API están diseñados para aceptar un array de operaciones. Si agrupas varias operaciones en cada solicitud, puedes reducir la cantidad de solicitudes que realizas y los costos fijos asociados. Si puedes, evita realizar 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 para 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.
Cómo 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 quieres 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 es menos probable que produzcan errores.
Los campos que no están en update_mask (también conocidos como FieldMask) no se modifican.
Por ejemplo, una app que actualiza las ofertas a nivel de la palabra clave puede beneficiarse del uso de actualizaciones escasas, ya que solo se deben propagar los campos del ID del grupo de anuncios, el ID del criterio y las ofertas.
Manejo y administración de errores
Es probable que encuentres errores durante el desarrollo. En esta sección, se describen las consideraciones y estrategias para incorporar 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 cómo administrar errores.
Distingue las fuentes de solicitudes
Algunas apps son principalmente interactivas y emiten llamadas a la API directamente en respuesta a acciones que inicia el usuario en una IU. Otros funcionan principalmente sin conexión y emiten llamadas a la API como parte de un proceso de backend periódico. 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 que inicia el usuario, tu principal preocupación debe ser proporcionar una buena experiencia a los usuarios. Usa el error específico que se produjo para proporcionar al usuario tanto contexto como sea posible en la IU. Ofrece pasos sencillos que pueda seguir para resolver el error (consulta las sugerencias que aparecen a continuación).
Para las solicitudes que se inician 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 que no se habían encontrado anteriormente. Un buen enfoque para un controlador predeterminado es agregar la operación y el error fallidos a una cola para que un operador manual 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 cuando se compila una administración de errores sólida. Estos son algunos de los tipos de errores más comunes:
- Errores de autenticación
- Errores que se pueden reintentar
- Errores de validación
- Errores relacionados con la sincronización
Consulta Tipos de errores y Errores comunes para obtener más información.
Backends de sincronización
Si los usuarios de tu app tienen acceso manual a las cuentas de Google Ads, es posible que realicen cambios que tu app no conozca, lo que provocará que la base de datos local de tu app deje de estar sincronizada. Como se indica en nuestra guía Tipos de errores, puedes abordar los errores relacionados con la sincronización de forma reactiva cuando ocurren, pero también puedes intentar evitarlos de forma proactiva. Una estrategia proactiva es ejecutar una tarea de sincronización todas las noches en todas tus cuentas, recuperar los objetos de Google Ads en tus cuentas y compararlos con tu base de datos local.
Errores de registro
Todos los errores deben registrarse para facilitar la depuración y la supervisión. Como mínimo, registra el ID de la solicitud, las operaciones que causaron el error y el error en sí. Otra información que se debe registrar incluye el ID del cliente, el servicio de la API, la latencia de la solicitud de ida y vuelta, la cantidad de reintentos y la solicitud y la respuesta sin procesar.
Supervisa las tendencias
Asegúrate de supervisar las tendencias de los errores de la API para detectar y abordar los problemas de tu app. Considera crear tu propia solución o emplear una de las muchas herramientas comerciales disponibles que pueden usar tus registros para producir paneles interactivos y enviar alertas automatizadas.
Desarrollo
Usa cuentas de prueba durante el 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 probar que la conectividad, la lógica de administración de campañas o cualquier otro procesamiento de tu app funcionen según lo esperado. No es necesario que se apruebe tu token de desarrollador para usarlo en una cuenta de prueba, por lo que 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 app.