Objeto de datos AssetGroup: Administración de campañas

  • Artículo

Define un grupo de recursos en una campaña publicitaria.

Sintaxis

<xs:complexType name="AssetGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
    <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetGroupEditorialStatus" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element xmlns:q114="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q114:ArrayOfstring" />
    <xs:element xmlns:q115="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q115:ArrayOfstring" />
    <xs:element xmlns:q116="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q116:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AssetGroupStatus" />
  </xs:sequence>
</xs:complexType>

Elementos

El objeto AssetGroup tiene los siguientes elementos: BusinessName, CallToAction, Descriptions, EditorialStatus, EndDate, FinalMobileUrls, FinalUrls, ForwardCompatibilityMap, Headlines, Id, Images, LongHeadlines, Name, Path1, Path2, StartDate, Status.

Elemento Descripción Tipo de datos
BusinessName Nombre de la empresa.

El nombre de tu empresa puede aparecer en tu anuncio, en función de la ubicación del anuncio.

La longitud de la cadena está limitada a 25 caracteres.

Añadir: Obligatorio. Si no se proporciona y la campaña primaria se asocia a una tienda, el nombre de la tienda se usará como nombre comercial.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 string
CallToAction Una breve y contundente razón para que los clientes haga clic en su anuncio en este momento.

Esto se muestra en el botón llamada a la acción.

Añadir: Obligatorio. Si no se proporciona y la campaña primaria se asocia a una tienda, el valor predeterminado será LearnMore.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.		 CallToAction
Descripciones Las descripciones que se muestran debajo de la ruta de acceso del anuncio.

Debe establecer entre 2 y 5 descripciones. El texto de cada descripción debe contener al menos una palabra. El texto no puede contener el carácter de nueva línea (\n).

Si la campaña primaria se asocia a una tienda y especifica Descripciones, también debe especificar Titulares, LongHeadlines e Imágenes.

Agregar: opcional si la campaña primaria se asocia a un almacén, necesario si su campaña primaria no se asocia a un almacén.
Actualización: opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este elemento nulo. Si establece un valor para este elemento, se reemplazarán las descripciones que se vincularon anteriormente a este grupo de recursos. Si la campaña primaria se asocia a un almacén y establece este elemento en una lista vacía, se eliminará la configuración anterior.		 Matriz AssetLink
EditorialStatus Estado de revisión editorial del grupo de recursos, que indica si el grupo de recursos está pendiente de revisión, se ha aprobado o se ha desaprobado.

Agregar: solo lectura
Actualización: solo lectura		 AssetGroupEditorialStatus
EndDate 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 EndDate en 12/31/2020, los anuncios del grupo de anuncios expirarán a las 11:59 p. m. del 12/31/2020. La hora se basa en la zona horaria que especifique en el nivel de campaña.

Agregar: opcional. Para no establecer ninguna fecha de finalización al agregar un grupo de recursos, establezca este elemento en null.
Actualización: opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para eliminar la configuración de fecha de finalización existente y no establecer eficazmente ninguna fecha de finalización al actualizar un grupo de recursos, establezca la fecha de finalización igual o posterior al 2 de enero de 2050. Cuando recupere el grupo de recursos la próxima vez, este elemento será nulo, es decir, no se establecerá en el 2 de enero de 2050.		 Date
FinalMobileUrls 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 FinalUrls y FinalMobileUrls; 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.
- El uso de '{' y '}' solo puede delinear etiquetas, por ejemplo{lpurl}.
- Las direcciones URL finales deben ser una dirección URL bien formada a partir de http:// o https://.
- Si especifica FinalMobileUrls, también debe especificar FinalUrls.

Agregar: opcional
Actualización: opcional		 matriz de cadenas
FinalUrls 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 FinalUrls y FinalMobileUrls; 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.
- El uso de '{' y '}' solo puede delinear etiquetas, por ejemplo{lpurl}.
- Las direcciones URL finales deben ser una dirección URL bien formada a partir de http:// o https://.
- Si especifica FinalMobileUrls, también debe especificar FinalUrls.

En el caso de las campañas comerciales, la dirección URL final debe coincidir con el dominio de la tienda asociada a la campaña.

Agregar: obligatorio. Si no se proporciona y la campaña primaria se asocia a un almacén, la dirección URL del almacén se usará como la dirección URL final.
Actualización: opcional		 matriz de cadenas
ForwardCompatibilityMap Lista de cadenas de clave y valor para la compatibilidad con reenvíos para evitar cambios importantes en caso contrario cuando se agregan nuevos elementos en la versión actual de la API.

Los cambios de compatibilidad de reenvío se anotarán aquí en futuras versiones. Actualmente no hay cambios de compatibilidad de reenvío para este objeto.		 Matriz KeyValuePairOfstringstring
Encabezados Los titulares son el texto más destacado que aparece en tu anuncio, por lo que deberías sacar el máximo partido a los caracteres disponibles. Necesitamos varios titulares para que el anuncio pueda mostrarse de forma flexible en una variedad de publicadores y ubicaciones.

Desde la perspectiva del modelo de datos, las descripciones y los titulares se almacenan como recursos de texto, es decir, un TextAsset por AssetLink. 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. El texto de cada título debe contener al menos una palabra.

El texto no puede contener el carácter de nueva línea (\n).

Si la campaña primaria se asocia a una tienda y especifica Titulares, también debe especificar LongHeadlines, Descriptions e Images.

