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

Artículo
11/14/2024

Define un objeto que empareja un encabezado con entre 3 y 10 valores de fragmento de código que indican a los clientes más sobre su negocio.

En el ejemplo siguiente, Courses es el encabezado y .NET, Java, Python y PHP son ejemplos de valores individuales.

Cursos: .NET, Java, Python, PHP

Puede asociar una extensión de anuncio de fragmento de código estructurado con la cuenta o con campañas y grupos de anuncios de la cuenta. Cada entidad (cuenta, campaña o grupo de anuncios) se puede asociar a hasta 20 extensiones de anuncios de fragmentos de código estructurados. Un anuncio de texto expandido solo incluirá un fragmento estructurado (un título con entre 3 y 10 valores) por impresión.

<xs:complexType name="StructuredSnippetAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Header" nillable="true" type="xs:string" />
        <xs:element xmlns:q54="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Values" nillable="true" type="q54:ArrayOfstring" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "DevicePreference": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Scheduling": {
    "DayTimeRanges": [
      {
        "Day": "ValueHere",
        "EndHour": IntValueHere,
        "EndMinute": "ValueHere",
        "StartHour": IntValueHere,
        "StartMinute": "ValueHere"
      }
    ],
    "EndDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "StartDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "UseSearcherTimeZone": "ValueHere"
  },
  "Status": "ValueHere",
  "Type": "StructuredSnippetAdExtension",
  "Version": IntValueHere,
  "Header": "ValueHere",
  "Values": [
    "ValueHere"
  ]
}

Elementos

El objeto StructuredSnippetAdExtension tiene los siguientes elementos: Header, Values.

Elemento	Descripción	Tipo de datos
Encabezado	Encabezado que se anexa con dos puntos (:) y precede a los valores del fragmento de código. Los encabezados de fragmentos de código estructurados deben especificarse en el mismo idioma que pretende que se muestre. Por ejemplo, si desea el encabezado Amenities en inglés, debe especificar el encabezado como Amenities. Si desea el encabezado Ausstattung en alemán, debe especificar el encabezado como Ausstattung (Amenities en alemán). Para obtener una lista de los encabezados admitidos por idioma, consulte Lenguajes de encabezado de extensión de anuncio. Agregar: Obligatorio Actualizar: Obligatorio	string
Valores	Los valores de fragmento de código que siguen después del componente Encabezado del anuncio que se muestra. Cada valor de texto que elija puede tener una longitud máxima de 25 caracteres. Tenga en cuenta que para los caracteres chinos tradicionales, cada valor puede tener una longitud máxima de 12 caracteres. Agregar: Obligatorio Actualizar: Obligatorio	matriz de cadenas

El objeto StructuredSnippetAdExtension tiene elementos heredados.

Elementos heredados

Elementos heredados de AdExtension

El objeto StructuredSnippetAdExtension deriva del objeto AdExtension y hereda los siguientes elementos: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Las descripciones siguientes son específicas de StructuredSnippetAdExtension 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 . Agregar: Solo lectura Actualizar: Solo lectura	Matriz KeyValuePairOfstringstring
Identificación	Identificador único de Microsoft Advertising de la extensión de anuncio. Agregar: 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. Agregar: 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. Agregar: Solo lectura Actualizar: Solo lectura	AdExtensionStatus
Tipo	Tipo de la extensión de anuncio. Este valor es StructuredSnippetAdExtension cuando se recupera una extensión de anuncio de fragmento de código estructurado. Agregar: 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. Agregar: No permitido Actualizar: No permitido	int

Requisitos

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

Compartir a través de