Video: Consulta la charla sobre prácticas recomendadas del taller de 2019
En esta guía, se describen 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 comunicarnos 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 estar al tanto de problemas, como cambios en los productos, tiempo de inactividad por mantenimiento,
El equipo de la API de Google Ads supervisa con regularidad 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 a través de 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 respondiendo el correo electrónico que te envió cuando revisaste tu solicitud de token de desarrollador.
Optimización
Operaciones por lotes
Enviar 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 modificación en la API están diseñados para aceptar un array de operaciones. Si agrupas en lotes varias operaciones 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 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.
Envía 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 tiempo de procesamiento adicional y una disminución del rendimiento.
Para mitigar este problema, la API de Google Ads admite actualizaciones dispersas, lo que te permite
propagar solo los campos en 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 conocido como FieldMask) no se modifican.
Por ejemplo, una app que actualiza ofertas a nivel de palabras clave puede beneficiarse del uso de actualizaciones dispersas, ya que solo se deberán propagar el ID del grupo de anuncios, el ID del criterio y los campos de 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 estrategias para incorporar la administración de errores en tu app. Además de esta sección, puedes visitar la guía de solución de problemas para obtener más información sobre cómo administrar 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 ambos elementos. 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 pueda encontrar tu app. Siempre incluye un controlador predeterminado para abordar errores poco comunes o que no se encontraron con anterioridad. Un buen enfoque para un controlador predeterminado es agregar la operación con errores y el error a una cola para que un operador humano los revise y determine una resolución adecuada.
Distinguir tipos de error
Conocer las diferencias entre los tipos de errores en la API de Google Ads es fundamental para compilar un manejo sólido de los errores. Estos son algunos de los tipos de error 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 error y Errores comunes para obtener más detalles.
Sincronización de 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 conoce, lo que podría provocar que la base de datos local de la app no esté sincronizada. Como se indica en nuestra guía Tipos de errores, puedes abordar los errores relacionados con la sincronización de manera reactiva cuando ocurren, pero también puedes tratar de evitarlos de manera proactiva. Una estrategia proactiva es ejecutar un trabajo de sincronización nocturno en todas tus cuentas, recuperar los objetos de Google Ads de tus cuentas 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 la solicitud 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 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 probar que la conectividad de tu app, la lógica de administración de la campaña o algún otro procesamiento funcionen según lo esperado. 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 solicitarlo, incluso antes de que se revise tu app.