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

Artículo
11/14/2024

Define un objeto que especifica texto adicional sobre la empresa, los productos o los servicios que se van a incluir en un anuncio de texto.

Puedes asociar una extensión de anuncio de aplicación a la cuenta o a campañas y grupos de anuncios de la cuenta. Debes asociar entre 2 y 20 extensiones de anuncios de llamada por entidad (cuenta, campaña o grupo de anuncios). Si asocias una o menos extensiones de llamada a tu cuenta, campaña o grupo de anuncios, no se mostrará ningún texto de llamada con tu anuncio. Un anuncio puede incluir entre 2 y 4 llamadas por impresión.

Las extensiones de anuncio asociadas en el nivel de grupo de anuncios invalidarán las extensiones de anuncio del mismo tipo que están asociadas en el nivel de campaña. Por ejemplo, si tiene dos extensiones de llamada establecidas para la campaña A, cero extensiones de llamada asociadas a Ad Group AA y una extensión de llamada asociada a Ad Group AB, solo ad group AA es apto para que sus anuncios de texto se decoran con llamadas.

<xs:complexType name="CalloutAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
      </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": "CalloutAdExtension",
  "Version": IntValueHere,
  "Text": "ValueHere"
}

Elementos

El objeto CalloutAdExtension tiene los siguientes elementos: Text.

Elemento	Descripción	Tipo de datos
Mensaje de texto	Texto de llamada adicional sobre su empresa, productos o servicios para incluirlo en un anuncio de texto. El texto de la extensión de llamada debe ser diferente del texto del anuncio. La longitud de esta cadena debe tener entre 1 y 25 caracteres. Tenga en cuenta que para los caracteres chinos tradicionales, la longitud de esta cadena debe tener entre 1 y 12 caracteres. Agregar: Obligatorio Actualizar: Obligatorio	string

El objeto CalloutAdExtension tiene elementos heredados.

Elementos heredados

Elementos heredados de AdExtension

El objeto CalloutAdExtension deriva del objeto AdExtension y hereda los siguientes elementos: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Las descripciones siguientes son específicas de CalloutAdExtension 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 CalloutAdExtension cuando se recupera una extensión de anuncio de llamada. 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