Condividi tramite

Oggetto dati InsertionOrder - Fatturazione del cliente

  • Articolo

Un ordine di inserimento è un contratto che stabilisce l'importo massimo che si spenderà per il conto in un determinato periodo di tempo. Se hai configurato la fatturazione mensile per il tuo account, devi avere un ordine di inserimento attivo affinché gli annunci siano idonei per la distribuzione. Puoi comunque controllare la spesa usando il budget della campagna e ti verranno addebitati solo i costi accumulati. Ad esempio, se si ha un ordine di inserimento di un mese per $ 5.000 e si sono accumulati solo $ 4.500 in addebiti nel periodo di fatturazione, verranno dedotti solo $ 4.500 dal budget dell'ordine di inserimento.

Avviso

Il budget dell'ordine di inserimento si applica solo alla spesa pubblicitaria, che è una distinzione importante se l'azienda si trova in un paese o in un'area geografica in cui Servizi online sono tassati. Se si dispone di un limite di budget rigoroso, potrebbe essere necessario tenere conto delle imposte nel budget dell'ordine di inserimento. Per altre informazioni sui requisiti fiscali nella propria sede aziendale, vedere l'articolo della Guida sulle informazioni fiscali o sull'IVA .

La maggior parte degli elementi di questo oggetto può essere impostata solo prima dell'approvazione dell'ordine di inserimento, ad esempio se Status è impostato su PendingUserReview. In tal caso è possibile apportare nuove modifiche o approvare o rifiutare l'ordine di inserimento tramite elementi di questo oggetto. Quando lo stato dell'ordine di inserimento è Attivo, Esaurito, Scaduto o NotStarted, è possibile apportare nuove modifiche o approvare o rifiutare le modifiche in sospeso correnti tramite l'elemento PendingChanges . Se lo stato dell'ordine di inserimento è Annullato o Rifiutato, non è possibile aggiornare l'ordine di inserimento.

Nota

L'operazione SearchInsertionOrders restituirà fino a 24 ordini di inserimento per serie ricorrente.

È possibile recuperare ma con poche eccezioni non è possibile aggiungere o aggiornare una serie di ordini di inserimento tramite l'API Bing Ads. Utilizzare l'elemento IsInSeries per determinare se l'ordine di inserimento è in una serie ricorrente.

  • Se si tenta di aggiornare StartDate o EndDate di un ordine di inserimento che fa parte di una serie ricorrente, l'API restituirà un errore.
  • Se si aggiorna lo stato di un ordine di inserimento che fa parte di una serie ricorrente, l'aggiornamento dello stato verrà applicato a tutti gli ordini di inserimento della serie.

Per gestire gli ordini di inserimento ricorrenti nell'applicazione Web Microsoft Advertising, vedere l'articolo della Guida Ricerca per categorie creare e modificare un ordine di inserimento.

Sintassi

<xs:complexType name="InsertionOrder" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AccountId" type="xs:long" />
    <xs:element minOccurs="0" name="BookingCountryCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Comment" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <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="NotificationThreshold" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ReferenceId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="SpendCapAmount" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:InsertionOrderStatus" />
    <xs:element minOccurs="0" name="PurchaseOrder" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="PendingChanges" nillable="true" type="tns:InsertionOrderPendingChanges" />
    <xs:element minOccurs="0" name="AccountNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="BudgetRemaining" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetSpent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetRemainingPercent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="BudgetSpentPercent" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="SeriesName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsInSeries" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="SeriesFrequencyType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsUnlimited" nillable="true" type="xs:boolean">
      <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="IsEndless" nillable="true" type="xs:boolean">
      <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 InsertionOrder include gli elementi seguenti: AccountId, AccountNumber, BookingCountryCode, BudgetRemaining, BudgetRemainingPercent, BudgetSpent, BudgetSpentPercent, Comment, EndDate, Id, IsEndless, IsInSeries, IsUnlimited, LastModifiedByUserId, LastModifiedTime, Name, NotificationThreshold, PendingChanges, PurchaseOrder, ReferenceId, SeriesFrequencyType, SeriesName, SpendCapAmount, StartDate, Status.

Elemento Descrizione Tipo di dati
AccountId Identificatore dell'account a cui si applica l'ordine di inserimento.

Non è possibile aggiornare l'identificatore dell'account dopo aver creato l'ordine di inserimento.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura		 long
AccountNumber 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
BookingCountryCode Riservato per uso interno.

