Compartir a través de


Registro de grupo de lista de grupos de activos: masivo

Define un grupo de listas de grupos de recursos que se puede cargar y descargar en un archivo masivo.

Puede cargar registros de grupo de listas de grupos de grupos de activos para varios grupos de anuncios en el mismo archivo masivo, siempre y cuando se cumplan las reglas de validación que se describen a continuación.

  • Como mínimo, debe especificar al menos el nodo raíz para la estructura de árbol del grupo de particiones de producto. El nodo raíz del grupo de particiones de producto debe tener su campo Condición de producto 1 establecido en "Todos" y Valor de producto 1 nulo o vacío. Si va a pujar por todos los productos del catálogo por igual, establezca el campo Subtipo en Unidad. Si va a crear particiones de las pujas en función de condiciones de producto más específicas, establezca el campo Subtipo en Subdivision, el Id. de criterio primario en null o vacío y el Id en un valor negativo. Usará el valor negativo como Id. de criterio primario para los nodos secundarios.

  • El nodo raíz se considera nivel 0 y un árbol puede tener ramas de hasta 7 niveles de profundidad.

  • Por solicitud de carga, puede incluir un máximo de 20 000 nodos de árbol de particiones de producto por grupo de anuncios. El número completo de nodos de árbol de particiones de producto para un grupo de anuncios no puede superar los 20 000.

  • Los nodos de árbol de partición de producto para el mismo árbol (mismo grupo de anuncios) deben agruparse en el archivo.

  • El orden de los nodos de partición de producto no está garantizado durante la descarga y es posible que se proporcionen nodos primarios después de los nodos secundarios; sin embargo, todos los nodos del mismo grupo de anuncios se agruparán en el archivo.

  • Si va a crear o modificar la estructura de árbol, los nodos de árbol de partición de producto primario se deben ordenar antes que los nodos de árbol de partición de producto secundario; sin embargo, la orden no es importante para los cambios no estructurales, como actualizar la oferta. Por ejemplo, si desea actualizar las pujas sin agregar, eliminar o actualizar la estructura de árbol, solo tiene que cargar los campos Id y Parent Id .

  • Para actualizar el campo Condición de producto 1, Valor de producto 1 o Está excluido , debe eliminar el nodo de árbol de partición de producto existente y cargar un nuevo nodo de árbol de particiones de producto que obtendrá un nuevo identificador.

  • Si se produce un error en alguna acción, también se producirá un error en todas las acciones restantes que podrían haberse realizado correctamente.

  • Todas las acciones de adición y eliminación de nodos de partición de producto deben dar lugar a una estructura de árbol completa.

  • Cada ruta de acceso desde el nodo raíz hasta el final de una rama debe terminar con un nodo hoja (Subtipo=Unidad). Cada unidad debe tener una puja, a menos que el campo Se excluye sea TRUE, lo que significa que el nodo es un criterio negativo del grupo de anuncios.

  • Cada subdivisión debe tener al menos un nodo hoja que puja por el resto de las condiciones de la subdivisión, es decir, usar el mismo operando que sus unidades del mismo nivel y establecer su valor de producto 1 null o vacío.

  • Si va a agregar particiones con varios niveles en los que aún no existe ninguno de los elementos primarios o secundarios, use un valor int negativo como referencia para identificar al elemento primario. Por ejemplo, establezca el id. del elemento primario y el campo Parent Criterion Id del elemento secundario en el mismo valor negativo. Los identificadores negativos solo son válidos durante la llamada. Los identificadores únicos del sistema para cada criterio de grupo de anuncios agregado correctamente se devuelven en el archivo de resultados de carga.

  • Para pausar cualquier partición de producto, debe pausar todo el grupo de anuncios actualizando el campo Estado del grupo de anuncios a Pausado. Puedes pausar toda la campaña actualizando el campo Estado de la campaña a Pausado .

  • En el caso de una acción Eliminada , solo tiene que especificar el identificador y el identificador primario.

  • Si elimina una partición de producto primaria, también se eliminarán todos sus elementos secundarios y descendientes.

  • No puede especificar condiciones de producto duplicadas en una rama.

Puede descargar todos los registros de grupo de listas de grupos de grupos de activos de la cuenta incluyendo el valor DownloadEntity de AssetGroupListingGroups en la solicitud de servicio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Además, la solicitud de descarga debe incluir el ámbito EntityData . Para obtener más información sobre el servicio masivo, incluidos los procedimientos recomendados, consulte Descarga y carga masivas.

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkAssetGroupListingGroup , en lugar de llamar a las operaciones de servicio directamente y escribir código personalizado para analizar cada campo en el archivo masivo.

