Condividi tramite

Set di valori SearchCampaignChangeHistoryReportColumn - Creazione di report

  • Articolo

Definisce le colonne dell'attributo che è possibile includere in SearchCampaignChangeHistoryReportRequest.

Per un elenco delle colonne che è necessario includere, vedere la sezione Colonne obbligatorie di seguito.

Sintassi

<xs:simpleType name="SearchCampaignChangeHistoryReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="DateTime" />
    <xs:enumeration value="AccountId" />
    <xs:enumeration value="AccountName" />
    <xs:enumeration value="AccountNumber" />
    <xs:enumeration value="ChangedBy" />
    <xs:enumeration value="CampaignName" />
    <xs:enumeration value="CampaignId" />
    <xs:enumeration value="AdGroupName" />
    <xs:enumeration value="AdGroupId" />
    <xs:enumeration value="AdTitle" />
    <xs:enumeration value="AdDescription" />
    <xs:enumeration value="DisplayUrl" />
    <xs:enumeration value="Keyword" />
    <xs:enumeration value="ItemChanged" />
    <xs:enumeration value="AttributeChanged" />
    <xs:enumeration value="HowChanged" />
    <xs:enumeration value="OldValue" />
    <xs:enumeration value="NewValue" />
    <xs:enumeration value="EntityName" />
    <xs:enumeration value="EntityId" />
    <xs:enumeration value="Tool" />
  </xs:restriction>
</xs:simpleType>

Valori

Il set di valori SearchCampaignChangeHistoryReportColumn ha i valori seguenti: AccountId, AccountName, AccountNumber, AdDescription, AdGroupId, AdGroupName, AdTitle, AttributeChanged, CampaignId, CampaignName, ChangedBy, DateTime, DisplayUrl, EntityId, EntityName, HowChanged, ItemChanged, Keyword, NewValue, OldValue, Tool.

Valore Descrizione
AccountId Identificatore assegnato da Microsoft Advertising di un account.
Accountname Nome dell'account.
AccountNumber Numero assegnato da Microsoft Advertising di un account.
AdDescription La prima descrizione dell'annuncio visualizzata sotto il percorso dell'annuncio. Questa colonna sarà vuota se ItemChanged non è Ad.
AdGroupId Identificatore assegnato da Microsoft Advertising di un gruppo di annunci. Questa colonna sarà vuota se ItemChanged non è Ad, Ad group o Keyword.
AdGroupName Nome del gruppo di annunci. Questa colonna sarà vuota se ItemChanged non è Ad, Ad group o Keyword.
AdTitle Parti del titolo dell'annuncio. Questa colonna sarà vuota se ItemChanged non è Ad.
AttributeChanged Identifica l'attributo o la proprietà dell'entità dalla colonna ItemChanged modificata. Per un elenco degli elementi la cui cronologia delle modifiche viene segnalata, vedere la colonna Attribute Changed all'interno di Note. Questa colonna è vuota se è stata aggiunta o eliminata una campagna, un gruppo di annunci o un'entità pubblicitaria.
CampaignId Identificatore assegnato da Microsoft Advertising di una campagna.
CampaignName Nome della campagna.
ChangedBy Nome utente dell'utente che ha apportato la modifica alle impostazioni all'interno dell'account. Se il sistema ha apportato la modifica, il valore sarà Amministratore.
Datetime Data e ora della modifica. La data e l'ora si troveranno nel fuso orario della campagna.
DisplayUrl URL di visualizzazione dell'annuncio. Questa colonna sarà vuota se ItemChanged non è Ad.
EntityId Identificatore del sistema Microsoft Advertising dell'entità aggiornata.
EntityName Nome dell'entità aggiornata.
HowChanged Valore che indica se l'elemento è stato aggiunto, aggiornato o eliminato. Per i valori possibili, vedere Set di valori ChangeTypeReportFilter. Per le aggiunte, la colonna NewValue contiene l'entità aggiunta. Per le eliminazioni, la colonna OldValue contiene l'entità eliminata. Per gli aggiornamenti, la colonna NewValue contiene il nuovo valore e la colonna OldValue contiene il valore precedente. Se è stata aggiunta un'entità con una proprietà di stato di recapito, ad esempio una campagna, viene aggiunto il valore di HowChanged . Per segnalare un'entità eliminata, il campo ItemChanged è Status, il campo HowChanged è Changed e il campo NewValue è Deleted. L'associazione di un target a una campagna o a un gruppo di annunci verrà segnalata come modifica aggiuntiva. La colonna AttributeChanged identificherà i tipi di destinazione contenuti nell'oggetto di destinazione. Aggiornamenti a un oggetto di destinazione verrà segnalato come modifica di eliminazione e come modifica aggiuntiva. La rimozione dell'associazione di una campagna o di un gruppo di annunci a un oggetto di destinazione verrà segnalata come modifica dell'eliminazione.
Itemchanged Valore che identifica l'entità modificata. Se la modifica è un aggiornamento a un elemento dell'entità o è correlata a una destinazione associata a una campagna o a un gruppo di annunci, la colonna AttributeChanged contiene l'elemento dell'entità modificata o il tipo di destinazione modificato.
Parola chiave Testo della parola chiave. Questa colonna sarà vuota se ItemChanged non è Keyword.
Newvalue Valore dopo la modifica. Per altre informazioni, vedere la colonna HowChanged .
Oldvalue Valore prima della modifica. Per altre informazioni, vedere la colonna HowChanged .
Strumento Lo strumento Microsoft Advertising usato per apportare modifiche.

