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

Artículo
11/14/2024

Define un anuncio de texto.

Importante

A partir de abril de 2020, no se admite la entrega de anuncios de texto standart (STA).

Standard anuncios de texto han quedado en desuso a favor de los anuncios de texto expandido (EXTA). La compatibilidad con la adición y actualización de anuncios de texto estándar (STA) finalizó el 31 de julio de 2017. Ahora, los anunciantes pueden obtener y eliminar, pero ya no pueden agregar nuevas AEA ni actualizar los anuncios de texto estándar existentes. Una excepción a la regla es que todavía puede actualizar el estado STA, por ejemplo, de Activo a Pausado. De lo contrario, los intentos de agregar o actualizar LASA producirán el error CampaignServiceAdTypeInvalid .

XML
JSON

<xs:complexType name="TextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AdFormatPreference": "ValueHere",
  "DevicePreference": "LongValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "Type": "Text",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "DestinationUrl": "ValueHere",
  "DisplayUrl": "ValueHere",
  "Text": "ValueHere",
  "Title": "ValueHere"
}

Elementos

El objeto TextAd tiene los siguientes elementos: DestinationUrl, DisplayUrl, Text, Title.

Elemento	Descripción	Tipo de datos
DestinationUrl	Dirección URL de la página web a la que se va a llevar al usuario al hacer clic en el anuncio. La dirección URL 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 dirección URL puede contener un máximo de 1024 caracteres. Si la dirección URL no especifica un protocolo, el sistema usa el protocolo HTTP cuando un usuario hace clic en el anuncio. Si la dirección URL especifica el protocolo HTTP al agregar un anuncio, el servicio quitará la cadena de protocolo http:// (la cadena de protocolo HTTP no cuenta con el límite de 1024 caracteres); sin embargo, el servicio no quitará una cadena de protocolo HTTPS (https://) de la dirección URL. Importante: Si actualmente usa direcciones URL de destino, debe reemplazarlas por direcciones URL finales. Para obtener más información, consulte Seguimiento de direcciones URL con direcciones URL actualizadas. Esta dirección URL solo se usa si la palabra clave no especifica una dirección URL de destino. Agregar: No compatible Actualizar: No compatible	string
DisplayUrl	Dirección URL que se va a mostrar en el anuncio. El subdirectorio de la dirección URL para mostrar puede contener cadenas de texto dinámicas, como {keyword}; sin embargo, el nombre de host de la dirección URL no puede contener texto dinámico. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico. La longitud máxima de entrada de la dirección URL es de 200 caracteres y puede contener cadenas de texto dinámicas. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 35 caracteres después de que se produzca la sustitución dinámica de texto. Agregar: No compatible Actualizar: No compatible	string
Mensaje de texto	La copia del anuncio. La copia debe contener al menos una palabra. La copia y el título combinados del anuncio deben totalizar al menos tres palabras. El texto puede contener cadenas de texto dinámicas como {keyword}. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico. La longitud máxima de entrada de la copia es de 300 caracteres y puede contener cadenas de texto dinámicas. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 71 caracteres después de que se produzca la sustitución dinámica de texto. Tenga en cuenta que para los grupos de anuncios que usan chino tradicional, el texto se limita a 38 caracteres después de la sustitución. El texto no puede contener el carácter de nueva línea (\n). Agregar: No compatible Actualizar: No compatible	string
Título	El título del anuncio. El título debe contener al menos una palabra. La copia y el título combinados del anuncio deben totalizar al menos tres palabras. El título puede contener cadenas de texto dinámicas como {keyword}. Para obtener más información, consulte el artículo de ayuda de Microsoft Advertising Personalización automática de los anuncios con parámetros de texto dinámico. La longitud máxima de entrada del título es de 80 caracteres y puede contener cadenas de texto dinámicas. El anuncio no se mostrará o se usará texto predeterminado si la longitud supera los 25 caracteres después de que se produzca la sustitución dinámica de texto. Tenga en cuenta que para los grupos de anuncios que usan chino tradicional, el título se limita a 15 caracteres después de la sustitución. El título no puede contener el carácter de nueva línea (\n). Agregar: No compatible Actualizar: No compatible	string

El objeto TextAd tiene elementos heredados.

Elementos heredados

Elementos heredados de Ad

El objeto TextAd deriva del objeto Ad y hereda los siguientes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Las descripciones siguientes son específicas de TextAd y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto Ad .