Para un registro de grupo de lista de grupos de recursos, los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Grupo de recursos

Nombre del grupo de recursos al que pertenece el grupo de listas de grupos de recursos.

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de recursos y Campaña .

Agregar: Solo lectura y Obligatorio
Actualizar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio

Campaña

Nombre de la campaña que contiene el grupo de recursos y el grupo de listados.

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de recursos y Campaña .

Agregar: Solo lectura y Obligatorio
Actualizar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio

Identificador de cliente

Se usa para asociar registros en el archivo de carga masiva con registros en el archivo de resultados. El servidor no usa ni almacena el valor de este campo; simplemente se copia del registro cargado en el registro de resultados correspondiente. Puede ser cualquier cadena válida de hasta 100 en longitud.

Agregar: Opcional
Actualizar: Opcional
Borrar: Solo lectura

Id

Identificador generado por el sistema del grupo de listas de grupos de recursos.

Agregar: Opcional. Debe dejar este campo vacío o especificar un identificador negativo. A continuación, se puede hacer referencia a un identificador negativo establecido para el grupo de listas de grupos de recursos en el campo Id. primario de tipos de registro dependientes, como anuncios, palabras clave o criterio. Esto se recomienda si va a agregar nuevos grupos de listas de grupos de recursos y nuevos registros dependientes en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio

Se excluye

Determina si los productos pertenecen al grupo de lista deben excluirse al servir.

Si se establece en true , es un criterio negativo y, de lo contrario, si es false , es un criterio positivo.

Agregar: Obligatorio
Actualizar: Solo lectura
Borrar: Solo lectura

Tiempo de modificación

Fecha y hora en que se actualizó por última vez la entidad. El valor se encuentra en la hora UTC (hora universal coordinada).

Nota:

El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.

Agregar: Solo lectura
Actualizar: Solo lectura
Borrar: Solo lectura

Parent Id

Identificador del grupo de recursos que contiene el grupo de listados.

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de recursos y Campaña .

Agregar: Solo lectura y Obligatorio
Actualizar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio

Id. de grupo de lista principal

Como mínimo, debe especificar al menos el nodo raíz para la estructura de árbol.

El nodo raíz del grupo de listado debe tener su campo Condición de producto 1 establecido en Todos y Valor de producto 1 nulo o vacío.

Si va a pujar por todos los productos del catálogo por igual, establezca el campo Subtipo en Unidad.

Si va a crear particiones de los productos en función de condiciones de producto más específicas, establezca el campo Subtipo en Subdivision, el Id. de grupo de listado primario en null o vacío y el Id en un valor negativo. Usará el valor negativo como Id. de grupo de listado primario para los nodos secundarios.

Agregar: Obligatorio
Actualizar: Solo lectura y Obligatorio
Borrar: Solo lectura y Obligatorio

Condición del producto 1

Operando de la condición. Los operandos incluyen implícitamente el operador igual. Por ejemplo, puede leer Marca como Brand=.

Use la condición de producto 1 como operando para el valor de producto 1.

Se pueden especificar varias condiciones de producto para cada grupo de recursos de Microsoft Performance Max. Cada condición se cumple si el valor del atributo del producto es igual al valor del atributo del operando. Por ejemplo, si el operando se establece en Marca y el atributo se establece en Contoso, se cumple la condición si el valor del atributo Brand del catálogo de productos es igual a Contoso.

En las campañas De rendimiento máximo, las condiciones del producto solo se pueden establecer en el nivel de grupo de recursos. En la tabla siguiente se describen las reglas de negocio Condición del producto (operando) y Valor del producto (atributo) para los objetos AssetGroupListingGroup del grupo de recursos.

Condición del producto (operando) Descripción del valor del producto (atributo) Reglas de partición de producto del grupo de recursos
todas Debe ser null. Para las particiones de producto de un grupo de recursos, el nodo raíz debe tener el operando establecido en All y el atributo establecido en null o vacío.
Marca Fabricante, marca o editor del producto.

Un máximo de 1000 caracteres.
Para las particiones de producto de un grupo de recursos, el nodo raíz debe tener el operando establecido en All y el atributo establecido en null o vacío.
CategoryL1-5

Hay cinco valores de operando de categoría disponibles, es decir, CategoryL1, CategoryL2, CategoryL3, CategoryL4 y CategoryL5.
Categoría de producto definida por la tienda de Microsoft Merchant Center.

CategoryL0 es la categoría de nivel más alto y CategoryL4 es el nivel más bajo o la categoría más granular.