I valori possibili includono "API", "Regole automatizzate", "Caricamento bulk", "Importazioni", "Editor", "App per dispositivi mobili", "Altro", "Script" e "Client Web (manuale)". In futuro è possibile aggiungere nuovi valori, quindi non è consigliabile assumere alcuna dipendenza da un set fisso di valori.

Osservazioni

Colonne obbligatorie

Il report deve includere almeno le colonne seguenti. Come regola generale, ogni report deve includere almeno una colonna attributo e almeno una colonna delle statistiche sulle prestazioni delle condivisioni non impressioni. Per altre informazioni, vedere Attributi del report e statistiche sulle prestazioni.

Colonna
DateTime

Dettagli cronologia modifiche

Di seguito sono riportati i tipi di entità la cui cronologia delle modifiche viene segnalata.

Nota

Se il campo AttributeChanged è vuoto o vuoto e il campo HowChanged è Added o Deleted, il contenuto del campo NewValue o OldValue rappresenta rispettivamente un elemento dell'entità aggiunta o eliminata. Ad esempio, se viene aggiunta una parola chiave, il campo NewValue contiene il testo della parola chiave.

Account

Quando il valore del campo ItemChanged è Account, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Nessuno (vuoto) Fa riferimento al nome dell'account aggiunto.

Viene aggiunto il valore del campo HowChanged corrispondente.
Account Fa riferimento al nome dell'account modificato.
Contatto dell'agenzia Si riferisce al nome del contatto dell'agenzia.
Cliente della casa di vendita Si riferisce al cliente della casa di vendita.
Fattura al cliente Si riferisce al cliente di fatturazione
Stato finanziario Si riferisce allo stato finanziario
Stato blocco Fa riferimento allo stato del blocco
Opzione di pagamento Si riferisce all'opzione di pagamento
Metodo di pagamento preferito per la fatturazione Si riferisce al metodo di pagamento preferito per la fatturazione
Lingua preferita Si riferisce alla lingua preferita
Metodo di pagamento venduto Metodo di pagamento venduto
Stato Fa riferimento allo stato dell'account.
Utente preferito Fa riferimento all'utente preferito
Limite di spesa Si riferisce al limite di spesa
Modello di rilevamento Fa riferimento al modello di rilevamento dell'account.

Quando il valore del campo ItemChanged è Ad, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Nessuno (vuoto) Fa riferimento al titolo dell'annuncio aggiunto.

Viene aggiunto il valore del campo HowChanged corrispondente.
Testo dell'annuncio Fa riferimento alla descrizione della copia dell'annuncio.
Titolo dell'annuncio Fa riferimento al titolo dell'annuncio modificato.
Parametri personalizzati Fa riferimento ai parametri personalizzati dell'annuncio.
URL di destinazione Fa riferimento all'URL di destinazione dell'annuncio.
URL di visualizzazione Fa riferimento all'URL visualizzato dell'annuncio.
Stato editoriale Fa riferimento allo stato editoriale dell'annuncio.

Se l'annuncio è in attesa di revisione editoriale offline, all'interno di una cronologia delle modifiche scaricata lo stato editoriale è rappresentato come In sospeso - Attivo o In sospeso - Inattivo. Per altre informazioni, vedere Entità e stato recapito.
URL finale Fa riferimento all'URL finale dell'annuncio.
URL per dispositivi mobili Fa riferimento all'URL per dispositivi mobili finale dell'annuncio.
Stato Si riferisce allo stato di recapito dell'annuncio.

