Freigeben über

InsertionOrder-Datenobjekt – Kundenabrechnung

  • Artikel

Ein Einfügeauftrag ist ein Vertrag, der den maximalen Betrag festlegt, den Sie für Ihr Konto über einen bestimmten Zeitraum ausgeben. Wenn Sie die monatliche Rechnungsabrechnung für Ihr Konto eingerichtet haben, benötigen Sie einen aktiven Einfügeauftrag, damit Ihre Anzeigen zur Zustellung berechtigt sind. Sie steuern Ihre Ausgaben weiterhin mithilfe Ihres Kampagnenbudgets, und Ihnen wird nur das in Rechnung gestellt, was Ihnen anfällt. Wenn Sie beispielsweise einen einmonatigen Einfügeauftrag für 5.000 USD hatten und während des Abrechnungszeitraums nur 4.500 USD an Gebühren angefallen sind, werden wir nur 4.500 USD vom Budget Ihres Einfügeauftrags abziehen.

Warnung

Das Budget für Einfügungsbestellungen gilt nur für Anzeigenausgaben. Dies ist eine wichtige Unterscheidung, wenn sich Ihr Unternehmen in einem Land/einer Region befindet, in dem Onlinedienste besteuert werden. Wenn Sie ein strenges Budgetlimit haben, müssen Sie möglicherweise Steuern in Ihrem Einfügeauftragsbudget berücksichtigen. Weitere Informationen zu den Steuerlichen Anforderungen an Ihrem Unternehmensstandort finden Sie im Hilfeartikel Steuer- oder Mehrwertsteuerinformationen .

Die meisten Elemente dieses Objekts können nur festgelegt werden, bevor die Einfügereihenfolge genehmigt wird, d. h. wenn status auf PendingUserReview festgelegt ist. In diesem Fall können Sie entweder neue Änderungen vornehmen oder die Einfügereihenfolge über Elemente dieses Objekts genehmigen oder ablehnen. Sobald der Status der Einfügereihenfolge Aktiv, Erschöpft, Abgelaufen oder Nicht Starten lautet, können Sie entweder neue Änderungen vornehmen oder die aktuellen ausstehenden Änderungen über das PendingChanges-Element genehmigen oder ablehnen. Wenn der Status der Einfügereihenfolge abgebrochen oder Abgelehnt lautet, können Sie die Einfügereihenfolge nicht aktualisieren.

Hinweis

Der SearchInsertionOrders-Vorgang gibt bis zu 24 Einfügeaufträge pro Serie zurück.

Sie können eine Einfügereihenfolge über die Bing Ads-API abrufen, aber mit sehr wenigen Ausnahmen nicht hinzufügen oder aktualisieren. Verwenden Sie das IsInSeries-Element , um zu bestimmen, ob sich die Einfügereihenfolge in einer Serie befindet.

  • Wenn Sie versuchen, das StartDate oder EndDate einer Einfügereihenfolge zu aktualisieren, die Teil einer Serie ist, gibt die API einen Fehler zurück.
  • Wenn Sie den Status einer Einfügereihenfolge aktualisieren, die Teil einer Serie ist, wird das status Update auf alle Einfügeaufträge in der Reihe angewendet.

Informationen zum Verwalten von wiederkehrenden Einfügeaufträgen in der Microsoft Advertising-Webanwendung finden Sie im Hilfeartikel Gewusst wie Erstellen und Bearbeiten eines Einfügeauftrags?.

Syntax

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

Elemente

Das InsertionOrder-Objekt verfügt über die folgenden Elemente: AccountId, AccountNumber, BookingCountryCode, BudgetRemainingPercent, BudgetRemainingPercent, BudgetSpent, BudgetSpentPercent, Comment, EndDate, Id, IsEndless, IsInSeries, IsUnlimited, LastModifiedByUserId, LastModifiedTime, Name, NotificationThreshold, PendingChanges, PurchaseOrder, ReferenceId, SeriesFrequencyType, SeriesName, SpendCapAmount, StartDate, Status.

Element Beschreibung Datentyp
Accountid Der Bezeichner des Kontos, für das die Einfügereihenfolge gilt.

Sie können den Kontobezeichner nicht aktualisieren, nachdem Sie die Einfügereihenfolge erstellt haben.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt		 Lange
Accountnumber Die vom System generierte Kontonummer, die zum Identifizieren des Kontos in der Microsoft Advertising-Webanwendung verwendet wird. Die Kontonummer hat das Format xxxxxxxx, wobei xxxxxxxx eine Reihe von acht beliebigen alphanumerischen Zeichen ist.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge
BookingCountryCode Für die interne Verwendung reserviert.

Hinzufügen: Für einige Konten erforderlich; Optional für einige Konten.
Aktualisieren: Schreibgeschützt		 Zeichenfolge
BudgetRemaining Der laufende Saldo der Einfügereihenfolge.

Der Wert des ausgeführten Saldos entspricht anfänglich dem Wert von SpendCapAmount und verringert sich dann jedes Mal, wenn eine Anzeige im Konto geschaltet wird.