Elemento	Descripción	Tipo de datos
AdFormatPreference	La preferencia de formato de anuncio se usa para indicar si prefieres que la copia del anuncio se muestre a los usuarios como un anuncio de búsqueda o audiencia. Los anuncios de búsqueda tienden a escribirse como una llamada a la acción, mientras que los anuncios de audiencia deben escribirse con un estilo más informativo. Aunque tienes la opción de usar anuncios de texto de búsqueda como anuncios de audiencia, designar un anuncio como formato preferido de anuncios de audiencia te permite optimizar su mensajería para la entrega nativa. IMPORTANTE: Debes definir al menos un anuncio de texto por grupo de anuncios que no prefiera anuncios de audiencia; de lo contrario, la copia de anuncios de todos los anuncios de texto será apta para anuncios de búsqueda y de audiencia. Los valores posibles son AudienceAd y All. Si se establece en Todo, el anuncio será apto para los formatos de anuncios de búsqueda y audiencia. Si se establece en AudienceAd, el anuncio solo será apto para el formato de anuncio de audiencia. Agregar: No compatible Actualizar: No compatible	string
DevicePreference	Este elemento determina si la preferencia es que los anuncios de texto se muestren en dispositivos móviles o en todos los dispositivos. Para especificar una preferencia para dispositivos móviles, establezca este elemento en 30001. Para especificar todos los dispositivos, establezca este elemento en 0 (cero) o deje el elemento nil. De forma predeterminada, este elemento será nulo. Debes definir al menos un anuncio de texto por grupo de anuncios que no sea el preferido para dispositivos móviles; de lo contrario, el anuncio será apto para todos los dispositivos. Agregar: No compatible Actualizar: No compatible	largo
EditorialStatus	El estado de revisión editorial del anuncio, que indica si el anuncio está pendiente de revisión, se ha aprobado o se ha desaprobado. Agregar: No compatible Actualizar: No compatible	AdEditorialStatus
FinalAppUrls	No se admite para anuncios de texto.	Matriz AppUrl
FinalMobileUrls	Dirección URL de la página de aterrizaje móvil. Esta dirección URL solo se usa si la palabra clave no especifica una dirección URL móvil final. 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. - No puede especificar FinalMobileUrls si la preferencia de dispositivo está establecida en móvil. Tenga en cuenta también que para los objetos TextAd no puede especificar FinalMobileUrls si DevicePreference está establecido en 30001 (móvil). Agregar: No compatible Actualizar: No compatible	matriz de cadenas
FinalUrls	Dirección URL de la página de aterrizaje. Esta dirección URL solo se usa si la palabra clave no especifica una dirección URL final. 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. - No puede especificar FinalMobileUrls si la preferencia de dispositivo está establecida en móvil. Tenga en cuenta también que si se establece el elemento TrackingUrlTemplate o UrlCustomParameters de este anuncio, se requiere al menos una dirección URL final. Agregar: No compatible Actualizar: No compatible	matriz de cadenas
FinalUrlSuffix	No se admite para anuncios de texto.	string
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
Identificación	Identificador único de Microsoft Advertising para el anuncio. Agregar: No compatible Actualizar: Obligatorio y de solo lectura	largo
Estado	Estado del anuncio. Puedes establecer el estado del anuncio en Activo o En pausa. Agregar: No compatible Actualizar: Opcional	AdStatus
TrackingUrlTemplate	Plantilla de seguimiento que se usará como valor predeterminado para todas las direcciones URL de página de aterrizaje. 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. Agregar: No compatible Actualizar: No compatible	string
Tipo	Tipo del anuncio. Este valor es Texto al recuperar un anuncio de texto. Para obtener más información sobre los tipos de anuncios, consulte comentarios sobre los objetos de datos de anuncios. Agregar: No compatible Actualizar: No compatible	AdType
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 . Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Establezca el elemento UrlCustomParameters en null o vacío para conservar los parámetros personalizados existentes. Para quitar todos los parámetros personalizados, establezca el elemento Parameters del objeto CustomParameters en null o vacío. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar en el elemento Parameters del objeto CustomParameters .	CustomParameters

Requisitos

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

Compartir a través de

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

Elementos

Elementos heredados

Elementos heredados de Ad

Requisitos

Comentarios

Recursos adicionales