El procesamiento por lotes proporciona una forma de enviar un conjunto de operaciones, que pueden ser interdependientes, a varios servicios sin esperar de forma síncrona a que se completen las operaciones. Puedes usar el procesamiento por lotes para crear y administrar campañas de máximo rendimiento.
En esta guía, se proporcionan detalles específicos sobre las campañas de máximo rendimiento cuando se trabaja con el procesamiento por lotes. La guía de procesamiento por lotes genérica proporciona información general sobre el procesamiento por lotes, y la guía de estructura de solicitudes contiene información detallada sobre cómo crear solicitudes para crear o administrar campañas de máximo rendimiento.
Para crear una campaña de máximo rendimiento con el procesamiento por lotes, sigue estos pasos:
Crea un trabajo por lotes nuevo
Sigue el paso general para crear un trabajo de procesamiento por lotes y crear un recurso BatchJob.
Prepara una lista de operaciones de mutación
Las campañas de máximo rendimiento requieren operaciones para crear varios recursos relacionados, que se detallan en la guía de solicitudes de estructura. Crea un objeto MutateOperation para cada recurso que se deba incluir en el trabajo por lotes.
Requisitos de CampaignOperation y CampaignAssetOperation
Cuando los lineamientos de la marca están habilitados para una campaña (consulta los lineamientos de la marca), debes vincular los recursos de marca a la campaña con los recursos de CampaignAsset. Además, en un trabajo por lotes, la creación de estos recursos CampaignAsset debe ocurrir inmediatamente después de la creación del recurso Campaign en sí. Si los recursos de CampaignAsset no se crean inmediatamente después del recurso de Campaign (cuando se habilitan los lineamientos de desarrollo de la marca; consulta la solución de problemas), la solicitud fallará y devolverá un CampaignError que indica que faltan recursos.
Incluir las operaciones de creación de CampaignAsset más adelante en la misma lista de operaciones no evitará este error.
Requisitos de AssetGroupOperation y AssetGroupAssetOperation
Las operaciones de tipo MutateOperation que crean recursos AssetGroup y AssetGroupAsset en un trabajo por lotes deben ser secuenciales sin otras operaciones intermedias debido a la forma en que se agrupan estas operaciones cuando se procesan. De lo contrario, la solicitud arroja un AssetGroupError que indica que faltan algunos recursos, incluso si las operaciones necesarias para cumplir con los requisitos mínimos de recursos se incluyen más adelante en la lista de operaciones.
AssetGroupListingGroupFilterOperation prácticas recomendadas
Cuando trabajes con filtros de grupos de fichas en el contexto de un AssetGroupListingGroupFilter, te recomendamos que agregues operaciones AssetGroupListingGroupFilterOperation dirigidas al mismo AssetGroup a un trabajo por lotes de forma consecutiva, de modo que el conjunto de operaciones se trate de forma atómica durante la división por lotes. Para obtener más información sobre la división de lotes y otros factores que afectan a los grupos de fichas, consulta la guía de procesamiento por lotes de grupos de fichas.
Agrega las operaciones de mutación al trabajo
Agrega las operaciones de mutación del paso 2 a una lista y llama a AddBatchJobOperations para agregar la lista de mutaciones al trabajo por lotes creado en el paso 1.
Sigue el paso para agregar operaciones de la guía general de procesamiento por lotes para agregar la lista de operaciones de mutación.
Ejecuta el trabajo por lotes
Llama a RunBatchJob para permitir que se ejecuten los trabajos subidos. Consulta el paso Ejecuta el trabajo por lotes en la guía general de procesamiento por lotes para ver un ejemplo.
Recupera el estado del trabajo
Los trabajos por lotes se inician como operaciones de larga duración y suelen tardar en finalizar.
Después de iniciar el trabajo, usa el método GetOperation de la operación de larga duración para sondear el estado del trabajo hasta que se complete.
Cuando finalicen todos tus trabajos por lotes, llama a ListBatchJobResults para imprimir sus estados y respuestas según el paso de enumerar todos los resultados de trabajos por lotes en la guía general de procesamiento por lotes.