Objeto de Dados AdvertiserAccount - Gestão de Clientes

Artigo
07/19/2024

Define uma conta de anunciante.

Sintaxe

<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

O objeto AdvertiserAccount tem os seguintes 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	Descrição	Tipo de Dados
AccountFinancialStatus	O estado financeiro da conta. Por exemplo, o estado pode indicar se a conta está em bom estado ou está em dívida. Adicionar: Só de leitura Atualização: Só de leitura	AccountFinancialStatus
AccountLifeCycleStatus	O estado da conta. Não é possível definir o estado da conta. Adicionar: Só de leitura Atualização: Só de leitura	AccountLifeCycleStatus
AccountMode	O modo de conta distingue entre contas inteligentes e especializadas. Os valores possíveis incluem, mas não estão limitados a: Expert - Expert Mode é a experiência completa do Microsoft Advertising. Dá-lhe mais controlo sobre a gestão de campanhas, permite-lhe adicionar mais conteúdos aos seus anúncios e fornece muito mais na forma de relatórios de desempenho e controlo. Smart - O Microsoft Advertising utilizará o Microsoft AI para criar anúncios e gerir a sua campanha publicitária por si. UnifiedSmart – a conta suporta publicidade em todo o Bing, Google e Facebook. Também pode gerir a sua presença na rede social no Facebook, Instagram e LinkedIn. Nota: a partir de 25 de abril de 2023, o UnifiedSmart já não suporta o Twitter. A maioria das operações da API Bing Ads só são suportadas com contas de Especialistas. As contas com qualquer modo de conta são devolvidas quando solicita informações de conta, por exemplo, FindAccountsOrCustomersInfo, GetAccount, GetAccountsInfo, GetUser e SearchAccounts. Adicionar: Só de leitura para a maioria das contas. Os clientes no piloto de campanhas inteligentes unificadas fechados podem definir o modo de conta como "UnifiedSmart". Atualização: Só de leitura	cadeia
AutoTagType	Determina se pretende anexar ou substituir os códigos de controlo UTM suportados. O Microsoft Advertising pode adicionar automaticamente etiquetas UTM ao URL de destino para que possa utilizar a sua ferramenta de análise de sites, por exemplo o Google Analytics, para controlar a forma como as pessoas chegaram ao seu site. As etiquetas automáticas são aplicadas, por exemplo, a anúncios de texto expandidos, palavras-chave, Campanhas de Compras da Microsoft e Extensões de Sitelink. Para obter detalhes sobre a etiquetagem automática, consulte o artigo de ajuda do Microsoft Advertising Como devo proceder para adicionar etiquetas UTM ao URL da minha página de destino?. Adicionar: Opcional. Se não for especificado, o valor predefinido é Inativo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	AutoTagType
BackUpPaymentInstrumentId	O identificador de um instrumento de pagamento alternativo a utilizar para liquidar a conta. Este elemento não é aplicável para contas faturadas. Adicionar: Só de leitura Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Longo
BillingThresholdAmount	Um cliente especificou o montante para liquidação relativamente ao instrumento de pagamento selecionado. Adicionar: Só de leitura Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	decimal
BillToCustomerId	O identificador do cliente que é cobrado pelos custos gerados pela conta. Este é o agregador que gere esta conta em nome do proprietário ou do identificador do cliente proprietário da conta. O serviço define o identificador com base no proprietário do instrumento de pagamento identificado no elemento PaymentMethodId . Adicionar: Só de leitura Atualização: Só de leitura	Longo
Endereço Comercial	A localização onde a sua empresa está legalmente registada. Se for uma agência que trabalha como agente para o cliente, esta é a localização onde o cliente está legalmente registado. Se for uma agência que trabalha como agregador, este é o endereço comercial legalmente registado da sua empresa. O endereço comercial é utilizado para determinar os seus requisitos fiscais. Adicionar: Necessário. Os elementos Address BusinessName, City e Line1 são necessários para todos os países ou regiões. Para o Brasil (BR) e a Índia (IN), também são necessários os elementos Código Postal e StateOrProvince. Atualização: Opcional para contas que não são faturadas por fatura mensal. Dito isto, se quiser efetuar alterações ao Endereço , tem de definir os respetivos elementos BusinessName, City, CountryCode, Line1 e StateOrProvince (quando aplicável); Só de leitura para contas de fatura mensal. Para atualizar o Endereço Empresarial de uma conta de fatura, contacte o seu gestor de conta ou suporte.	Address
CurrencyCode	O código ISO para a moeda utilizada para liquidar a conta. O serviço utiliza as informações de moeda para fins de faturação. Adicionar: Necessário Atualização: Só de leitura	CurrencyCode
ForwardCompatibilityMap	A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API. As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.	Matriz KeyValuePairOfstringstring
ID	O identificador gerado pelo sistema da conta. Este é o identificador para o qual definiu o elemento AccountId e o cabeçalho SOAP CustomerAccountId em muitos dos pedidos de campanha. Adicionar: Só de leitura Atualização: Necessário	Longo
Idioma	O idioma utilizado para compor os documentos de faturação que recebe do Microsoft Advertising (se utilizar uma fatura como método de pagamento). Esta definição destina-se apenas a documentos de faturação para esta conta e não se aplica a outras contas do Microsoft Advertising que possa ter. Se deixar isto em branco ao inscrever um cliente, a operação utiliza o valor de idioma do elemento Lcid do utilizador primário. Se o Lcid estiver definido para um valor como FrenchCanada, o idioma da conta é definido como Francês. Adicionar: Só de leitura para AddAccount; Necessário para SignupCustomer se a UserInvitation estiver definida e, caso contrário, este elemento for Opcional. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	LanguageType
LastModifiedByUserId	O identificador do último utilizador a atualizar as informações da conta. Adicionar: Só de leitura Atualização: Só de leitura	Longo
LastModifiedTime	A data e hora em que a conta foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC). O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos. Adicionar: Só de leitura Atualização: Só de leitura	dateTime
LinkedAgencies	A lista de agências ligadas a esta conta. Atualmente, apenas um cliente da agência é suportado quando adiciona a conta. Quando obtém a conta, todas as informações do cliente da agência associada serão incluídas. Adicionar: Opcional para AddAccount; Opcional para SignupCustomer se o cliente da agência estiver no piloto Criar Contas em Nome do Cliente (GetCustomerPilotFeatures devolve 793). Os agregadores não podem ligar como agências neste contexto e, por conseguinte, não podem definir este elemento. Atualização: Só de leitura	Matriz CustomerInfo
Nome	O nome da conta. A cadeia pode conter entre 3 e 100 carateres e tem de ser exclusiva entre todos os nomes de conta no cliente. Adicionar: Necessário Atualização: Necessário	cadeia
Número	O número de conta gerado pelo sistema que é utilizado para identificar a conta na aplicação Web Microsoft Advertising. O número da conta tem o formulário xxxxxxxx, em que xxxxxxxx é uma série de oito carateres alfanuméricos. Adicionar: Só de leitura Atualização: Só de leitura	cadeia
ParentCustomerId	O identificador do cliente que é o proprietário da conta. Nos pedidos de campanha que requerem um identificador de cliente, este é o identificador para o qual definiu o cabeçalho SOAP CustomerId . Adicionar: Necessário para AddAccount; Necessário para SignupCustomer se a UserInvitation não estiver definida e, caso contrário, este elemento for ignorado. Atualização: Só de leitura	Longo
PauseReason	Um valor de sinalizador que indica quem colocou a conta em pausa. Seguem-se os valores possíveis: 1 - O utilizador fez uma pausa na conta. 2 - O serviço de faturação fez uma pausa na conta. 4 - O utilizador e o serviço de faturação colocaram a conta em pausa. Adicionar: Só de leitura Atualização: Só de leitura	unsignedByte
PaymentMethodId	O identificador do instrumento de pagamento a utilizar para liquidar a conta. Adicionar: Opcional para AddAccount; Só de leitura para SignupCustomer se a UserInvitation não estiver definida. Quando chamar SignupCustomer , defina este elemento como NULL. O serviço recolhe automaticamente o identificador do método de pagamento associado à fatura do cliente agregador. Para SignupCustomer se a UserInvitation estiver definida e se a nova conta de cliente estiver a ser associada a uma agência através do LinkedAgencies e se a agência deve ser faturada, defina este elemento para o ID do instrumento de pagamento da agência. Caso contrário, deve deixar este elemento nulo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Longo
PaymentMethodType	O tipo de instrumento de pagamento a utilizar para liquidar a conta. Não tem de definir este valor porque o tipo é determinado pelo instrumento de pagamento correspondente ao elemento PaymentMethodId . Quando liga para GetAccount e SearchAccounts para obter os dados da conta, PaymentMethodType está definido como NULL e não pode determinar o método de pagamento que a conta utiliza. Reservado para utilização interna. Adicionar: Só de leitura Atualização: Só de leitura	PaymentMethodType
PrimaryUserId	O identificador do gestor de conta que é o principal responsável pela gestão desta conta. Apenas os utilizadores do Super Administração e Standard podem ser definidos como o contacto principal de uma conta. Adicionar: Para a AddAccount , se a nova conta de cliente estiver a ser associada a uma agência através do LinkedAgencies, pode atribuir um dos utilizadores da agência como utilizador principal para a nova conta. Quando chamar SignupCustomer como agregador sem incluir a UserInvitation, deve deixar este elemento vazio e o utilizador principal será definido como o identificador de utilizador do agregador. Quando chama SignupCustomer e a UserInvitation está incluída, pode deixar este elemento vazio e o utilizador principal será definido como o identificador do novo utilizador cliente que aceita o convite. Quando chamar SignupCustomer e se a UserInvitation estiver definida e se a nova conta de cliente estiver a ser associada a uma agência através do LinkedAgencies, pode atribuir um dos utilizadores da agência como utilizador principal para a nova conta. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Longo
SalesHouseCustomerId	O identificador de terceiros responsável por uma oportunidade potencial de vendas. Adicionar: Só de leitura Atualização: Só de leitura	Longo
SoldToPaymentInstrumentId	O identificador do instrumento de pagamento do cliente (o cliente vendido) a utilizar para liquidar a conta. Adicionar: Necessário para AddAccount se BillToCustomerId for diferente do ParentCustomerId; Só de leitura e não aplicável a SignupCustomer. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Longo
TaxCertificate	O objeto de dados de certificado de imposto de conta.	AccountTaxCertificate
TaxInformation	Para obter uma lista de cadeias de chave e valor válidas para este elemento, veja AdvertiserAccount TaxInformation na secção abaixo. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para remover um par de chave e valor, defina a chave e, em seguida, defina o valor como uma cadeia vazia ("").	Matriz KeyValuePairOfstringstring
Carimbo de data/hora	O valor do carimbo de data/hora que o sistema utiliza internamente para reconciliar as atualizações quando chama as operações UpdateAccount e DeleteAccount . Adicionar: Só de leitura Atualização: Necessário	base64Binary
Fuso Horário	O valor de fuso horário predefinido a utilizar para campanhas nesta conta. Se não especificar um valor quando a conta for adicionada, o fuso horário será definido como PacificTimeUSCanadaT induzido por predefinição. Este valor de fuso horário é utilizado pela aplicação Web Microsoft Advertising para apresentar a preferência de fuso horário da conta e não fornece um valor de fuso horário predefinido para campanhas criadas com a API de Gestão de Campanhas ou em Massa. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	TimeZoneType

