Oggetto dati campagna - Campaign Management
Definisce una campagna.
Nota
Non è più possibile aggiungere, aggiornare o recuperare campagne che supportano solo gli annunci di ricerca dinamica. Il tipo di campagna delle campagne esistenti è stato aggiornato da "DynamicSearchAds" a "Search". I gruppi di annunci sono ora considerati gruppi di annunci "dinamici", ma non ci sono modifiche strutturali, ad esempio contengono gli stessi obiettivi automatici e gli annunci di ricerca dinamica di prima.
Nota
A partire da aprile 2021, la strategia di offerta manuale CPC può essere usata solo con campagne di pubblico e campagne di alloggio. Se si tenta di impostare CPC manuale per qualsiasi altro tipo di campagna, la richiesta verrà ignorata senza errori e la strategia di offerta verrà impostata su CPC migliorato.
A partire da aprile 2021, non puoi impostare strategie di offerta per gruppi di annunci o parole chiave. Le strategie di offerta possono essere impostate solo a livello di campagna. Se tenti di impostare strategie di offerta per gruppi di annunci o parole chiave, la richiesta verrà ignorata senza errori. I gruppi di annunci e le parole chiave erediteranno la strategia di offerta della campagna.
Sintassi
<xs:complexType name="Campaign" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AudienceAdsBidAdjustment" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
<xs:element minOccurs="0" name="BudgetType" nillable="true" type="tns:BudgetLimitType" />
<xs:element minOccurs="0" name="DailyBudget" nillable="true" type="xs:double" />
<xs:element xmlns:q9="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="DealIds" nillable="true" type="q9:ArrayOflong">
<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="ExperimentId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
<xs:element xmlns:q11="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="GoalIds" nillable="true" type="q11:ArrayOflong">
<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="IsDealCampaign" 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="MultimediaAdsBidAdjustment" 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:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Status" nillable="true" type="tns:CampaignStatus" />
<xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
<xs:element minOccurs="0" name="CampaignType" nillable="true" type="tns:CampaignType" />
<xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
<xs:element minOccurs="0" name="BudgetId" nillable="true" type="xs:long" />
<xs:element xmlns:q12="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Languages" nillable="true" type="q12:ArrayOfstring" />
<xs:element minOccurs="0" name="AdScheduleUseSearcherTimeZone" 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="BidStrategyId" nillable="true" type="xs:long">
<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 Campaign include gli elementi seguenti: AdScheduleUseSearcherTimeZone, AudienceAdsBidAdjustment, BiddingScheme, BidStrategyId, BudgetId, BudgetType, CampaignType, DailyBudget, DealIds, ExperimentId, FinalUrlSuffix, ForwardCompatibilityMap, GoalIds, Id, IsDealCampaign, Languages, MultimediaAdsBidAdjustment, Name, Settings, Status, SubType, TimeZone, TrackingUrlTemplate, UrlCustomParameters.
Elemento | Descrizione | Tipo di dati |
---|---|---|
AdScheduleUseSearcherTimeZone | Determina se usare il fuso orario dell'account o il fuso orario dell'utente di ricerca in cui potrebbero essere recapitati gli annunci. Impostare questa proprietà su true se si desidera che gli annunci vengano visualizzati nel fuso orario dell'utente di ricerca e impostarli in caso contrario su false. Questo elemento non viene restituito per impostazione predefinita. Per ottenere questo elemento, includere il valore AdScheduleUseSearcherTimeZone nell'elemento ReturnAdditionalFields quando si chiamano le operazioni del servizio GetCampaignsByAccountId e GetCampaignsByIds . Aggiungere: Opzionale. Se non si specifica questo elemento o lo si lascia vuoto, verrà impostato il valore predefinito false e verrà usato il fuso orario dell'account. Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
booleano |
AudienceAdsBidAdjustment | Importo percentuale in base al quale modificare l'offerta per gli annunci del pubblico al di sopra o al di sotto del gruppo di annunci di base o dell'offerta per parole chiave. Questa proprietà è disponibile nelle campagne di ricerca se il cliente è abilitato per Microsoft Audience Network. Questa proprietà non è disponibile con campagne di shopping intelligente. I valori supportati sono negativi da cento (-100) a 900 positivi (900). L'impostazione della rettifica dell'offerta su -100 impedirà la visualizzazione degli annunci del pubblico per questa campagna. Imposta questo elemento su zero (0) se vuoi usare il gruppo di annunci di base o l'offerta di parole chiave invece di specificare qualsiasi rettifica dell'offerta per gli annunci del pubblico. Come procedura consigliata è consigliabile specificare sempre un valore di rettifica dell'offerta. Se si imposta questo elemento su null, verrà usata la rettifica dell'offerta predefinita del sistema. La rettifica dell'offerta predefinita del sistema è attualmente zero (0) ed è soggetta a modifiche. Aggiungere: Opzionale Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
int |
BiddingScheme | Tipo di strategia di offerta per la gestione delle offerte. Per informazioni dettagliate sulle strategie di offerta supportate per tipo di campagna, vedere Strategie di budget e offerte. IMPORTANTE: Per alcuni tipi di strategia di offerta, le impostazioni di rotazione delle offerte e degli annunci vengono ignorate e il monitoraggio della conversione (tramite il tag Di rilevamento eventi universale e un obiettivo di conversione) è obbligatorio. Per altre informazioni, incluse le località supportate, vedere Consentire a Microsoft Advertising di gestire le offerte con le strategie di offerta. Questo elemento sarà nil o vuoto per impostazione predefinita se la campagna usa la strategia di offerta MaxConversionValueBiddingScheme o TargetImpressionShareBiddingScheme . Per ottenere gli oggetti MaxConversionValueBiddingScheme o TargetImpressionShareBiddingScheme , includere i rispettivi valori MaxConversionValueBiddingScheme e TargetImpressionShareBiddingScheme nell'elemento ReturnAdditionalFields quando si chiamano le operazioni del servizio GetCampaignsByAccountId e GetCampaignsByIds . Aggiungere: Opzionale. Il tipo di strategia di offerta predefinito per le campagne Search e DynamicSearchAds è EnhancedCpcBiddingScheme. Il tipo di strategia di offerta predefinito per la maggior parte delle campagne Shopping è EnhancedCpcBiddingScheme; tuttavia, gli unici tipi di strategia di offerta supportati per le campagne di shopping intelligente sono MaxConversionsBiddingScheme e MaxConversionValueBiddingScheme. I tipi di strategia di offerta supportati per le campagne audience sono EnhancedCpcBiddingScheme, ManualCpcBiddingScheme, ManualCpmBiddingScheme e TargetCpaBiddingScheme. I tipi di strategia di offerta supportati per le campagne di alloggio sono CommissionBiddingScheme, ManualCpcBiddingScheme e PercentCpcBiddingScheme. Le strategie di offerta supportate per le campagne Performance Max sono MaxConversionsBiddingScheme (con TCPA facoltativo) e MaxConversionValueBiddingScheme (con TROAS facoltativo). Le strategie di offerta supportate per le nuove campagne video sono ManualCpmBiddingScheme e ManualCpvBiddingScheme. NOTA: A partire da maggio 2024, non è più possibile usare la strategia di offerta CPC manuale per le campagne native del pubblico. È possibile usare CPC manuale solo per le campagne video e di visualizzazione del pubblico e per le campagne di alloggio. Convertiremo automaticamente tutte le campagne di pubblico CPC manuali esistenti in CPC migliorato. Se si tenta di impostare CPC manuale per qualsiasi altro tipo di campagna, la richiesta verrà ignorata senza errori e la strategia di offerta verrà impostata su CPC migliorato. A partire da aprile 2021, non puoi impostare strategie di offerta per gruppi di annunci o parole chiave. Le strategie di offerta possono essere impostate solo a livello di campagna. Se tenti di impostare strategie di offerta per gruppi di annunci o parole chiave, la richiesta verrà ignorata senza errori. I gruppi di annunci e le parole chiave erediteranno la strategia di offerta della campagna. Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
BiddingScheme |
BidStrategyId | Identificatore generato dal sistema dell'oggetto BidStrategy condiviso da questa campagna con altre campagne nell'account. Se il campo è vuoto, la campagna non usa una strategia di offerta portfolio. Se il campo non è vuoto e il valore è maggiore di zero, la campagna usa una strategia di offerta portfolio. Se la campagna usa una strategia di offerta portfolio e si preferisce usare la propria strategia di offerta, impostare questo campo su "0" (zero). Nota: Le strategie di offerta portfolio non sono supportate con campagne di shopping intelligente o campagne performance max. Aggiungere: Opzionale Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
long |
BudgetId | Identificatore univoco di Microsoft Advertising del budget condiviso da questa campagna con altre campagne nell'account. Se il valore non è Null e maggiore di zero, la campagna usa un budget condiviso. Se il valore è Null, la campagna non usa un budget condiviso. Se la campagna usa un budget condiviso e si preferisce usare il proprio budget, ad esempio l'importo dailybudget , impostare questo elemento su '0' (zero) e impostare DailyBudget su un importo di budget valido. Nota: I budget condivisi non sono supportati con campagne di shopping intelligente o campagne performance max. Con le campagne di shopping intelligente, è necessario impostare l'importo DailyBudget . Aggiungere: Opzionale Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
long |
BudgetType | Il tipo di budget determina la modalità di spesa del budget. I valori possibili sono DailyBudgetAccelerated e DailyBudgetStandard. Il tipo di budget DailyBudgetAccelerated è disponibile solo per le campagne audience che usano budget a livello di campagna non condivisi. Nel contesto dei budget condivisi, il tipo di budget è una proprietà di sola lettura che viene sempre restituita indipendentemente dal fatto che la campagna usi o meno un budget condiviso. Per determinare se la campagna usa un budget condiviso, controllare il valore dell'elemento BudgetId come descritto in precedenza. Con le campagne di esperimento non è possibile impostare Budget, BudgetType o Status. Il budget e lo stato di una campagna di esperimento vengono sempre ereditati dalle impostazioni della campagna di base. Aggiungere: Obbligatorio se BudgetId non è impostato. Sola lettura se la campagna usa un budget condiviso. Aggiornare: Facoltativo se BudgetId non è impostato. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Non consentito se la campagna usa un budget condiviso. Se si tenta di aggiornare il tipo di budget di una campagna con un budget condiviso, il servizio restituirà il codice di errore CampaignServiceCannotUpdateSharedBudget . |
BudgetLimitType |
CampaignType | Il tipo di campagna determina se la campagna è un pubblico, annunci di ricerca dinamica, ricerca, campagna shopping, annunci hotel o prestazioni massime. Aggiungere: Opzionale. Se non specificato, viene usato il valore predefinito Cerca . Aggiornare: Non consentito. |
CampaignType |
DailyBudget | Importo da spendere ogni giorno per la campagna. È necessario impostare l'importo del budget giornaliero se BudgetId non è impostato. Il budget è un obiettivo; la spesa effettiva potrebbe essere superiore o inferiore. Le variazioni sono causate da una serie di fattori, ad esempio volumi di traffico diversi in diversi giorni della settimana, o il rilevamento automatico e il rimborso dei clic sulle frodi che possono restituire denaro a una campagna entro poche ore dal clic. Microsoft Advertising prevede e compensa automaticamente le fluttuazioni e in genere mantiene una spesa eccessiva inferiore al 100% al di sopra del limite giornaliero. Tieni anche presente che Microsoft Advertising non richiede che il budget della campagna sia superiore al gruppo di annunci e alle offerte per parole chiave. In altre parole, le offerte per gruppi di annunci e parole chiave vengono convalidate indipendentemente dal budget della campagna. Nel contesto dei budget condivisi, l'importo del budget è una proprietà di sola lettura che viene sempre restituita indipendentemente dal fatto che la campagna usi o meno un budget condiviso. Quando una campagna è associata a un budget condiviso, l'importo restituito è quello del budget condiviso. Per determinare se la campagna usa un budget condiviso, controllare il valore dell'elemento BudgetId come descritto in precedenza. Con le campagne di esperimento non è possibile impostare Budget, BudgetType o Status. Il budget e lo stato di una campagna di esperimento vengono sempre ereditati dalle impostazioni della campagna di base. Aggiungere: Obbligatorio se BudgetId non è impostato. Sola lettura se la campagna usa un budget condiviso. Aggiornare: Facoltativo se BudgetId non è impostato. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Non consentito se la campagna usa un budget condiviso. Se si tenta di aggiornare l'importo del budget di una campagna con un budget condiviso, il servizio restituirà il codice di errore CampaignServiceCannotUpdateSharedBudget . |
doppio |
DealId | Elenco di identificatori di sistema univoci corrispondenti alle trattative aggiunte. L'elenco di identificatori corrisponde direttamente all'elenco delle trattative nella richiesta. Gli elementi dell'elenco possono essere restituiti come Null. Per ogni indice elenco in cui non è stata aggiunta una trattativa, l'elemento corrispondente sarà Null. |
matrice long |
ExperimentId | Identificatore generato dal sistema dell'esperimento. Questo elemento è impostato solo per le campagne di esperimento, ad esempio le campagne create per i test A/B in base a un'altra campagna di ricerca. Le campagne di base non conterrà un ID esperimento. Allo stesso modo, dopo che un esperimento è stato laureato in una campagna indipendente, questo elemento sarà vuoto, anche se la campagna era in precedenza una campagna di esperimento. Con le campagne di esperimento non è possibile impostare Budget, BudgetType o Status. Il budget e lo stato di una campagna di esperimento vengono sempre ereditati dalle impostazioni della campagna di base. Se si vuole modificare il budget di un esperimento, è necessario modificare il budget della campagna di base. La modifica del valore verrà quindi divisa in base all'impostazione TrafficSplitPercent dell'esperimento. Aggiungere: Sola lettura Aggiornare: Sola lettura |
long |
FinalUrlSuffix | Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche. Aggiungere: Opzionale Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata. |
corda |
ForwardCompatibilityMap | Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API. Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per questo oggetto. |
Matrice KeyValuePairOfstringstring |
GoalIds | Elenco di ID obiettivo. | matrice long |
Id | Identificatore univoco di Microsoft Advertising della campagna. Aggiungere: Sola lettura Aggiornare: Obbligatorio |
long |
IsDealCampaign | La campagna è una campagna deal, se vera. | booleano |
Lingue | L'impostazione della lingua degli annunci determina la lingua che userai quando scrivi i tuoi annunci e dovrebbe essere la lingua dei tuoi clienti. IMPORTANTE: Se le lingue sono impostate sia a livello di gruppo di annunci che di campagna, la lingua a livello di gruppo di annunci sostituirà la lingua a livello di campagna. È possibile specificare più lingue singolarmente nell'elenco oppure includere un solo elemento di elenco impostato su Tutti se si desidera impostare come destinazione tutte le lingue. Le stringhe di lingua supportate per le campagne di ricerca e shopping sono: albanese, bulgaro, croato, ceco, danese, olandese, inglese, estone, finlandese, francese, tedesco, greco, ungherese, italiano, giapponese, lettone, lituano, maltese, norvegese, polacco, portoghese, romeno, slovacco, sloveno, spagnolo, svedese e tradizionalechinese. NOTA: Le lingue seguenti non sono ancora disponibili per tutti: bulgaro, croato, ceco, estone, greco, ungherese, giapponese, lettone, lituano, maltesi, polacco, romeno, slovacco, sloveno. Per le campagne audience è necessario includere tutte le lingue, ad esempio impostare questo elemento su Tutti. Per le campagne degli annunci di ricerca dinamica, le impostazioni della lingua della campagna e del gruppo di annunci vengono ignorate a favore del linguaggio di dominio del sito Web. Devi impostare le lingue della campagna su "Tutti" e lasciare vuota la lingua a livello di gruppo di annunci. Aggiungere: Obbligatorio per le campagne audience e in caso contrario questo elemento è facoltativo. Se non è presente alcun set di lingue della campagna, sarà necessaria la lingua di ogni gruppo di annunci all'interno della campagna. Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Dopo aver impostato le lingue della campagna, non è possibile eliminarle tutte. L'elenco di lingue specificato durante l'aggiornamento sostituisce le impostazioni precedenti, ovvero non viene aggiunto al set di lingue esistente. |
matrice di stringhe |
MultimediaAdsBidAdjustment | Importo percentuale in base al quale modificare l'offerta per gli annunci multimediali al di sopra o al di sotto del gruppo di annunci di base o dell'offerta per parole chiave | int |
Nome | Nome della campagna. Il nome deve essere univoco tra tutte le campagne attive o sospese all'interno dell'account. Il nome può contenere un massimo di 128 caratteri. Il servizio esegue un confronto senza distinzione tra maiuscole e minuscole quando confronta il nome con i nomi delle campagne esistenti. Aggiungere: Obbligatorio Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
corda |
Impostazioni | Impostazioni supportate che variano in base al tipo di campagna. Nota: VerifiedTrackingSetting non è attualmente disponibile. È possibile includere un massimo di un oggetto per tipo di impostazione nell'elenco di impostazioni, ad esempio un oggetto TargetSetting. Se CampaignType è impostato su Search e se l'elemento ExperimentId non è impostato, questo elenco può includere facoltativamente un oggetto DynamicSearchAdsSetting . Le campagne di esperimento e le campagne di base degli esperimenti non possono includere le impostazioni degli annunci di ricerca dinamica. Se intendi usare questa campagna per gli esperimenti, non includere le impostazioni degli annunci di ricerca dinamica. Se un esperimento esistente è già basato su questa campagna, non puoi aggiornare la campagna per includere le impostazioni degli annunci di ricerca dinamica. Se CampaignType è impostato su Shopping, questo elenco deve includere un oggetto ShoppingSetting . Se CampaignType è impostato su Audience, questo elenco può includere o meno un oggetto ShoppingSetting , a seconda che la campagna Audience supporti o meno gli annunci di prodotto. Se CampaignType è impostato su DynamicSearchAds, questo elenco deve includere un oggetto DynamicSearchAdsSetting . Se CampaignType è impostato su Hotel, questo elenco deve includere un oggetto HotelSetting . Se CampaignType è impostato su PerformanceMax, questo elenco deve includere un oggetto PerformanceMaxSetting . Se la campagna Performance Max è associata a un negozio, supporta anche un oggetto ShoppingSetting. TargetSetting può essere usato con qualsiasi tipo di campagna tranne Performace Max e determina se i criteri audience associati a questa campagna usano l'opzione "target and bid" o l'opzione target "solo offerta". All'interno di TargetSetting è possibile avere un oggetto TargetSettingDetail , ad esempio uno per criteriontypegroup supportato. L'unico valore del tipo di criterio attualmente supportato per l'impostazione di destinazione a livello di campagna è "Audience". L'oggetto TargetSetting non viene restituito per impostazione predefinita. Per ottenere questo oggetto, includere il valore TargetSetting nell'elemento ReturnAdditionalFields quando si chiamano le operazioni del servizio GetCampaignsByAccountId e GetCampaignsByIds . Aggiungere: Obbligatorio se CampaignType è impostato su DynamicSearchAds o Shopping e in caso contrario questo elemento è facoltativo. Se questo elemento non include un oggetto TargetSetting , l'opzione di offerta predefinita per tutti i gruppi di tipi di criteri è di fatto "solo offerta". Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Gli oggetti DynamicSearchAdsSetting e ShoppingSetting non possono essere rimossi durante l'aggiornamento. |
Impostazione della matrice |
Stato | Stato della campagna. I valori possibili sono Attivo e Sospeso. Il servizio sospenderà automaticamente la campagna se il budget è esaurito. Con le campagne di esperimento non è possibile impostare il budget, il BudgetType o lo stato Il budget e lo stato di una campagna di esperimento vengono sempre ereditati dalle impostazioni della campagna di base. Aggiungere: Opzionale. Il valore predefinito è Paused. Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
CampaignStatus |
Sottotipo | Sottotipo della campagna. Se il sottotipo non è impostato, la campagna viene creata in base al tipo di campagna. Se il sottotipo è impostato su AudienceVideoAds e il tipo di campagna è Audience, la campagna è una campagna di pubblico video. Se il sottotipo è impostato su ShoppingSmartAds, la campagna è una campagna Microsoft Smart Shopping. Se il sottotipo è impostato su ShoppingSponsoredProductAd, la campagna è una campagna di shopping Microsoft per i marchi. Aggiungere: Facoltativo e non applicabile per la maggior parte dei tipi di campagna. Per le campagne di smart shopping Microsoft è necessario impostare il sottotipo su ShoppingSmartAds. Per le campagne di acquisto Microsoft per i marchi è necessario impostare il sottotipo su ShoppingSponsoredProductAd. Aggiornare: Sola lettura |
corda |
Fuso orario |
Questa colonna è deprecata. Fuso orario in cui opera la campagna. Il fuso orario viene usato per la creazione di report e l'applicazione della data di inizio e fine di un gruppo di annunci. Per i valori possibili, vedere Fusi orari. Con le campagne di esperimento non è possibile impostare Budget, BudgetType, Status o TimeZone. Il budget, lo stato e il fuso orario di una campagna di esperimento vengono sempre ereditati dalle impostazioni della campagna di base. Aggiungere: Obbligatorio Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Non puoi aggiornare il fuso orario se la campagna contiene o ha mai contenuto gruppi di annunci nello stato Attivo o Sospeso . |
corda |
TrackingUrlTemplate | Modello di rilevamento da usare come predefinito per tutti gli URL della campagna. Le regole di convalida seguenti si applicano ai modelli di rilevamento. Per altre informazioni sui modelli e i parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare? - Modelli di rilevamento definiti per entità di livello inferiore, ad esempio gli annunci sostituiscono quelli impostati per le entità di livello superiore, ad esempio la campagna. Per altre informazioni, vedere Limiti delle entità. - La lunghezza del modello di rilevamento è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri. - Il modello di rilevamento deve essere un URL ben formato che inizia con uno dei seguenti: http://, https://, {lpurl} o {unescapedlpurl}. - Microsoft Advertising non convalida l'esistenza di parametri personalizzati. Se si usano parametri personalizzati nel modello di rilevamento e non esistono, l'URL della pagina di destinazione includerà i segnaposto chiave e valore dei parametri personalizzati senza sostituzione. Ad esempio, se il modello di rilevamento non è https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} e {_season} o {_promocode} non sono definiti a livello di campagna, gruppo di annunci, criterio, parola chiave o annuncio, l'URL della pagina di destinazione sarà lo stesso.Aggiungere: Opzionale Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata. |
corda |
UrlCustomParameters | Raccolta personalizzata di parametri chiave e valore per il rilevamento url. Microsoft Advertising accetterà i primi 8 oggetti CustomParameter inclusi nell'oggetto CustomParameters e, se si includono più di 8 parametri personalizzati, verrà restituito un errore. Ogni CustomParameter include elementi Key e Value . Aggiungere: Opzionale Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Impostare l'elemento UrlCustomParameters su null o vuoto per mantenere eventuali parametri personalizzati esistenti. Per rimuovere tutti i parametri personalizzati, impostare l'elemento Parameters dell'oggetto CustomParameters su null o vuoto. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere nell'elemento Parameters dell'oggetto CustomParameters . |
CustomParameters |
Requisiti
Servizio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
Usato da
AddCampaigns
GetCampaignsByAccountId
GetCampaignsByIds
UpdateCampaigns