Dieses Element ist leer, wenn der Einfügeauftrag über ein unbegrenztes Budget verfügt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Doppel
BudgetRemainingPercent Der Prozentsatz des verbleibenden Budgets für die Einfügereihenfolge.

Dieser Wert wird als BudgetRemaining / SpendCapAmount berechnet.

Dieses Element ist leer, wenn der Einfügeauftrag über ein unbegrenztes Budget verfügt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Doppel
BudgetSpent Der verbleibende Saldo der Einfügereihenfolge.

Der verbleibende Saldo beträgt zunächst 0 (null) und erhöht sich dann in Richtung SpendCapAmount , wenn eine Anzeige im Konto geschaltet wird.

Dieses Element ist leer, wenn der Einfügeauftrag über ein unbegrenztes Budget verfügt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Doppel
BudgetSpentPercent Der Prozentsatz des Budgets, das für den Einfügeauftrag aufgewendet wurde.

Dieser Wert wird als BudgetSpent / SpendCapAmount berechnet.

Dieses Element ist leer, wenn der Einfügeauftrag über ein unbegrenztes Budget verfügt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Doppel
Kommentar Eine Beschreibung der Einfügereihenfolge. Die Beschreibung ist auf 100 Zeichen beschränkt.

Hinzufügen: Optional
Aktualisieren: Optional		 Zeichenfolge
EndDate Das Datum, an dem die Einfügereihenfolge abläuft. Das Enddatum muss nach dem Startdatum sein.

Das Datum wird in koordinierter Weltzeit (UTC) gespeichert. Es werden nur der Monat, der Tag und das Jahr der angegebenen Zeichenfolge verwendet. Wenn Sie die Stunde, Minuten und Sekunden eines Datums angeben, werden diese ignoriert.

Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Hinweis: Wenn die Einfügereihenfolge kein Enddatum aufweist, ist EndDate leer. Das Hinzufügen oder Aktualisieren von unbegrenzten Einfügeaufträgen wird nicht unterstützt. EndDate arbeitet im schreibgeschützten Modus.

Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn Sie versuchen, das StartDate oder EndDate einer Einfügereihenfolge zu aktualisieren, die Teil einer Serie ist , gibt die API einen Fehler zurück.		 dateTime
Id Ein vom System generierter Bezeichner, der die Einfügereihenfolge identifiziert.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt und erforderlich		 Lange
IsEndless Bestimmt, ob die Einfügereihenfolge kein Enddatum aufweist.

Wenn der Wert True ist, hat die Einfügereihenfolge kein Enddatum, und das EndDate dieser Einfügereihenfolge wird ignoriert.

Hinzufügen: Optional
Aktualisieren: Optional		 boolean
IsInSeries Bestimmt, ob sich die Einfügereihenfolge in einer Serie befindet.

Wenn der Wert True ist, ist die Einfügereihenfolge Teil einer Serie. Wenn Sie versuchen, das StartDate oder EndDate einer Einfügereihenfolge zu aktualisieren, die Teil einer Serie ist, gibt die API einen Fehler zurück. Wenn Sie den Status einer Einfügereihenfolge aktualisieren, die Teil einer Serie ist, wird das status Update auf alle Einfügeaufträge in der Reihe angewendet.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 boolean
IsUnlimited Bestimmt, ob der Einfügeauftrag über ein unbegrenztes Budget verfügt.

Wenn der Wert True ist, verfügt der Einfügeauftrag über ein unbegrenztes Budget, und der SpendCapAmount dieser Einfügereihenfolge wird ignoriert.

Hinzufügen: Optional
Aktualisieren: Optional		 boolean
LastModifiedByUserId Ein Bezeichner des letzten Benutzers, der die Einfügereihenfolge aktualisiert hat.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Lange
LastModifiedTime Datum und Uhrzeit der letzten Aktualisierung der Einfügereihenfolge.

Das Datum wird in koordinierter Weltzeit (UTC) gespeichert.

Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 dateTime
Name Der Anzeigename, der verwendet werden kann, um auf diese Einfügereihenfolge zu verweisen.

Der Name darf maximal 100 Zeichen enthalten.

Der Name muss im Vergleich zu anderen Einfügeaufträgen für den Kunden nicht eindeutig sein.

Hinzufügen: Optional
Aktualisieren: Optional		 Zeichenfolge
NotificationThreshold Ein Prozentsatz des ausgegebenen Budgets. Geben Sie den Prozentsatz als Wert zwischen 0 und 100 an. Die Benachrichtigung wird gesendet, wenn der Schwellenwert erreicht wird. Wenn Sie beispielsweise den Schwellenwert auf 70 festlegen, sendet der Abrechnungsdienst eine Benachrichtigung, wenn Sie 70 Prozent des Budgets ausgegeben haben.

Wenn Sie keine Benachrichtigung erhalten möchten, legen Sie auf NULL fest.

Für die interne Verwendung reserviert.

