AppInstallGoal Data Object - Campaign Management

Definisce un obiettivo di conversione dell'installazione dell'app. Usa questo tipo di obiettivo per tenere traccia ogni volta che qualcuno installa l'app come conversione.

Per altri tipi di obiettivo di conversione, creare un tag UET (Universal Event Tracking), aggiungerlo al sito Web e quindi creare un obiettivo di conversione. Per gli obiettivi di conversione dell'installazione dell'app, tuttavia, è necessario solo usare l'URL specifico dell'app fornito dal partner certificato per Microsoft Advertising. Per altre informazioni, vedere Come tenere traccia delle installazioni di app per dispositivi mobili come conversioni.

Consiglio

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

Sintassi

<xs:complexType name="AppInstallGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto AppInstallGoal include gli elementi seguenti: AppPlatform, AppStoreId.

Elemento Descrizione Tipo di dati
AppPlatform Piattaforma dell'applicazione.

I valori possibili includono Android, iOS, Windows e WindowsPhone.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale
Stringa
AppStoreId Identificatore dell'applicazione fornito dall'App Store.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale
Stringa

L'oggetto AppInstallGoal include elementi ereditati.

Elementi ereditati

Elementi ereditati da ConversionGoal

L'oggetto AppInstallGoal 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 AppInstallGoal e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto ConversionGoal .

Elemento Descrizione Tipo di dati
AttributionModelType Non applicabile per gli obiettivi di installazione dell'app. 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
Aggiornamento: Opzionale
int
CountType Non applicabile per gli obiettivi di installazione dell'app. 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 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".

Aggiungere: Opzionale
Aggiornamento: Opzionale
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. Gli obiettivi di installazione dell'app supportano solo la categoria Download .

Aggiungere: Opzionale. Se si lascia questo elemento nil o vuoto, la categoria predefinita verrà impostata su Download.
Aggiornamento: Opzionale. 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
Aggiornamento: 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.
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.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale
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 gli obiettivi di conversione dell'installazione dell'app.

Aggiungere: Opzionale
Aggiornamento: 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.

Per gli obiettivi di installazione dell'app, 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.

Aggiungere: Opzionale
Aggiornamento: 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, vedere l'elemento TrackingStatus .

Aggiungere: Opzionale
Aggiornamento: Opzionale
ConversionGoalStatus
TagId Non applicabile per gli obiettivi di installazione dell'app. 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 RecordingConversions se sono state registrate conversioni negli ultimi 7 giorni.

Solo gli stati NoRecentConversions e RecordingConversions sono applicabili per gli obiettivi di conversione dell'installazione dell'app.

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
Aggiornamento: Sola lettura
ConversionGoalTrackingStatus
Digitare Tipo dell'obiettivo di conversione. Questo valore è AppInstall quando si recupera un obiettivo di installazione dell'app. 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
Aggiornamento: Sola lettura
ConversionGoalType
ViewThroughConversionWindowInMinutes Non applicabile per gli obiettivi di installazione dell'app. int

Requisiti

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