Freigeben über

Offlinekonvertierungsdatensatz – Massenvorgang

  • Artikel

Definiert eine Offlinekonvertierung, die in eine Massendatei hochgeladen werden kann.

Hinweis

Massendownloads werden nicht unterstützt.

Sie können Offlinekonvertierungen hinzufügen, neu erstellen (aktualisieren) oder wiederherstellen (löschen).

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 fünf Stunden dauern, bis Konvertierungsdaten in der Microsoft Advertising-Berichterstellung angezeigt werden.

Sie müssen OfflineConversionGoal über die Kampagnenverwaltungs-API erstellen, um die IsExternallyAttributed-Eigenschaft festzulegen.

Als bewährte Methode sollten Sie nach einem Anzeigenklick eine Stunde warten, bevor Sie Offlinekonvertierungen hochladen.

Hinweis

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

Im folgenden Beispiel für Massen-CSV wird eine neue Offlinekonvertierung hinzugefügt.

Type,Status,Id,Parent Id,Client Id,Name,Conversion Currency Code,Conversion Name,Conversion Time,Conversion Value,Microsoft Click Id
Format Version,,,,,6.0,,,,,
Offline Conversion,,,,ClientIdGoesHere,,USD,My Goal Name,4/1/2020 6:50:54 PM,10,f894f652ea334e739002f7167ab8f8e3

Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie den BulkServiceManager zum Hochladen des BulkOfflineConversion-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zu schreiben, um jedes Feld in der Massendatei zu analysieren.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkOfflineConversion
var bulkOfflineConversion = new BulkOfflineConversion
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    OfflineConversion = new OfflineConversion
    {
        // 'Conversion Currency Code' column header in the Bulk file
        ConversionCurrencyCode = "USD",
        // 'Conversion Name' column header in the Bulk file
        ConversionName = "My Goal Name",
        // 'Conversion Time' column header in the Bulk file
        ConversionTime = DateTime.UtcNow,
        // 'Conversion Value' column header in the Bulk file
        ConversionValue = 10,
        // 'Microsoft Click Id' column header in the Bulk file
        MicrosoftClickId = "f894f652ea334e739002f7167ab8f8e3"
    },

    // 'Adjustment Currency Code' column header in the Bulk file
    AdjustmentCurrencyCode = null,

    // 'Adjustment Time' column header in the Bulk file
    AdjustmentTime = null,

    // 'Adjustment Type' column header in the Bulk file
    AdjustmentType = null,

    // 'Adjustment Value' column header in the Bulk file
    AdjustmentValue = null,

    // 'External Attribution Credit' column header in the Bulk file
    ExternalAttributionCredit = null,

    // 'External Attribution Model' column header in the Bulk file
    ExternalAttributionModel = null,

    // 'Hashed Email Address' column header in the Bulk file
    HashedEmailAddress = null,

    // 'Hashed Phone Number' column header in the Bulk file
    HashedPhoneNumber = null
};

uploadEntities.Add(bulkOfflineConversion);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Für einen Offlinekonvertierungsdatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.

Währungscode der Anpassung

Der Währungscode für die neu dargestellte Offlineumrechnung.

Weitere Informationen finden Sie unter Währungen.

Hinzufügen: Nicht zutreffend
Restate: Erforderlich. Wenn Sie keinen Anpassungswährungscode mit der Neubewertung angeben, wird das CurrencyCode-Element des ConversionGoalRevenue-Elements des Ziels verwendet.
Zurückziehen: Nicht zutreffend

Anpassungszeit

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.

Hinzufügen: Nicht zutreffend
Restate: Erforderlich
Zurückziehen: Erforderlich

Anpassungstyp

Bestimmt, ob die Offlinekonvertierung zurückgezogen oder neu festgelegt werden soll.

Wenn dieser Wert "Restate" lautet, wird die offline umgerechnete Konvertierung, die zuvor der angegebenen Microsoft Click ID zugeordnet wurde, entsprechend dem neuen Anpassungswährungscode, der Anpassungszeit und dem neuen Anpassungswert angepasst.

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

Hinzufügen: Nicht zutreffend
Restate: Erforderlich. Dieses Feld muss auf "Restate" festgelegt werden.
Zurückziehen: Erforderlich. Dieses Feld muss auf "Zurückziehen" festgelegt werden.

Anpassungswert

Der angepasste Offlinekonvertierungswert.

Hinzufügen: Nicht zutreffend
Restate: Erforderlich
Zurückziehen: Nicht zutreffend

Client-ID

Wird verwendet, um Datensätze in der Massenuploaddatei datensätzen in der Ergebnisdatei zuzuordnen. Der Wert dieses Felds wird vom Server nicht verwendet oder gespeichert. es wird einfach aus dem hochgeladenen Datensatz in den entsprechenden Ergebnisdatensatz kopiert. Es kann eine beliebige gültige Zeichenfolge sein, die eine Länge von bis zu 100 hat.

Hinzufügen: Optional
Restate: Optional
Zurückziehen: Optional

Währungsumrechnungscode

Der Währungscode für die Offlineumrechnung.

Weitere Informationen finden Sie unter Währungen.

Hinzufügen: Optional. Wenn Sie keinen Offlineumrechnungswährungscode angeben, wird das CurrencyCode-Element des ConversionGoalRevenue-Elements des Ziels verwendet.
Restate: Nicht zutreffend
Zurückziehen: Nicht zutreffend

Konvertierungsname

Der Name des Konvertierungsziels.

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

Hinzufügen: Erforderlich
Restate: Erforderlich
Zurückziehen: Erforderlich

Konvertierungszeit

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.

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.

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.
  • Datum und Uhrzeit müssen innerhalb des Konvertierungsfensters sein. 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).

Hinzufügen: Erforderlich
Restate: Erforderlich
Zurückziehen: Erforderlich

Konvertierungswert

Der Offlinekonvertierungswert.

Hinzufügen: Optional. Wenn Sie keinen Offlinekonvertierungswert angeben, wird das Value-Element des ConversionGoalRevenue-Elements des Ziels verwendet.
Restate: Nicht zutreffend
Zurückziehen: Nicht zutreffend

Externe Zuordnungsgutschrift

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

Externes Zuordnungsmodell

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

Hashed Email Address

Die gehashte E-Mail-Adresse, die den SHA-256-Algorithmus für die Verwendung mit erweiterten Konvertierungen verwendet.

Hinzufügen: Erforderlich für erweiterte Konvertierungen.
Restate: Erforderlich für erweiterte Konvertierungen.
Zurückziehen: Erforderlich für erweiterte Konvertierungen.

Telefonnummer mit Hash

Die gehashte Telefonnummer nach dem E.164-Standard für die Verwendung mit erweiterten Konvertierungen.

Hinzufügen: Erforderlich für erweiterte Konvertierungen.
Restate: Erforderlich für erweiterte Konvertierungen.
Zurückziehen: Erforderlich für erweiterte Konvertierungen.

Microsoft Click Id

Die MSCLKID für die Offlinekonvertierung.

Verwenden Sie das Feld MSCLKID Auto Tagging aktiviert im Kontodatensatz , um sicherzustellen, dass die automatische Kennzeichnung für die Microsoft-Klick-ID-Nachverfolgung aktiviert ist.

Hinzufügen: Erforderlich
Restate: Erforderlich
Zurückziehen: Erforderlich