Se si segnala un annuncio eliminato, il campo ItemChanged è Status, il campo HowChanged è Changed e il campo NewValue è Deleted.
Modello di rilevamento Fa riferimento al modello di rilevamento dell'annuncio.

Gruppo di annunci

Quando il valore del campo ItemChanged è Gruppo di annunci, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Nessuno (vuoto) Fa riferimento al nome del gruppo di annunci aggiunto.

Viene aggiunto il valore del campo HowChanged corrispondente.
Gruppo di annunci Fa riferimento al nome del gruppo di annunci modificato.
Destinazione della posizione avanzata Fa riferimento all'opzione di finalità della destinazione della posizione associata al gruppo di annunci.
Età Fa riferimento all'obiettivo di età.
Parametri personalizzati Fa riferimento ai parametri personalizzati del gruppo di annunci.
Giorno Si riferisce alla destinazione del giorno deprecata dopo l'API Bing Ads versione 9.
Offerta di corrispondenza generale predefinita Fa riferimento all'offerta di corrispondenza generale predefinita
Offerta di corrispondenza del contenuto predefinita Fa riferimento all'offerta di corrispondenza del contenuto predefinita
Offerta di corrispondenza esatta predefinita Fa riferimento all'offerta di corrispondenza esatta predefinita
Offerta di corrispondenza di frasi predefinita Fa riferimento all'offerta di corrispondenza della frase predefinita
Dispositivo Fa riferimento al rinvio alla destinazione del dispositivo.
Distance Fa riferimento alla distanza della destinazione raggio.
Data di fine Fa riferimento alla data di fine pianificata per il gruppo di annunci.
Ora fine Fa riferimento alla combinazione di To Hour e To Minute della destinazione DayTime. La rettifica dell'offerta è inclusa anche in questo campo, delimitata dall'ora da un singolo carattere barra verticale.
Sesso Si riferisce all'obiettivo di genere.
Ora Fa riferimento alla destinazione ora deprecata dopo l'API Bing Ads versione 9.
Posizione Fa riferimento alla destinazione della posizione.
Esclusione della posizione Fa riferimento all'esclusione di posizioni da una destinazione di posizione.
Media Fa riferimento alla distribuzione di annunci di ricerca o contenuto.
Parola chiave negativa Fa riferimento a una parola chiave negativa associata al gruppo di annunci.

Aggiornamenti a parole chiave negative vengono segnalate come modifiche rimosse e aggiunte in due righe. Il record Removed corrisponde al valore precedente e il record Added riflette il nuovo valore.
Sospendere lo stato Fa riferimento a uno qualsiasi degli stati sospesi del gruppo di annunci.
Gruppo di prodotti Le condizioni del prodotto di un gruppo di prodotti sono delimitate l'una dall'altra da una barra indietro ('') e delimitate dall'offerta da un singolo carattere di spazio.
Esclusione del sito Fa riferimento agli URL del sito negativi del gruppo di annunci. Un gruppo di annunci può avere più esclusioni del sito e ogni esclusione del sito è rappresentata separatamente nella propria riga di report.
Ora inizio Fa riferimento alla destinazione combinata From Hour e From Minute della destinazione DayTime. La rettifica dell'offerta è inclusa anche in questo campo, delimitata dall'ora da un singolo carattere barra verticale.
Stato Fa riferimento allo stato di recapito del gruppo di annunci.

Se si segnala un gruppo di annunci eliminato, il campo ItemChanged è Status, il campo HowChanged è Changed e il campo NewValue è Deleted.
Giorni di destinazione Fa riferimento al giorno della destinazione DayTime. La rettifica dell'offerta è inclusa anche in questo campo, delimitata dal giorno da un singolo carattere barra verticale.
Modello di rilevamento Fa riferimento al modello di rilevamento del gruppo di annunci.

Estensione di chiamata

Quando il valore del campo ItemChanged è Estensione di chiamata, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Associazione Fa riferimento all'associazione di un'estensione di chiamata a un'entità.

Ad esempio, se l'estensione è associata a una campagna, il valore del campo CampaignName è il nome della campagna associata, il valore del campo ItemChanged è Estensione chiamata, il valore del campo AttributeChanged è Association e il valore del campo HowChanged è Aggiunto.

