Objeto de datos de AdvertiserAccount: Administración de clientes

Artículo
12/21/2023

Define una cuenta de anunciante.

Sintaxis

<xs:complexType name="AdvertiserAccount" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="BillToCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="tns:CurrencyCode" />
    <xs:element minOccurs="0" name="AccountFinancialStatus" nillable="true" type="tns:AccountFinancialStatus" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Language" nillable="true" type="tns:LanguageType" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Number" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ParentCustomerId" type="xs:long" />
    <xs:element minOccurs="0" name="PaymentMethodId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="PaymentMethodType" nillable="true" type="tns:PaymentMethodType" />
    <xs:element minOccurs="0" name="PrimaryUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="AccountLifeCycleStatus" nillable="true" type="tns:AccountLifeCycleStatus" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="TimeZone" nillable="true" type="tns:TimeZoneType" />
    <xs:element minOccurs="0" name="PauseReason" nillable="true" type="xs:unsignedByte" />
    <xs:element xmlns:q1="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q1:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="LinkedAgencies" nillable="true" type="tns:ArrayOfCustomerInfo" />
    <xs:element minOccurs="0" name="SalesHouseCustomerId" nillable="true" type="xs:long" />
    <xs:element xmlns:q2="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="TaxInformation" nillable="true" type="q2:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="BackUpPaymentInstrumentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="BillingThresholdAmount" nillable="true" type="xs:decimal" />
    <xs:element minOccurs="0" name="BusinessAddress" nillable="true" type="tns:Address" />
    <xs:element minOccurs="0" name="AutoTagType" nillable="true" type="tns:AutoTagType" />
    <xs:element minOccurs="0" name="SoldToPaymentInstrumentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="TaxCertificate" nillable="true" type="tns:AccountTaxCertificate">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="AccountMode" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elementos

El objeto AdvertiserAccount tiene los siguientes elementos: AccountFinancialStatus, AccountLifeCycleStatus, AccountMode, AutoTagType, BackUpPaymentInstrumentId, BillingThresholdAmount, BillToCustomerId, BusinessAddress, CurrencyCode, ForwardCompatibilityMap, Id, Language, LastModifiedByUserId, LastModifiedTime, LinkedAgencies, Name, Number, ParentCustomerId, PauseReason, PaymentMethodId, PaymentMethodType, PrimaryUserId, SalesHouseCustomerId, SoldToPaymentInstrumentId, TaxCertificate, TaxInformation, TimeStamp, TimeZone.