Observações

AdvertiserAccount TaxInformation

Segue-se a lista de chaves que estão disponíveis para o elemento TaxInformation de uma AdvertiserAccount.

Nota

O Microsoft Advertising não pode fornecer orientações sobre impostos ou IVA. Se tiver dúvidas, contacte o seu consultor fiscal ou fiscal local.

Chave de TaxInformation	Descrição	Países ou Regiões
AUGSTNumber	O identificador fiscal das contas na Austrália. Sem um identificador fiscal, os impostos podem aplicar-se com base na sua localização businessAddress . Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Austrália
CCM	O número de registo municipal, ou Cadastro de contribuinte mobiliario (CCM), da entidade legal. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Brasil
CNPJ	O identificador fiscal das contas comerciais no Brasil. Sem um identificador fiscal, os impostos podem aplicar-se com base na sua localização businessAddress . Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Brasil
CPF	O identificador fiscal das contas pessoais no Brasil. Sem um identificador fiscal, os impostos podem aplicar-se com base na sua localização businessAddress . Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Brasil
GSTINNumber	Este ID começa com dois números que representam o código de estado no qual a empresa é registada, seguido de um máximo de 13 números e letras. Adicionar: Opcional Atualização: Opcional	Índia
GSTNumber	Em Singapura, a faturação é gerida pela Microsoft Ireland Operations Ltd., na Irlanda. A partir de 1 de janeiro de 2020, a Microsoft Advertising tem de cobrar o Imposto sobre Bens e Serviços de Singapura (SG GST) às empresas registadas em Singapura. Se fornecer o seu número de registo SG GST, o Microsoft Advertising aplicará o GST SG a 0%. Se não fornecer o seu número de registo SG GST, o Microsoft Advertising terá de cobrar 7% de GST SG. (Nota: a taxa de imposto está sujeita a alterações.) Os formatos GSTNumber possíveis incluem: dois carateres alfanuméricos seguidos de um traço opcional seguido de sete dígitos seguidos de um traço opcional seguido de um caráter alfanumérico; OU oito ou nove dígitos seguidos de um caráter alfanumérico; OU T ou S seguido de dois dígitos seguidos por uma letra em maiúscula A - Z seguido de um caráter alfanumérico seguido de quatro dígitos seguido de um caráter alfanumérico. Exemplos de GSTNumber: ab-1234567-a; ab1234567-a; ab1234567a; ab-1234567a; 12345678a; 123456789a; T12Aa1234a Adicionar: Opcional Atualização: Opcional	Singapura
IsIVAOrVATTaxPayer	O valor é VERDADEIRO ou FALSO, que é utilizado para a determinação fiscal. Adicionar: Necessário Atualização: Necessário	Chile
IsWithholdingTaxExempted	O valor é VERDADEIRO ou FALSO, que é utilizado para a determinação fiscal. Adicionar: Necessário Atualização: Necessário	Chile
NZGSTNumber	Trata-se de um ID de imposto longo de 8 ou 9 dígitos. Sem os impostos NZGSTNumber pode aplicar-se com base na sua localização comercial. Adicionar: Opcional Atualização: Só de leitura	Nova Zelândia
PanNumber	O número do PAN. Adicionar: Necessário Atualização: Só de leitura	Índia
Nifúmero	O número de registo do Imposto sobre o Valor Acrescentado (IVA) da conta (também conhecido como identificador de IVA). O número do NIF tem de ser válido no país ou região que especificou no elemento BusinessAddress . Sem um número de registo de IVA ou certificado de isenção, os impostos podem aplicar-se com base na sua localização comercial. Adicionar: Opcional Atualização: Opcional	Consulte o formato do número de IVA por país/região para obter detalhes.

