Registro de declinación de responsabilidades: masiva

Define una declinación de responsabilidades que se puede descargar y cargar en un archivo masivo.

Puede asociar una declinación de responsabilidades a una campaña de la cuenta. Use los registros de declinación de responsabilidades de campaña para administrar las asociaciones de declinación de responsabilidades.

Puede descargar todos los registros de extensión de aviso de declinación de responsabilidades en la cuenta incluyendo el valor DownloadEntity de DisclaimerAdExtensions 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 una nueva declinación de responsabilidades a la biblioteca compartida de la cuenta.

Type,Status,Id,Parent Id,Campaign,Client Id,Modified Time,Start Date,End Date,Ad Schedule,Use Searcher Time Zone,Disclaimer Layout,Name,Popup Text,Title,Final Url,Mobile Final Url
Format Version,,,,,,,,,,,6.0,,,,,,
Disclaimer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,English,,(Monday[09:00-21:00]),FALSE,Amenities,ValueOne;ValueTwo;ValueThree,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkDisclaimerAdExtension , en lugar de llamar directamente a las operaciones del servicio 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 BulkDisclaimerAdExtension
var bulkDisclaimerAdExtension = new BulkDisclaimerAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // DisclaimerAdExtension object of the Campaign Management service.
    DisclaimerAdExtension = new DisclaimerAdExtension
    {
        // 'DisclaimerLayout' column header in the Bulk file
        DisclaimerLayout = "additionalLine",
        // 'Id' column header in the Bulk file
        Id = disclaimerAdExtensionIdKey,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/one",
            "https://www.contoso.com/two",
            "https://www.contoso.com/three"
        },
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/one",
            "https://mobile.contoso.com/two",
            "https://mobile.contoso.com/three"
        },
        // 'Name' column header in the Bulk file
        Name = "DisclaimerName",
        // 'PopupText' column header in the Bulk file
        PopupText = "DisclaimerPopupText",
        // 'Title' column header in the Bulk file
        Title = "Disclaimer info",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        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 Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkDisclaimerAdExtension);

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

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

Para un registro de declinación de responsabilidades , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

• Programación de anuncios
• Id. de cliente
• Diseño de declinación de responsabilidades
• Ubicación editorial
• Código de motivo editorial
• Estado editorial
• Término editorial
• Fecha de finalización
• Final Url
• Id
• Mobile Final Url
• Tiempo de modificación
• Nombre
• Parent Id
• Texto emergente
• Países editores
• Fecha de inicio
• Estado
• Title
• Uso de la zona horaria del buscador
• Versión

Programación de anuncios

La lista de intervalos de día y hora que quieres que el registro se muestre con tus anuncios. Cada día y intervalo de tiempo incluye el día programado de la semana, la hora de inicio/finalización y el minuto de inicio y finalización. Cada intervalo de día y hora se incluye entre paréntesis izquierdo y derecho, y se separa de otros intervalos de días y horas con un punto y coma (;) delimitador. Dentro de cada intervalo de día y hora, el formato es Day[StartHour:StartMinue-EndHour:EndMinute].

Los valores posibles de StartHour oscilan entre 00 y 23, donde 00 es equivalente a 12:00 a.m. y 12 es a las 12:00 p.m.

Los valores posibles de EndHour oscilan entre 00 y 24, donde 00 es equivalente a 12:00 a.m. y 12 es 12:00 p.m.

Los valores posibles de StartMinute y EndMinute van de 00 a 60.

En el ejemplo siguiente se muestran los intervalos de día y hora durante los días laborables de 9:00 a.m. a 9:00 p.m.: (lunes[09:00-21:00]);( Martes[09:00-21:00]); (Miércoles[09:00-21:00]); (Jueves[09:00-21:00]); (Viernes[09:00-21:00])

Añadir: Opcional. Si no establece este campo, el registro será apto para programar en cualquier momento durante las fechas de inicio y finalización del calendario.
Actualizar: Opcional. No se pueden actualizar los intervalos de día y hora individuales. Puede actualizar eficazmente los intervalos de día y hora mediante el envío de un nuevo conjunto que debe reemplazar el conjunto anterior. Los campos Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja todos estos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de todos estos campos se quitan o reemplazan. Para quitar toda la configuración de programación anterior, establezca cada uno de estos campos en delete_value.
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

Diseño de declinación de responsabilidades

Diseño de la declinación de responsabilidades. Puede ser additionalLine o popup.

Ubicación editorial

Componente o propiedad del registro que produjo un error en la revisión editorial.

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

Código de motivo editorial

Código que identifica el motivo del error. Para obtener una lista de posibles códigos de motivo, consulte Códigos de motivo editoriales.

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

Estado editorial

Estado editorial del registro.

Los valores posibles se describen en la tabla siguiente.

Valor	Descripción
Activo	El registro superó la revisión editorial.
ActiveLimited	El registro superó la revisión editorial en uno o varios mercados, y uno o más elementos del registro se someten a revisión editorial en otro mercado. Por ejemplo, el registro pasó la revisión editorial para Canadá y todavía está pendiente de revisión en el Estados Unidos.
Desaprobó	El registro falló en la revisión editorial.
Inactivo	Uno o varios elementos del registro están siendo revisados editorialmente.

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

Término editorial

El término que falló en la revisión editorial.

Este campo no se establecerá si una combinación de términos produjo el error o si el error se basó en una infracción de directiva.

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

Fecha de finalización

Cadena de fecha de finalización programada del registro con formato MM/DD/AAAA.

