Condividi tramite


Oggetto dati AdvertiserAccount - Gestione dei clienti

Definisce un account inserzionista.

Sintassi

<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>

Elementi

L'oggetto AdvertiserAccount include gli elementi seguenti: 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 Descrizione Tipo di dati
AccountFinancialStatus Stato finanziario del conto. Ad esempio, lo stato può indicare se l'account è in regola o è scaduto.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
AccountFinancialStatus
AccountLifeCycleStatus Stato dell'account. Non è possibile impostare lo stato dell'account.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
AccountLifeCycleStatus
AccountMode La modalità account distingue tra account intelligenti ed esperti.

I valori possibili includono, ma non sono limitati a:

Expert - Expert Mode è l'esperienza Microsoft Advertising completa. Ti offre un maggiore controllo sulla gestione delle campagne, ti consente di aggiungere più contenuti agli annunci e offre molto di più in relazione alla creazione di report e al monitoraggio delle prestazioni.

Smart - Microsoft Advertising userà Microsoft AI per creare annunci e gestire la campagna pubblicitaria.

UnifiedSmart: l'account supporta la pubblicità in Bing, Google e Facebook. Puoi anche gestire la tua presenza sui social network su Facebook, Instagram e LinkedIn. Nota: a partire dal 25 aprile 2023, UnifiedSmart non supporta più Twitter.

La maggior parte delle operazioni dell'API Bing Ads è supportata solo con gli account Expert. Gli account con qualsiasi modalità account vengono restituiti quando si richiedono informazioni sull'account, ad esempio FindAccountsOrCustomersInfo, GetAccount, GetAccountsInfo, GetUser e SearchAccounts.

Aggiungere: Sola lettura per la maggior parte degli account. I clienti nel progetto pilota di campagne intelligenti unificate chiuse possono impostare la modalità account su "UnifiedSmart".
Aggiornamento: Sola lettura
Stringa
AutoTagType Determina se accodare o sostituire i codici di rilevamento UTM supportati.

Microsoft Advertising può aggiungere automaticamente tag UTM all'URL di destinazione in modo da poter usare lo strumento di analisi del sito Web, ad esempio Google Analytics, per tenere traccia del modo in cui le persone sono arrivate al sito Web. I tag automatici vengono applicati ad esempio ad annunci di testo espansi, parole chiave, campagne di microsoft shopping ed estensioni Sitelink. Per informazioni dettagliate sull'aggiunta automatica di tag, vedere l'articolo della Guida di Microsoft Advertising Ricerca per categorie aggiungere tag UTM all'URL della pagina di destinazione.

Aggiungere: Opzionale. Se non è specificato, il valore predefinito è Inactive.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
AutoTagType
BackUpPaymentInstrumentId Identificatore di uno strumento di pagamento di backup da utilizzare per liquidare l'account. Questo elemento non è applicabile per gli account fatturati.

Aggiungere: Sola lettura
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
long
BillingThresholdAmount Un cliente ha specificato l'importo per la liquidazione rispetto allo strumento di pagamento selezionato.

Aggiungere: Sola lettura
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Decimale
BillToCustomerId Identificatore del cliente fatturato per gli addebiti generati dall'account. Si tratta dell'aggregatore che gestisce questo account per conto del proprietario o dell'identificatore del cliente proprietario dell'account.

Il servizio imposta l'identificatore in base al proprietario dello strumento di pagamento identificato nell'elemento PaymentMethodId .

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
long
BusinessAddress La posizione in cui l'azienda è legalmente registrata. Se sei un'agenzia che lavora come agente per il tuo cliente, questa è la posizione in cui il tuo cliente è legalmente registrato. Se sei un'agenzia che lavora come aggregatore, questo è l'indirizzo aziendale registrato legalmente della tua azienda. L'indirizzo aziendale viene usato per determinare i requisiti fiscali.

Aggiungere: Obbligatorio. Gli elementi Address BusinessName, City e Line1 sono necessari per tutti i paesi o le aree geografiche. Per Brasile (BR) e India (IN), sono necessari anche gli elementi PostalCode e StateOrProvince.
Aggiornamento: Facoltativo per gli account non fatturati tramite fattura mensile. Detto questo, se si desidera apportare modifiche all'indirizzo , è necessario impostare gli elementi BusinessName, City, CountryCode, Line1 e StateOrProvince (se applicabile); Sola lettura per gli account con fattura mensile. Per aggiornare BusinessAddress di un account di fattura, contattare il responsabile dell'account o il supporto tecnico.
Indirizzo
CurrencyCode Codice ISO per la valuta utilizzata per liquidare l'account.

