Oggetto dati EventGoal - Campaign Management

Articolo
11/14/2024

Definisce un obiettivo di conversione di eventi personalizzato.

Usare questo tipo di obiettivo per contare ogni volta che qualcuno completa un'azione specifica, ad esempio la sottoscrizione alla newsletter o il download di un documento come conversione.

Per impostazione predefinita, il tag UET registra le visite degli utenti alle pagine del sito Web che consentono a Microsoft Advertising di supportare tipi di obiettivo come UrlGoal, DurationGoal e PagesViewedPerVisitGoal. Tuttavia, è possibile tenere traccia di altri tipi di eventi, ad esempio la sottoscrizione a una newsletter o il download di un documento. Microsoft Advertising abilita questo scenario con EventGoal. Oltre a creare un eventgoal, è necessario personalizzare il codice di rilevamento tag UET per segnalare i valori per uno o più parametri di evento personalizzati. Per altre informazioni, vedere Come segnalare eventi personalizzati con UET.

Consiglio

Per una panoramica dell'implementazione, vedere la guida tecnica di Universal Event Tracking .

Importante

Ogni volta che si aggiunge o si aggiorna un nuovo oggetto DurationGoal, EventGoal, OfflineConversionGoal, PagesViewedPerVisitGoal o UrlGoal tramite l'applicazione Web Microsoft Advertising o l'API Campaign Management, il valore MSCLKIDAutoTaggingEnableddell'accountProperty corrispondente viene impostato automaticamente su True . Se l'ambito dell'obiettivo è impostato su Livello cliente , verrà impostata la proprietà AccountProperty per tutti gli account in Customer.

<xs:complexType name="EventGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="ActionExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="CategoryExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="LabelExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" nillable="true" type="tns:ValueOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AttributionModelType": "ValueHere",
  "ConversionWindowInMinutes": IntValueHere,
  "CountType": "ValueHere",
  "ExcludeFromBidding": "ValueHere",
  "GoalCategory": "ValueHere",
  "Id": "LongValueHere",
  "IsEnhancedConversionsEnabled": "ValueHere",
  "Name": "ValueHere",
  "Revenue": {
    "CurrencyCode": "ValueHere",
    "Type": "ValueHere",
    "Value": DecimalValueHere
  },
  "Scope": "ValueHere",
  "Status": "ValueHere",
  "TagId": "LongValueHere",
  "TrackingStatus": "ValueHere",
  "Type": "Event",
  "ViewThroughConversionWindowInMinutes": IntValueHere,
  "ActionExpression": "ValueHere",
  "ActionOperator": "ValueHere",
  "CategoryExpression": "ValueHere",
  "CategoryOperator": "ValueHere",
  "LabelExpression": "ValueHere",
  "LabelOperator": "ValueHere",
  "Value": DecimalValueHere,
  "ValueOperator": "ValueHere"
}

Elementi

L'oggetto EventGoal include gli elementi seguenti: ActionExpression, ActionOperator, CategoryExpression, CategoryOperator, LabelExpression, LabelOperator, Value, ValueOperator.

