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 Estructura las solicitudes contiene información detallada sobre la creació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 general de creación de trabajos de procesamiento por lotes
para crear un recurso
BatchJob.
Prepara una lista de operaciones de modificación
Las campañas de máximo rendimiento requieren operaciones para crear varios recursos relacionados, que se detallan en la
guía Estructura las solicitudes. Crea un
MutateOperation para cada recurso que deba
incluirse en el trabajo por lotes.
Requisitos de CampaignOperation y CampaignAssetOperation
Cuando se habilitan los lineamientos de la marca para una campaña (consulta
los lineamientos de la marca), debes vincular
los recursos de marca a la campaña con recursos CampaignAsset. Además, en un trabajo por lotes, la creación de estos CampaignAsset
recursos debe ocurrir inmediatamente después de la creación del Campaign
recurso. Si los recursos CampaignAsset no se crean inmediatamente
después del recurso Campaign (cuando se habilitan los lineamientos de la marca, 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 agregar
AssetGroupListingGroupFilterOperation
operaciones que segmenten 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 modificación al trabajo
Agrega las operaciones de modificación de Paso 2 a una lista y llama a
AddBatchJobOperations
para agregar la lista de modificaciones al trabajo por lotes creado en Paso 1.
Sigue el paso de agregar operaciones
en la guía general de procesamiento por lotes para agregar la lista de operaciones de modificación.
Ejecuta el trabajo por lotes
Para permitir que los trabajos subidos comiencen a ejecutarse, llama a
RunBatchJob. 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 comienzan como operaciones de larga duración y, por lo general, tardan 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 finalice.
Cuando finalicen todos tus trabajos por lotes, llama a
ListBatchJobResults para
imprimir sus estados y respuestas siguiendo el
paso para enumerar todos los resultados de trabajos por lotes en
la guía general de procesamiento por lotes.