Objeto de datos ActionAdExtension: Administración de campañas
Define una extensión de anuncio de acción con un botón de llamada a la acción.
Sintaxis
<xs:complexType name="ActionAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:AdExtension">
<xs:sequence>
<xs:element name="ActionType" type="tns:ActionAdExtensionActionType" />
<xs:element xmlns:q51="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q51:ArrayOfstring" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q52="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q52:ArrayOfstring" />
<xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Elementos
El objeto ActionAdExtension tiene los siguientes elementos: ActionType, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Language, TrackingUrlTemplate, UrlCustomParameters.
| Elemento | Descripción | Tipo de datos |
|---|---|---|
| ActionType | El tipo de acción que elija aquí, así como el idioma que establezca, determina el texto que se muestra en el botón llamada a la acción. Microsoft Advertising no admite todos los tipos de acción para todos los idiomas. Si intenta usar un tipo de acción no admitido y una combinación de idioma, se devolverá un error. Para obtener más información, consulta Texto de acción para extensiones de anuncios de acción. Añadir: Obligatorio Actualizar: Obligatorio |
ActionAdExtensionActionType |
| FinalMobileUrls | Se trata de una dirección URL de página de aterrizaje fácil de usar para dispositivos móviles cuando se proporcionan extensiones de acción en dispositivos móviles. Si especifica direcciones URL móviles finales, también debe especificar FinalUrls. 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. Añadir: Opcional Actualizar: Opcional. Si establece este elemento null, se eliminará la configuración anterior. |
matriz de cadenas |
| FinalUrls | Este es el vínculo a la página web o formulario específico que corresponde al texto de la acción. Cuando no se proporciona una dirección URL de acción, se usará la dirección URL final del anuncio. 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. Aunque el tipo de datos es una lista de cadenas, Microsoft Advertising solo usa el primer elemento de lista. Añadir: Opcional Actualizar: Opcional. Si establece este elemento null, se eliminará la configuración anterior. |
matriz de cadenas |
| FinalUrlSuffix | El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas. Esta característica solo está disponible para los clientes de la fase 3 del sufijo final url (GetCustomerPilotFeatures devuelve 636). Si no está en el piloto, esta propiedad se omitirá y no se devolverá ningún error. Añadir: Opcional Actualizar: Opcional. Si establece este elemento null, se eliminará la configuración anterior. |
string |
| Idioma | Idioma en el que se proporcionará la extensión del anuncio. La extensión siempre se servirá en este idioma, independientemente de la configuración de idioma de la campaña o del grupo de anuncios. Las cadenas de idioma admitidas son: danés, holandés, inglés, finés, francés, alemán, italiano, noruego, portugués, español, sueco y tradicional chino. Microsoft Advertising no admite todos los tipos de acción para todos los idiomas. Si intenta usar un tipo de acción no admitido y una combinación de idioma, se devolverá un error. Para obtener más información, consulta Texto de acción para extensiones de anuncios de acción. Añadir: Obligatorio Actualizar: Obligatorio |
string |
| TrackingUrlTemplate | Plantilla de seguimiento que se va a usar como valor predeterminado para todos los FinalUrls y FinalMobileUrls. Las siguientes reglas de validación se aplican a las plantillas de seguimiento. Para obtener más información sobre las plantillas y los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar? - Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad. - La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres. - La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}. - Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma.Añadir: Opcional Actualizar: Opcional. Si establece este elemento null, se eliminará la configuración anterior. |
string |
| UrlCustomParameters | Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL. Microsoft Advertising aceptará los 8 primeros objetos CustomParameter que incluya en el objeto CustomParameters y, si incluye más de 8 parámetros personalizados, se devolverá un error. Cada CustomParameter incluye elementos Key y Value . Para los clientes de la fase 3 de aumento de límite de parámetros personalizados piloto (GetCustomerPilotFeatures devuelve 635), Microsoft Advertising aceptará los primeros 8 pares de clave y valor de parámetro personalizados que incluya y, si incluye más de 8 parámetros personalizados, se devolverá un error. Añadir: Opcional Actualizar: Opcional. Si establece este elemento null, se eliminará la configuración anterior. |
CustomParameters |
El objeto ActionAdExtension tiene elementos heredados.
Elementos heredados
Elementos heredados de AdExtension
El objeto ActionAdExtension deriva del objeto AdExtension y hereda los siguientes elementos: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Las descripciones siguientes son específicas de ActionAdExtension y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto AdExtension .
| Elemento | Descripción | Tipo de datos |
|---|---|---|
| DevicePreference | No se admite para este tipo de extensión de anuncio. | Largo |
| 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. Actualmente no hay cambios de compatibilidad de reenvío para el objeto AdExtension . Añadir: Solo lectura Actualizar: Solo lectura |
Matriz KeyValuePairOfstringstring |
| Id | Identificador único de Microsoft Advertising de la extensión de anuncio. Añadir: Solo lectura Actualizar: Solo lectura y Obligatorio |
Largo |
| Programar | Determina los intervalos de día y hora del calendario cuando la extensión del anuncio es apta para mostrarse en los anuncios. Añadir: Opcional Actualizar: Opcional. Si establece este elemento null, cualquier programación existente establecida para la extensión de anuncio permanecerá sin cambios. Si establece esto en cualquier objeto Schedule que no sea NULL, está reemplazando eficazmente la configuración de programación existente para la extensión de anuncio. Para quitar toda la programación, establezca este elemento en un objeto Schedule vacío. |
Schedule |
| Estado | Estado de la extensión del anuncio. El valor siempre será Activo porque el servicio Administración de campañas no devuelve extensiones de anuncios eliminadas. Añadir: Solo lectura Actualizar: Solo lectura |
AdExtensionStatus |
| Tipo | Tipo de la extensión de anuncio. Este valor es ActionAdExtension cuando se recupera una extensión de anuncio de acción. Añadir: Solo lectura Actualizar: Solo lectura Para obtener más información sobre los tipos de extensión de anuncio, consulte comentarios sobre los objetos de datos de extensión de anuncios. |
string |
| Versión | Realiza un seguimiento del número de veces que se ha actualizado la extensión del anuncio. La versión se establece en 1 cuando se crea la extensión del anuncio y aumenta en uno después de cada actualización. Añadir: No permitido Actualizar: No permitido |
int |
Requisitos
Servicio: CampaignManagementService.svc v13
Nombres: https://bingads.microsoft.com/CampaignManagement/v13
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de