Registro de extensión de anuncio de ubicación: masiva
Define una extensión de anuncio de ubicación que se puede descargar y cargar en un archivo masivo.
Puede asociar una extensión de anuncio de ubicación a la cuenta o a campañas de la cuenta. Cada entidad (cuenta o campaña) se puede asociar con tantas extensiones de anuncios de ubicación como decidas, hasta el número total de extensiones de anuncios de ubicación en tu cuenta. Usa los registros Extensión de anuncio ubicación de la cuenta y Extensión de anuncio ubicación de campaña para administrar las asociaciones de extensión de anuncios de ubicación.
Puede descargar todos los registros de extensión de anuncios de ubicación de la cuenta incluyendo el valor DownloadEntity de LocationAdExtensions 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 ubicación a la biblioteca compartida de la cuenta.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Business Name,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Address Line 1,Address Line 2,Postal Code,City,State Or Province Code,Province Name,Latitude,Longitude,Country Code
Format Version,,,,,,,,,,,,,6.0,,,,,,,,,,,
Location Ad Extension,Active,-15,0,,,ClientIdGoesHere,,,12/31/2020,Contoso Shoes,206-555-0100,,,(Monday[09:00-21:00]),FALSE,1234 Washington Place,Suite 1210,98608,Woodinville,,WA,0,0,US
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkLocationAdExtension , 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 BulkLocationAdExtension
var bulkLocationAdExtension = new BulkLocationAdExtension
{
// '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
// LocationAdExtension object of the Campaign Management service.
LocationAdExtension = new LocationAdExtension
{
Address = new Address
{
// 'City' column header in the Bulk file
CityName = "Woodinville",
// 'Country Code' column header in the Bulk file
CountryCode = "US",
// 'Postal Code' column header in the Bulk file
PostalCode = "98608",
// 'State Or Province Code' column header in the Bulk file
ProvinceCode = null,
// 'Province Name' column header in the Bulk file
ProvinceName = "WA",
// 'Address Line 1' column header in the Bulk file
StreetAddress = "1234 Washington Place",
// 'Address Line 2' column header in the Bulk file
StreetAddress2 = "Suite 1210",
},
// 'Business Name' column header in the Bulk file
CompanyName = "Contoso Shoes",
// 'Geo Code Status' column header in the Bulk file
GeoCodeStatus = null,
GeoPoint = new GeoPoint
{
// 'Latitude' column header in the Bulk file
LatitudeInMicroDegrees = 0,
// 'Longitude' column header in the Bulk file
LongitudeInMicroDegrees = 0,
},
// 'Id' column header in the Bulk file
Id = locationAdExtensionIdKey,
// 'Phone Number' column header in the Bulk file
PhoneNumber = "206-555-0100",
// '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(bulkLocationAdExtension);
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 ubicación , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Programación de anuncios
- Línea de dirección 1
- Línea de dirección 2
- Nombre de la empresa
- Ciudad
- Id. de cliente
- Código de país
- Ubicación editorial
- Código de motivo editorial
- Estado editorial
- Término editorial
- Fecha de finalización
- Estado del código geográfico
- Id
- Latitude
- Longitude
- Tiempo de modificación
- Parent Id
- Número de teléfono
- Código postal
- Nombre de la provincia
- Países editores
- Fecha de inicio
- Código de estado o provincia
- Estado
- 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 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
Línea de dirección 1
Primera línea de la dirección.
La primera línea puede contener un máximo de 80 caracteres.
Añadir: Obligatorio
Actualizar: Obligatorio
Eliminar: Solo lectura
Línea de dirección 2
Segunda línea de la dirección.
La segunda línea puede contener un máximo de 80 caracteres.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, se quita la configuración anterior.
Eliminar: Solo lectura
Nombre de la empresa
Nombre de la empresa.
El nombre puede contener un máximo de 80 caracteres.
Añadir: Obligatorio
Actualizar: Obligatorio
Eliminar: Solo lectura
Ciudad
Nombre de la ciudad donde se encuentra la dirección de la calle.
El nombre puede contener un máximo de 80 caracteres.
Añadir: Obligatorio
Actualizar: Obligatorio
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
País o región donde se encuentra la dirección de la calle.
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: Obligatorio
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.
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
Estado del código geográfico
Valor de estado que indica si se han determinado las coordenadas de latitud y longitud de la empresa.
Si proporciona las coordenadas, el estado se establecerá en Completo; De lo contrario, el estado indicará el progreso de la determinación de las coordenadas de la dirección de la empresa especificada.
Los valores posibles se describen en la tabla siguiente.
Añadir: Solo lectura
Actualizar: Solo lectura
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 ubicación 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
Latitude
Latitud especificada en grados. La latitud debe ser mayor o igual que -85 y menor o igual que +85.
Nota:
El servicio De administración de campañas usa micro grados, es decir, de -85000000 a 85000000. Cuando se usa BulkLocationAdExtension a través de los SDK, se deben usar micro grados, ya que la implementación de BulkLocationAdExtension se convierte a partir de micro grados y escribe el valor como grados en el archivo masivo.
Las coordenadas de latitud y longitud se usan para marcar la ubicación de la empresa en Mapas de Bing cuando el usuario hace clic en la dirección del anuncio. Si las coordenadas especificadas no están dentro del intervalo de valores válidos, el servicio determina las coordenadas en función de la dirección.
Si especifica las coordenadas conocidas, el servicio no confirma si las coordenadas especificadas coinciden con la dirección de negocio especificada. Si no proporciona las coordenadas, el servicio masivo usa la dirección de las empresas para determinar las coordenadas.
Nota:
Al agregar más de 10 extensiones de anuncios de ubicación, el servicio resuelve las coordenadas sin conexión y, de lo contrario, resuelve las coordenadas por adelantado durante la ejecución de la operación del servicio. La ubicación no se usará en un anuncio hasta que se determinen las coordenadas, lo que puede tardar entre segundos y minutos en función del número de extensiones de anuncios de ubicación que se agreguen y de la demanda actual.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura
Longitude
Longitud especificada en grados. La longitud debe ser mayor o igual que -180 y menor o igual que +180.
Nota:
El servicio De administración de campañas usa micro grados, es decir, de -1800000000 a 180000000. Cuando se usa BulkLocationAdExtension a través de los SDK, se deben usar micro grados, ya que la implementación de BulkLocationAdExtension se convierte a partir de micro grados y escribe el valor como grados en el archivo masivo.
Las coordenadas de latitud y longitud se usan para marcar la ubicación de la empresa en Mapas de Bing cuando el usuario hace clic en la dirección del anuncio. Si las coordenadas especificadas no están dentro del intervalo de valores válidos, el servicio determina las coordenadas en función de la dirección.
Si especifica las coordenadas conocidas, el servicio no confirma si las coordenadas especificadas coinciden con la dirección de negocio especificada. Si no proporciona las coordenadas, el servicio masivo usa la dirección de las empresas para determinar las coordenadas.
Nota:
Al agregar más de 10 extensiones de anuncios de ubicación, el servicio resuelve las coordenadas sin conexión y, de lo contrario, resuelve las coordenadas por adelantado durante la ejecución de la operación del servicio. La ubicación no se usará en un anuncio hasta que se determinen las coordenadas, lo que puede tardar entre segundos y minutos en función del número de extensiones de anuncios de ubicación que se agreguen y de la demanda actual.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
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
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 en el que se puede hacer clic en la empresa para incluirlo 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 también incluye una extensión de llamada, el número de teléfono de la extensión de llamada invalidará el número de teléfono de la extensión de anuncio de ubicación.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura
Código postal
Código postal o postal.
El código postal puede contener un máximo de 80 caracteres.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, se quita la configuración anterior.
Eliminar: Solo lectura
Nombre de la provincia
Nombre del estado o provincia donde se encuentra la dirección de la calle, por ejemplo , Washington.
El nombre puede contener un máximo de 50 caracteres.
Debe especificar el nombre de la provincia o el código de estado o provincia.
Nota:
El código de estado o provincia y el nombre de provincia no son necesarios si el campo Código de país está establecido en FR, IE o SG.
Añadir: Obligatorio
Actualizar: Obligatorio
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
Código de estado o provincia
Código que identifica el estado o provincia donde se encuentra la dirección postal, por ejemplo WA.
El código puede contener un máximo de 50 caracteres.
Debe especificar el nombre de la provincia o el código de estado o provincia.
Nota:
El código de estado o provincia y el nombre de provincia no son necesarios si el campo Código de país está establecido en FR, IE o SG.
Añadir: Obligatorio
Actualizar: Obligatorio
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.
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