Registro de elemento de fuente: masivo

Define un elemento de fuente que se puede descargar y cargar en un archivo masivo.

Sugerencia

Para obtener información general sobre cómo usar fuentes y elementos de fuente, consulta las guías técnicas Fuentes de personalización de anuncios, Fuentes de inventario automático y Fuentes de páginas .

Nota:

• Actualiza tus anuncios de texto expandidos a anuncios de búsqueda adaptables antes del 1 de febrero de 2023. Después de esta fecha, ya no podrás crear anuncios de texto expandidos nuevos ni editarlos. Para obtener más información, consulte Acerca de los anuncios de búsqueda con capacidad de respuesta.
• Las fuentes programadas seguirán ejecutándose y los anuncios de texto expandidos existentes con fuentes de personalizador de anuncios seguirán funcionando. Podrá ver informes sobre su rendimiento.
• Seguirás siendo capaz de pausar, ejecutar o quitar las fuentes de personalizador de anuncios existentes. De lo contrario, los intentos de crear o editar personalizadores de anuncios existentes para anuncios de texto expandido producirán un CustomerNotEligibleForAdCustomizersFeed error.
• Obtenga más información sobre este cambio.

Si va a crear nuevas entidades primarias y secundarias en el mismo archivo masivo, los registros dependientes se deben incluir después de las dependencias según la jerarquía:

1. Fuente
2. Campaña
3. Grupo de anuncios
4. Elemento de fuente

Puede tener 100 fuentes por cuenta (este número máximo incluye todos los tipos de fuentes) y el número máximo de elementos de fuente (filas) por cuenta es de 5 millones.