Hinzufügen: Optional
Aktualisieren: Optional		 Doppel
PendingChanges Kann verwendet werden, um Änderungen für eine genehmigte Einfügereihenfolge zu verwalten, wobei status entweder auf Aktiv, Erschöpft, Abgelaufen oder NichtStarted festgelegt ist.

Hinzufügen: Schreibgeschützt
Aktualisieren: Optional		 InsertionOrderPendingChanges
Purchaseorder Ein Bestellwert, der verwendet werden kann, um auf diesen Einfügeauftrag in monatlichen Rechnungen zu verweisen. Dieser Wert wird als Bestellung in den monatlichen Rechnungen ausgegeben.

Die Bestellung darf maximal 50 Zeichen enthalten.

Hinzufügen: Optional
Aktualisieren: Optional		 Zeichenfolge
ReferenceId Nur für die interne Verwendung reserviert.

Hinzufügen: Optional
Aktualisieren: Optional		 Lange
SeriesFrequencyType Bestimmt, wie eine Reihenfolge in der Reihe rekursiert wird.

Die möglichen Werte sind Monthly, BiMonthly, Quarterly und Yearly.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge
SeriesName Der Name der Serienreihenfolge für die Einfügereihenfolge.

Der Name darf maximal 100 Zeichen enthalten.

Auch wenn die Einfügereihenfolge später aus der Serie entfernt wird, spiegelt dieses Element weiterhin den Namen der Reihe wider, in der es erstellt wurde.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge
SpendCapAmount Das Budget für diese Einfügereihenfolge. Das Budget ist eine harte Grenze. Wenn das Konto diesen Grenzwert erreicht und keine weitere Einfügereihenfolge verfügbar ist, wird der Lebenszyklus status Wert des Kontos auf Anhalten festgelegt.

Dieses Element ist leer, wenn der Einfügeauftrag über ein unbegrenztes Budget verfügt. Das Budget ist der maximale Geldbetrag, den Sie für einen Einfügeauftrag ausgeben möchten. Bei Einfügeaufträgen mit unbegrenztem Budget ist Ihr Budget durch Ihr Kreditlimit begrenzt. In diesem Fall bestimmt das Tagesbudget jeder Kampagne die maximalen Ausgaben.

Hinweis: Das Hinzufügen oder Aktualisieren von unbegrenzten Einfügeaufträgen wird nicht unterstützt. SpendCapAmount arbeitet im schreibgeschützten Modus.

Hinzufügen: Erforderlich
Aktualisieren: Optional		 Doppel
StartDate Das Datum, an dem der Einfügeauftrag mit dem Anrechnen von Gebühren beginnen kann. Das Startdatum muss nach dem aktuellen Datum sein.

Das Datum wird in koordinierter Weltzeit (UTC) gespeichert. Es werden nur der Monat, der Tag und das Jahr der angegebenen Zeichenfolge verwendet. Wenn Sie die Stunde, Minuten und Sekunden eines Datums angeben, werden diese ignoriert.

Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Hinzufügen: Erforderlich
Aktualisieren: Optional. Sie können das Startdatum nur über dieses Element aktualisieren, wenn der Status PendingUserReview lautet. Wenn das Startdatum bereits abgelaufen ist, können Sie ihn nicht ändern.

Wenn Sie versuchen, das StartDate oder EndDate einer Einfügereihenfolge zu aktualisieren, die Teil einer Serie ist , gibt die API einen Fehler zurück.		 dateTime
Status Die status der Einfügereihenfolge.

Hinzufügen: Schreibgeschützt. Von Ihnen erstellte Einfügeaufträge werden sofort auf Aktiv, Nicht Gestartet oder Abgelehnt festgelegt.
Aktualisieren: Erforderlich, um einen noch nicht genehmigten Einfügeauftrag zu genehmigen oder abzulehnen oder einen bereits genehmigten Einfügeauftrag zu stornieren. Sie können über dieses Element nur genehmigen oder ablehnen, wenn die aktuelle status auf PendingUserReview festgelegt ist. Sie können nur über dieses Element abbrechen, wenn die aktuelle status auf Aktiv, Erschöpft oder NotStarted festgelegt ist. Sobald die Einfügereihenfolge status Aktiv, Erschöpft, Abgelaufen oder NichtStarted lautet, können Sie entweder neue Änderungen vornehmen oder die aktuellen ausstehenden Änderungen über das PendingChanges-Element genehmigen oder ablehnen.

Wenn Sie UpdateInsertionOrder aufrufen, können Sie entweder dieses Status-Element festlegen oder andere Elemente dieses Objekts ändern, aber Sie können die status nicht parallel zu anderen Eigenschaftenaktualisierungen ändern.

Wenn Sie den Status einer Einfügereihenfolge aktualisieren, die Teil einer Serie ist, wird das status Update auf alle Einfügeaufträge in der Reihe angewendet.		 InsertionOrderStatus

Anforderungen

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

Verwendet von

AddInsertionOrder
SearchInsertionOrders
UpdateInsertionOrder