Video: Mira 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 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 en relación con el cumplimiento de las Condiciones del Servicio de las APIs, es posible que se revoque tu acceso a las APIs sin que lo sepas. Evita usar una dirección de correo electrónico personal vinculada a una cuenta individual o no supervisada. Para ver el Centro de API, debes acceder a tu cuenta de administrador.
Para estar al tanto de problemas como cambios en los productos, tiempo 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 regularidad, lo que lo convierte en el lugar ideal para publicar preguntas sobre la API.
- Mantén tu aplicación en cumplimiento con los Términos y Condiciones (TyC) 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 C&C, puedes comunicarte con el equipo de revisión respondiendo el correo electrónico que te envió cuando revisó tu solicitud de token de desarrollador.
Optimización
Puedes optimizar tu app ejecutando operaciones por lotes y, si corresponde, enviando 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 los sistemas de backend. Para reducir 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 es posible, 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 en 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 los objetos se envían a la API, los campos se deben deserializar, validar y almacenar en la base de datos. Si pasas objetos completos cuando solo quieres actualizar algunos campos, se puede generar un tiempo de procesamiento adicional y un rendimiento reducido.
Para mitigar este problema, la API de Google Ads admite actualizaciones dispersas, lo que te permite completar 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 conocido 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 dispersas, ya que solo se deberían completar los campos de ID del grupo de anuncios, ID del criterio y 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, consulta la guía de solución de problemas para obtener más información sobre la administración de errores.
Distingue las fuentes de solicitudes
Algunas apps son principalmente interactivas y emiten llamadas a la API directamente en respuesta a las acciones iniciadas por el usuario en una IU. Otros funcionan principalmente sin conexión y emiten llamadas a la API como parte de un proceso periódico de backend. Muchas apps combinan ambos enfoques. 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 principal preocupación debe ser proporcionar una buena experiencia a los usuarios. Usa el error específico que se produjo para proporcionar al usuario la mayor cantidad de contexto posible en la IU. Ofrece pasos sencillos que puedan seguir para resolver el error (consulta las sugerencias a continuación).
Para 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 comunes o que no se hayan encontrado antes. Un buen enfoque para un controlador predeterminado es agregar la operación fallida y el error a una cola para 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 cuando se compila un control de errores sólido. 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 detalles.
Backend 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 detecte, lo que provocará que la base de datos local de tu app deje de estar sincronizada. Como se indica en nuestra guía de Tipos de errores, puedes abordar los errores relacionados con la sincronización de forma reactiva cuando ocurren, pero también puedes intentar prevenirlos de forma proactiva. Una estrategia proactiva es ejecutar un trabajo de sincronización nocturno 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 se deben registrar 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 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 que puedas 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 generar 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 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 aplicación funcionen según lo previsto. 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 aplicación.