Oggetto dati OfflineConversion - Campaign Management

  • Articolo

Definisce una conversione offline inviata a Microsoft Advertising.

Per configurare il rilevamento delle conversioni offline, creare un oggetto OfflineConversionGoal. Se si imposta CountType di OfflineConversionGoal su All, tutte le conversioni offline per lo stesso MicrosoftClickId con tempi di conversione diversi verranno aggiunte cumulativamente. Se imposti CountType di OfflineConversionGoal su Unique, verrà conteggiata solo la prima conversione che si verifica dopo un clic pubblicitario. Le conversioni offline duplicate con gli stessi MicrosoftClickId e ConversionTime verranno ignorate. In altre parole, verrà conteggiata solo la prima conversione offline per un determinato MicrosoftClickId e ConversionTime .

Importante

Dopo aver configurato OfflineConversionGoal , attendere due ore e quindi inviare i dati OfflineConversion di Microsoft Advertising tramite l'operazione ApplyOfflineConversions . La visualizzazione dei dati di conversione nei report di Microsoft Advertising può richiedere fino a sei ore.

Nota

Anche se è possibile caricare conversioni offline nella sandbox per il test funzionale, i dati di conversione offline non verranno attribuiti nei dati di report sulle prestazioni della sandbox.

Sintassi

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

Elementi

L'oggetto OfflineConversion include gli elementi seguenti: ConversionCurrencyCode, ConversionName, ConversionTime, ConversionValue, ExternalAttributionCredit, ExternalAttributionModel, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

Elemento Descrizione Tipo di dati
ConversionCurrencyCode Codice di valuta per la conversione offline.

Per altre informazioni, vedere Valute.

Applicare: Opzionale. Se non si specifica un codice di valuta di conversione offline, viene usato l'elemento CurrencyCode dell'obiettivo ConversionGoalRevenue .		 Stringa
ConversionName Nome dell'obiettivo di conversione.

Questo nome deve corrispondere a un nome di obiettivo di conversione esistente, altrimenti i dati dell'obiettivo di conversione offline non verranno applicati.

Applicare: Obbligatorio		 Stringa
ConversionTime Data e ora in cui si è verificata la conversione offline.

La data e l'ora devono essere entro gli ultimi 90 giorni, altrimenti l'operazione avrà esito negativo quando si tenta di inviare a Microsoft Advertising i dati di conversione offline.

Per essere conteggiata da Microsoft Advertising come conversione offline dopo aver completato il caricamento, è necessario soddisfare i requisiti aggiuntivi seguenti:
- La data e l'ora della conversione devono essere impostate in un secondo momento rispetto alla data e all'ora del clic registrato.
- La data e l'ora devono essere all'interno della finestra di conversione. La proprietà ConversionWindowInMinutes di OfflineConversionGoal determina la durata massima in minuti dopo un clic in cui verranno rilevate le conversioni.

Ad esempio, se il 30 aprile sono stati registrati tre clic, se conversionWindowInMinutes di OfflineConversionGoal è uguale a 30 giorni (43200 minuti) e se si inviano a Microsoft Advertising le conversioni offline seguenti il 31 luglio, Microsoft Advertising conterà solo quella con MicrosoftClickId=2 come conversione offline.
- 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

I dati di conversione offline con MicrosoftClickId=1 non verranno caricati perché la data e l'ora di conversione sono più di 90 giorni fa e i dati di conversione offline con MicrosoftClickId=3 non verranno conteggiati perché non rientrano nella finestra di conversione (dal 30 aprile al 29 maggio).

Importante: Il valore deve essere in formato UTC (Coordinated Universal Time). Ciò differisce dalle opzioni del fuso orario quando si caricano conversioni offline nell'applicazione Web Microsoft Advertising. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Applicare: Obbligatorio		 Datetime
ConversionValue Valore di conversione offline.

Applicare: Opzionale. Se non si specifica un valore di conversione offline, viene usato l'elemento Value dell'oggetto ConversionGoalRevenue dell'obiettivo.		 Doppia
ExternalAttributionCredit Questo campo può essere impostato solo per le azioni di conversione che usano l'attribuzione esterna. Rappresenta la frazione della conversione attribuita a ogni clic. Il valore deve essere maggiore di 0 e minore o uguale a 1.

Verrà restituito un errore GoalNotEligibleForExternalAttribution se questo campo viene usato con un'azione di conversione con attributi non esterni.

Applicare: Opzionale		 Doppia
ExternalAttributionModel Questo campo può essere impostato solo per le azioni di conversione che usano l'attribuzione esterna. Specifica il nome del modello di attribuzione.

Verrà restituito un errore GoalNotEligibleForExternalAttribution se questo campo viene usato con un'azione di conversione con attributi non esterni.

Applicare: Opzionale		 Stringa
HashedEmailAddress Indirizzo di posta elettronica con hash che usa l'algoritmo SHA-256 per l'uso con conversioni avanzate. Stringa
HashedPhoneNumber Numero di telefono hash in base allo standard E.164 per l'uso con conversioni avanzate. Stringa
MicrosoftClickId MSCLKID per la conversione offline.

Per assicurarsi che l'assegnazione automatica di tag sia abilitata per il rilevamento degli ID, usare le operazioni GetAccountProperties e SetAccountProperties .

Applicare: Opzionale

Nota: MSCLKID è facoltativo quando si specifica un indirizzo di posta elettronica con hash o un numero di telefono per conversioni avanzate.		 Stringa

Requisiti

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

Usato da

ApplyOfflineConversions