Formato do número de IVA por país ou região

Esta tabela lista os formatos de número de registo de IVA por país ou região.

Número do NIF	País/região
Começa com 2 letras específicas de cada país/região, seguidas de um máximo de 12 dígitos ou letras.	Áustria, Bélgica, Bulgária, Chipre, República Checa, Alemanha, Dinamarca, Estónia, Grécia, Finlândia, França, Reino Unido, Croácia, Hungria, Irlanda, Itália, Lituânia, Luxemburgo, Letónia, Malta, Mónaco, Países Baixos, Polónia, Portugal, Roménia, Espanha, Suécia, Eslovénia e Eslováquia.
Tem de estar no seguinte formato: XXXXXXXX-X ou XXXXXXXX-K, em que X representa 8 dígitos seguido de um dígito à direita.	Chile
Tem de estar no seguinte formato: HUXXXXXXXX (em que HU é seguido de 8 dígitos).	Hungria
Tem de estar no seguinte formato: LIXXXXX ou XXXXX (em que ambos os formatos são suportados e LI é opcional e o número de dígitos é 5).	Listenstaine
Tem de estar no seguinte formato: XXXXXXXX-0001 (em que 8 dígitos previamente -0001).	Nigéria
Tem de estar no seguinte formato: PTXXXXXXXXXXX (em que PT é seguido de 9 dígitos).	Portugal
9 ou 13 dígitos de comprimento, dos quais os primeiros 8 ou 12 dígitos são o número de ID real e o último dígito é um dígito de soma de verificação calculado de acordo com ISO 7064, MOD 11-10.	Sérvia
CHE + 9 dígitos numéricos + TVA, MWST ou IVA (por exemplo, CHE-123.456.788 TVA). O último dígito é um dígito de soma de verificação MOD11 criado com o padrão de ponderação: 5,4,3,2,7,6,5,4.	Suíça
Tem de ter o seguinte formato: 13 dígitos de comprimento.	Tailândia

Requisitos

Serviço: CustomerManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Customer/v13/Entities

Utilizado Por

AddAccount
GetAccount
SearchAccounts
SignupCustomer
UpdateAccount

Partilhar via