Agregar: opcional si su campaña primaria se asocia a un almacén, necesario si su campaña primaria no se asocia a un almacén.
Actualización: opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este elemento nulo. Si establece un valor para este elemento, se reemplazarán los titulares que se vincularon anteriormente a este grupo de recursos. Si la campaña primaria se asocia a un almacén y establece este elemento en una lista vacía, se eliminará la configuración anterior.		 Matriz AssetLink
Id Identificador del grupo de recursos generado por el sistema.

Agregar: solo lectura
Actualización: solo lectura		 Largo
Imágenes 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.

Incluya uno o varios objetos AssetLink que contengan un ImageAsset con subtipo y opciones de recorte que coincidan con la relación de aspecto deseada.

ImageAsset contiene los campos CropHeight, CropWidth, CropX, CropY y SubType.

Los posibles valores de subtipo incluyen LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 e ImageMedia4X1.

Debe proporcionar al menos 1 LandscapeImageMedia y 1 SquareImageMedia. Se pueden guardar hasta 20 imágenes y un total de hasta 5 logotipos.

Si la campaña primaria se asocia a una tienda y especifica Imágenes, también debe especificar Titulares, Líneas largas y Descripciones.

Agregar: opcional si la campaña primaria se asocia a un almacén, necesario si su campaña primaria no se asocia a un almacén.
Actualización: opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si incluye imágenes durante la actualización, se reemplazarán las imágenes establecidas anteriormente. Si la campaña primaria se asocia a un almacén y establece este elemento en una lista vacía, se eliminará la configuración anterior.		 Matriz AssetLink
LongHeadlines Debe establecer entre 1 y 5 titulares largos. El texto de cada título debe contener al menos una palabra. El texto no puede contener el carácter de nueva línea (\n).

Si la campaña primaria se asocia a una tienda y especifica LongHeadlines, también debe especificar Titulares, descripciones e imágenes.

Agregar: opcional si la campaña primaria se asocia a un almacén, necesario si su campaña primaria no se asocia a un almacén.
Actualización: opcional. Para conservar todos los vínculos de recursos existentes, establezca o deje este elemento nulo. Si establece un valor para este elemento, se reemplazarán los titulares que se vincularon anteriormente a este grupo de recursos. Si la campaña primaria se asocia a un almacén y establece este elemento en una lista vacía, se eliminará la configuración anterior.		 Matriz AssetLink
Nombre Nombre del grupo de recursos. Los nombres deben ser únicos en una campaña y distinguen mayúsculas de minúsculas. La longitud no puede superar los 256 caracteres.

Agregar: obligatorio
Actualización: opcional		 string
Ruta de acceso1 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 (elemento FinalUrls). A continuación, si ha especificado un valor para Path1, se anexará a la dirección URL para mostrar. Si también ha especificado un valor para Path2, también se anexará a la dirección URL para mostrar después de Path1. Por ejemplo, si FinalUrls contiene https://www.contoso.com, Path1 se establece en subdirectory1 y Path2 se establece en subdirectorio2, la dirección URL mostrada será https://www.contoso.com/subdirectory1/subdirectory2.

No se pueden introducir más de 15 caracteres. El anuncio no se mostrará 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 no se pueden introducir más de 7 caracteres finales. El anuncio no se mostrará 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 del idioma de la campaña. 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.

Agregar: opcional
Actualización: opcional		 string
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 (elemento FinalUrls). A continuación, si ha especificado un valor para Path1, se anexará a la dirección URL para mostrar. Si también ha especificado un valor para Path2, también se anexará a la dirección URL para mostrar después de Path1. Por ejemplo, si FinalUrls contiene https://www.contoso.com, Path1 se establece en subdirectory1 y Path2 se establece en subdirectorio2, la dirección URL mostrada será https://www.contoso.com/subdirectory1/subdirectory2.

Solo puede especificar Path2 si path1 también está establecido.

No se pueden introducir más de 15 caracteres. El anuncio no se mostrará 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 no se pueden introducir más de 7 caracteres finales. El anuncio no se mostrará 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 del idioma de la campaña. 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.

Agregar: opcional
Actualización: opcional		 string
StartDate Fecha en la que el grupo de recursos puede empezar a atender; De lo contrario, el servicio puede empezar a publicar anuncios el día en que el grupo de recursos se active.

La fecha de inicio es inclusiva. Por ejemplo, si establece la fecha de inicio en 5/5/2021, los anuncios creados a partir del grupo de recursos comenzarán a las 12:00 AM el 5/5/2021. La hora se basa en la zona horaria que especifique en el nivel de campaña.

Agregar: opcional. Si no establece la fecha de inicio, el valor predeterminado será la fecha de hoy y el servicio podrá empezar a publicar anuncios tan pronto como el estado del grupo de activos esté activo.
Actualización: 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.		 Date
Estado Estado del grupo de recursos. Los valores posibles son Active, Expired y Paused. El estado Expirado es de solo lectura.

Agregar: opcional. El valor predeterminado es Pausado.
Actualización: opcional		 AssetGroupStatus

Requisitos

Servicio: CampaignManagementService.svc v13
Nombres: https://bingads.microsoft.com/CampaignManagement/v13

Usado por

AddAssetGroups
GetAssetGroupsByCampaignId
GetAssetGroupsByIds
UpdateAssetGroups