Freigeben über

OfflineConversionAdjustment-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert ein Objekt, um eine Offlinekonvertierung über den ApplyOfflineConversionAdjustments-Vorgang zurückzuziehen oder neu zu erstellen.

Sie können die Konvertierungszeit und den Wert für Offlinekonvertierungen anpassen, die zuvor über den ApplyOfflineConversions-Vorgang angewendet wurden.

<xs:complexType name="OfflineConversionAdjustment" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdjustmentCurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="AdjustmentTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="AdjustmentType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="AdjustmentValue" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ConversionName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="HashedEmailAddress" 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:element minOccurs="0" name="HashedPhoneNumber" 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:element minOccurs="0" name="MicrosoftClickId" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elemente

Das OfflineConversionAdjustment-Objekt verfügt über die folgenden Elemente: AdjustmentCurrencyCode, AdjustmentTime, AdjustmentType, AdjustmentValue, ConversionName, ConversionTime, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

Element Beschreibung Datentyp
AdjustmentCurrencyCode Der Währungscode für die neu dargestellte Offlineumrechnung.

Weitere Informationen finden Sie unter Währungen.

Anwenden: Erforderlich, wenn AdjustmentType auf "Restate" festgelegt ist, andernfalls wird dieses Feld ignoriert. Wenn Sie keinen Anpassungswährungscode mit der Neubewertung angeben, wird das CurrencyCode-Element des ConversionGoalRevenue-Elements des Ziels verwendet.		 Zeichenfolge
AdjustmentTime Das Datum und die Uhrzeit der Anpassung.

Die Anpassungszeit darf nicht vor dem ursprünglichen Offlinekonvertierungsdatum und der ursprünglichen Uhrzeit der Offlinekonvertierung sein.

Wichtig: Der Wert muss in koordinierter Weltzeit (UTC) vorliegen. Dies unterscheidet sich von den Zeitzonenoptionen beim Hochladen von Offlinekonvertierungen in der Microsoft Advertising-Webanwendung. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Anwenden: Erforderlich		 dateTime
AdjustmentType Bestimmt, ob die Offlinekonvertierung zurückgezogen oder neu festgelegt werden soll.

Wenn dieser Wert "Restate" lautet, wird die Offlinekonvertierung, die zuvor der angegebenen MicrosoftClickId zugeordnet wurde, entsprechend dem neuen AdjustmentCurrencyCode, AdjustmentTime und AdjustmentValue angepasst.

Wenn dieser Wert "Retract" lautet, wird die zuvor der angegebenen MicrosoftClickId zugeordnete Offlinekonvertierung zurückgezogen oder gelöscht.

Anwenden: Erforderlich		 Zeichenfolge
AdjustmentValue Der angepasste Offlinekonvertierungswert.

Anwenden: Erforderlich, wenn AdjustmentType auf "Restate" festgelegt ist, andernfalls sollte dieses Feld nicht festgelegt werden.		 doppelt
ConversionName Der Name des Konvertierungsziels.

Dieser Name muss mit einem vorhandenen Konvertierungszielnamen übereinstimmen, andernfalls werden die Offlinekonvertierungszieldaten nicht angewendet.

Anwenden: Erforderlich		 Zeichenfolge
ConversionTime Das Datum und die Uhrzeit der ursprünglichen Offlinekonvertierung.

Datum und Uhrzeit müssen innerhalb der letzten 90 Tage sein. Andernfalls schlägt der Vorgang fehl, wenn Sie versuchen, Microsoft Advertising die Offlinekonvertierungsdaten zu senden.

Um von Microsoft Advertising nach erfolgreichem Upload als Offlinekonvertierung gezählt zu werden, müssen die folgenden zusätzlichen Anforderungen erfüllt sein:
- Das Datum und die Uhrzeit der Konvertierung müssen später als das Datum und die Uhrzeit des aufgezeichneten Klicks festgelegt werden.
– Das Datum und die Uhrzeit müssen sich innerhalb des Konvertierungsfensters befindet. Die ConversionWindowInMinutes-Eigenschaft von OfflineConversionGoal bestimmt die maximale Zeitspanne in Minuten nach einem Klick, die Konvertierungen nachverfolgt werden.

Wenn beispielsweise am 30. April drei Klicks aufgezeichnet wurden, wenn conversionWindowInMinutes des OfflineConversionGoal gleich 30 Tage (43200 Minuten) ist und Sie Microsoft Advertising die folgenden Offlinekonvertierungen am 31. Juli senden, zählt Microsoft Advertising nur die mit MicrosoftClickId=2 als Offlinekonvertierung.
– MicrosoftClickId=1; ConversionTime=2020-04-30T17:02:35.6853793Z
– MicrosoftClickId=2; ConversionTime=2020-05-15T17:02:35.6853793Z
– MicrosoftClickId=3; ConversionTime=2020-06-15T17:02:35.6853793Z

Die Offlinekonvertierungsdaten mit MicrosoftClickId=1 werden nicht hochgeladen, da Datum und Uhrzeit der Konvertierung mehr als 90 Tage zurückliegt, und die Offlinekonvertierungsdaten mit MicrosoftClickId=3 werden nicht gezählt, da sie nicht in das Konvertierungsfenster fallen (30. April bis 29. Mai).

Wichtig: Der Wert muss in koordinierter Weltzeit (UTC) vorliegen. Dies unterscheidet sich von den Zeitzonenoptionen beim Hochladen von Offlinekonvertierungen in der Microsoft Advertising-Webanwendung. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Anwenden: Erforderlich		 dateTime
HashedEmailAddress Die gehashte E-Mail-Adresse, die den SHA-256-Algorithmus für die Verwendung mit erweiterten Konvertierungen verwendet. Zeichenfolge
HashedPhoneNumber Die gehashte Telefonnummer nach dem E.164-Standard für die Verwendung mit erweiterten Konvertierungen. Zeichenfolge
MicrosoftClickId Die MSCLKID für die Offlinekonvertierung.

Verwenden Sie die Vorgänge GetAccountProperties und SetAccountProperties , um sicherzustellen, dass die automatische Kennzeichnung für die Microsoft-Klick-ID-Nachverfolgung aktiviert ist.

Anwenden: Wahlfrei

Hinweis: Die MSCLKID ist optional, wenn Sie eine Hash-E-Mail-Adresse oder Telefonnummer für erweiterte Konvertierungen angeben.		 Zeichenfolge

Anforderungen

Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Verwendet von

ApplyOfflineConversionAdjustments