Registro de extensión de anuncio de llamada: masiva

  • Artículo

Define una extensión de anuncio de llamada que se puede cargar y descargar en un archivo masivo.

Puede asociar una extensión de anuncio de llamada a campañas de la cuenta. Cada entidad (campaña) se puede asociar a una extensión de anuncio de llamada. Usa el registro Extensión de anuncio de llamada de campaña para administrar las asociaciones de extensiones de anuncios de llamadas.

Puede descargar todos los registros de extensión de anuncio de llamada de la cuenta incluyendo el valor DownloadEntity de CallAdExtensions 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 extensión de anuncio de llamada a la biblioteca compartida de la cuenta.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Country Code,Call Only,Call Tracking Enabled,Toll Free
Format Version,,,,,,,,,,,,6.0,,,,,,
Call Ad Extension,Active,-12,0,,,ClientIdGoesHere,,,12/31/2020,2065550100,,,(Monday[09:00-21:00]),FALSE,US,TRUE,TRUE,FALSE

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkCallAdExtension , 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 BulkCallAdExtension
var bulkCallAdExtension = new BulkCallAdExtension
{
    // '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 
    // CallAdExtension object of the Campaign Management service.
    CallAdExtension = new CallAdExtension
    {
        // 'Country Code' column header in the Bulk file
        CountryCode = "US",
        // 'Id' column header in the Bulk file
        Id = callAdExtensionIdKey,
        // 'Call Only' column header in the Bulk file
        IsCallOnly = true,
        // 'Call Tracking Enabled' column header in the Bulk file
        IsCallTrackingEnabled = true,
        // 'Phone Number' column header in the Bulk file
        PhoneNumber = "2065550100",
        // 'Toll Free' column header in the Bulk file
        RequireTollFreeTrackingNumber = false,
                    
        // '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(bulkCallAdExtension);

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 extensión de anuncio de llamada , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Programación de anuncios

La lista de intervalos de día y hora que quieres que la extensión del anuncio 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, la extensión del anuncio será apta 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

Solo llamada

La opción de mostrar tanto tu número de teléfono como tu sitio web, o solo tu número de teléfono, a las personas que ven tus anuncios en un teléfono inteligente. Es posible que quiera mostrar solo su número de teléfono si su empresa requiere que hable con cada cliente.

Establezca esta propiedad en TRUE si desea que la extensión del anuncio solo muestre el número de teléfono sin un vínculo a su sitio web y, de lo contrario, si desea que la extensión del anuncio incluya un vínculo a su sitio web, además del número de teléfono, establézcalo en FALSE.

Añadir: Opcional. Si no especifica este campo o lo deja vacío, se establecerá el valor predeterminado de FALSE y la extensión del anuncio incluirá un vínculo a su sitio web además del número de teléfono.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Seguimiento de llamadas habilitado

Determina si el seguimiento de llamadas está habilitado para la extensión de anuncio de llamada.

Establezca esta propiedad en TRUE para habilitar el seguimiento de llamadas y, de lo contrario, establézcala en FALSE.

Nota:

El seguimiento de llamadas solo se admite en Estados Unidos y Reino Unido.

Añadir: Opcional. Si no especifica este campo o lo deja vacío, se establecerá el valor predeterminado de FALSE .
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
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

Country Code

El código de país donde está registrado el número de teléfono.

El código de país debe contener un código de país de 2 caracteres. Los valores de código de país admitidos incluyen AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE y VN.

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

Ubicación editorial

Componente o propiedad de la extensión de anuncio 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 de la extensión del anuncio.

Los valores posibles se describen en la tabla siguiente.

Valor Descripción
Activo La extensión del anuncio superó la revisión editorial.
ActiveLimited La extensión de anuncio superó la revisión editorial en uno o varios mercados, y uno o varios elementos de la extensión del anuncio están siendo revisados editorialmente en otro mercado. Por ejemplo, la extensión de anuncio pasó la revisión editorial para Canadá y todavía está pendiente de revisión en el Estados Unidos.
Desaprobó No se pudo revisar la extensión del anuncio.
Inactivo Uno o varios elementos de la extensión del anuncio se están revisando 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 de la extensión de anuncio con formato MM/DD/AAAA.

La fecha de finalización es inclusiva. Por ejemplo, si establece este campo en 12/31/2020, las extensiones de anuncio 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, la extensión del anuncio 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

Id

Identificador generado por el sistema de la extensión de anuncio.

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 la extensión de anuncio en el campo Id de tipos de registro dependientes, como Extensión de anuncio de llamada de campaña. Esto se recomienda si va a agregar nuevas extensiones de anuncio 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

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

Parent Id

Identificador generado por el sistema de la cuenta que contiene la extensión de anuncio.

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

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

Número de teléfono

Número de teléfono que se puede hacer clic para incluir en el anuncio.

El número de teléfono puede contener un máximo de 35 caracteres y debe ser válido para el país o región especificados.

Si la campaña incluye extensiones de anuncios de llamada y ubicación, este número de teléfono invalidará el número de teléfono especificado en las extensiones de anuncios de ubicación.

Es posible que se vuelva a formatear el número de teléfono. Por ejemplo, si establece el número de teléfono en 4255551212, se reformatearía a (425) 555-1212.

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

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 de la extensión de anuncio con formato MM/DD/AAAA.

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

Añadir: Opcional. Si no especifica una fecha de inicio, la extensión del anuncio 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 estableces este campo en la cadena de delete_value , estás quitando de forma eficaz la fecha de inicio y la extensión del anuncio se puede programar 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 de la extensión del anuncio.

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.

Gratuito

Puede usar su propio número de teléfono o usar un número de teléfono de reenvío de Microsoft Advertising. Un número de teléfono de reenvío de Microsoft Advertising es un número de teléfono único que se enruta al número de teléfono de su empresa. Con un número de reenvío de Microsoft Advertising, puedes realizar un seguimiento de todas las llamadas desde tu anuncio para poder analizar el rendimiento del anuncio. Este campo determina si se debe crear un número de teléfono de reenvío gratuito de Microsoft Advertising para el seguimiento de llamadas. Este campo solo se puede establecer si el campo Seguimiento de llamadas habilitado también es TRUE.

Antes de agosto de 2017, los clientes podían establecer esta propiedad en TRUE si se creaba un número de teléfono de reenvío de Microsoft Advertising para el seguimiento de llamadas. Desde agosto de 2017, los clientes ya no pueden crear un nuevo número de teléfono de reenvío gratuito de Microsoft Advertising. Si establece este valor TRUE , la operación se realizará correctamente; sin embargo, no se creará un número gratuito y, al recuperar la extensión de anuncio de llamada, esta propiedad se establecerá en FALSE. Si se aprovisionó un número de reenvío gratuito antes de agosto de 2017, esta propiedad será TRUE si el número sigue activo al recuperar la extensión del anuncio de llamada.

Añadir: Opcional. Si no especifica este campo o lo deja vacío, se establecerá el valor predeterminado de FALSE .
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

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 las extensiones de anuncio 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 de la extensión del anuncio. La versión se establece en 1 cuando se agrega la extensión y se incrementa cada vez que se revisa.

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