Puede descargar todos los registros de elementos de fuente de la cuenta incluyendo el valor DownloadEntity de FeedItems 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 fuente de páginas y una fuente de personalizador de anuncios con un elemento de fuente para cada uno.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Target Campaign Id,Target Ad Group Id,Client Id,Modified Time,Start Date,End Date,Device Preference,Keyword,Match Type,Target,Physical Intent,Name,Ad Schedule,Audience Id,Feed Name,Custom Attributes
Format Version,,,,,,,,,,,,,,,,,,6,,,,
Feed,Active,-20,,PageFeed,,,,,PageFeedClientIdGoesHere,,,,,,,,,,,,MyPageFeedName,"[{""name"":""Page Url"",""feedAttributeType"":""Url"",""isPartOfKey"":true},{""name"":""Custom Label"",""feedAttributeType"":""StringList""},{""name"":""Ad Title"",""feedAttributeType"":""String""}]"
Feed,Active,-21,,AdCustomizerFeed,,,,,AdCustomizerFeedClientIdGoesHere,,,,,,,,,,,,MyAdCustomizerFeedName,"[{""name"":""DateTimeName"",""feedAttributeType"":""DateTime""},{""name"":""Int64Name"",""feedAttributeType"":""Int64""},{""name"":""PriceName"",""feedAttributeType"":""Price""},{""name"":""StringName"",""feedAttributeType"":""String"",""isPartOfKey"":true}]"
Feed,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,-21,,DynamicDataAutosListingFeed,,"[{""name"":""Vehicle ID""},{""name"":""Final URL""},{""name"":""Image URL""},{""name"":""Make""},{""name"":""Model""},{""name"":""Price""},{""name"":""Title""},{""name"":""Target campaign""},{""name"":""Target ad group""},{""name"":""Latitude""},{""name"":""Longitude""},{""name"":""Mileage value""},{""name"":""Mileage unit""},{""name"":""Year""},{""name"":""Fuel type""},{""name"":""Transmission""},{""name"":""City""},{""name"":""VIN""},{""name"":""State of vehicle""}]"
Feed Item,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,,-21,,,"{""Vehicle Id"":""2g161290-1d13"",""""Final Url"""":""https:\/\/www.contoso.com\/used-Redmond1"",""Image Urls"":""https:\/\/www.contoso.com\/inventoryphotos\/01.jpg;https:\/\/www.contoso.com\/inventoryphotos\/02.jpg"",""Make"":""Contoso"",""Model"":""SUV"",""Price"":""65495.00 USD"",""Title"":""2020 SUV"",""Target campaign"":""CampaignName"",""Target ad group"":"""",""Latitude"":"""",""Logitude"":"""",""Mileage Value"":""13000"",""Mileage Unit"":""MI"",""Year"":""2020"",""Fuel Type"":"""",""Transmission"":"""",""City"":""Redmond"",""Vin"":""SALLJGML8HA004044"",""State of Vehicle"":""USED"",""Trim"":""HSE""}"
Feed Item,Active,-200,-20,,,,20;200,,2020/06/22 00:00:00,2020/06/30 00:00:00,,,,,,,,,,"{""Page Url"":""https://contoso.com/3001"",""Custom Label"":[""Label_1_3001"",""Label_2_3001""],""Ad Title"":""An ad title""}"
Feed Item,Active,-210,-21,,,,21;210,,2020/06/22 00:00:00,2020/06/30 00:00:00,,value,Broad,,PeopleIn,,(Sunday[09:00-17:00]),,,"{""DateTimeName"":""2020/06/22 00:00:00"",""Int64Name"":237601,""PriceName"":""$601"",""StringName"":""s237601""}"

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkFeedItem , 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 BulkFeedItem
var bulkAdCustomizerFeedItem = new BulkFeedItem
{
	// 'Parent Id' column header in the Bulk file
	FeedId = adCustomizerFeedIdKey,
	// 'Custom Attributes' column header in the Bulk file
	CustomAttributes = adCustomizerFeedItemCustomAttributesJson,
	// 'Id' column header in the Bulk file
	Id = null,
	// 'Target Ad Group Id' column header in the Bulk file
	AdGroupId = null,
	// 'Ad Group' column header in the Bulk file
	AdGroupName = null,
	// 'Audience Id' column header in the Bulk file
	AudienceId = null,
	// 'Target Campaign Id' column header in the Bulk file
	CampaignId = null,
	// 'Campaign' column header in the Bulk file
	CampaignName = null,
	// 'Ad Schedule' column header in the Bulk file
	DayTimeRanges = new[]
	{
		// Each day and time range is delimited by a semicolon (;) in the Bulk file
		// 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 = null,
	// 'Start Date' column header in the Bulk file
	StartDate = null,
	// 'Physical Intent' column header in the Bulk file
	IntentOption = IntentOption.PeopleIn,
	// 'Keyword' column header in the Bulk file
	Keyword = "insurance",
	// 'Target' column header in the Bulk file
	LocationId = 190,
	// 'Match Type' column header in the Bulk file
	MatchType = MatchType.Exact,
	// 'Device Preference' column header in the Bulk file
	DevicePreference = null,
	// 'Client Id' column header in the Bulk file
	ClientId = "ClientIdGoesHere",
	// 'Status' column header in the Bulk file
	Status = Status.Active
};

uploadEntities.Add(bulkAdCustomizerFeedItem);

// Map properties in the Bulk file to the BulkFeedItem
var bulkPageFeedItem = new BulkFeedItem
{
    // 'Parent Id' column header in the Bulk file
    FeedId = pageFeedIdKey,
    // 'Custom Attributes' column header in the Bulk file
    CustomAttributes = pageFeedItemCustomAttributesJson,
    // 'Id' column header in the Bulk file
    Id = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkPageFeedItem);

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

• Grupo de anuncios
• Programación de anuncios
• Identificador de audiencia
• Campaña
• Id. de cliente
• Atributos personalizados
• Preferencia de dispositivo
• Fecha de finalización
• Id
• Palabra clave
• Tipo de coincidencia
• Tiempo de modificación
• Parent Id
• Intención física
• Fecha de inicio
• Estado
• Target
• Id. de grupo de anuncios de destino
• Id. de campaña de destino

Grupo de anuncios

Nombre del grupo de anuncios que se usa para dirigirse al elemento de fuente. Si se establece este campo, el elemento de fuente solo será apto para el grupo de anuncios especificado.

Nota:

Este campo solo es aplicable a las fuentes del personalizador de anuncios.

Añadir: Opcional. Si incluye este campo, también debe establecerse el campo Campaña y el grupo de anuncios debe existir dentro de la campaña especificada. Si se establecen los campos Ad Group (Grupo de anuncios ) y Target Ad Group Id (Id. de grupo de anuncios de destino ), se devuelve un error para este registro en el archivo masivo.
Actualizar: Opcional. Si incluye este campo, también debe establecerse el campo Campaña y el grupo de anuncios debe existir dentro de la campaña especificada. Si se establecen los campos Ad Group (Grupo de anuncios ) y Target Ad Group Id (Id. de grupo de anuncios de destino ), se devuelve un error para este registro en el archivo masivo. 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

Programación de anuncios

La lista de intervalos de día y hora que quieres que el elemento de la fuente 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].

Nota:

Este campo solo es aplicable a las fuentes del personalizador de anuncios.

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 elemento de fuente será apto para programar en cualquier momento durante las fechas de inicio y finalización del calendario.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. 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. Si no establece este campo, se conservará la configuración existente. Si establece este campo en delete_value, eliminará eficazmente todos los intervalos de día y hora existentes.
Eliminar: Solo lectura

Identificador de audiencia

El identificador de Microsoft Advertising de la audiencia, por ejemplo, la lista de remarketing que se usa para dirigirse al elemento de fuente. Si se establece este campo, el elemento de fuente solo será apto para la audiencia especificada.

Nota:

Este campo solo es aplicable a las fuentes del personalizador de anuncios.

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

Campaña

Nombre de la campaña utilizada para dirigirse al elemento de fuente. Si se establece este campo, el elemento de fuente solo será apto para la campaña especificada.

Nota:

Este campo solo es aplicable a las fuentes del personalizador de anuncios.

Añadir: Opcional. Si se establecen los campos Campaign (Campaña ) y Target Campaign Id (Id . de campaña de destino), se devuelve un error para este registro en el archivo masivo.
Actualizar: Opcional. Si se establecen los campos Campaign (Campaña ) y Target Campaign Id (Id . de campaña de destino), se devuelve un error para este registro en el archivo masivo. 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

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

Atributos personalizados

Los atributos se personalizan para cada subtipo de fuente y definen qué información sobre los productos o servicios que quieres insertar en tus anuncios.

Para el subtipo de fuente AdCustomizerFeed, puede incluir hasta 100 atributos personalizados por elemento de fuente donde cada nombre de atributo personalizado es único.

Para el subtipo DynamicDataAutosListingFeed , puede incluir hasta 100 atributos personalizados por elemento de fuente donde cada nombre de atributo personalizado sea único.

Para el subtipo de fuente PageFeed, puede incluir uno o dos atributos personalizados por elemento de fuente donde cada nombre de atributo personalizado es único.

Los atributos personalizados se representan en el archivo masivo como una cadena JSON. Para obtener más información, vea feedAttributeType, isPartOfKey y el nombre siguiente.

Estos son los atributos personalizados de ejemplo que puede cargar para una fuente de página.

Nota:

En el archivo masivo separado por comas, deberá rodear la lista de atributos, cada clave de atributo y cada valor de atributo con un conjunto adicional de comillas dobles, por ejemplo, la cadena JSON anterior se escribiría como "[{""name":""Page Url"","feedAttributeType"":"Url",""isPartOfKey"":true},{"name"":"Custom Label"",""feedAttributeType"":"StringList""},{""name"":"Ad Title"",""feedAttributeType"":"String""}]".

[
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	},
	{
		"name": "Ad Title",
		"feedAttributeType": "String"
	}
]

Estos son los atributos personalizados de ejemplo que se pueden cargar para una fuente del personalizador de anuncios.

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601"
}

Añadir: Obligatorio. Para un personalizador de anuncios y un elemento de fuente DynamicDataAutosListing, debe establecer al menos un atributo con un par de clave y valor válido. Para una fuente de páginas, debe establecer al menos un atributo con el nombre establecido en "Url de página".
Actualizar: Opcional. Para conservar todos los atributos personalizados existentes para el elemento de fuente, establezca o deje este campo vacío. Si establece este campo, se reemplazarán los atributos personalizados que se establecieron anteriormente para este elemento de fuente.
Eliminar: Solo lectura

feedAttributeType

Tipo de datos de cada atributo personalizado. El tipo de datos se define en el registro de fuente y, a continuación, se establecen valores en el elemento de fuente. Siempre que cada nombre de atributo personalizado sea único dentro de la fuente, puede definir varios atributos con el mismo tipo de datos.

Hay cuatro tipos de datos diferentes feedAttributeType que puede establecer para las fuentes del personalizador de anuncios:

feedAttributeType	Casos de uso	Valores de elemento de fuente aceptados
Cadena	Nombres de producto, categorías de productos, descripciones	Letras, números o símbolos
Int64	Recuento de inventario, número de colores disponibles	Cualquier número entero
Precio	Costo del producto, descuento por venta	Cualquier número (incluidos los decimales) y caracteres de moneda válidos
DateTime	Hora de inicio del evento, último día de una venta	aaaa/mm/dd HH:mm:ss Para que el valor predeterminado sea medianoche al principio del día, puede omitir la parte HH:mm:ss.

Por ejemplo, podemos definir los atributos personalizados de una fuente de personalizador de anuncios.

[
	{
		"name": "DateTimeName",
		"feedAttributeType": "DateTime"
	},
	{
		"name": "Int64Name",
		"feedAttributeType": "Int64"
	},
	{
		"name": "PriceName",
		"feedAttributeType": "Price"
	},
	{
		"name": "StringName",
		"feedAttributeType": "String",
		"isPartOfKey": true
	}
]

A continuación, podemos asignar cada nombre de fuente, es decir, "DateTimeName", "Int64Name", "PriceName" y "StringName" en la carga del elemento de fuente:

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601"
}

Hay seis tipos de datos diferentes feedAttributeType que puede establecer para las fuentes DynamicDataAutosListing:

feedAttributeType	Casos de uso	Valores de elemento de fuente aceptados
Cadena	Nombre del vehículo, categoría del vehículo, descripción	Letras, números o símbolos
Int64	año del vehículo, motor	Cualquier número entero
Precio	Costo del vehículo, descuento por venta	Cualquier número (incluidos los decimales) y caracteres de moneda válidos
DateTime	Hora de inicio del evento, último día de una venta	aaaa/mm/dd HH:mm:ss Para que el valor predeterminado sea medianoche al principio del día, puede omitir la parte HH:mm:ss.
Url	Contiene la dirección URL del sitio web que se va a incluir en la fuente.	Debe incluir una dirección URL por elemento de fuente.
StringList	Etiquetas que permiten agrupar las direcciones URL dentro de la fuente.	Puede incluir entre una y diez etiquetas personalizadas por elemento de fuente. Cada etiqueta personalizada se representa como un elemento de lista en notación JSON. Por ejemplo, la parte de etiqueta personalizada del elemento de fuente podría escribirse como ""Etiqueta personalizada":[""Label_1_3001"",""Label_2_3001"""]

