Registro de grupo de listado de hoteles del grupo de anuncios: masivo

Define un grupo de listados de hoteles de grupo de anuncios que se puede cargar y descargar en un archivo masivo.

Puede cargar registros de grupo de anuncios de hoteles de grupo de anuncios 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 de grupo de lista de hoteles. El nodo raíz del grupo de listado de hoteles debe tener su campo Atributo de hotel establecido en "All" y Valor de atributo de hotel nulo o vacío. Si va a pujar por todos los hoteles del catálogo por igual, establezca el campo Subtipo en Unidad. Si va a crear particiones de las pujas en función de atributos de hotel más específicos, establezca el campo Subtipo en Subtipo, el Id. de criterio primario en null o vacío y el Identificador 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 grupo de lista de hoteles por grupo de anuncios. El número completo de nodos de árbol de grupo de lista de hoteles para un grupo de anuncios no puede superar los 20 000.

• Los nodos de árbol de grupo de lista de hoteles para el mismo árbol (mismo grupo de anuncios) deben agruparse en el archivo.

• El orden de los nodos de grupo de lista de hoteles no está garantizado durante la descarga, y es posible que los nodos primarios se proporcionen 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 lista de hoteles primarios deben ordenarse antes que los nodos de árbol de grupo de lista de hoteles secundarios; 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 del árbol, solo tiene que cargar los campos Id, Parent Id y Bid .

• Para actualizar el campo Atributo de hotel, Valor de atributo de hotel o Está excluido , debe eliminar el nodo de árbol de grupo de lista de hoteles existente y cargar un nuevo nodo de árbol de grupo de listado de hoteles 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 grupo de lista de hoteles 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 oferta, 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 atributo hotel 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.

• El campo Bid solo es aplicable si el campo Está excluido es false , lo que significa que el nodo es un criterio de grupo de anuncios que se puede pujar. Sin embargo, la oferta se omite para los nodos de partición de subdivisión . Esos elementos solo son pertinentes para los nodos de partición de unidad (hoja).

• Para pausar cualquier grupo de anuncios de hoteles, debes 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 un grupo de listados de hoteles primario, también se eliminarán todos sus elementos secundarios y descendientes.

• No puede especificar atributos de hotel duplicados en una rama.

Puede descargar todos los registros del grupo de listados de hoteles de grupo de anuncios de la cuenta incluyendo el valor DownloadEntity de AdGroupHotelListingGroups 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.

En el siguiente ejemplo de CSV masivo se agregaría un nuevo grupo de listados de hoteles de grupo de anuncios si se proporciona un valor de Id. primario válido.

Type,Name,Campaign,Time Zone,Campaign Type,Language,Sub Type,Budget Id,Budget,Budget Type,Bid Strategy Type,Bid Strategy PercentMaxCpc,Ad Schedule Use Searcher Time Zone,Client Id,Id,Parent ID,Parent Criterion Id,Ad Group,Ad Group Type,Search Network,Content Network,Percent Cpc Bid,Hotel Ad Group Type,Percent Bid,Hotel Attribute,Hotel Attribute Value,Is Excluded
Format Version,6,,,,,,,,,,,,,,,,,,,,,,,,,
Campaign,,Test Hotel Campaign HLG,PacificTimeUSCanadaTijuana,Hotel,All,,delete_value,25,DailyBudgetStandard,PercentCpc,8.3,false,0,,,,,,,,,,,,,,
AdGroup,,Test Hotel Campaign HLG,,,,,,,,,,,,,,,Test Hotel AdGroup,Hotel,On,Off,3.74,HotelAd,,,,,
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Subdivision,,,,,,,,-1,,,Test Hotel AdGroup,,,,,HotelAd,,All,,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-2,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,Marriott,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-3,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,Hilton,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-4,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,,false

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupProductPartition
var bulkAdGroupProductPartition = new BulkAdGroupProductPartition
{
    // Map properties in the Bulk file to the BiddableAdGroupCriterion or
    // NegativeAdGroupCriterion object of the Campaign Management service.
    // Use the BiddableAdGroupCriterion to set the 'Is Excluded' field in the Bulk file to true,
    // and otherwise use the NegativeAdGroupCriterion to set the 'Is Excluded' field to false.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new HotelListingGroup { 
            Condition = new HotelListingCondition
            {
                // 'Hotel Attribute Value' column header in the Bulk file
                Attribute = null,
                // 'Hotel Attribute' column header in the Bulk file
                Operand = "All",
            },
            // 'Parent Criterion Id' column header in the Bulk file
            ParentCriterionId = null
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupProductPartition);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

