Compartir a través de

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

  • Artículo

Define un objeto que especifica un número de teléfono de clic a llamada que se va a incluir en un anuncio de texto.

Puede asociar una extensión de anuncio de llamada a campañas de la cuenta. Cada entidad (campaña) se puede asociar a una extensión de anuncio de llamada.

<xs:complexType name="CallAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="IsCallOnly" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="IsCallTrackingEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="RequireTollFreeTrackingNumber" nillable="true" type="xs:boolean" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto CallAdExtension tiene los siguientes elementos: CountryCode, IsCallOnly, IsCallTrackingEnabled, PhoneNumber, RequireTollFreeTrackingNumber.

Elemento Descripción Tipo de datos
CountryCode El código de país donde está registrado el número de teléfono. El código de país debe contener un código de país de 2 caracteres. Los valores de código de país admitidos incluyen AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE y VN.

Agregar: Obligatorio
Actualizar: Obligatorio		 string
IsCallOnly La opción de mostrar tanto tu número de teléfono como tu sitio web, o solo tu número de teléfono, a las personas que ven tus anuncios en un teléfono inteligente. Es posible que quiera mostrar solo su número de teléfono si su empresa requiere que hable con cada cliente.

Establezca esta propiedad en true si desea que la extensión del anuncio solo muestre el número de teléfono sin un vínculo a su sitio web y, en caso contrario, si desea que la extensión del anuncio incluya un vínculo a su sitio web, además del número de teléfono, establézcalo en false.

Agregar: Opcional. Si no especifica este elemento o lo deja vacío, se establecerá el valor predeterminado de false y la extensión del anuncio incluirá un vínculo a su sitio web además del número de teléfono.
Actualizar: Opcional		 boolean
IsCallTrackingEnabled Determina si el seguimiento de llamadas está habilitado para la extensión de anuncio de llamada.

El seguimiento de llamadas solo se admite en Estados Unidos y Reino Unido.

Establezca esta propiedad en true para habilitar el seguimiento de llamadas y, de lo contrario, establézcala en false.

Agregar: Opcional. Si no especifica este elemento o lo deja vacío, se establecerá el valor predeterminado de false .
Actualizar: Opcional		 boolean
PhoneNumber Número de teléfono que se puede hacer clic para incluir en el anuncio.

El número de teléfono puede contener un máximo de 35 caracteres y debe ser válido para el país o región especificados.

Si la campaña incluye extensiones de anuncios de llamada y ubicación, este número de teléfono invalidará el número de teléfono especificado en las extensiones de anuncios de ubicación.

Tenga en cuenta que es posible que el número de teléfono se vuelva a formatear. Por ejemplo, si establece el número de teléfono en 4255551212, se reformatearía a (425) 555-1212.

Agregar: Obligatorio
Actualizar: Obligatorio		 string
RequireTollFreeTrackingNumber Puede usar su propio número de teléfono o usar un número de teléfono de reenvío de Microsoft Advertising. Un número de teléfono de reenvío de Microsoft Advertising es un número de teléfono único que se enruta al número de teléfono de su empresa. Con un número de reenvío de Microsoft Advertising, puedes realizar un seguimiento de todas las llamadas desde tu anuncio para poder analizar el rendimiento del anuncio. Este elemento determina si se debe crear un número de teléfono de reenvío gratuito de Microsoft Advertising para el seguimiento de llamadas. Este elemento solo se puede establecer si IsCallTrackingEnabled también es true.

Antes de agosto de 2017, los clientes podían establecer esta propiedad en true si se creaba un número de teléfono de reenvío de Microsoft Advertising para el seguimiento de llamadas. Desde agosto de 2017, los clientes ya no pueden crear un nuevo número de teléfono de reenvío gratuito de Microsoft Advertising. Si establece este valor true , la operación se realizará correctamente; sin embargo, no se creará un número gratuito y, al recuperar la extensión de anuncio de llamada, esta propiedad se establecerá en false. Si se aprovisionó un número de reenvío gratuito antes de agosto de 2017, esta propiedad será true si el número sigue activo al recuperar la extensión de anuncio de llamada.

Agregar: Opcional. Si no especifica este elemento o lo deja vacío, se establecerá el valor predeterminado de false .
Actualizar: Opcional		 boolean

El objeto CallAdExtension tiene elementos heredados.

Elementos heredados

Elementos heredados de AdExtension

El objeto CallAdExtension deriva del objeto AdExtension y hereda los siguientes elementos: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Las descripciones siguientes son específicas de CallAdExtension 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 CallAdExtension 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