Come altro esempio, se l'estensione è associata o disassociata a una campagna, il rispettivo NewValue o OldValue è il nome della campagna e la colonna EntityName contiene il nome dell'estensione dell'annuncio.
Paese Fa riferimento al paese o all'area geografica dell'estensione della chiamata.
Numero di telefono Fa riferimento al numero di telefono dell'estensione della chiamata.
Mostra sito Web o telefono Indica se il sito Web deve essere visualizzato con il numero di telefono dell'estensione della chiamata. I valori possibili nelle colonne OldValue e NewValue sono Telefono , Sito Web e telefono.
Usare il numero di inoltro Indica se l'inoltro è configurato per l'estensione della chiamata. I valori possibili nelle colonne OldValue e NewValue sono No e Yes.

Campagna

Quando il valore del campo ItemChanged è Campaign, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Nessuno (vuoto) Fa riferimento al nome della campagna aggiunta.

Viene aggiunto il valore del campo HowChanged corrispondente.
Destinazione della posizione avanzata Fa riferimento all'opzione di finalità della destinazione della posizione associata alla campagna.
Età Fa riferimento all'obiettivo di età.
Tipo di budget Fa riferimento al tipo di budget della campagna.

I valori possibili nelle colonne OldValue e NewValue sono i seguenti:

- Il valore della destinazione giornaliera (accelerata) corrisponde all'impostazione Accelerazione giornaliera dell'applicazione Web Microsoft Advertising.

- Il valore della destinazione giornaliera (standard) corrisponde all'impostazione Daily Standard dell'applicazione Web Microsoft Advertising.
Priorità della campagna Fa riferimento alla priorità di una campagna Microsoft Shopping.
Parametri personalizzati Fa riferimento ai parametri personalizzati della campagna.
Budget giornaliero Fa riferimento all'importo del budget giornaliero della campagna.
Giorno Si riferisce alla destinazione del giorno deprecata dopo l'API Bing Ads versione 9.
Dispositivo Fa riferimento alla destinazione del dispositivo.
Distance Fa riferimento alla distanza della destinazione raggio.
Data di fine Fa riferimento alla data di fine pianificata per il gruppo di annunci.
Ora fine Fa riferimento alla combinazione di To Hour e To Minute della destinazione DayTime. La rettifica dell'offerta è inclusa anche in questo campo, delimitata dall'ora da un singolo carattere barra verticale.
Sesso Si riferisce all'obiettivo di genere.
Ora Fa riferimento alla destinazione ora deprecata dopo l'API Bing Ads versione 9.
Esclusione IP Fa riferimento alle esclusioni IP create tramite l'applicazione Web Microsoft Advertising.
Posizione Fa riferimento alla destinazione della posizione.
Esclusione della posizione Fa riferimento all'esclusione di posizioni da una destinazione di posizione.
Nome Fa riferimento al nome della campagna modificata.
Parola chiave negativa Fa riferimento a una parola chiave negativa associata alla campagna.

Aggiornamenti a parole chiave negative vengono segnalate come modifiche rimosse e aggiunte in due righe. Il record Removed corrisponde al valore precedente e il record Added riflette il nuovo valore.
Sospendere lo stato Fa riferimento a uno degli stati sospesi della campagna.

I valori possibili nelle colonne OldValue e NewValue sono "Budget Paused", "Budget and user Paused", "Not paused" e "Paused".
Filtro prodotto Fa riferimento all'ambito o alla condizione del prodotto di una campagna Microsoft Shopping. Una campagna Microsoft Shopping può avere più condizioni di prodotto e ogni condizione è rappresentata separatamente nella propria riga di report.
Budget condiviso Fa riferimento al budget condiviso da più campagne.
Esclusione del sito Fa riferimento agli URL del sito negativi della campagna. Una campagna può avere più esclusioni del sito e ogni esclusione del sito è rappresentata separatamente nella propria riga di report.
Data di inizio Per uso interno.
Ora inizio Fa riferimento alla destinazione combinata From Hour e From Minute della destinazione DayTime. La rettifica dell'offerta è inclusa anche in questo campo, delimitata dall'ora da un singolo carattere barra verticale.
Stato Fa riferimento allo stato di recapito della campagna.

Se si segnala una campagna eliminata, il campo ItemChanged è Status, il campo HowChanged è Changed e il campo NewValue è Deleted.
Giorni di destinazione Fa riferimento al giorno della destinazione DayTime. La rettifica dell'offerta è inclusa anche in questo campo, delimitata dal giorno da un singolo carattere barra verticale.
Modello di rilevamento Fa riferimento al modello di rilevamento della campagna.

Parola chiave

Quando il valore del campo ItemChanged è Keyword, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Nessuno (vuoto) Fa riferimento al testo della parola chiave aggiunta.