Elemento	Descrizione	Tipo di dati
ActionExpression	Tipo di interazione utente da tenere traccia. Ad esempio "play" o "pause". Se questo elemento viene specificato durante un'operazione di aggiunta o aggiornamento, è necessario anche l'elemento ActionOperator . La stringa non può superare la lunghezza massima di 100. Aggiungere: Facoltativo se si includono uno o più degli altri eventi; È necessario includere una o più delle coppie di operatori eventi seguenti: (ActionOperator e ActionExpression), (CategoryOperator e CategoryExpression), (LabelOperator e LabelExpression), (ValueOperator e Value). Aggiornare: Facoltativo se si includono uno o più degli altri eventi; Se non includi ActionOperator e ActionExpression durante l'aggiornamento, le impostazioni esistenti di ActionOperator e ActionExpression verranno eliminate.	corda
ActionOperator	Operatore che può essere applicato al valore dell'elemento ActionExpression . Se questo elemento viene specificato durante un'operazione di aggiunta o aggiornamento, è necessario anche l'elemento ActionExpression . Aggiungere: Facoltativo se si includono uno o più degli altri eventi; È necessario includere una o più delle coppie di operatori eventi seguenti: (ActionOperator e ActionExpression), (CategoryOperator e CategoryExpression), (LabelOperator e LabelExpression), (ValueOperator e Value). Aggiornare: Facoltativo se si includono uno o più degli altri eventi; Se non includi ActionOperator e ActionExpression durante l'aggiornamento, le impostazioni esistenti di ActionOperator e ActionExpression verranno eliminate.	ExpressionOperator
CategoryExpression	Categoria di evento da tenere traccia. Ad esempio, "video". Se questo elemento viene specificato durante un'operazione di aggiunta o aggiornamento, è necessario anche l'elemento CategoryOperator . La stringa non può superare la lunghezza massima di 100. Aggiungere: Facoltativo se si includono uno o più degli altri eventi; È necessario includere una o più delle coppie di operatori eventi seguenti: (ActionOperator e ActionExpression), (CategoryOperator e CategoryExpression), (LabelOperator e LabelExpression), (ValueOperator e Value). Aggiornare: Facoltativo se si includono uno o più degli altri eventi; Se non si includono CategoryOperator e CategoryExpression durante l'aggiornamento, tutte le impostazioni CategoryOperator e CategoryExpression esistenti verranno eliminate.	corda
CategoryOperator	Operatore che può essere applicato al valore dell'elemento CategoryExpression . Aggiungere: Facoltativo se si includono uno o più degli altri eventi; È necessario includere una o più delle coppie di operatori eventi seguenti: (ActionOperator e ActionExpression), (CategoryOperator e CategoryExpression), (LabelOperator e LabelExpression), (ValueOperator e Value). Aggiornare: Facoltativo se si includono uno o più degli altri eventi; Se non si includono CategoryOperator e CategoryExpression durante l'aggiornamento, tutte le impostazioni CategoryOperator e CategoryExpression esistenti verranno eliminate.	ExpressionOperator
LabelExpression	Nome dell'elemento che ha causato l'azione. Ad esempio "trailer" o "behindthescenes". Se questo elemento viene specificato durante un'operazione di aggiunta o aggiornamento, è necessario anche l'elemento LabelOperator . La stringa non può superare la lunghezza massima di 100. Aggiungere: Facoltativo se si includono uno o più degli altri eventi; È necessario includere una o più delle coppie di operatori eventi seguenti: (ActionOperator e ActionExpression), (CategoryOperator e CategoryExpression), (LabelOperator e LabelExpression), (ValueOperator e Value). Aggiornare: Facoltativo se si includono uno o più degli altri eventi; Se non si includono LabelOperator e LabelExpression durante l'aggiornamento, tutte le impostazioni LabelOperator e LabelExpression esistenti verranno eliminate.	corda
LabelOperator	Operatore che può essere applicato al valore dell'elemento LabelExpression . Aggiungere: Facoltativo se si includono uno o più degli altri eventi; È necessario includere una o più delle coppie di operatori eventi seguenti: (ActionOperator e ActionExpression), (CategoryOperator e CategoryExpression), (LabelOperator e LabelExpression), (ValueOperator e Value). Aggiornare: Facoltativo se si includono uno o più degli altri eventi; Se non si includono LabelOperator e LabelExpression durante l'aggiornamento, tutte le impostazioni LabelOperator e LabelExpression esistenti verranno eliminate.	ExpressionOperator
Valore	Valore numerico associato a tale evento. Ad esempio, il valore potrebbe essere la durata del tempo di riproduzione del video. Se questo elemento viene specificato durante un'operazione di aggiunta o aggiornamento, è necessario anche l'elemento ValueOperator . Aggiungere: Facoltativo se si includono uno o più degli altri eventi; È necessario includere una o più delle coppie di operatori eventi seguenti: (ActionOperator e ActionExpression), (CategoryOperator e CategoryExpression), (LabelOperator e LabelExpression), (ValueOperator e Value). Aggiornare: Facoltativo se si includono uno o più degli altri eventi; Se non si includono ValueOperator e Value durante l'aggiornamento, tutte le impostazioni ValueOperator e Value esistenti verranno eliminate	decimale
ValueOperator	Operatore che può essere applicato al valore dell'elemento Value . Aggiungere: Facoltativo se si includono uno o più degli altri eventi; È necessario includere una o più delle coppie di operatori eventi seguenti: (ActionOperator e ActionExpression), (CategoryOperator e CategoryExpression), (LabelOperator e LabelExpression), (ValueOperator e Value). Aggiornare: Facoltativo se si includono uno o più degli altri eventi; Se non si includono ValueOperator e Value durante l'aggiornamento, tutte le impostazioni ValueOperator e Value esistenti verranno eliminate.	ValueOperator

L'oggetto EventGoal include elementi ereditati.

Elementi ereditati

Elementi ereditati da ConversionGoal

L'oggetto EventGoal deriva dall'oggetto ConversionGoal ed eredita gli elementi seguenti: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes. Le descrizioni seguenti sono specifiche di EventGoal e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto ConversionGoal .

Elemento	Descrizione	Tipo di dati
AttributionModelType	Determina quale modello di attribuzione, LastTouch o LastClick, viene usato con un obiettivo di conversione.	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). Aggiungere: Opzionale Aggiornare: Opzionale	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. Aggiungere: Opzionale Aggiornare: Opzionale	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". Aggiungere: Opzionale Aggiornare: Opzionale	booleano
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. Gli obiettivi degli eventi supportano le categorie AddToCart, BeginCheckout, BookAppointment, Contact, GetDirections, Other, OutboundClick, PageView, Purchase, RequestQuote, Signup, SubmitLeadForm e Subscribe . Aggiungere: Obbligatorio a partire da giugno 2021. In precedenza, se si lasciava l'elemento nil o vuoto, la categoria predefinita era impostata su Nessuno. Aggiornare: Facoltativo se l'obiettivo di conversione ha già un set di categorie diverso da Nessuno. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.	ConversionGoalCategory
Id	Identificatore univoco di Microsoft Advertising per l'obiettivo di conversione. Aggiungere: Sola lettura Aggiornare: Obbligatorio e Read-Only	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.	booleano
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. Aggiungere: Obbligatorio Aggiornare: Opzionale	corda
Ricavo	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. Aggiungere: Opzionale Aggiornare: Opzionale	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. Se non specificato, l'ambito verrà impostato su Customer per impostazione predefinita. 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. Aggiungere: Opzionale Aggiornare: Opzionale	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 . Aggiungere: Opzionale Aggiornare: Opzionale	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 . Aggiungere: Obbligatorio Aggiornare: Opzionale	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 . Aggiungere: Sola lettura Aggiornare: Sola lettura	ConversionGoalTrackingStatus
Tipo	Tipo dell'obiettivo di conversione. Questo valore è Event quando si recupera un obiettivo dell'evento. Per altre informazioni sui tipi di obiettivo di conversione, vedere ConversionGoal Data Object Remarks.For more information about conversion goal types, see the ConversionGoal Data Object Remarks. Aggiungere: Sola lettura Aggiornare: Sola lettura	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 . Aggiungere: Opzionale Aggiornare: Opzionale	int

Requisiti

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

Condividi tramite