Por ejemplo, podemos definir los atributos personalizados de una fuente DynamicDataAutosListing.

[
	{
		"name": "DateTimeName",
		"feedAttributeType": "DateTime"
	},
	{
		"name": "Int64Name",
		"feedAttributeType": "Int64"
	},
	{
		"name": "PriceName",
		"feedAttributeType": "Price"
	},
	{
		"name": "StringName",
		"feedAttributeType": "String",
		"isPartOfKey": true
	},
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	}
]

A continuación, podemos asignar cada nombre de fuente, es decir, "DateTimeName", "Int64Name", "PriceName" y "StringName" en la carga del elemento de fuente :

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601",
	"Page Url": "https://contoso.com/3001",
	"Custom Label": [
		"Label_1_3001",
		"Label_2_3001"
	],
}

Estos son los feedAttributeType tipos de datos que puede establecer para las fuentes de páginas:

feedAttributeType	Casos de uso	Valores de elemento de fuente aceptados
Cadena	Encabezado estático que se muestra en lugar del titular generado dinámicamente.	Letras, números o símbolos de hasta 63 caracteres. Puedes incluir un título de anuncio por elemento de fuente.
StringList	Etiquetas que permiten agrupar las direcciones URL dentro de la fuente.	Puede incluir entre una y diez etiquetas personalizadas por elemento de fuente. Cada etiqueta personalizada se representa como un elemento de lista en notación JSON. Por ejemplo, la parte de etiqueta personalizada del elemento de fuente podría escribirse como ""Etiqueta personalizada":[""Label_1_3001"",""Label_2_3001"""]
Url	Contiene la dirección URL del sitio web que se va a incluir en la fuente.	Debe incluir una dirección URL por elemento de fuente.