Elemento	Descripción	Tipo de datos
AccountFinancialStatus	Estado financiero de la cuenta. Por ejemplo, el estado puede indicar si la cuenta está en buen estado o ha vencido. Añadir: Solo lectura Actualizar: Solo lectura	AccountFinancialStatus
AccountLifeCycleStatus	Estado de la cuenta. No se puede establecer el estado de la cuenta. Añadir: Solo lectura Actualizar: Solo lectura	AccountLifeCycleStatus
AccountMode	El modo de cuenta distingue entre cuentas inteligentes y expertas. Los valores posibles incluyen, entre otros: Expert - Expert Mode es la experiencia completa de Microsoft Advertising. Te proporciona más control sobre la administración de campañas, te permite agregar más contenido a tus anuncios y proporciona mucho más en la forma de informes y seguimiento de rendimiento. Inteligente: Microsoft Advertising usará Microsoft AI para crear anuncios y administrar su campaña publicitaria automáticamente. UnifiedSmart: la cuenta admite la publicidad en Bing, Google y Facebook. También puede administrar su presencia en redes sociales en Facebook, Instagram y LinkedIn. Nota: A partir del 25 de abril de 2023, UnifiedSmart ya no admite Twitter. La mayoría de las operaciones de API de Bing Ads solo se admiten con cuentas de expertos. Las cuentas con cualquier modo de cuenta se devuelven cuando se solicita información de la cuenta, por ejemplo, FindAccountsOrCustomersInfo, GetAccount, GetAccountsInfo, GetUser y SearchAccounts. Añadir: Solo lectura para la mayoría de las cuentas. Los clientes del piloto de campañas inteligentes unificadas cerradas pueden establecer el modo de cuenta en "UnifiedSmart". Actualizar: Solo lectura	string
AutoTagType	Determina si se anexan o reemplazan los códigos de seguimiento utm admitidos. Microsoft Advertising puede agregar automáticamente etiquetas UTM a la dirección URL de destino para que pueda usar su herramienta de análisis de sitios web, por ejemplo Google Analytics, para realizar un seguimiento de cómo las personas llegaron a su sitio web. Las etiquetas automáticas se aplican, por ejemplo, a los anuncios de texto expandido, las palabras clave, las campañas de Compras de Microsoft y las extensiones de vínculo de sitio. Para obtener más información sobre el etiquetado automático, consulte el artículo de ayuda de Microsoft Advertising Cómo add UTM tags to my landing page URL?. Añadir: Opcional. Si no se especifica, el valor predeterminado es Inactivo. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	AutoTagType
BackUpPaymentInstrumentId	Identificador de un instrumento de pago de copia de seguridad que se va a usar para liquidar la cuenta. Este elemento no es aplicable a las cuentas facturadas. Añadir: Solo lectura Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Largo
BillingThresholdAmount	Importe especificado por el cliente para la liquidación con respecto al instrumento de pago seleccionado. Añadir: Solo lectura Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Decimal
BillToCustomerId	Identificador del cliente que se factura por los cargos que genera la cuenta. Este es el agregador que administra esta cuenta en nombre del propietario o el identificador del cliente propietario de la cuenta. El servicio establece el identificador en función del propietario del instrumento de pago identificado en el elemento PaymentMethodId . Añadir: Solo lectura Actualizar: Solo lectura	Largo
BusinessAddress	Ubicación en la que su empresa está registrada legalmente. Si es una agencia que trabaja como agente para su cliente, esta es la ubicación donde el cliente está registrado legalmente. Si es una agencia que trabaja como agregador, esta es la dirección de negocio registrada legalmente de su empresa. La dirección de negocio se usa para determinar los requisitos fiscales. Añadir: Obligatorio. Los elementos Address BusinessName, City y Line1 son necesarios para todos los países o regiones. Para Brasil (BR) e India (IN), también son necesarios los elementos PostalCode y StateOrProvince. Actualizar: Opcional para las cuentas que no se facturan por factura mensual. Dicho esto, si desea realizar cambios en la dirección , debe establecer sus elementos BusinessName, City, CountryCode, Line1 y StateOrProvince (cuando corresponda); Solo lectura para cuentas de factura mensuales. Para actualizar businessaddress de una cuenta de factura, póngase en contacto con el administrador de cuentas o el soporte técnico.	Dirección
CurrencyCode	Código ISO de la moneda que se usa para liquidar la cuenta. El servicio usa la información de moneda con fines de facturación. Añadir: Obligatorio Actualizar: Solo lectura	CurrencyCode
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
Id	Identificador generado por el sistema de la cuenta. Este es el identificador que establece el elemento AccountId y el encabezado SOAP CustomerAccountId en en muchas de las solicitudes de campaña. Añadir: Solo lectura Actualizar: Obligatorio	Largo
Idioma	Idioma utilizado para representar los documentos de facturación que recibe de Microsoft Advertising (si usa una factura como método de pago). Esta configuración solo se aplica a los documentos de facturación de esta cuenta y no se aplica a otras cuentas de Microsoft Advertising que pueda tener. Si lo deja vacío al registrar un cliente, la operación usa el valor de idioma del elemento Lcid del usuario principal. Si lcid se establece en un valor como FrenchCanada, el idioma de la cuenta se establece en francés. Añadir: Solo lectura para AddAccount; Obligatorio para SignupCustomer si se establece UserInvitation y, de lo contrario, este elemento es Opcional. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	LanguageType
LastModifiedByUserId	Identificador del último usuario que actualiza la información de la cuenta. Añadir: Solo lectura Actualizar: Solo lectura	Largo
LastModifiedTime	Fecha y hora en que se actualizó por última vez la cuenta. El valor se encuentra en la hora UTC (hora universal coordinada). El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos. Añadir: Solo lectura Actualizar: Solo lectura	dateTime
LinkedAgencies	Lista de agencias vinculadas a esta cuenta. Actualmente solo se admite un cliente de agencia al agregar la cuenta. Al recuperar la cuenta, se incluirá toda la información de cliente de la agencia vinculada. Añadir: Opcional para AddAccount; Opcional para SignupCustomer si el cliente de la agencia está en el piloto Crear cuentas en nombre del cliente (GetCustomerPilotFeatures devuelve 793). Los agregadores no pueden vincularse como agencias en este contexto y, por tanto, no pueden establecer este elemento. Actualizar: Solo lectura	Matriz CustomerInfo
Nombre	Nombre de la cuenta. La cadena puede contener entre 3 y 100 caracteres y debe ser única entre todos los nombres de cuenta dentro del cliente. Añadir: Obligatorio Actualizar: Obligatorio	string
Número	Número de cuenta generado por el sistema que se usa para identificar la cuenta en la aplicación web de Microsoft Advertising. El número de cuenta tiene el formato xxxxxxxx, donde xxxxxxxx es una serie de ocho caracteres alfanuméricos. Añadir: Solo lectura Actualizar: Solo lectura	string
ParentCustomerId	Identificador del cliente propietario de la cuenta. En las solicitudes de campaña que requieren un identificador de cliente, este es el identificador en el que se establece el encabezado SOAP CustomerId . Añadir: Requerido para AddAccount; Obligatorio para SignupCustomer si no se establece UserInvitation y, en caso contrario, se omite este elemento. Actualizar: Solo lectura	Largo
PauseReason	Valor de marca que indica quién ha pausado la cuenta. Los valores posibles son los siguientes: 1: el usuario detuvo la cuenta. 2- El servicio de facturación detuvo la cuenta. 4- El usuario y el servicio de facturación pausaron la cuenta. Añadir: Solo lectura Actualizar: Solo lectura	unsignedByte
PaymentMethodId	Identificador del instrumento de pago que se va a usar para liquidar la cuenta. Añadir: Opcional para AddAccount; Solo lectura para SignupCustomer si no se ha establecido UserInvitation . Al llamar a SignupCustomer , establezca este elemento en NULL. El servicio recoge automáticamente el identificador de método de pago asociado a la factura del cliente del agregador. Para SignupCustomer si se establece UserInvitation y si la nueva cuenta de cliente se vincula a una agencia a través de LinkedAgencies y si se debe facturar a la agencia, establezca este elemento en el identificador del instrumento de pago de la agencia. De lo contrario, debe dejar este elemento null. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Largo
PaymentMethodType	Tipo de instrumento de pago que se va a utilizar para liquidar la cuenta. No es necesario establecer este valor porque el tipo viene determinado por el instrumento de pago correspondiente al elemento PaymentMethodId . Al llamar a GetAccount y SearchAccounts para obtener los datos de la cuenta, PaymentMethodType se establece en NULL y no se puede determinar el método de pago que usa la cuenta. Reservado para uso interno. Añadir: Solo lectura Actualizar: Solo lectura	PaymentMethodType
PrimaryUserId	Identificador del administrador de cuentas que es el principal responsable de administrar esta cuenta. Solo los usuarios super Administración y estándar se pueden establecer como el contacto principal de una cuenta. Añadir: Para AddAccount si la nueva cuenta de cliente se está vinculando a una agencia a través de LinkedAgencies, puede asignar a uno de los usuarios de la agencia como usuario principal para la nueva cuenta. Al llamar a SignupCustomer como agregador sin incluir UserInvitation, debe dejar este elemento vacío y el usuario principal se establecerá en el identificador de usuario del agregador. Al llamar a SignupCustomer y se incluye UserInvitation , puede dejar este elemento vacío y el usuario principal se establecerá en el identificador del nuevo usuario cliente que acepta la invitación. Al llamar a SignupCustomer y si se establece UserInvitation y si la nueva cuenta de cliente se está vinculando a una agencia a través de LinkedAgencies, puede asignar uno de los usuarios de la agencia como usuario principal para la nueva cuenta. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Largo
SalesHouseCustomerId	Identificador del tercero responsable de un cliente potencial de ventas. Añadir: Solo lectura Actualizar: Solo lectura	Largo
SoldToPaymentInstrumentId	Identificador del instrumento de pago del cliente (el cliente vendido) que se va a usar para liquidar la cuenta. Añadir: Necesario para AddAccount si billtocustomerId difiere de ParentCustomerId; Solo lectura y no aplicable para SignupCustomer. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Largo
TaxCertificate	Reservado.	AccountTaxCertificate
TaxInformation	Para obtener una lista de cadenas de clave y valor válidas para este elemento, vea AdvertiserAccount TaxInformation en la sección siguiente. Añadir: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para quitar un par de clave y valor, establezca la clave y, a continuación, establezca el valor en una cadena vacía ("").	Matriz KeyValuePairOfstringstring
Timestamp	Valor de marca de tiempo que el sistema usa internamente para conciliar las actualizaciones al llamar a las operaciones UpdateAccount y DeleteAccount . Añadir: Solo lectura Actualizar: Obligatorio	base64Binary
Timezone	Valor de zona horaria predeterminado que se va a usar para las campañas de esta cuenta. Si no especifica un valor cuando se agrega la cuenta, la zona horaria se establecerá en PacificTimeUSCanadaTijuana de forma predeterminada. La aplicación web de Microsoft Advertising usa este valor de zona horaria para mostrar la preferencia de zona horaria de la cuenta y no proporciona un valor de zona horaria predeterminado para las campañas creadas mediante la API de administración masiva o de campañas. Añadir: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	TimeZoneType