Il servizio usa le informazioni sulla valuta a scopo di fatturazione.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
CurrencyCode
ForwardCompatibilityMap Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API.

Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per questo oggetto.
Matrice KeyValuePairOfstringstring
Id Identificatore generato dal sistema dell'account.

Questo è l'identificatore su cui impostare l'elemento AccountId e l'intestazione SOAP CustomerAccountId in molte richieste della campagna.

Aggiungere: Sola lettura
Aggiornamento: Obbligatorio
long
Lingua Lingua usata per eseguire il rendering dei documenti di fatturazione ricevuti da Microsoft Advertising (se si usa una fattura come metodo di pagamento).

Questa impostazione è valida solo per i documenti di fatturazione per questo account e non si applica ad altri account Microsoft Advertising che potresti avere.

Se si lascia vuoto questo elemento durante l'iscrizione di un cliente, l'operazione usa il valore della lingua dell'elemento Lcid dell'utente primario. Se Lcid è impostato su un valore come FrenchCanada, la lingua dell'account viene impostata sul francese.

Aggiungere: Sola lettura per AddAccount; Obbligatorio per SignupCustomer se UserInvitation è impostato e in caso contrario questo elemento è Facoltativo.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
LanguageType
LastModifiedByUserId Identificatore dell'ultimo utente per aggiornare le informazioni dell'account.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
long
LastModifiedTime Data e ora dell'ultimo aggiornamento dell'account. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Datetime
LinkedAgencies Elenco delle agenzie collegate a questo account.

Attualmente è supportato un solo cliente dell'agenzia quando si aggiunge l'account. Quando recuperi l'account, verranno incluse tutte le informazioni sui clienti dell'agenzia collegata.

Aggiungere: Facoltativo per AddAccount; Facoltativo per SignupCustomer se il cliente dell'agenzia si trova nel progetto pilota Create Accounts on Behalf of Client (GetCustomerPilotFeatures restituisce 793). Gli aggregatori non possono collegarsi come agenzie in questo contesto e pertanto non possono impostare questo elemento.
Aggiornamento: Sola lettura
Matrice CustomerInfo
Nome Nome dell'account. La stringa può contenere da 3 a 100 caratteri e deve essere univoca tra tutti i nomi di account all'interno del cliente.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Stringa
Numero Numero di account generato dal sistema usato per identificare l'account nell'applicazione Web Microsoft Advertising.

Il numero di conto ha il formato xxxxxxxx, dove xxxxxxxx è una serie di otto caratteri alfanumerici.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Stringa
ParentCustomerId Identificatore del cliente proprietario dell'account.

Nelle richieste della campagna che richiedono un identificatore del cliente, si tratta dell'identificatore su cui è stata impostata l'intestazione SOAP CustomerId .

Aggiungere: Obbligatorio per AddAccount; Obbligatorio per SignupCustomer se UserInvitation non è impostato e in caso contrario questo elemento viene ignorato.
Aggiornamento: Sola lettura
long
PauseReason Valore del flag che indica chi ha sospeso l'account. Di seguito sono riportati i valori possibili:

1 - L'utente ha sospeso l'account.

2 - Il servizio di fatturazione ha sospeso l'account.

4 - L'utente e il servizio di fatturazione hanno sospeso l'account.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
unsignedByte
PaymentMethodId Identificatore dello strumento di pagamento da utilizzare per liquidare l'account.

Aggiungere: Facoltativo per AddAccount; Sola lettura per SignupCustomer se UserInvitation non è impostato. Quando si chiama SignupCustomer , impostare questo elemento su NULL. Il servizio preleva automaticamente l'identificatore del metodo di pagamento associato alla fattura del cliente aggregatore. Per SignupCustomer se userInvitation è impostato e se il nuovo account client è collegato a un'agenzia tramite LinkedAgencies e se l'agenzia deve essere fatturata, impostare questo elemento sull'ID strumento di pagamento dell'agenzia. In caso contrario, è consigliabile lasciare null questo elemento.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
long
PaymentMethodType Tipo di strumento di pagamento da utilizzare per liquidare il conto. Non è necessario impostare questo valore perché il tipo è determinato dallo strumento di pagamento corrispondente all'elemento PaymentMethodId .