Por ejemplo, podemos definir los atributos personalizados de la fuente de páginas.

Nota:

feedAttributeType es opcional para las fuentes de páginas. Si establece , feedAttributeTypedebe establecerse en "Url" para "Url de página", "StringList" para "Custom Label" y "String" para los atributos con nombre "Ad Title".

[
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	},
	{
		"name": "Ad Title",
		"feedAttributeType": "String"
	}
]

A continuación, podemos asignar cada nombre de fuente, es decir, "Url de página", "Etiqueta personalizada" y "Título del anuncio" en la carga del elemento de fuente :

{
	"Page Url": "https://contoso.com/3001",
	"Custom Label": [
		"Label_1_3001",
		"Label_2_3001"
	],
    "Ad Title": "Find New Customers & Increase Sales!",
}

isPartOfKey

isPartOfKey determina si los valores de un atributo personalizado deben ser únicos en todos los registros de elementos de fuente que se acumulan en la fuente. isPartOfKey Si se establece en "true", los valores deben ser únicos y, de lo contrario, puede cargar valores duplicados para el mismo atributo personalizado.

En el caso de las fuentes del personalizador de anuncios y los elementos de fuente, una cadena denominada "Id. personalizado" siempre se trata como una clave única, es decir, siempre isPartOfKey es "true". El atributo "Custom Id" es actualmente la única manera de establecer una clave única para las fuentes del personalizador de anuncios a través de la aplicación web microsoft Advertising. Con bulk API tiene más flexibilidad para usar cualquier nombre de atributo como clave única.