Observaciones

AdvertiserAccount TaxInformation

A continuación se muestra la lista de claves que están disponibles para el elemento TaxInformation de un objeto AdvertiserAccount.

Nota:

Microsoft Advertising no puede proporcionar instrucciones sobre impuestos o IVA. Si tiene alguna pregunta, póngase en contacto con su asesor fiscal o con la oficina de impuestos local.

TaxInformation Key	Descripción	Países o regiones
AUGSTNumber	El identificador fiscal de las cuentas en Australia. Sin un identificador fiscal, es posible que se apliquen impuestos en función de la ubicación de BusinessAddress . Añadir: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Australia
CCM	El número de registro municipal, o Cadastro de contribuinte mobiliario (CCM), de la entidad jurídica. Añadir: Requerido para las cuentas de negocio si el BusinessAddress está dentro de la ciudad de Sao Paulo, Brasil. El CCM no es aplicable a las empresas de otras ubicaciones. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Brasil
CNPJ	El identificador fiscal de las cuentas empresariales en Brasil. Sin un identificador fiscal, es posible que se apliquen impuestos en función de la ubicación de BusinessAddress . Añadir: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Brasil
CPF	El identificador fiscal de las cuentas personales en Brasil. Sin un identificador fiscal, es posible que se apliquen impuestos en función de la ubicación de BusinessAddress . Añadir: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	Brasil
GSTINNumber	Este identificador comienza con dos números que representan el código de estado en el que se registra la empresa seguido de un máximo de 13 números y letras. Añadir: Opcional Actualizar: Opcional	India
GSTNumber	En Singapur, la facturación está administrada por Microsoft Ireland Operations Ltd., en Irlanda. A partir del 1 de enero de 2020, Microsoft Advertising debe cobrar el Impuesto sobre Bienes y Servicios de Singapur (SG GST) para las empresas registradas en Singapur. Si proporciona su número de registro GST de SG, Microsoft Advertising aplicará SG GST al 0 %. Si no proporciona su número de registro de GST de SG, Microsoft Advertising deberá cobrar el 7% del GST de SG. (Nota: el tipo impositivo está sujeto a cambios). Los posibles formatos GSTNumber incluyen: dos caracteres alfanuméricos seguidos de un guión opcional seguido de siete dígitos seguidos de un guión opcional seguido de un carácter alfanumérico; O ocho o nueve dígitos seguidos de un carácter alfanumérico; O T o S seguidos de dos dígitos seguidos de una letra mayúscula A - Z seguida de un carácter alfanumérico seguido de cuatro dígitos seguido de un carácter alfanumérico. Ejemplos de GSTNumber: ab-1234567-a; ab1234567-a; ab1234567a; ab-1234567a; 12345678a; 123456789a; T12Aa1234a Añadir: Opcional Actualizar: Opcional	Singapur
IsIVAOrVATTaxPayer	El valor es TRUE o FALSE, que se usa para la determinación fiscal. Añadir: Obligatorio Actualizar: Obligatorio	Chile
IsWithholdingTaxExempted	El valor es TRUE o FALSE, que se usa para la determinación fiscal. Añadir: Obligatorio Actualizar: Obligatorio	Chile
NZGSTNumber	Se trata de un identificador de impuestos de 8 o 9 dígitos. Sin los impuestos de NZGSTNumber, se pueden aplicar impuestos en función de la ubicación de su empresa. Añadir: Opcional Actualizar: Solo lectura	Nueva Zelanda
PanNumber	Número PAN. Añadir: Obligatorio Actualizar: Solo lectura	India
VATNumber	Número de registro del impuesto sobre el valor añadido (IVA) de la cuenta (también conocido como identificador de IVA). El número de IVA debe ser válido en el país o región especificado en el elemento BusinessAddress . Sin un número de registro de IVA o un certificado de exención, es posible que se apliquen impuestos en función de su ubicación empresarial. Añadir: Opcional Actualizar: Opcional	Consulte formato de número de IVA por país o región para obtener más información.