Aggiungere: Obbligatorio per alcuni account; Facoltativo per alcuni account.
Aggiornamento: Sola lettura		 Stringa
BudgetRemaining Saldo in esecuzione dell'ordine di inserimento.

Il valore del saldo in esecuzione è inizialmente lo stesso di SpendCapAmount e quindi diminuisce ogni volta che viene pubblicato un annuncio nell'account.

Questo elemento è vuoto se l'ordine di inserimento ha un budget illimitato.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 Doppia
BudgetRemainingPercent Percentuale del budget rimanente per l'ordine di inserimento.

Questo valore viene calcolato come BudgetRemaining / SpendCapAmount.

Questo elemento è vuoto se l'ordine di inserimento ha un budget illimitato.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 Doppia
BudgetSpent Saldo rimanente dell'ordine di inserimento.

Il saldo rimanente è inizialmente 0 (zero) e quindi aumenta verso spendCapAmount ogni volta che viene pubblicato un annuncio nell'account.

Questo elemento è vuoto se l'ordine di inserimento ha un budget illimitato.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 Doppia
BudgetSpentPercent Percentuale del budget speso per l'ordine di inserimento.

Questo valore viene calcolato come BudgetSpent / SpendCapAmount.

Questo elemento è vuoto se l'ordine di inserimento ha un budget illimitato.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 Doppia
Comment Descrizione dell'ordine di inserimento. La descrizione è limitata a 100 caratteri.

Aggiungere: Opzionale
Aggiornamento: Opzionale		 Stringa
EndDate Data di scadenza dell'ordine di inserimento. La data di fine deve essere successiva alla data di inizio.

La data viene archiviata in formato UTC (Coordinated Universal Time). Vengono usati solo il mese, il giorno e l'anno della stringa specificata. Se si specificano l'ora, i minuti e i secondi di una data, verranno ignorati.

Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Nota: se l'ordine di inserimento non ha una data di fine, EndDate è vuoto. L'aggiunta o l'aggiornamento di ordini di inserimento illimitati non è supportato. EndDate funziona in modalità di sola lettura.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se si tenta di aggiornare StartDate o EndDate di un ordine di inserimento che fa parte di una serie ricorrente , l'API restituirà un errore.		 Datetime
Id Identificatore generato dal sistema che identifica l'ordine di inserimento.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura e Obbligatorio		 long
IsEndless Determina se l'ordine di inserimento non ha una data di fine.

Se il valore è True, l'ordine di inserimento non avrà una data di fine e l'oggetto EndDate di questo ordine di inserimento verrà ignorato.

Aggiungere: Opzionale
Aggiornamento: Opzionale		 Boolean
IsInSeries Determina se l'ordine di inserimento è in una serie ricorrente.

Se il valore è True, l'ordine di inserimento fa parte di una serie ricorrente. Se si tenta di aggiornare StartDate o EndDate di un ordine di inserimento che fa parte di una serie ricorrente, l'API restituirà un errore. Se si aggiorna lo stato di un ordine di inserimento che fa parte di una serie ricorrente, l'aggiornamento dello stato verrà applicato a tutti gli ordini di inserimento della serie.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 Boolean
IsUnlimited Determina se l'ordine di inserimento ha un budget illimitato.

Se il valore è True, l'ordine di inserimento avrà un budget illimitato e spendCapAmount di questo ordine di inserimento verrà ignorato.

Aggiungere: Opzionale
Aggiornamento: Opzionale		 Boolean
LastModifiedByUserId Identificatore dell'ultimo utente per aggiornare l'ordine di inserimento.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 long
LastModifiedTime Data e ora dell'ultimo aggiornamento dell'ordine di inserimento.

La data viene archiviata in formato UTC (Coordinated Universal Time).

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
Nome Nome descrittivo che può essere usato per fare riferimento a questo ordine di inserimento.

Il nome può contenere un massimo di 100 caratteri.

Il nome non deve essere univoco rispetto ad altri ordini di inserimento per il cliente.

Aggiungere: Opzionale
Aggiornamento: Opzionale		 Stringa
NotificationThreshold Percentuale del budget speso. Specificare la percentuale come valore compreso tra 0 e 100. La notifica viene inviata quando viene raggiunta la soglia. Ad esempio, se si imposta la soglia su 70, il servizio di fatturazione invia una notifica quando è stato speso il 70% del budget.

