Oggetto dati ConversionGoal - Campaign Management

Articolo
12/21/2023

Definisce l'oggetto di base di un obiettivo di conversione.

Non provare a creare un'istanza di ConversionGoal. È possibile creare uno o più degli oggetti seguenti che ne derivano.

Sintassi

<xs:complexType name="ConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AttributionModelType" nillable="true" type="tns:AttributionModelType">
      <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="ConversionWindowInMinutes" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="CountType" nillable="true" type="tns:ConversionGoalCountType" />
    <xs:element minOccurs="0" name="ExcludeFromBidding" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="GoalCategory" nillable="true" type="tns:ConversionGoalCategory">
      <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="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsEnhancedConversionsEnabled" 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="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Revenue" nillable="true" type="tns:ConversionGoalRevenue" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ConversionGoalStatus" />
    <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:ConversionGoalTrackingStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalType" />
    <xs:element minOccurs="0" name="ViewThroughConversionWindowInMinutes" nillable="true" type="xs:int">
      <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>

Elementi

L'oggetto ConversionGoal include gli elementi seguenti: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes.

Elemento	Descrizione	Tipo di dati
AttributionModelType	Determina quale modello di attribuzione, LastTouch o LastClick, viene usato con un obiettivo di conversione. Questo elemento non viene restituito per impostazione predefinita. Per ottenere questo elemento, includere il valore AttributionModelType nell'elemento ReturnAdditionalFields quando si chiamano le operazioni del servizio GetConversionGoalsByIds e GetConversionGoalsByTagIds . Questo elemento non è applicabile per AppInstallGoal, InStoreTransactionGoal e OfflineConversionGoal.	AttributionModelType
ConversionWindowInMinutes	La finestra di conversione indica l'intervallo di tempo in minuti dopo un clic che si desidera tenere traccia delle conversioni. Se si imposta questo valore su 43200 minuti (30 giorni), le conversioni che si verificano entro 30 giorni dopo il rilevamento di un clic. Le conversioni precedenti non sono interessate. Il valore minimo supportato è 1 minuto, anche se tenere presente che una finestra di conversione più breve ridurrà il numero di conversioni dei record dell'account. Il valore massimo supportato è 129600 minuti (90 giorni).	int
CountType	Ciò determina la modalità di registrazione delle conversioni all'interno della finestra di conversione scelta. Sono disponibili due opzioni e, se non si imposta un valore, il valore predefinito è All: - Tutto: tutte le conversioni che si verificano dopo un clic pubblicitario verranno conteggiate. Si tratta di una scelta comune per le vendite. - Univoco: verrà conteggiata una sola conversione che si verifica dopo un clic pubblicitario. Si tratta di una scelta comune per i lead. Ad esempio: si tengono traccia di due conversioni: lead e vendite. Si seleziona Univoco per i lead e Tutto per le vendite. Quando un clic pubblicitario si trasforma in due lead e due vendite, viene conteggiato come tre conversioni: una per il lead univoco e due per tutte le vendite. Questo elemento non è applicabile per AppInstallGoal.	ConversionGoalCountType
ExcludeFromBidding	Determina se escludere o meno i dati altrimenti correlati a questo obiettivo di conversione da un subset di colonne del report sulle prestazioni. Questo elemento è disponibile solo per i clienti abilitati per la funzionalità Includi nelle conversioni (GetCustomerPilotFeatures restituisce 574). Se questo elemento è impostato su true, i dati altrimenti correlati a questo obiettivo di conversione verranno esclusi dalle `Conversions`colonne del report , `ConversionRate`, `CostPerConversion`, `ReturnOnAdSpend`, `RevenuePerConversion`e `Revenue` . Inoltre, se si usa una strategia di offerta di offerta automatizzata, l'impostazione di questa proprietà true comporterà che le conversioni dell'obiettivo non vengano più incluse nei calcoli delle offerte automatizzate. L'impostazione di questa proprietà "true" equivale a deselezionare "Includi nelle conversioni" nell'applicazione Web Microsoft Advertising. Indipendentemente da questo valore dell'elemento, le `AllConversions`colonne del report , `AllConversionRate`, `AllCostPerConversion`, `AllReturnOnAdSpend`, `AllRevenuePerConversion`e `AllRevenue` includeranno i dati per tutti gli obiettivi di conversione. Per impostazione predefinita, questo elemento è false e i dati correlati a questo obiettivo di conversione sono inclusi in tutte le colonne del report. Per altre informazioni, vedere Attributi del report e statistiche sulle prestazioni e l'articolo Obiettivi di conversione: "Conversioni" rispetto a "Tutte le conversioni".	Boolean
GoalCategory	Categoria usata per segmentare l'obiettivo di conversione. Categorizzare gli obiettivi di conversione, tuttavia, ha senso per l'azienda. Le categorie di obiettivi non influiscono sulle prestazioni: sono qui per aiutarti a segmentare gli obiettivi e le metriche delle prestazioni. I valori di categoria supportati variano in base al tipo di obiettivo di conversione, quindi fare riferimento alla pagina di riferimento corrispondente per informazioni dettagliate sui requisiti.	ConversionGoalCategory
Id	Identificatore univoco di Microsoft Advertising per l'obiettivo di conversione.	long
IsEnhancedConversionsEnabled	Determina se le conversioni avanzate sono abilitate per un obiettivo di conversione. Nota: per creare un obiettivo di conversione avanzato e impostare `isEnhancedConversionsEnabled=true`, è necessario creare un obiettivo di conversione per l'account tramite l'interfaccia utente di Microsoft Advertising con l'impostazione di conversione avanzata selezionata e la casella di controllo associata selezionata.	Boolean
Nome	Nome dell'obiettivo di conversione. La lunghezza massima del nome è 100 e il nome deve essere univoco tra tutti gli obiettivi di conversione appartenenti allo stesso cliente.	Stringa
Entrate	Determina il valore di ogni conversione per l'azienda. Quando si aggiunge un obiettivo di conversione se non si specificano preferenze di rilevamento dei ricavi, ogni ConversionGoalRevenue verrà impostato sul rispettivo valore predefinito. Quando si aggiorna un obiettivo di conversione, se l'elemento Revenue è nil o vuoto, nessuna delle proprietà annidate verrà aggiornata. Tuttavia, se questo elemento non è nil o vuoto, si stanno sostituendo in modo efficace eventuali proprietà di ricavi esistenti. L'opzione VariableValue non è disponibile per AppInstallGoal, DurationGoal o PagesViewedPerVisitGoal.	ConversionGoalRevenue
Ambito	Determina se l'obiettivo si applica a tutti gli account o solo all'account specificato nell'elemento di intestazione CustomerAccountId obbligatorio. Se si dispone di più account Microsoft Advertising, è possibile tenere traccia delle conversioni in tutti questi account. Se si associa un obiettivo a un account, le conversioni verranno rilevate solo per tale account. I valori possibili sono Account e Customer. Dopo aver impostato l'ambito, non è possibile modificarlo. Se si vuole modificare l'ambito, è necessario creare un nuovo obiettivo di conversione e sospendere quello precedente. Solo l'ambito Customer è supportato per AppInstallGoal.	EntityScope
Stato	Definisce i possibili valori di stato determinati dall'utente di un obiettivo di conversione. Questi sono i valori di stato che un utente può decidere di impostare, ad esempio un obiettivo può essere impostato su Sospeso se non si desidera più tenere traccia delle conversioni per tale obiettivo. Per i valori di stato che possono essere impostati dal sistema, ad esempio se il tag UET è verificato o meno, vedere l'elemento TrackingStatus .	ConversionGoalStatus
TagId	Identificatore univoco di Microsoft Advertising del tag UET aggiunto al sito Web per consentire a Microsoft Advertising di raccogliere le azioni eseguite dagli utenti sul sito Web. Prima di assumere una dipendenza dall'ID tag, tenere presente che il tag UET può essere condiviso con o da un altro cliente. I tag UET condivisi e i gruppi di destinatari sono disponibili solo per i clienti pilota. Per una panoramica della condivisione di gruppi di destinatari e tag UET in una gerarchia di clienti, vedere la guida tecnica Condividi gruppi di destinatari e tag UET . Questo elemento non è applicabile per AppInstallGoal, InStoreTransactionGoal e OfflineConversionGoal.	long
TrackingStatus	Definisce i possibili valori di stato determinati dal sistema di un obiettivo di conversione. Questi sono i valori di stato che possono essere impostati dal sistema, ad esempio il sistema imposta lo stato su TagUnverified se il tag UET non è ancora stato verificato. Per i valori di stato che un utente può decidere di impostare, ad esempio l'impostazione dello stato su Sospeso se non si desidera più tenere traccia delle conversioni per tale obiettivo, vedere l'elemento Status . Solo gli stati NoRecentConversions e RecordingConversions sono applicabili per AppInstallGoal e OfflineConversionGoal.	ConversionGoalTrackingStatus
Digitare	Tipo dell'obiettivo di conversione. Per altre informazioni sui tipi di obiettivo di conversione, vedere la sezione Osservazioni.	ConversionGoalType
ViewThroughConversionWindowInMinutes	La finestra di conversione view-through è il periodo di tempo in minuti dopo un clic che si desidera tenere traccia delle conversioni view-through. Se si imposta questo valore su 43200 minuti (30 giorni), le conversioni view-through che si verificano entro 30 giorni dopo il rilevamento di un clic. Le conversioni precedenti non sono interessate. Il valore minimo supportato è 1 minuto, anche se tenere presente che una finestra di conversione più breve ridurrà il numero di conversioni dei record dell'account. Il valore massimo supportato è 43200 minuti (30 giorni). Anche la proprietà dell'account IncludeViewThroughConversions deve essere impostata su true per tenere traccia delle conversioni view-through. Questo elemento non viene restituito per impostazione predefinita. Per ottenere questo elemento, includere il valore ViewThroughConversionWindowInMinutes nell'elemento ReturnAdditionalFields quando si chiamano le operazioni del servizio GetConversionGoalsByIds e GetConversionGoalsByTagIds . Questo elemento non è applicabile per AppInstallGoal, InStoreTransactionGoal e OfflineConversionGoal.	int