Quando chiami GetAccount e SearchAccounts per ottenere i dati dell'account, PaymentMethodType è impostato su NULL e non puoi determinare il metodo di pagamento usato dall'account.

Riservato per uso interno.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
PaymentMethodType
PrimaryUserId Identificatore del responsabile dell'account che è responsabile principalmente della gestione di questo account.

Solo gli utenti Super Amministrazione e Standard possono essere impostati come contatto principale per un account.

Aggiungere: Per AddAccount se il nuovo account client viene collegato a un'agenzia tramite LinkedAgencies, è possibile assegnare uno degli utenti dell'agenzia come utente primario per il nuovo account. Quando si chiama SignupCustomer come aggregatore senza includere UserInvitation, è necessario lasciare vuoto questo elemento e l'utente primario verrà impostato sull'identificatore utente aggregatore. Quando chiami SignupCustomer e userInvitation è incluso, puoi lasciare vuoto questo elemento e l'utente primario verrà impostato sull'identificatore del nuovo utente client che accetta l'invito. Quando chiami SignupCustomer e se userInvitation è impostato e se il nuovo account client viene collegato a un'agenzia tramite LinkedAgencies, puoi assegnare uno degli utenti dell'agenzia come utente primario per il nuovo account.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
long
SalesHouseCustomerId Identificatore della terza parte responsabile di un lead di vendita.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
long
SoldToPaymentInstrumentId Identificatore dello strumento di pagamento del cliente (il cliente venduto) da utilizzare per liquidare l'account.

