Condividi tramite

Record obiettivo evento - Bulk

  • Articolo

Definisce un obiettivo di conversione di eventi personalizzato che può essere caricato e scaricato in un file bulk.

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.

È possibile scaricare tutti i record dell'obiettivo di evento nell'account includendo il valore DownloadEntity di EventGoals nella richiesta di servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.

Nell'esempio csv bulk seguente viene aggiunto un nuovo obiettivo di evento.

Type,Id,Attribution Model Type,Count Type,Exclude From Bidding,Goal Category,Is Enhanced Conversions Enabled,Name,Conversion Currency Code,Revenue Value,Revenue Type,Scope,UET Tag Id,Status,View Through Conversion Window In Minutes,Conversion Window In Minutes,Category Expression,Category Operator,Action Expression,Action Operator,Label Expression,Label Operator,Event Value,Event Value Operator,URL Expression,URL Operator,Minimum Duration In Second,App Platform,App Id,Minimum Pages Viewed  
Format Version,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,  
Event Goal,,LastTouch,Unique,False,AddToCart,False,GoalA,USD,1,FixedValue,Account,123431,Active,150,367,video,Contains,buy,Contains,lb,Contains,3,Equals,,,,,,

Per un record Obiettivo evento , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Espressione azione

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.

Aggiungi: 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).
Aggiornamento: 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.

Operatore Action

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 .

Aggiungi: 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).
Aggiornamento: 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.

Tipo di modello di attribuzione

Determina quale modello di attribuzione, LastTouch o LastClick, viene usato con un obiettivo di conversione.

Aggiungi: facoltativo
Aggiornamento: facoltativo

Espressione categoria

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.

Aggiungi: 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). Aggiornamento: 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.

Operatore category

Operatore che può essere applicato al valore dell'elemento CategoryExpression.

Aggiungi: 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).
Aggiornamento: 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.

Finestra di conversione in minuti

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

Aggiungi: facoltativo
Aggiornamento: facoltativo

Tipo di conteggio

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.

Aggiungi: Aggiornamento facoltativo: Facoltativo

Codice valuta

Tipo di valuta che si desidera segnalare i ricavi dell'obiettivo di conversione.

Per un elenco dei possibili valori stringa, vedere Microsoft Advertising Currencies.For a list of possible string values see Microsoft Advertising Currencies.

Se l'elemento Scope è impostato su Customere type èFixedValue o VariableValue, questa proprietà è obbligatoria.

Aggiungere: Facoltativo, se non diversamente indicato in precedenza.
Aggiornare: Facoltativo, se non diversamente indicato in precedenza.

Valore evento

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 .

Aggiungi: 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). Aggiornamento: 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

Operatore valore evento

Operatore che può essere applicato al valore dell'elemento Value .

Aggiungi: 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). Aggiornamento: 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.

Escludi dall'offerta

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 Conversionscolonne del report , ConversionRate, CostPerConversion, ReturnOnAdSpend, RevenuePerConversione 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 AllConversionscolonne del report , AllConversionRate, AllCostPerConversion, AllReturnOnAdSpend, AllRevenuePerConversione 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".

Aggiungi: facoltativo
Aggiornamento: facoltativo

Categoria obiettivo

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 solo la categoria Download .

Aggiungi: facoltativo. Se si lascia questo elemento nil o vuoto, la categoria predefinita verrà impostata su Download.
Aggiornamento: facoltativo. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.

Id

Identificatore univoco di Microsoft Advertising per l'obiettivo di conversione.

Aggiungere: Sola lettura
Aggiornare: Sola lettura e Obbligatorio

Le conversioni avanzate sono abilitate

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.

Aggiungi: facoltativo
Aggiornamento: facoltativo

Espressione etichetta

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.

Aggiungi: 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).
Aggiornamento: 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.

Operatore Label

Operatore che può essere applicato al valore dell'elemento LabelExpression .

Aggiungi: 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).
Aggiornamento: 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.

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.

Aggiungi: Obbligatorio
Aggiornamento: facoltativo

Tipo di ricavi

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.

Aggiungi: facoltativo
Aggiornamento: facoltativo

Valore dei ricavi

Valore o importo dei ricavi. Se si assegnano valori alle conversioni, sarà possibile visualizzare il valore totale determinato dalla pubblicità in diverse conversioni, anziché semplicemente il numero di conversioni che si sono verificate.

Il valore predefinito è effettivamente 0 e i valori possibili sono compresi tra 0 e 999.9999. I valori accettati dipendono dal tipo di ricavi. Per informazioni dettagliate, vedere l'elemento Type.

Aggiungi: facoltativo. Se non specificato, il tipo predefinito è effettivamente 0.
Aggiornamento: facoltativo. Se non specificato, il tipo predefinito è effettivamente 0.

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.

Per gli obiettivi dell'evento, l'ambito a livello di account non è supportato. È possibile impostare questo elemento su Customer o lasciarlo null. Se non specificato, l'ambito verrà impostato su Customer per impostazione predefinita.

Aggiungi: facoltativo
Aggiornamento: facoltativo

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, vedere l'elemento TrackingStatus .

Aggiungi: facoltativo
Aggiornamento: facoltativo

Stato verifica

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 RecordingConversions se sono state registrate conversioni negli ultimi 7 giorni.

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.

Aggiungi: sola lettura
Aggiornamento: sola lettura

Tipo

Tipo dell'obiettivo di conversione. Questo valore è InStoreTransaction quando si recupera un obiettivo di 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.

Aggiungi: sola lettura
Aggiornamento: sola lettura

UET Tag ID

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 .

Aggiungi: Obbligatorio
Aggiornamento: facoltativo

Visualizzazione tramite i minuti della finestra di conversione

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.

Aggiungi: Aggiornamento facoltativo: Facoltativo