Registro de grupo de recursos: masivo
Define un grupo de recursos que se puede descargar y cargar en un archivo masivo.
Puede descargar todos los registros de grupo de recursos de la cuenta incluyendo el valor DownloadEntity de AssetGroups 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.
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkAssetGroup , en lugar de llamar a las operaciones del servicio directamente y escribir código personalizado para analizar cada campo en el archivo masivo.
Para un registro de grupo de recursos , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Grupo de recursos
- Nombre de la empresa
- Llamada a la acción
- Campaña
- Id. de cliente
- Descripciones
- Estado de la apelación editorial
- Ubicación editorial
- Código de motivo editorial
- Estado editorial
- Término editorial
- Fecha de finalización
- Final Url
- Encabezados
- Id
- Images
- Titulares largos
- Mobile Final Url
- Tiempo de modificación
- Parent Id
- Ruta de acceso 1
- Ruta de acceso 2
- Estado
- Fecha de inicio
Grupo de recursos
Nombre del grupo de recursos.
Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura y Obligatorio
Nombre de la empresa
Nombre de la empresa.
En función de la ubicación del anuncio de audiencia, el nombre de la empresa puede aparecer en el anuncio.
La longitud de la cadena está limitada a 25 caracteres.
Añadir: Obligatorio
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura
Llamada a la acción
Una breve y contundente razón para que los clientes haga clic en su anuncio en este momento.
Los valores posibles son ActNow, AddToCart, ApplyNow, Automated, BetNow, BidNow, BookACar, BookHotel, BookNow, BookTravel, Browse, BuildNow, Buy, BuyNow, ChatNow, Compare, ContactUs, Coupon, Dealers, Default, Directions, Donate, Download, EmailNow, EnrollNow, Explore, FileNow, FindJob, FindStore, FreePlay, FreeQuote, FreeTrial, GetDeals, GetDemo, GetNow, GetOffer, GetQuote, GoToDemo, Install, JoinNow, LearnMore, ListenNow, LogIn, Message, NewCars, NoButton, OpenLink, OrderNow, PlayGame, PlayNow, PostJob, Register, RegisterNow, RenewNow, RentACar, RentNow, Reorder, Reserve, Sale, SaveNow, Schedule, SeeDemo, SeeMenu, SeeModels, SeeMore, SeeOffer, SeeOffers, SellNow, ShopNow, Showtimes, SignIn, SignUp, StartFree, StartNow, Subscribe, SwitchNow, TestDrive, TryNow, Unknown, UsedCars, ViewCars, ViewDemo, ViewNow, ViewPlans, VisitSite, VisitStore, VoteNow, Watch, WatchMore, WatchNow.
Añadir: Obligatorio.
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 recursos.
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 Campaña .
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. 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
Descripciones
Lista de descripciones que Bing puede usar para optimizar el diseño del anuncio.
Para maximizar las impresiones en todos los formatos de anuncio, es posible que las descripciones no siempre se muestren en el anuncio.
Desde la perspectiva del modelo de datos, las descripciones se almacenan como recursos de texto. Varios anuncios pueden usar el mismo recurso. Por ejemplo, si "Integración directa" es un recurso de texto, tendrá el mismo identificador de recurso en todos los anuncios de la misma cuenta de Microsoft Advertising.
Debe establecer entre 2 y 5 descripciones. Las descripciones se representan en el archivo masivo como una cadena JSON. En el json de ejemplo siguiente se incluyen dos descripciones y la primera se ancla a una posición específica.
text y id son propiedades del recurso, mientras que y editorialStatusassetPerformanceLabel son propiedades del vínculo del recurso, es decir, la relación entre el recurso y el anuncio. Para obtener más información, vea assetPerformanceLabel, editorialStatus, id y texto a continuación.
[{
"text": "Find New Customers & Increase Sales!",
},
{
"text": "Start Advertising on Contoso Today."
}]
Nota:
En el archivo masivo separado por comas, tendrá que rodear la lista de vínculos de recursos, cada clave de atributo y cada valor de cadena de atributo con un conjunto adicional de comillas dobles, por ejemplo, la cadena JSON anterior se escribiría como "[{"text"":"Buscar nuevos clientes & Aumentar ventas!""},{"text":""Start Advertising on Contoso Today."}]".
Este es un ejemplo de descarga masiva donde también obtendrá atributos de solo lectura, por ejemplo, id y editorialStatus:
[{
"id": 1,
"text": "Contoso",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
},
{
"id": 2,
"text": "Seamless Integration",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
}]
Añadir: Obligatorio si su campaña primaria no se asocia a un almacén, opcional si la campaña primaria se asocia a una tienda. Si la campaña primaria se asocia a una tienda y especifica Descripciones, también debe especificar Titulares, LongHeadlines e Imágenes. Solo se respeta el texto . Incluso si el recurso ya existe en su cuenta, el identificador, assetPerformanceLabel y editorialStatus se omitirán si los incluye.
Actualizar: Opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este campo vacío. Si estableces este campo, se reemplazarán las descripciones que se vincularon anteriormente a este anuncio. Si especifica este campo, se requiere una lista de 2 a 5 descripciones. Solo se respeta el texto . Incluso si el recurso ya existe en su cuenta, el identificador, assetPerformanceLabel y editorialStatus se omitirán si los incluye.
Eliminar: Solo lectura
assetPerformanceLabel
Esto le permite saber el rendimiento del recurso.
El assetPerformanceLabel atributo es de solo lectura cuando se descarga el anuncio de búsqueda con capacidad de respuesta. Los valores posibles se describen en la tabla siguiente.
| Valor | Description |
|---|---|
| Bajo | El rendimiento de este recurso es bajo y se recomienda reemplazar este recurso para mejorar el rendimiento del anuncio. |
| Good | Este recurso funciona bien. Se recomienda conservar este recurso y agregar más recursos para mejorar el rendimiento del anuncio. |
| Procedimientos | El rendimiento de este recurso es uno de los mejores y se recomienda agregar más recursos similares. |
| Sin censura | No tenemos ninguna clasificación de rendimiento para este recurso. Esto puede deberse a que el recurso está inactivo, no tiene suficiente información para determinar su rendimiento o si no hay suficientes recursos similares para comparar con él. |
| Aprendizaje | El rendimiento del recurso se está evaluando activamente. Una vez completada la evaluación, la clasificación de activos será Baja, Buena, Mejor o No clasificada. |
editorialStatus
El editorialStatus atributo es de solo lectura cuando se descarga el anuncio de búsqueda con capacidad de respuesta. Los valores posibles se describen en la tabla siguiente.
| Valor | Description |
|---|---|
| Activo | El recurso superó la revisión editorial. |
| ActiveLimited | El recurso pasó la revisión editorial en uno o varios mercados, y uno o varios elementos del activo están siendo revisados editorialmente en otro mercado. Por ejemplo, el recurso pasó la revisión editorial para Canadá y sigue pendiente de revisión en el Estados Unidos. |
| Desaprobó | Error en la revisión editorial del recurso. |
| Inactivo | Uno o varios elementos del recurso se están revisando editorialmente. |
| Unknown | Reservado para uso futuro. |
id
El id atributo es un identificador único de Microsoft Advertising para el recurso de una cuenta de Microsoft Advertising.
Varios anuncios pueden usar el mismo recurso. Por ejemplo, si "Integración directa" es un recurso de texto, tendrá el mismo identificador de recurso en todos los anuncios de la misma cuenta de Microsoft Advertising. Después de cargar un recurso de texto, el archivo de resultados incluirá el identificador de recurso, por ejemplo, ""id:""123, si el recurso es nuevo o ya existe en la biblioteca de recursos de la cuenta.
text
El atributo de text cada descripción debe contener al menos una palabra. La longitud máxima de entrada del atributo de text cada descripción es de 90 caracteres. Para los idiomas con caracteres de ancho doble, por ejemplo, chino tradicional, la longitud máxima de entrada es de 45 caracteres. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la campaña o la configuración del idioma del grupo de anuncios. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis.
El text atributo no puede contener el carácter newline (\n).
Estado de la apelación editorial
Determina si puede apelar los problemas encontrados por la revisión editorial.
Los valores posibles se describen en la tabla siguiente.
| Valor | Description |
|---|---|
| Atractivo | El tema editorial es atractivo. |
| AppealPending | El tema editorial es apelable y se ha presentado una apelación. |
| NotAppealable | El tema editorial no es atractivo. |
Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura
Ubicación editorial
Componente o propiedad del anuncio que no pudo revisar editorialmente.
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 grupo de recursos.
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
Fecha de expiración del grupo de recursos.
Si no especifica una fecha de finalización, el grupo de recursos no expirará. La fecha de finalización se puede ampliar para que un grupo de recursos sea apto para la entrega, incluso después de que expire el grupo de recursos.
La fecha de finalización es inclusiva. Por ejemplo, si establece Fecha de finalización en 12/31/2020, el grupo de recursos expirará a las 11:59 p. m. el 12/31/2020. La hora se basa en la zona horaria que especifique en el nivel de campaña.
Añadir: Opcional. Para no establecer ninguna fecha de finalización al agregar un grupo de recursos, no establezca este campo.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para eliminar la fecha de finalización actual y no establecer eficazmente ninguna fecha de finalización, establezca este campo en la cadena "delete_value". Cuando recupere el grupo de recursos la próxima vez, este campo no se establecerá.
Eliminar: Solo lectura
Final Url
Dirección URL de la página de aterrizaje.
La parte de dominio de la dirección URL en combinación con las cadenas de ruta de acceso 1 y ruta de acceso 2 no puede superar los 67 caracteres.
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 para las direcciones URL finales y las direcciones URL móviles finales; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 para la 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}".
Cada dirección URL debe ser una dirección URL bien formada a partir de http:// o https://.
Si especifica direcciones URL de Final Mobile, 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
Encabezados
Lista de titulares que Bing puede usar para optimizar el diseño del anuncio.
Para maximizar el rendimiento en todos los formatos de anuncio, es posible que los titulares no siempre se muestren en el anuncio.
Desde la perspectiva del modelo de datos, los titulares se almacenan como recursos de texto. Varios anuncios pueden usar el mismo recurso. Por ejemplo, si "Integración directa" es un recurso de texto, tendrá el mismo identificador de recurso en todos los anuncios de la misma cuenta de Microsoft Advertising.
Debe establecer entre 3 y 15 titulares. Los titulares se representan en el archivo masivo como una cadena JSON. En el json de ejemplo siguiente se incluyen dos titulares.
text y id son propiedades del recurso, mientras que y editorialStatusassetPerformanceLabel son propiedades del vínculo del recurso, es decir, la relación entre el recurso y el anuncio. Para obtener más información, vea assetPerformanceLabel, editorialStatus, id y texto a continuación.
[{
"text": "Contoso",
},
{
"text": "Seamless Integration"
}]
Nota:
En el archivo masivo separado por comas, tendrá que rodear la lista de vínculos de recursos, cada clave de atributo y cada valor de cadena de atributo con un conjunto adicional de comillas dobles, por ejemplo, la cadena JSON anterior se escribiría como "[{"text"":"Contoso"},{"text"":"Seamless Integration""}]".
Este es un ejemplo de descarga masiva donde también obtendrá atributos de solo lectura, por ejemplo, id y editorialStatus:
[{
"id": 1,
"text": "Contoso",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
},
{
"id": 2,
"text": "Seamless Integration",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
}]
Añadir: Obligatorio si su campaña primaria no se asocia a un almacén, opcional si la campaña primaria se asocia a una tienda. Si la campaña primaria se asocia a una tienda y especifica Titulares, también debe especificar LongHeadlines, Descriptions e Images. Solo se respeta el texto . Incluso si el recurso ya existe en su cuenta, el identificador, assetPerformanceLabel y editorialStatus se omitirán si los incluye.
Actualizar: Opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este campo vacío. Si estableces este campo, se reemplazarán los titulares que se vincularon anteriormente a este anuncio. Si especifica este campo, se requiere una lista de entre 3 y 15 titulares. Solo se respeta el texto . Incluso si el recurso ya existe en su cuenta, el identificador, assetPerformanceLabel y editorialStatus se omitirán si los incluye.
Eliminar: Solo lectura
assetPerformanceLabel
Esto le permite saber el rendimiento del recurso.
El assetPerformanceLabel atributo es de solo lectura cuando se descarga el anuncio de búsqueda con capacidad de respuesta. Los valores posibles se describen en la tabla siguiente.
| Valor | Description |
|---|---|
| Bajo | El rendimiento de este recurso es bajo y se recomienda reemplazar este recurso para mejorar el rendimiento del anuncio. |
| Good | Este recurso funciona bien. Se recomienda conservar este recurso y agregar más recursos para mejorar el rendimiento del anuncio. |
| Procedimientos | El rendimiento de este recurso es uno de los mejores y se recomienda agregar más recursos similares. |
| Sin censura | No tenemos ninguna clasificación de rendimiento para este recurso. Esto puede deberse a que el recurso está inactivo, no tiene suficiente información para determinar su rendimiento o si no hay suficientes recursos similares para comparar con él. |
| Aprendizaje | El rendimiento del recurso se está evaluando activamente. Una vez completada la evaluación, la clasificación de activos será Baja, Buena, Mejor o No clasificada. |
editorialStatus
El editorialStatus atributo es una cadena de solo lectura al descargar el anuncio de búsqueda con capacidad de respuesta. Los valores posibles se describen en la tabla siguiente.
| Valor | Description |
|---|---|
| Activo | El recurso superó la revisión editorial. |
| ActiveLimited | El recurso superó la revisión editorial en uno o varios mercados, y uno o más elementos de El activo está siendo revisado editorialmente en otro mercado. Por ejemplo, el recurso pasó la revisión editorial para Canadá y todavía está pendiente de revisión en el Estados Unidos. |
| Desaprobó | Error en la revisión editorial del recurso. |
| Inactivo | Uno o varios elementos del recurso se están revisando editorialmente. |
| Unknown | Reservado para uso futuro. |
id
El id atributo es un identificador único de Microsoft Advertising para el recurso de una cuenta de Microsoft Advertising.
Varios anuncios pueden usar el mismo recurso. Por ejemplo, si "Integración directa" es un recurso de texto, tendrá el mismo identificador de recurso en todos los anuncios de la misma cuenta de Microsoft Advertising. Después de cargar un recurso de texto, el archivo de resultados incluirá el identificador de recurso, por ejemplo, ""id:""123, si el recurso es nuevo o ya existe en la biblioteca de recursos de la cuenta.
text
El atributo de text cada título debe contener al menos una palabra. La longitud máxima de entrada del atributo de text cada título es de 30 caracteres. Para los idiomas con caracteres de ancho doble, por ejemplo, chino tradicional, la longitud máxima de entrada es de 15 caracteres. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la campaña o la configuración del idioma del grupo de anuncios. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis.
El text atributo no puede contener el carácter newline (\n).
Id
Identificador generado por el sistema del grupo de recursos.
Añadir: Opcional. Debe dejar este campo vacío o especificar un identificador negativo. 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
Imágenes
Cree varios recursos de imagen con diferentes tamaños y proporciones de aspecto para que puedan mostrarse de forma flexible en una variedad de publicadores y ubicaciones.
Debe proporcionar al menos 1 LandscapeImageMedia y 1 SquareImageMedia. Se pueden guardar hasta 20 imágenes y un total de hasta 5 logotipos.
Los recursos de imagen se representan en el archivo masivo como una cadena JSON. En el json de ejemplo siguiente se incluyen nueve imágenes y solo LandscapeImageMedia subType no se recorta.
id es una propiedad del recurso, mientras que , cropHeightcropWidth, cropX, cropYy subType son propiedades del vínculo del recurso, es decir, la relación entre el recurso y el anuncio. Para obtener más información, vea cropHeight, cropWidth, cropX, cropY, id y subType a continuación.
[{
"id": 1234567890000,
"subType": "LandscapeImageMedia"
},
{
"id": 1234567890000,
"subType": "SquareImageMedia",
"cropX": 286,
"cropY": 0,
"cropWidth": 628,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "LandscapeLogoMedia",
"cropX": 70,
"cropY": 0,
"cropWidth": 200,
"cropHeight": 50
},
{
"id": 1234567890000,
"subType": "SquareLogoMedia",
"cropX": 308,
"cropY": 0,
"cropWidth": 120,
"cropHeight": 120
},
{
"id": 1234567890000,
"subType": "ImageMedia15X10",
"cropX": 129,
"cropY": 0,
"cropWidth": 942,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia133X100",
"cropX": 183,
"cropY": 0,
"cropWidth": 835,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia178X100",
"cropX": 41,
"cropY": 0,
"cropWidth": 1118,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia1x2",
"cropX": 41,
"cropY": 0,
"cropWidth": 500,
"cropHeight": 1000
},
{
"id": 1234567890000,
"subType": "ImageMedia4x1",
"cropX": 60,
"cropY": 0,
"cropWidth": 1000,
"cropHeight": 250
}]
Nota:
En el archivo masivo separado por comas, deberá rodear la lista de vínculos de recursos, cada clave de atributo y cada valor de cadena de atributo con un conjunto adicional de comillas dobles, por ejemplo, la cadena JSON anterior se escribiría como "[{""id"":1234567890000,"subType":""LandscapeImageMedia""},{"id"":1234567890000,"subType"":"SquareImageMedia"",", ""cropX":286,""cropY":0,""cropWidth"":628,""cropHeight"":628},{"id"":1234567890000, ""subType"":""LandscapeLogoMedia"",""cropX":70,""cropY":0,""cropWidth":200,""cropHeight"":50},{"id"":1234567890000,""subType"":""SquareLogoMedia"",""cropX"":308,""cropY"":0,""cropWidth":120,""cropHeight"":120},{"id"":1234567890000,""subType"":"ImageMedia15X10"","cropX"":129,""cropY":0,"cropWidth":942,"cropHeight"":628},{". "id":1234567890000,"subType":""ImageMedia133X100","cropX":183,"cropY":0,""cropWidth":835,""cropHeight"" :628},{""id":1234567890000,"subType"":"ImageMedia178X100"",""cropX"":41,""cropY":0,"cropWidth"":1118,""cropHeight":628},{"id":1234567890000,"subType":"ImageMedia1X2","cropX":":41,""cropY"":0,""cropWidth":500,"cropHeight"":1000},{"id"":1234567890000,"subType":"". "ImageMedia4X1"",""cropX":60,""cropY":0,"cropWidth"":1000,""cropHeight"":250}]".
Añadir: Obligatorio si su campaña primaria no se asocia a un almacén, opcional si la campaña primaria se asocia a una tienda. Si la campaña primaria se asocia a una tienda y especifica Imágenes, también debe especificar Titulares, Líneas largas y Descripciones. Solo se requieren el id . y el subType para cada vínculo de recurso.
Actualizar: Opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este campo vacío. Si estableces este campo, se reemplazarán las imágenes que se vincularon anteriormente a este anuncio. Si establece este campo, solo se requieren el identificador y el subTipo para cada vínculo de recurso.
Eliminar: Solo lectura
cropHeight
Número de píxeles que se van a usar desde el origen del recurso de imagen, empezando por la posición recortada y moviéndose hacia arriba.
cropWidth
Número de píxeles que se van a usar desde el origen del recurso de imagen, empezando por la posición cropX y moviéndose a la derecha.
cropX
A partir de la esquina inferior izquierda del origen del recurso de imagen, este es el número de píxeles que se van a ir a la derecha en el eje X antes de aplicar el cropWidth.
cropY
A partir de la esquina inferior izquierda del origen del recurso de imagen, este es el número de píxeles que se omitirán hacia arriba en el eje Y antes de aplicar cropHeight.
id
El id atributo es un identificador único de Microsoft Advertising para el recurso de una cuenta de Microsoft Advertising.
El mismo identificador de recurso de imagen se puede usar varias veces en el mismo anuncio para diferentes relaciones de aspecto, y también puede ser utilizado por varios anuncios en la misma cuenta de Microsoft Advertising. Puede crear imágenes para anuncios con capacidad de respuesta a través del registro masivo Imagen . A continuación, puede usar el identificador multimedia devuelto como identificador de recurso de imagen. La relación de aspecto de la imagen que agregó debe ser compatible con el subTipo del recurso de imagen.
Subtipo
El subType atributo representa la relación de aspecto de este recurso de imagen.
La verdadera relación de aspecto de la imagen que se almacena en la biblioteca multimedia de nivel de cuenta puede variar, siempre y cuando las dimensiones resultantes produzcan la relación de aspecto esperada por subtipo.
Los posibles valores de subtipo incluyen LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 e ImageMedia4X1. Es posible que en el futuro se agreguen nuevos subtipos, por lo que no debe tomar ninguna dependencia de un conjunto fijo de valores.
| Subtipo | Relación de aspecto | Dimensiones mínimas en píxeles |
|---|---|---|
| LandscapeImageMedia | 1.91:1 | 703 ancho x 368 alto |
| SquareImageMedia | 1:1 | 300 ancho x 300 alto |
| LandscapeLogoMedia | 4:1 | 160 ancho x 40 alto |
| SquareLogoMedia | 1:1 | 40 ancho x 40 alto |
| ImageMedia15x10 | 1.5:1 | 300 ancho x 200 alto |
| ImageMedia133x100 | 1.33:1 | 100 ancho x 75 de alto |
| ImageMedia178x100 | 1.78:1 | 624 ancho x 350 alto |
| ImageMedia1x2 | 1:2 | 470 ancho x 940 alto |
| ImageMedia4x1 | 4:1 | 608 ancho x 152 de alto |
Titulares largos
Lista de titulares largos que Bing puede usar para optimizar el diseño del anuncio.
Para maximizar el rendimiento en todos los formatos de anuncio, es posible que los titulares largos no siempre se muestren en el anuncio.
Desde la perspectiva del modelo de datos, los titulares largos se almacenan como recursos de texto. Varios anuncios pueden usar el mismo recurso. Por ejemplo, si "Integración directa" es un recurso de texto, tendrá el mismo identificador de recurso en todos los anuncios de la misma cuenta de Microsoft Advertising.
Debe establecer entre 1 y 5 titulares largos. Los titulares largos se representan en el archivo masivo como una cadena JSON. En el json de ejemplo siguiente se incluyen dos titulares largos.
text y id son propiedades del recurso, mientras que y editorialStatusassetPerformanceLabel son propiedades del vínculo del recurso, es decir, la relación entre el recurso y el anuncio. Para obtener más información, vea assetPerformanceLabel, editorialStatus, id y texto a continuación.
[{
"text": "Find New Customers & Increase Sales!",
},
{
"text": "Start Advertising on Contoso Today."
}]
Nota:
En el archivo masivo separado por comas, tendrá que rodear la lista de vínculos de recursos, cada clave de atributo y cada valor de cadena de atributo con un conjunto adicional de comillas dobles, por ejemplo, la cadena JSON anterior se escribiría como "[{"text"":"Buscar nuevos clientes & Aumentar ventas!""},{"text":""Start Advertising on Contoso Today."}]".
Este es un ejemplo de descarga masiva donde también obtendrá atributos de solo lectura, por ejemplo, id y editorialStatus:
[{
"id": 1,
"text": "Find New Customers & Increase Sales!",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
},
{
"id": 2,
"text": "Start Advertising on Contoso Today",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
}]
Añadir: Obligatorio si su campaña primaria no se asocia a un almacén, opcional si la campaña primaria se asocia a una tienda. Si la campaña primaria se asocia a una tienda y especifica LongHeadlines, también debe especificar Titulares, descripciones e imágenes. Solo se respeta el texto . Incluso si el recurso ya existe en su cuenta, el identificador, assetPerformanceLabel y editorialStatus se omitirán si los incluye.
Actualizar: Opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este campo vacío. Si estableces este campo, se reemplazarán los titulares que se vincularon anteriormente a este anuncio. Si especifica este campo, se requiere una lista de 1 a 5 titulares. Solo se respeta el texto . Incluso si el recurso ya existe en su cuenta, el identificador, assetPerformanceLabel y editorialStatus se omitirán si los incluye.
Eliminar: Solo lectura
assetPerformanceLabel
Esto le permite saber el rendimiento del recurso.
El assetPerformanceLabel atributo es de solo lectura cuando se descarga el anuncio de búsqueda con capacidad de respuesta. Los valores posibles se describen en la tabla siguiente.
| Valor | Description |
|---|---|
| Bajo | El rendimiento de este recurso es bajo y se recomienda reemplazar este recurso para mejorar el rendimiento del anuncio. |
| Good | Este recurso funciona bien. Se recomienda conservar este recurso y agregar más recursos para mejorar el rendimiento del anuncio. |
| Procedimientos | El rendimiento de este recurso es uno de los mejores y se recomienda agregar más recursos similares. |
| Sin censura | No tenemos ninguna clasificación de rendimiento para este recurso. Esto puede deberse a que el recurso está inactivo, no tiene suficiente información para determinar su rendimiento o si no hay suficientes recursos similares para comparar con él. |
| Aprendizaje | El rendimiento del recurso se está evaluando activamente. Una vez completada la evaluación, la clasificación de activos será Baja, Buena, Mejor o No clasificada. |
editorialStatus
El editorialStatus atributo es una cadena de solo lectura al descargar el anuncio de búsqueda con capacidad de respuesta. Los valores posibles se describen en la tabla siguiente.
| Valor | Description |
|---|---|
| Activo | El recurso superó la revisión editorial. |
| ActiveLimited | El recurso superó la revisión editorial en uno o varios mercados, y uno o más elementos de El activo está siendo revisado editorialmente en otro mercado. Por ejemplo, el recurso pasó la revisión editorial para Canadá y todavía está pendiente de revisión en el Estados Unidos. |
| Desaprobó | Error en la revisión editorial del recurso. |
| Inactivo | Uno o varios elementos del recurso se están revisando editorialmente. |
| Unknown | Reservado para uso futuro. |
id
El id atributo es un identificador único de Microsoft Advertising para el recurso de una cuenta de Microsoft Advertising.
Varios anuncios pueden usar el mismo recurso. Por ejemplo, si "Integración directa" es un recurso de texto, tendrá el mismo identificador de recurso en todos los anuncios de la misma cuenta de Microsoft Advertising. Después de cargar un recurso de texto, el archivo de resultados incluirá el identificador de recurso, por ejemplo, ""id:""123, si el recurso es nuevo o ya existe en la biblioteca de recursos de la cuenta.
text
El atributo de text cada título largo debe contener al menos una palabra. La longitud máxima de entrada del atributo de text cada título es de 90 caracteres. Para los idiomas con caracteres de ancho doble, por ejemplo, chino tradicional, la longitud máxima de entrada es de 45 caracteres. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la campaña o la configuración del idioma del grupo de anuncios. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis.
El text atributo no puede contener el carácter newline (\n).
Mobile Final Url
Dirección URL de la página de aterrizaje móvil.
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 para las direcciones URL finales y las direcciones URL móviles finales; sin embargo, solo se usa el primer elemento de cada lista para la entrega. El servicio permite hasta 10 para la 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}".
Cada dirección URL debe ser una dirección URL bien formada a partir de http:// o https://.
Si especifica direcciones URL de Final Mobile, 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
Parent Id
Identificador generado por el sistema de la campaña que contiene el grupo de recursos.
Este campo masivo se asigna al campo Id del registro Campaña .
Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de campaña existente o especificar un identificador negativo que sea igual al campo Id del registro de campaña primario. Esto se recomienda si va a agregar nuevos grupos de anuncios a una nueva campaña 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 Campaña .
Ruta de acceso 1
La primera parte de la ruta de acceso opcional que se anexará a la parte del dominio de la dirección URL para mostrar. La parte del dominio de la dirección URL de presentación, por ejemplo, https://www.contoso.com se generará a partir del dominio de la dirección URL final (campo Url final ). A continuación, si ha especificado un valor para Path 1 , se anexará a la dirección URL de presentación. Si también ha especificado un valor para Path 2, también se anexará a la dirección URL de presentación después de Path 1. Por ejemplo, si la dirección URL final contiene https://www.contoso.com, Path 1 se establece en subdirectory1 y Path 2 se establece en subdirectory2, la dirección URL mostrada será https://www.contoso.com/subdirectory1/subdirectory2.
La ruta de acceso puede contener parámetros dinámicos como {MatchType}. Para obtener una lista de los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?.
La longitud máxima de entrada es de 1000 caracteres si se incluyen cadenas de texto dinámicas. No se pueden introducir más de 15 caracteres finales (no texto dinámico). El anuncio no se mostrará o se usará el texto predeterminado si la longitud del dominio de dirección URL final y las rutas de acceso combinadas superan los 67 caracteres.
En el caso de los idiomas con caracteres de ancho doble, por ejemplo, el chino tradicional, la longitud máxima de entrada es de 1000 caracteres si se incluyen cadenas de texto dinámicas. No se pueden introducir más de 7 caracteres finales (no de texto dinámico). El anuncio no se mostrará o se usará el texto predeterminado si la longitud del dominio de dirección URL final y las rutas de acceso combinadas superan los 33 caracteres. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la configuración de idioma de la campaña o del grupo de recursos. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis.
La ruta de acceso no puede contener los caracteres de barra diagonal (/) o nueva línea (\n).
Si la ruta de acceso incluye un espacio, se reemplazará por un carácter de subrayado (_) cuando se muestre el anuncio.
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
Ruta de acceso 2
La segunda parte de la ruta de acceso opcional que se anexará a la parte del dominio de la dirección URL de presentación. La parte del dominio de la dirección URL de presentación, por ejemplo, https://www.contoso.com se generará a partir del dominio de la dirección URL final (campo Url final ). A continuación, si ha especificado un valor para Path 1 , se anexará a la dirección URL de presentación. Si también ha especificado un valor para Path 2, también se anexará a la dirección URL de presentación después de Path 1. Por ejemplo, si la dirección URL final contiene https://www.contoso.com, Path 1 se establece en subdirectory1 y Path 2 se establece en subdirectory2, la dirección URL mostrada será https://www.contoso.com/subdirectory1/subdirectory2.
Solo puede especificar ruta de acceso 2 si también está establecida la ruta de acceso 1 .
La ruta de acceso puede contener parámetros dinámicos como {MatchType}. Para obtener una lista de los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?.
La longitud máxima de entrada es de 1000 caracteres si se incluyen cadenas de texto dinámicas. No se pueden introducir más de 15 caracteres finales (no texto dinámico). El anuncio no se mostrará o se usará el texto predeterminado si la longitud del dominio de dirección URL final y las rutas de acceso combinadas superan los 67 caracteres.
En el caso de los idiomas con caracteres de ancho doble, por ejemplo, el chino tradicional, la longitud máxima de entrada es de 1000 caracteres si se incluyen cadenas de texto dinámicas. No se pueden introducir más de 7 caracteres finales (no de texto dinámico). El anuncio no se mostrará o se usará el texto predeterminado si la longitud del dominio de dirección URL final y las rutas de acceso combinadas superan los 33 caracteres. Los caracteres de doble ancho vienen determinados por los caracteres que se usan en lugar del conjunto de caracteres de la configuración de idioma de la campaña o del grupo de recursos. Los caracteres de doble ancho incluyen caracteres coreanos, japoneses y chinos, así como emojis.
La ruta de acceso no puede contener los caracteres de barra diagonal (/) o nueva línea (\n).
Si la ruta de acceso incluye un espacio, se reemplazará por un carácter de subrayado (_) cuando se muestre el anuncio.
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
Estado
Estado del grupo de recursos.
Los valores posibles son Active, Deleted, Expired o Paused. El estado Expirado es de solo lectura.
Añadir: Opcional. El valor predeterminado es Paused.
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.
Fecha de inicio
Fecha en la que el grupo de recursos puede empezar a atender; De lo contrario, el servicio puede empezar a atender al grupo de recursos el día en que el grupo de recursos se active.
La fecha de inicio es inclusiva. Por ejemplo, si establece Fecha de inicio en 5/5/2020, el grupo de recursos comenzará a las 12:00 AM el 5/5/2020. La hora se basa en la zona horaria que especifique en el nivel de campaña.
Añadir: Opcional. Si no establece este campo o si la fecha que envía es anterior a la fecha de hoy, se establecerá la fecha de hoy y el servicio podrá empezar a atender al grupo de activos en cuanto el estado del grupo de recursos esté activo.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. La fecha de inicio no se puede actualizar después de enviar el grupo de recursos, es decir, una vez que ha llegado la fecha de inicio.
Eliminar: Solo lectura