En el caso de las fuentes de páginas y los elementos de fuente, la "dirección URL de página" siempre se trata como una clave única, es decir, siempre isPartOfKey es "true".

En el caso de las fuentes DynamicDataAutosListing y los elementos de fuente, "VehicleId" siempre se trata como una clave única, es decir, siempre isPartOfKey es "true".

name

El name atributo se usa para asignar un atributo personalizado distinto a través de la fuente y el elemento de fuente. De hecho, así es como se asegura de que un elemento de fuente específico se acumula en la misma "columna" de la fuente. En el ejemplo del personalizador de anuncios situado encima de los nombres "DateTimeName", "Int64Name", "PriceName" y "StringName" se usan tanto en la fuente como en el elemento de fuente.

Preferencia de dispositivo

Este campo determina si la preferencia es que el elemento de fuente se muestre en dispositivos móviles o en todos los dispositivos.

Nota:

Este campo solo es aplicable a las fuentes del personalizador de anuncios.

Los valores posibles son All y Mobile, que difieren de los valores usados en el servicio de administración de campañas.

SixMonths

En el archivo de resultados de carga y descarga masiva, este campo nunca estará vacío. Si no especificó una preferencia de dispositivo, se devolverá el valor predeterminado de Todo .

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. Si establece este campo en delete_value, se restablecerá eficazmente al valor predeterminado de Todos.
Eliminar: Solo lectura

Fecha de finalización

Cadena de fecha de finalización programada del elemento de fuente con formato aaaa/mm/dd HH:mm:ss. Para que el valor predeterminado sea medianoche al principio del día, puede omitir la parte HH:mm:ss.

Nota:

Este campo solo es aplicable a las fuentes del personalizador de anuncios.

La fecha de finalización es inclusiva. Por ejemplo, si establece este campo en 2020/12/31 00:00:00, el elemento de fuente dejará de ser apto a las 12:00 AM del 12/31/2020.

Añadir: Opcional. Si no especificas una fecha de finalización, el elemento de la fuente se seguirá entregando a menos que pauses las campañas, los grupos de anuncios o los anuncios asociados.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. 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 no establece este campo, se conservará la configuración existente. Si estableces este campo en delete_value, eliminas de forma eficaz la fecha de finalización y el elemento de la fuente se seguirá entregando a menos que pauses las campañas, los grupos de anuncios o los anuncios asociados.
Eliminar: Solo lectura

Id

Identificador generado por el sistema de la fuente.

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

Palabra clave

Texto de palabra clave.

El texto puede contener un máximo de 100 caracteres.