Osservazioni

Per Java e i linguaggi .NET, non impostare l'elemento Type perché il valore è determinato dal tipo di obiettivo di conversione di cui si crea un'istanza.

Se si genera il soap manualmente, usare l'attributo type del <ConversionGoal> nodo, come illustrato nell'esempio seguente, per specificare il tipo dell'obiettivo di conversione.

<ConversionGoals i:nil="false">
  <ConversionGoal i:type="UrlGoal">
    <ConversionWindowInMinutes i:nil="false"></ConversionWindowInMinutes>
    <CountType i:nil="false">Unique</CountType>
    <Id i:nil="true" />
    <Name i:nil="false">My Url Conversion Goal</Name>
    <Revenue i:nil="false">
      <CurrencyCode i:nil="false">USDollar</CurrencyCode>
      <Type i:nil="false">FixedValue</Type>
      <Value i:nil="false">10.00</Value>
    </Revenue>
    <Scope i:nil="false">Customer</Scope>
    <Status i:nil="true" />
    <TagId i:nil="false"></TagId>
    <TrackingStatus i:nil="true" />
    <UrlExpression i:nil="false">contoso</UrlExpression>
    <UrlOperator i:nil="false">Contains</UrlOperator>
  </ConversionGoal>
</ConversionGoals>

Requisiti

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

Usato da

AddConversionGoals
GetConversionGoalsByIds
GetConversionGoalsByTagIds
UpdateConversionGoals

Condividi tramite