Compartir a través de

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

  • Artículo

Define una extensión de anuncio que especifica una dirección de negocio y un número de teléfono que se incluirán en un anuncio de texto.

Puede asociar una extensión de anuncio de ubicación a la cuenta o a campañas de la cuenta. Cada entidad (cuenta o campaña) se puede asociar con tantas extensiones de anuncios de ubicación como decidas, hasta el número total de extensiones de anuncios de ubicación en tu cuenta.

<xs:complexType name="LocationAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Address" nillable="true" type="tns:Address" />
        <xs:element minOccurs="0" name="CompanyName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="GeoCodeStatus" nillable="true" type="tns:BusinessGeoCodeStatus" />
        <xs:element minOccurs="0" name="GeoPoint" nillable="true" type="tns:GeoPoint" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto LocationAdExtension tiene los siguientes elementos: Address, CompanyName, GeoCodeStatus, GeoPoint, PhoneNumber.

Elemento Descripción Tipo de datos
Dirección La dirección de negocio.

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		 Dirección
CompanyName Nombre de la empresa. El nombre puede contener un máximo de 80 caracteres.

Agregar: Obligatorio
Actualizar: Obligatorio		 string
GeoCodeStatus Valor de estado que indica si se han determinado las coordenadas de latitud y longitud empresariales.

Si proporciona las coordenadas, el estado se establecerá en Completo; De lo contrario, el estado indicará el progreso de la determinación de las coordenadas de la dirección de negocio especificada.

Agregar: No permitido
Actualizar: No permitido		 BusinessGeoCodeStatus
GeoPoint Coordenadas de latitud y longitud del elemento Address especificado. Las coordenadas se usan para marcar la ubicación de la empresa en Mapas de Bing cuando el usuario hace clic en la dirección del anuncio. Si las coordenadas especificadas no están dentro del intervalo de valores válidos, el servicio determina las coordenadas en función de la dirección.

Si especifica las coordenadas conocidas, el servicio no confirma si las coordenadas especificadas coinciden con la dirección de negocio especificada. Si no proporciona las coordenadas, la operación AddAdExtensions usa la dirección de negocio para determinar las coordenadas.

Al agregar más de 10 extensiones de anuncios de ubicación, el servicio resuelve las coordenadas sin conexión y, de lo contrario, resuelve las coordenadas por adelantado durante la ejecución de la operación del servicio. La ubicación no se usará en un anuncio hasta que se determinen las coordenadas, lo que puede tardar entre segundos y minutos en función del número de extensiones de anuncios de ubicación que se agreguen y de la demanda actual.

Para determinar si se han resuelto las coordenadas, llame a la operación GetAdExtensionsByIds y acceda al elemento GeoCodeStatus . Para obtener una lista de los valores de estado posibles, vea BusinessGeoCodeStatus.

Agregar: Opcional
Actualizar: Opcional		 GeoPoint
PhoneNumber Número de teléfono comercial que se va a incluir en el anuncio. El número de teléfono se puede hacer clic en dispositivos móviles de alta fidelidad.

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 también incluye una extensión de llamada, el número de teléfono de la extensión de llamada invalidará este número de teléfono.

Agregar: Opcional
Actualizar: Opcional. Si establece este elemento null, se eliminará la configuración anterior.		 string

El objeto LocationAdExtension tiene elementos heredados.

Elementos heredados

Elementos heredados de AdExtension

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

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