Viene aggiunto il valore del campo HowChanged corrispondente.
Offerta di corrispondenza ampia Fa riferimento all'importo dell'offerta di corrispondenza generale per la parola chiave .
Offerta di corrispondenza contenuto Fa riferimento all'importo dell'offerta di corrispondenza del contenuto per la parola chiave .
Parametri personalizzati Fa riferimento ai parametri personalizzati della parola chiave .
Stato editoriale Fa riferimento allo stato editoriale della parola chiave .

Se la parola chiave è in attesa di revisione editoriale offline, all'interno di una cronologia delle modifiche scaricata lo stato editoriale è rappresentato come In sospeso - Attivo o In sospeso - Inattivo. Per altre informazioni, vedere Entità e stato recapito.
Offerta di corrispondenza esatta Fa riferimento all'importo esatto dell'offerta di corrispondenza per la parola chiave .
URL finale Fa riferimento all'URL finale della parola chiave .
URL per dispositivi mobili Fa riferimento all'URL per dispositivi mobili finali della parola chiave .
Tipo di corrispondenza (Match type) Fa riferimento al tipo di corrispondenza dell'offerta per la parola chiave .

Il tipo di corrispondenza dell'offerta non può essere aggiornato usando l'API Bing Ads. tuttavia, è possibile modificare il tipo di corrispondenza dell'offerta usando l'applicazione Web Microsoft Advertising.
Offerta di corrispondenza frasi Fa riferimento alla frase corrispondente all'importo dell'offerta per la parola chiave.
Stato Fa riferimento allo stato di recapito della parola chiave .

Se si segnala una parola chiave eliminata, il campo ItemChanged è Status, il campo HowChanged è Changed e il campo NewValue è Deleted.
Modello di rilevamento Fa riferimento al modello di rilevamento della parola chiave .

Estensione della posizione

Quando il valore del campo ItemChanged è Estensione posizione, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Associazione Fa riferimento all'associazione di un'estensione di posizione a un'entità.

Ad esempio, se l'estensione è associata a una campagna, il valore del campo CampaignName è il nome della campagna associata, il valore del campo ItemChanged è l'estensione Location, il valore del campo AttributeChanged è Association e il valore del campo HowChanged è Added.

Elenco di parole chiave negative

Quando il valore del campo ItemChanged è Negative Keyword List, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Associazione Fa riferimento all'associazione di un elenco di parole chiave negative a una campagna.

Ad esempio, se l'elenco di parole chiave negative è associato a una campagna, il valore del campo CampaignName è il nome della campagna associata, il valore del campo ItemChanged è Negative Keyword List, il valore del campo AttributeChanged è Association e il valore del campo HowChanged è Added.
Parola chiave negativa Fa riferimento alla parola chiave negativa aggiunta o rimossa dall'elenco di parole chiave negative.
Nome elenco parole chiave negative Fa riferimento al nome dell'elenco di parole chiave negative.

Estensione Sitelink

Quando il valore del campo ItemChanged è l'estensione Sitelink, sono disponibili la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Associazione Fa riferimento all'associazione di un'estensione sitelink a un'entità.

Ad esempio, se l'estensione è associata a una campagna, il valore del campo CampaignName è il nome della campagna associata, il valore del campo ItemChanged è l'estensione Sitelink, il valore del campo AttributeChanged è Association e il valore del campo HowChanged è Added.
Parametri personalizzati Fa riferimento ai parametri personalizzati di un sitelink.
URL di destinazione Fa riferimento all'URL di destinazione dell'estensione sitelink.
Visualizza testo Fa riferimento al testo visualizzato dell'estensione sitelink.
URL finale Fa riferimento all'URL finale di un sitelink.
URL per dispositivi mobili Fa riferimento all'URL del dispositivo mobile finale di un sitelink.
Modello di rilevamento Fa riferimento al modello di rilevamento di un sitelink.

Utente

Quando il valore del campo ItemChanged è User, è disponibile la cronologia delle modifiche per gli attributi seguenti.

Attributo modificato Descrizione
Nessuno (vuoto) Fa riferimento al nome utente dell'utente aggiunto.

Viene aggiunto il valore del campo HowChanged corrispondente.
Codice Per uso interno.
Posta elettronica Fa riferimento all'indirizzo di posta elettronica del contatto dell'utente.
Nome Fa riferimento al nome dell'utente.
Cognome Fa riferimento al cognome dell'utente.
Stato Fa riferimento allo stato dell'utente.

Requisiti

Servizio: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13

Usato da

SearchCampaignChangeHistoryReportRequest