Debe especificar la palabra clave en la configuración regional del idioma de la campaña de destino o del grupo de anuncios.

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

Tipo de coincidencia

Tipo de coincidencia para comparar la palabra clave y el término de búsqueda del usuario.

Los valores de tipo de coincidencia admitidos para una palabra clave son Broad, Exact y Phrase.

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

Parent Id

Identificador generado por el sistema de la fuente primaria.

Los atributos personalizados y subtipo de la fuente primaria determinan qué atributos personalizados son válidos para este elemento de fuente. Actualmente se admiten fuentes de personalizador de anuncios y fuentes de páginas, y otros tipos de fuentes podrían agregarse en el futuro.

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

Intención física

Determina si una persona debe encontrarse físicamente en la ubicación de destino para que el elemento de fuente sea apto.

De forma predeterminada, el elemento de fuente se puede mostrar a los usuarios en, buscar o ver páginas sobre la ubicación de destino. Establezca este campo en PeopleIn si solo desea que el elemento de fuente se muestre a personas físicamente ubicadas en la ubicación de destino.

Añadir: Opcional. Si establece este campo, también debe establecerse la ubicación de destino .
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. Si establece este campo en delete_value, se restablece eficazmente al valor predeterminado de PeopleIn.
Eliminar: Solo lectura

Fecha de inicio

Cadena de fecha de inicio programada del elemento de fuente con formato aaaa/mm/dd HH:mm:ss. Para que el valor predeterminado sea medianoche al principio del día, puede omitir la parte HH:mm:ss.

La fecha de inicio es inclusiva. Por ejemplo, si establece este campo en 2020/06/15 00:00:00, el elemento de fuente comenzará a ser apto a las 12:00 a.m. del 15 de junio de 2020.

Añadir: Opcional. Si no especifica una fecha de inicio, el elemento de fuente se puede programar inmediatamente durante el día y los intervalos de tiempo.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. 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 no establece este campo, se conservará la configuración existente. Si establece este campo en delete_value, eliminará de forma eficaz la fecha de inicio y el elemento de fuente podrá programarse inmediatamente durante el día y los intervalos de tiempo.
Eliminar: Solo lectura

Estado

Estado del elemento de fuente.

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.

Target

Identificador de la ubicación utilizada para dirigirse al elemento de fuente. Si se establece este campo, el elemento de fuente solo será apto para la ubicación especificada.

Si solo quiere dirigirse a personas físicamente en una ubicación, también tendrá que establecer el campo Intención física .

El identificador de ubicación corresponde al campo Id. de ubicación del archivo de ubicaciones geográficas. Para obtener más información, vea Códigos de ubicación geográfica y GetGeoLocationsFileUrl.

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. de grupo de anuncios de destino

Identificador del grupo de anuncios que se usa para dirigirse al elemento de fuente. Si se establece este campo, el elemento de fuente solo será apto para el grupo de anuncios especificado.

Nota:

Este campo solo es aplicable a las fuentes del personalizador de anuncios.

Añadir: Opcional. Si también estableces el campo Campaña (no obligatorio), el grupo de anuncios debe existir dentro de la campaña especificada. Si se establecen los campos Ad Group (Grupo de anuncios ) y Target Ad Group Id (Id. de grupo de anuncios de destino ), se devuelve un error para este registro en el archivo masivo.
Actualizar: Opcional. Si también estableces el campo Campaña (no obligatorio), el grupo de anuncios debe existir dentro de la campaña especificada. Si se establecen los campos Ad Group (Grupo de anuncios ) y Target Ad Group Id (Id. de grupo de anuncios de destino ), se devuelve un error para este registro en el archivo masivo. 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. de campaña de destino

Identificador de la campaña usada para dirigirse al elemento de fuente. Si se establece este campo, el elemento de fuente solo será apto para la campaña especificada.

Nota:

Este campo solo es aplicable a las fuentes del personalizador de anuncios.

Añadir: Opcional. Si se establecen los campos Campaign (Campaña ) y Target Campaign Id (Id . de campaña de destino), se devuelve un error para este registro en el archivo masivo.
Actualizar: Opcional. Si se establecen los campos Campaign (Campaña ) y Target Campaign Id (Id . de campaña de destino), se devuelve un error para este registro en el archivo masivo. 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