En el caso de un registro de grupo de listados de hoteles de grupo de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

• Grupo de anuncios
• Oferta
• Porcentaje de puja
• Campaña
• Id. de cliente
• Parámetro personalizado
• Sufijo de dirección URL final
• Id
• Se excluye
• Tiempo de modificación
• Id. de criterio primario
• Parent Id
• Atributo Hotel
• Valor del atributo hotel
• Estado
• Subtipo
• Plantilla de seguimiento

Grupo de anuncios

Nombre del grupo de anuncios que contiene el grupo de anuncios de hoteles.

Añadir: Solo lectura y Obligatorio
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

Nota:

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .

Oferta

Cantidad que se va a pujar en la subasta. Esto se usa cuando el esquema de puja de campaña es ManualCpc.

Añadir: Obligatorio si Se excluye es false y el subtipo es Unit y, en caso contrario, no se permite la puja.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Porcentaje de puja

Cantidad que se va a pujar en la subasta. Esto se usa cuando el esquema de licitación de campaña es PercentCpc o Commission.

Añadir: Obligatorio si Se excluye es false y el subtipo es Unit y, en caso contrario, no se permite la puja.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Campaña

Nombre de la campaña que contiene el grupo de anuncios y el grupo de anuncios de hoteles.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

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.

Añadir: Opcional
Actualizar: Opcional
Eliminar: Solo lectura

Parámetro personalizado

Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL.

En un archivo masivo, la lista de parámetros personalizados tiene el formato siguiente.

• Dé formato a cada par de parámetros personalizado como Key=Value, por ejemplo{_promoCode}=PROMO1.

• Microsoft Advertising aceptará los 8 primeros pares de clave y valor de parámetro personalizados que incluya y, si incluye más de 8 parámetros personalizados, se devolverá un error.

• Cada par de clave y valor se delimita por un punto y coma y un espacio ("; "), por ejemplo {_promoCode}=PROMO1; {_season}=verano.

• Una clave no puede contener un punto y coma. Si un valor contiene un punto y coma, debe tener escape como '\;'. Además, si el valor contiene una barra diagonal inversa, también debe tener el carácter de escape '\'.

• La clave no puede superar los 16 bytes UTF-8 y el valor no puede superar los 250 bytes UTF-8. La clave es necesaria y el valor es opcional. El tamaño máximo de la clave no incluye las llaves y el carácter de subrayado, es decir, '{', '_' y '}'.

  Nota:

  Con el servicio bulk, la clave debe tener formato con llaves circundantes y un carácter de subrayado inicial, por ejemplo, si la clave es promoCode, debe tener el formato {_promoCode}. Con el servicio Administración de campañas no puede especificar las llaves y el carácter de subrayado circundantes.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para quitar todos los parámetros personalizados, establezca este campo en delete_value. La palabra clave delete_value quita la configuración anterior. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar y omita los que no desee conservar. El nuevo conjunto de parámetros personalizados reemplazará a cualquier conjunto de parámetros personalizados anterior.
Eliminar: Solo lectura

Sufijo de dirección URL final

El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura

Id

Identificador generado por el sistema del grupo de listados de hoteles.

Añadir: Solo lectura
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

Se excluye

Determina si el grupo de listados de hoteles representa un criterio pujable o negativo.

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

Añadir: Obligatorio
Actualizar: Solo lectura
Eliminar: 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.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Id. de criterio primario

Identificador de criterio del grupo de listados de hoteles primario.

Este campo masivo se asigna a ParentNodeId y debe ser null para que apunte al nodo raíz.

Nota:

Este campo no es aplicable para el nodo de grupo de lista de hoteles raíz de árbol, que no tiene ningún elemento primario.

Añadir: Solo lectura y Obligatorio
Actualizar: Solo lectura
Eliminar: Solo lectura

Parent Id

Identificador generado por el sistema del grupo de anuncios que contiene el grupo de listados de hoteles.

