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 de las campañas de máximo rendimiento cuando se trabaja con el procesamiento por lotes. La guía genérica de procesamiento por lotes proporciona información general sobre el procesamiento por lotes, y la guía de solicitudes de estructura contiene información detallada sobre la construcción de 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 de creación de trabajos general del procesamiento por lotes para 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 MutateOperation para cada recurso que se debe incluir en el trabajo por lotes.
Requisitos de CampaignOperation y CampaignAssetOperation
Cuando los lineamientos de desarrollo de la marca están habilitados para una campaña (consulta los lineamientos de desarrollo de la marca), debes vincular los recursos de la marca a la campaña con 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. Si los recursos CampaignAsset no se crean inmediatamente después del recurso Campaign (cuando los lineamientos de desarrollo de la marca están habilitados, consulta la solución de problemas), la solicitud fallará y mostrará 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 en el medio 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.
Prácticas recomendadas de AssetGroupListingGroupFilterOperation
Cuando trabajes con filtros de grupos de fichas en el contexto de un AssetGroupListingGroupFilter, te recomendamos que agregues operaciones AssetGroupListingGroupFilterOperation segmentadas para el 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 por 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 en 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 los trabajos subidos comiencen a ejecutarse. Consulta el paso Ejecuta el trabajo por lotes en la guía general de procesamiento por lotes para ver un ejemplo.
Cómo recuperar el estado del trabajo
Los trabajos por lotes comienzan como operaciones de larga duración y, por lo general, tardan en finalizarse.
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 siguiendo el paso Lista todos los resultados de los trabajos por lotes en la guía general de procesamiento por lotes.