Se non si vuole ricevere la notifica, impostare su NULL.

Riservato per uso interno.

Aggiungere: Opzionale
Aggiornamento: Opzionale		 Doppia
PendingChanges Può essere usato per gestire le modifiche per un ordine di inserimento approvato con stato impostato su Attivo, Esaurito, Scaduto o NotStarted.

Aggiungere: Sola lettura
Aggiornamento: Opzionale		 InsertionOrderPendingChanges
Purchaseorder Valore dell'ordine di acquisto che può essere usato per fare riferimento a questo ordine di inserimento nelle fatture mensili. Questo valore verrà stampato come ordine di acquisto nelle fatture mensili.

L'ordine di acquisto può contenere un massimo di 50 caratteri.

Aggiungere: Opzionale
Aggiornamento: Opzionale		 Stringa
ReferenceId Riservato solo per uso interno.

Aggiungere: Opzionale
Aggiornamento: Opzionale		 long
SeriesFrequencyType Determina il modo in cui un ordine si ripete nella serie.

I valori possibili sono Monthly, BiMonthly, Quarterly e Yearly.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 Stringa
SeriesName Nome della serie dell'ordine di inserimento ricorrente.

Il nome può contenere un massimo di 100 caratteri.

Anche se l'ordine di inserimento viene rimosso in un secondo momento dalla serie ricorrente, questo elemento continuerà a riflettere il nome della serie in cui è stato creato.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 Stringa
SpendCapAmount Budget per questo ordine di inserimento. Il budget è un limite rigido. Quando l'account raggiunge questo limite e non è disponibile un altro ordine di inserimento, il valore dello stato del ciclo di vita dell'account è impostato su Sospendi.

Questo elemento è vuoto se l'ordine di inserimento ha un budget illimitato. Il budget è la quantità massima di denaro che si desidera spendere per un ordine di inserimento. Per gli ordini di inserimento con budget illimitato, il budget è limitato dal limite di credito. In tal caso, il budget giornaliero di ogni campagna determina la spesa massima.

Nota: l'aggiunta o l'aggiornamento di ordini di inserimento illimitati non è supportato. SpendCapAmount funziona in modalità di sola lettura.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale		 Doppia
StartDate Data in cui l'ordine di inserimento può iniziare ad accumulare addebiti. La data di inizio deve essere successiva alla data corrente.

La data viene archiviata in formato UTC (Coordinated Universal Time). Vengono usati solo il mese, il giorno e l'anno della stringa specificata. Se si specificano l'ora, i minuti e i secondi di una data, verranno ignorati.

Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. È possibile aggiornare la data di inizio solo tramite questo elemento se Lo stato è PendingUserReview. Se la data di inizio è già passata, non è possibile modificarla.

Se si tenta di aggiornare StartDate o EndDate di un ordine di inserimento che fa parte di una serie ricorrente , l'API restituirà un errore.		 Datetime
Stato Stato dell'ordine di inserimento.

Aggiungere: Sola lettura. Gli ordini di inserimento creati vengono impostati immediatamente su Attivo, NonAvviato o Rifiutato.
Aggiornamento: Necessario per approvare o rifiutare un ordine di inserimento non ancora approvato o annullare un ordine di inserimento che è già stato approvato. È possibile approvare o rifiutare solo tramite questo elemento se lo stato corrente è impostato su PendingUserReview. È possibile annullare tramite questo elemento solo se lo stato corrente è impostato su Attivo, Esaurito o NotStarted. Quando lo stato dell'ordine di inserimento è Attivo, Esaurito, Scaduto o NotStarted, è possibile apportare nuove modifiche oppure approvare o rifiutare le modifiche in sospeso correnti tramite l'elemento PendingChanges .

Quando si chiama UpdateInsertionOrder è possibile impostare questo elemento Status o modificare altri elementi di questo oggetto, ma non è possibile modificare lo stato in parallelo con altri aggiornamenti delle proprietà.

Se si aggiorna lo stato di un ordine di inserimento che fa parte di una serie ricorrente, l'aggiornamento dello stato verrà applicato a tutti gli ordini di inserimento della serie.		 InsertionOrderStatus

Requisiti

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

Usato da

AddInsertionOrder
SearchInsertionOrders
UpdateInsertionOrder