La fecha de finalización es inclusiva. Por ejemplo, si establece este campo en 12/31/2020, los registros dejarán de mostrarse a las 11:59 p. m. del 12/31/2020.

Añadir: Opcional. Si no especificas una fecha de finalización, el registro se seguirá entregando a menos que pauses las campañas, grupos de anuncios o anuncios asociados.
Actualizar: Opcional. La fecha de finalización se puede acortar o ampliar, siempre que la fecha de inicio sea nula o se produzca antes de la nueva fecha de finalización. Si establece este campo en la cadena de delete_value , quitará eficazmente la fecha de finalización. Los campos Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja todos estos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de todos estos campos se quitan o reemplazan. Para quitar toda la configuración de programación anterior, establezca cada uno de estos campos en delete_value.
Eliminar: Solo lectura

Final Url

Dirección URL de la página de aterrizaje.

Las siguientes reglas de validación se aplican a las direcciones URL finales y las direcciones URL de Final Mobile.

• La longitud de la dirección URL está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.
• Puede especificar hasta 10 elementos de lista para la dirección URL final y la dirección URL final móvil; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 elementos de lista para una posible compatibilidad con reenvíos.
• Cada dirección URL está delimitada por un punto y coma y un espacio ("; ").
• El uso de '{' y '}' solo puede delinear etiquetas, por ejemplo {lpurl}.
• Las direcciones URL finales deben ser una dirección URL bien formada a partir de http:// o https://.
• Si especifica Mobile Final Url, también debe especificar La dirección URL final.

Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Id

Identificador generado por el sistema del registro.

Añadir: 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 registro en el campo Id de tipos de registro dependientes, como y Aviso de declinación de responsabilidades de campaña. Esto se recomienda si va a agregar registros nuevos 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
Eliminar: Solo lectura y Obligatorio

Mobile Final Url

Dirección URL de la página de aterrizaje para dispositivos móviles.

Las siguientes reglas de validación se aplican a las direcciones URL finales y las direcciones URL de Final Mobile.

• La longitud de la dirección URL está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.
• Puede especificar hasta 10 elementos de lista para la dirección URL final y la dirección URL final móvil; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 elementos de lista para una posible compatibilidad con reenvíos.
• Cada dirección URL está delimitada por un punto y coma y un espacio ("; ").
• El uso de '{' y '}' solo puede delinear etiquetas, por ejemplo {lpurl}.
• Las direcciones URL finales deben ser una dirección URL bien formada a partir de http:// o https://.
• Si especifica Mobile Final Url, también debe especificar La dirección URL final.

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

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

Nombre

Nombre de la declinación de responsabilidades. Esto solo se usa para los informes para ayudar a identificar el registro.

Máx. longitud: 35 caracteres.

Parent Id

Identificador generado por el sistema de la cuenta que contiene el registro.

Este campo masivo se asigna al campo Id del registro de cuenta .

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

Texto emergente

Texto necesario si la declinación de responsabilidades está en el diseño de elementos emergentes .

Máx. longitud: 500 caracteres.

Países editores

Lista de países o regiones del publicador cuyas directrices editoriales no permiten el término especificado.

En un archivo masivo, la lista de países o regiones del publicador se delimita con un punto y coma (;).

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

Fecha de inicio

Cadena de fecha de inicio programada del registro con formato MM/DD/AAAA.

La fecha de inicio es inclusiva. Por ejemplo, si establece StartDate en 5/5/2020, los registros comenzarán a mostrarse a las 12:00 AM el 5/5/2020.

Añadir: Opcional. Si no especifica una fecha de inicio, el registro se puede programar inmediatamente.
Actualizar: Opcional. La fecha de inicio se puede acortar o ampliar, siempre que la fecha de finalización sea nula o se produzca después de la nueva fecha de inicio. Si establece este campo en la cadena de delete_value , eliminará de forma eficaz la fecha de inicio y el registro podrá programarse inmediatamente. Los campos Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja todos estos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de todos estos campos se quitan o reemplazan. Para quitar toda la configuración de programación anterior, establezca cada uno de estos campos en delete_value.
Eliminar: Solo lectura

Estado

Estado del registro.

Los valores posibles son Active o Deleted.

Añadir: Opcional. El valor predeterminado es Active.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.

Cargo

Título del elemento emergente en el diseño de elementos emergentes.

Máx. longitud: 75 caracteres.

Uso de la zona horaria del buscador

Determina si se debe usar la zona horaria de la cuenta o la zona horaria del usuario de búsqueda donde se podrían entregar los anuncios.

Establezca esta propiedad en TRUE si desea que los registros se muestren en la zona horaria del usuario de búsqueda y, de lo contrario, establézcala en FALSE.

Añadir: Opcional. Si no especifica este campo o lo deja vacío, se establecerá el valor predeterminado de FALSE y se usará la zona horaria de la cuenta.
Actualizar: Opcional. Si establece este campo en la cadena delete_value , se restablece eficazmente al valor predeterminado de FALSE. Los campos Programación de anuncios, Fecha de finalización, Fecha de inicio y Usar zona horaria del buscador dependen entre sí y se actualizan juntos. Si deja todos estos campos vacíos durante la actualización, ninguno de ellos se actualiza. Si incluye valores para cualquiera de estos campos, los valores anteriores de todos estos campos se quitan o reemplazan. Para quitar toda la configuración de programación anterior, establezca cada uno de estos campos en delete_value.
Eliminar: Solo lectura

Versión

Número de veces que se ha actualizado el contenido del registro. La versión se establece en 1 cuando se agrega el registro y se incrementa cada vez que se revisa.

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