Este campo masivo se asigna al campo Id del registro del grupo de anuncios .

Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de grupo de anuncios existente o especificar un identificador negativo que sea igual al campo Id del registro del grupo de anuncios primario. Esto se recomienda si va a agregar nuevos grupos de anuncios de hoteles a un nuevo grupo de anuncios 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
Eliminar: Solo lectura y Obligatorio

Nota:

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .

Atributo Hotel

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

Use el atributo Hotel como operando para el valor del atributo Hotel.

Se pueden especificar varios atributos de hotel para cada campaña y grupo de anuncios. Cada condición se cumple si el valor del atributo del hotel es igual al valor del atributo del operando. Por ejemplo, si el operando está establecido en Marca y el atributo se establece en Contoso, se cumple la condición si el valor del atributo Brand del catálogo de hoteles es igual a Contoso.

En tus campañas, los atributos de hotel se pueden establecer en el nivel de campaña y grupo de anuncios. En la tabla siguiente se describen las reglas de negocios Atributo de hotel (operando) y Valor de atributo de hotel (atributo) para los registros de grupo de listados de hoteles de grupo de anuncios .

Nota:

El atributo Hotel debe ser "All" cuando Hotel Value está establecido en null o vacío para el nodo raíz.

Atributo Hotel (operando)	Descripción del valor de atributo de hotel (atributo)	Reglas de grupo de anuncios de hoteles de grupo
todas	No procede.	Para los grupos de listados de hoteles de un grupo de anuncios, 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 hotel. Un máximo de 200 caracteres.	El operando Brand se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
Categoría	Una categoría de hotel, como "Inn", "Motel", "Resort", etc. Un máximo de 200 caracteres.	No procede.
Ciudad	La ciudad donde se encuentra el hotel.	No procede.
País	País o región donde se encuentra el hotel.	No procede.
CustomLabel0-4 Hay cinco valores de operando de etiqueta personalizados disponibles, como CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 y CustomLabel4.	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 . Un máximo de 200 caracteres.	No procede.
HotelId	Identificador de hotel. Un máximo de 1024 caracteres.	El operando Id se puede usar en varias ramas, pero solo se puede especificar una vez por rama.
StarRating	Clasificación de hotel de 1 a 5 estrellas.	No procede.
Estado	Estado en el que se encuentra el hotel.	No procede.

Añadir: Obligatorio
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar el grupo de listados de hoteles y agregar uno nuevo.
Eliminar: Solo lectura

Valor del atributo hotel

Valor del atributo de la condición.

Añadir: Obligatorio
Actualizar: Solo lectura. No se pueden actualizar los campos de condición o valor. Para actualizar las condiciones, debe eliminar el grupo de listados de hoteles y agregar uno nuevo.
Eliminar: Solo lectura

Estado

Estado del grupo de listados de hoteles.

Los valores posibles son Active o Deleted.

Añadir: Opcional. El único estado posible es Activo. Si establece el estado en Eliminado , se omitirá y el registro devuelto tendrá el estado establecido en Activo.
Actualizar: Opcional
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.

Subtipo

El tipo de grupo de listados de hoteles.

Los valores posibles son Subdivision y Unit.

Añadir: Obligatorio
Actualizar: Solo lectura
Eliminar: Solo lectura

Plantilla de seguimiento

Las plantillas de seguimiento se pueden usar junto con la dirección URL especificada en el campo "Link" para la oferta de hotel que envió a través de Content API. Al combinar la dirección URL de la fuente con la plantilla de seguimiento, la dirección URL de la página de aterrizaje se ensambla donde se dirige a un usuario después de hacer clic en el anuncio. Al usar el campo Plantilla de seguimiento para actualizar los parámetros de dirección URL en lugar de actualizarlos en la dirección URL de la fuente, la dirección URL de la fuente no tiene que pasar por la revisión editorial y los anuncios seguirán atendiendo de forma ininterrumpida. Por ejemplo, si la dirección URL de la oferta de hotel en la fuente del catálogo es https://contoso.com/, podría especificar la siguiente plantilla de seguimiento: {lpurl}?matchtype={matchtype}&device={device}.

Las siguientes reglas de validación se aplican a las plantillas de seguimiento. Para obtener más información sobre las plantillas y los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?

• Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad.

• La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.

• La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}.

• Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura