Freigeben über

OfflineConversion-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine Offlinekonvertierung, die Sie an Microsoft Advertising senden.

Um die Offlinekonvertierungsnachverfolgung einzurichten, erstellen Sie offlineConversionGoal. Wenn Sie countType von OfflineConversionGoal auf Alle festlegen, werden alle Offlinekonvertierungen für dieselbe MicrosoftClickId mit unterschiedlichen Konvertierungszeiten kumulativ hinzugefügt. Wenn Sie den CountType von OfflineConversionGoal auf Unique festlegen, wird nur die erste Konvertierung gezählt, die nach einem Anzeigenklick erfolgt. Doppelte Offlinekonvertierungen mit derselben MicrosoftClickId und ConversionTime werden ignoriert. Anders ausgedrückt: Nur die erste Offlinekonvertierung für eine bestimmte MicrosoftClickId und ConversionTime wird gezählt.

Wichtig

Nachdem OfflineConversionGoal eingerichtet wurde, warten Sie zwei Stunden, und senden Sie dann Microsoft Advertising die OfflineConversion-Daten über den ApplyOfflineConversions-Vorgang . Es kann bis zu sechs Stunden dauern, bis Konvertierungsdaten in der Microsoft Advertising-Berichterstellung angezeigt werden.

Hinweis

Obwohl Sie Offlinekonvertierungen in der Sandbox für Funktionstests hochladen können, werden die Offlinekonvertierungsdaten nicht in Sandbox-Leistungsberichtsdaten zugeordnet.

<xs:complexType name="OfflineConversion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ConversionCurrencyCode" nillable="true" type="xs:string" />
    <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="ConversionValue" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionCredit" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionModel" nillable="true" type="xs:string" />
    <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 OfflineConversion-Objekt verfügt über die folgenden Elemente: ConversionCurrencyCode, ConversionName, ConversionTime, ConversionValue, ExternalAttributionCredit, ExternalAttributionModel, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

Element Beschreibung Datentyp
ConversionCurrencyCode Der Währungscode für die Offlineumrechnung.

Weitere Informationen finden Sie unter Währungen.

Anwenden: Wahlfrei. Wenn Sie keinen Offlineumrechnungswährungscode angeben, wird das CurrencyCode-Element des ConversionGoalRevenue-Elements des Ziels verwendet.		 Zeichenfolge
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 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
ConversionValue Der Offlinekonvertierungswert.

Anwenden: Wahlfrei. Wenn Sie keinen Offlinekonvertierungswert angeben, wird das Value-Element des ConversionGoalRevenue-Elements des Ziels verwendet.		 doppelt
ExternalAttributionCredit Dieses Feld kann nur für Konvertierungsaktionen festgelegt werden, die eine externe Zuordnung verwenden. Er stellt den Anteil der Konvertierung dar, der jedem Klick zugeordnet wird. Sein Wert muss größer als 0 und kleiner oder gleich 1 sein.

Ein GoalNotEligibleForExternalAttribution-Fehler wird zurückgegeben, wenn dieses Feld mit einer nicht extern attributierten Konvertierungsaktion verwendet wird.

Anwenden: Wahlfrei		 doppelt
ExternalAttributionModel Dieses Feld kann nur für Konvertierungsaktionen festgelegt werden, die eine externe Zuordnung verwenden. Es gibt den Namen des Zuordnungsmodells an.

Ein GoalNotEligibleForExternalAttribution-Fehler wird zurückgegeben, wenn dieses Feld mit einer nicht extern attributierten Konvertierungsaktion verwendet wird.

Anwenden: Wahlfrei		 Zeichenfolge
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

ApplyOfflineConversions