Un máximo de 100 caracteres.
Cada uno de los operandos CategoryL se puede usar en varias ramas.

Cada uno de los operandos CategoryL se puede usar en varias ramas, pero solo se puede especificar una vez por rama. Por ejemplo, una rama puede contener CategoryL1 y CategoryL2, pero puede que no contenga otro nodo con el operando CategoryL2 .

Si establece el operando en una categoría de producto de 1 a 5, se deben especificar en orden ascendente. Por ejemplo, el operando se puede establecer en CategoryL2 con el atributo Pet Supplies, si una partición de producto de nivel superior tiene operando CategoryL1 con el atributo Animals & Pet Supplies.

No es necesario especificar el operando de categoría de producto de nivel anterior en la partición primaria inmediata. Por ejemplo, se podría especificar una condición CategoryL2 para una partición de producto si el elemento primario de su elemento primario especificaba una condición CategoryL1 .
Canal El canal anuncios de inventario local (LIA).

Entre los valores posibles se incluyen "Tiendas locales" y "En línea".

Si la campaña no ha optado por anuncios de inventario local, todas las ofertas son de forma predeterminada solo en línea (Channel=Online) y un solo canal (ChannelExclusivity=Single-channel). Para obtener más información, consulta la página de ayuda de Anuncios de inventario local .
El operando channel se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
ChannelExclusivity Exclusividad del canal anuncios de inventario local (LIA).

Entre los valores posibles se incluyen "Canal único" y "Multicanal".

Si la campaña no ha optado por anuncios de inventario local, todas las ofertas son de forma predeterminada solo en línea (Channel=Online) y un solo canal (ChannelExclusivity=Single-channel). Para obtener más información, consulta la página de ayuda de Anuncios de inventario local .
El operando ChannelExclusivity se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
Condición Condición del producto.

Si el operando se establece en Condición, los valores de atributo admitidos que puede especificar son New, Used y Refurbished.
El operando Condition se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
CustomLabel0-4

Hay cinco valores de operando de etiqueta personalizados disponibles, como CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 y CustomLabel4.
Etiqueta personalizada definida por el comerciante.

Las etiquetas personalizadas, por ejemplo, CustomLabel0 y CustomLabel4, no se validan en función de ninguna jerarquía.

Un máximo de 100 caracteres.
Cada uno de los operandos CustomLabel se puede usar en varias ramas, pero solo se puede especificar una vez por rama. Por ejemplo, una rama puede contener CustomLabel0 y CustomLabel1, pero puede que no contenga otro nodo con el operando CustomLabel1 .
Id Identificador de producto definido por el comerciante.

Un máximo de 1000 caracteres.
El operando Id se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
ProductType1-5

Hay cinco valores de operando de tipo de producto disponibles, es decir, ProductType1, ProductType2, ProductType3, ProductType4 y ProductType5.
Tipo de producto o categoría definido por el comerciante.

ProductType1 es el tipo de producto de nivel más alto y ProductType5 es el nivel más bajo o el tipo de producto más granular.

Un máximo de 100 caracteres.
Cada uno de los operandos ProductType se puede usar en varias ramas, pero solo se puede especificar una vez por rama. Por ejemplo, una rama puede contener ProductType1 y ProductType2, pero no puede contener otro nodo con el operando ProductType2 .

Si establece el operando en un tipo de producto de 1 a 5, se deben especificar en orden ascendente. Por ejemplo, el operando se puede establecer en ProductType2 con el atributo Pet Supplies, si una partición de producto de nivel superior tiene operando ProductType1 con el atributo Animals & Pet Supplies.

No es necesario especificar el operando de tipo de producto de nivel anterior en la partición primaria inmediata. Por ejemplo, se podría especificar una condición ProductType2 para una partición de producto si el elemento primario de su elemento primario especificaba una condición ProductType1 .

Agregar: Obligatorio
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar la partición del producto y agregar una nueva.
Borrar: Solo lectura

Valor del producto 1

Valor del atributo de la condición.

El valor de un atributo debe coincidir exactamente con el valor especificado en el archivo de catálogo de Microsoft Merchant Center del cliente.

Agregar: Obligatorio
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar la partición del producto y agregar una nueva.
Borrar: Solo lectura

Estado

Estado del grupo de listas de grupos de recursos.

Los valores posibles son Active y Deleted.

Agregar: Opcional.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Borrar: Obligatorio. El estado debe establecerse en Eliminado.

Subtipo

Tipo de grupo de listas de grupos de recursos.

Los valores posibles son Subdivision y Unit.

Agregar: Obligatorio
Actualizar: Solo lectura
Borrar: Solo lectura