Formato de número de IVA por país o región

En esta tabla se enumeran los formatos de número de registro de IVA por país o región.

Número de IVA	País o región
Comienza con 2 letras específicas de cada país o región, seguidas de un máximo de 12 dígitos o letras.	Austria, Bélgica, Bulgaria, Chipre, República Checa, Alemania, Dinamarca, Estonia, Grecia, Finlandia, Francia, Reino Unido, Croacia, Hungría, Irlanda, Italia, Lituania, Luxemburgo, Letonia, Malta, Mónaco, Países Bajos, Polonia, Portugal, Rumanía, España, Suecia, Eslovenia y Eslovaquia.
Debe tener el siguiente formato: XXXXXXXX-X o XXXXXXXX-K, donde X representa 8 dígitos seguidos de un dígito final.	Chile
Debe tener el siguiente formato: HUXXXXXXXX (donde HU va seguido de 8 dígitos).	Hungría
Debe tener el siguiente formato: LIXXXXX o XXXXX (donde se admiten ambos formatos y LI es opcional y el número de dígitos es 5).	Liechtenstein
Debe tener el siguiente formato: XXXXXXXX-0001 (donde 8 dígitos preceed -0001).	Nigeria
Debe tener el formato siguiente: PTXXXXXXXXX (donde PT va seguido de 9 dígitos).	Portugal
9 o 13 dígitos de longitud, de los cuales los primeros 8 o 12 dígitos son el número de id. real, y el último dígito es un dígito de suma de comprobación calculado según ISO 7064, MOD 11-10.	Serbia
CHE + 9 dígitos numéricos + TVA, MWST o IVA (por ejemplo, CHE-123.456.788 TVA). El último dígito es un dígito de suma de comprobación MOD11 creado con el patrón de ponderación: 5,4,3,2,7,6,5,4.	Suiza
Debe tener el formato siguiente: 13 dígitos de longitud.	Tailandia

Requisitos

Servicio: CustomerManagementService.svc v13
Nombres: https://bingads.microsoft.com/Customer/v13/Entities

Usado por

AddAccount
GetAccount
SearchAccounts
SignupCustomer
UpdateAccount