Aggiungere: Obbligatorio per AddAccount se BillToCustomerId è diverso da ParentCustomerId; Sola lettura e non applicabile per SignupCustomer.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
long
TaxCertificate Riservati. AccountTaxCertificate
TaxInformation Per un elenco di stringhe di chiave e valore valide per questo elemento, vedere AdvertiserAccount TaxInformation nella sezione seguente.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per rimuovere una coppia chiave-valore, impostare la chiave e quindi impostare il valore su una stringa vuota (""".
Matrice KeyValuePairOfstringstring
Timestamp Valore del timestamp usato internamente dal sistema per riconciliare gli aggiornamenti quando si chiamano le operazioni UpdateAccount ed DeleteAccount .

Aggiungere: Sola lettura
Aggiornamento: Obbligatorio
base64Binary
Fuso orario Valore predefinito del fuso orario da usare per le campagne in questo account.

Se non si specifica un valore quando viene aggiunto l'account, il fuso orario verrà impostato su PacificTimeUSCanadaTijuana per impostazione predefinita.

Questo valore del fuso orario viene usato dall'applicazione Web Microsoft Advertising per visualizzare la preferenza del fuso orario dell'account e non fornisce un valore predefinito per il fuso orario per le campagne create tramite l'API Gestione campagne o Bulk.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
TimeZoneType

Osservazioni

AdvertiserAccount TaxInformation

Di seguito è riportato l'elenco delle chiavi disponibili per l'elemento TaxInformation di un AdvertiserAccount.

Nota

Microsoft Advertising non può fornire indicazioni su imposte o IVA. In caso di domande, contattare il consulente fiscale o l'ufficio fiscale locale.

Chiave TaxInformation Descrizione Paesi o aree geografiche
AUGSTNumber Identificatore fiscale per gli account in Australia. Senza un identificatore fiscale, le imposte potrebbero essere applicate in base alla posizione BusinessAddress .

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Australia
CCM Numero di registrazione municipale, o Cadastro de contribuinte mobiliario (CCM), della persona giuridica.

Aggiungere: Obbligatorio per gli account aziendali se BusinessAddress si trova all'interno della città di San Paolo, in Brasile. Il CCM non è applicabile per le aziende di altre località.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Brasile
CNPJ Identificatore fiscale per gli account aziendali in Brasile. Senza un identificatore fiscale, le imposte potrebbero essere applicate in base alla posizione BusinessAddress .

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Brasile
CPF Identificatore fiscale per gli account personali in Brasile. Senza un identificatore fiscale, le imposte potrebbero essere applicate in base alla posizione BusinessAddress .

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Brasile
GSTINNumber Questo ID inizia con due numeri che rappresentano il codice di stato in cui è registrata l'azienda seguita da un massimo di 13 numeri e lettere.

Aggiungere: Opzionale
Aggiornamento: Opzionale
India
GSTNumber A Singapore, la fatturazione è gestita da Microsoft Ireland Operations Ltd., in Irlanda. A partire dal 1° gennaio 2020, Microsoft Advertising è tenuta ad addebitare la Singapore Goods and Services Tax (SG GST) per le aziende registrate a Singapore. Se si specifica il numero di registrazione SG GST, Microsoft Advertising applicherà SG GST allo 0%. Se non fornisci il tuo numero di registrazione SG GST, Microsoft Advertising deve addebitare il 7% di SG GST. Nota: l'aliquota fiscale è soggetta a modifiche.

I possibili formati GSTNumber includono: due caratteri alfanumerici seguiti da un trattino facoltativo seguito da sette cifre seguite da un trattino facoltativo seguito da un carattere alfanumerico; OPPURE otto o nove cifre seguite da un carattere alfanumerico; OR T o S seguito da due cifre seguite da una lettera maiuscola A - Z seguita da un carattere alfanumerico seguito da quattro cifre seguite da un carattere alfanumerico. Esempi GSTNumber: ab-1234567-a; ab1234567-a; ab1234567a; ab-1234567a; 12345678a; 123456789a; T12Aa1234a

Aggiungere: Opzionale
Aggiornamento: Opzionale
Singapore
IsIVAOrVATTaxPayer Il valore è TRUE o FALSE, usato per la determinazione dell'imposta.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Cile
IsWithholdingTaxExempted Il valore è TRUE o FALSE, usato per la determinazione dell'imposta.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Cile
NZGSTNumber Si tratta di un ID imposta lungo 8 o 9 cifre. Senza le imposte NZGSTNumber potrebbero essere applicate in base alla posizione dell'azienda.

Aggiungere: Opzionale
Aggiornamento: Sola lettura
Nuova Zelanda
PanNumber Numero PAN.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
India
NUMERO PARTITA IVA Numero di registrazione dell'imposta sul valore aggiunto (IVA) del conto (noto anche come identificatore IVA). Il numero di partita IVA deve essere valido nel paese o nell'area geografica specificata nell'elemento BusinessAddress . Senza un numero di partita IVA o un certificato di esenzione, potrebbero essere applicate imposte in base alla sede aziendale.

Aggiungere: Opzionale
Aggiornamento: Opzionale
Per informazioni dettagliate, vedere Formato numero DI PARTITA IVA per paese/area geografica.

Formato del numero di partita IVA per paese o area geografica

Questa tabella elenca i formati dei numeri di partita IVA per paese o area geografica.

Numero di partita IVA Paese
Inizia con 2 lettere specifiche per ogni paese/area geografica, seguite da un massimo di 12 cifre o lettere. Austria, Belgio, Bulgaria, Cipro, Repubblica Ceca, Germania, Danimarca, Estonia, Grecia, Finlandia, Francia, Regno Unito, Croazia, Ungheria, Irlanda, Italia, Lituania, Lussemburgo, Lettonia, Malta, Monaco, Paesi Bassi, Polonia, Portogallo, Romania, Spagna, Svezia, Slovenia e Slovacchia.
Deve essere nel formato seguente: XXXXXXXX-X o XXXXXXXX-K, dove X rappresenta 8 cifre seguite da una cifra finale. Cile
Deve essere nel formato seguente: HUXXXXXXXX (dove HU è seguito da 8 cifre). Ungheria
Deve essere nel formato seguente: LIXXXXX o XXXXX (in cui entrambi i formati sono supportati e LI è facoltativo e il numero di cifre è 5). Liechtenstein
Deve essere nel formato seguente: XXXXXXXX-0001 (dove 8 cifre precedevano -0001). Nigeria
Deve essere nel formato seguente: PTXXXXXXXXX (dove PT è seguito da 9 cifre). Portogallo
9 o 13 cifre di lunghezza, di cui le prime 8 o 12 cifre sono il numero ID effettivo e l'ultima cifra è una cifra di checksum calcolata in base a ISO 7064, MOD 11-10. Serbia
CHE + 9 cifre numeriche + TVA, MWST o IVA (ad esempio CHE-123.456.788 TVA). L'ultima cifra è una cifra di checksum MOD11 compilata con il modello di ponderazione: 5,4,3,2,7,6,5,4. Svizzera
Deve essere nel formato seguente: 13 cifre di lunghezza. Thailandia

Requisiti

Servizio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Usato da

AddAccount
GetAccount
SearchAccounts
SignupCustomer
UpdateAccount