Oggetto dati PromotionAdExtension - Campaign Management

Articolo
12/21/2023

Le estensioni per la promozione evidenziano le vendite speciali e le offerte nei tuoi annunci di testo. Facendo risaltare le offerte, i potenziali clienti sono più propensi a fare clic sul tuo annuncio, contribuendo a generare più vendite per te.

Puoi associare un'estensione dell'annuncio promozionale all'account o alle campagne e ai gruppi di annunci nell'account. Ogni entità (account, campagna o gruppo di annunci) può essere associata a un massimo di 20 estensioni pubblicitarie promozionali.

Nota

Le estensioni per la promozione sono disponibili per i clienti in AU, CA, DE, FR, US e Regno Unito.

Sintassi

<xs:complexType name="PromotionAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DiscountModifier" nillable="true" type="tns:PromotionDiscountModifier" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q56="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q56:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q57="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q57:ArrayOfstring" />
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="MoneyAmountOff" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="OrdersOverAmount" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="PercentOff" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="PromotionCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="PromotionEndDate" nillable="true" type="tns:Date" />
        <xs:element minOccurs="0" name="PromotionItem" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="PromotionOccasion" nillable="true" type="tns:PromotionOccasion" />
        <xs:element minOccurs="0" name="PromotionStartDate" nillable="true" type="tns:Date" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto PromotionAdExtension include gli elementi seguenti: CurrencyCode, DiscountModifier, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Language, MoneyAmountOff, OrdersOverAmount, PercentOff, PromotionCode, PromotionEndDate, PromotionItem, PromotionOccasion, PromotionStartDate, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descrizione	Tipo di dati
CurrencyCode	Codice di valuta per il prezzo o lo sconto della promozione. Questo campo è applicabile solo se si imposta MoneyAmountOff o OrdersOverAmount. I codici di valuta supportati sono ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD e VEF. Aggiungere: Obbligatorio se vengono impostati MoneyAmountOff o OrdersOverAmount . Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta PercentOff o PromotionCode, questa impostazione non è più applicabile e verrà eliminata.	Stringa
DiscountModifier	Modificatore sconto promozione. Si supponga, ad esempio, che il modificatore sconto sia impostato su UpTo. Quindi, se lo sconto promozionale non modificato sarebbe "$20 off shoes", la promozione modificata è "Fino a $20 off scarpe". Aggiungere: Opzionale. Se non si specifica questo elemento o lo si lascia vuoto, verrà impostato il valore predefinito None . Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.	PromotionDiscountModifier
FinalAppUrls	Parametro riservato per utilizzi futuri.	Matrice AppUrl
FinalMobileUrls	URL della pagina di destinazione per i dispositivi mobili. Le regole di convalida seguenti si applicano agli URL finali e agli URL finali per dispositivi mobili. - La lunghezza dell'URL è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri. - È possibile specificare fino a 10 voci di elenco sia per FinalUrls che per FinalMobileUrls; tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 elementi di elenco per una potenziale compatibilità con il forward. - L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}. - Gli URL finali devono essere ognuno un URL ben formato che inizia con http:// o https://. - Se si specifica FinalMobileUrls, è necessario specificare anche FinalUrls. Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su un elenco vuoto, l'impostazione precedente verrà eliminata.	matrice di stringhe
FinalUrls	URL della pagina di destinazione. Le regole di convalida seguenti si applicano agli URL finali e agli URL finali per dispositivi mobili. - La lunghezza dell'URL è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri. - È possibile specificare fino a 10 voci di elenco sia per FinalUrls che per FinalMobileUrls; tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 elementi di elenco per una potenziale compatibilità con il forward. - L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}. - Gli URL finali devono essere ognuno un URL ben formato che inizia con http:// o https://. - Se si specifica FinalMobileUrls, è necessario specificare anche FinalUrls. Aggiungere: Obbligatorio Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.	matrice di stringhe
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. Questa funzionalità è disponibile solo per i clienti nel progetto pilota Final URL Suffix Phase 3 (GetCustomerPilotFeatures restituisce 636). Se non si è nel progetto pilota, questa proprietà verrà ignorata e non verrà restituito alcun errore. Aggiungere: Opzionale Aggiornamento: 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.	Stringa
Lingua	Lingua in cui verrà servita l'estensione dell'annuncio. L'estensione verrà sempre fornita in questa lingua, indipendentemente dalle impostazioni della lingua della campagna o del gruppo di annunci. Le stringhe di lingua supportate sono: danese, olandese, inglese, finlandese, francese, tedesco, italiano, norvegese, portoghese, spagnolo, svedese e tradizionaleChinese. Aggiungere: Obbligatorio Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.	Stringa
MoneyAmountOff	Il denaro fuori valore di promozione. Ad esempio, per alzare di livello "$20 off shoes - On orders over $100", impostare PromotionItem su "shoes", impostare CurrencyCode su "USD", impostare MoneyAmountOff su 20 e ordersOverAmount su 100. Aggiungere: Obbligatorio. È necessario impostare MoneyAmountOff o PercentOff, ma non è possibile impostare entrambi. Aggiornamento: Opzionale. È possibile impostare MoneyAmountOff o PercentOff, ma non è possibile impostare entrambi.	Doppia
OrdersOverAmount	Ordini rispetto al valore dell'importo accodati alla destinazione di promozione. Ad esempio, per alzare di livello "$20 off shoes - On orders over $100", impostare PromotionItem su "shoes", impostare CurrencyCode su "USD", impostare MoneyAmountOff su 20 e ordersOverAmount su 100. Aggiungere: Opzionale. Non è possibile impostare sia OrdersOverAmount che PromotionCode. Aggiornamento: Opzionale. Non è possibile impostare sia OrdersOverAmount che PromotionCode. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su '0' (zero), l'impostazione precedente verrà eliminata.	Doppia
PercentOff	Percentuale di off promotion value.The percent off promotion value. Ad esempio, 10,0 rappresenta uno sconto del 10%. Aggiungere: Obbligatorio. È necessario impostare MoneyAmountOff o PercentOff, ma non è possibile impostare entrambi. Aggiornamento: Opzionale. È possibile impostare MoneyAmountOff o PercentOff, ma non è possibile impostare entrambi. Se si imposta questa proprietà, l'impostazione CurrencyCode non è più applicabile e verrà eliminata se è stata impostata in precedenza.	Doppia
PromotionCode	Codice di promozione aggiunto alla destinazione di promozione. Ad esempio, per alzare di livello "$20 off shoes - Promocode SAVE20", impostare PromotionItem su "shoes", impostare CurrencyCode su "USD", impostare MoneyAmountOff su 20 e promotionCode su "SAVE20". La stringa può contenere un massimo di 15 caratteri. Aggiungere: Opzionale. Non è possibile impostare sia OrdersOverAmount che PromotionCode. Aggiornamento: Opzionale. Non è possibile impostare sia OrdersOverAmount che PromotionCode. 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. Se si imposta questa proprietà, l'impostazione CurrencyCode non è più applicabile e verrà eliminata se è stata impostata in precedenza.	Stringa
PromotionEndDate	La data di fine consente di informare la data di promozione o le date che verranno visualizzate nell'annuncio. Ad esempio, se le date PromotionStartDate e PromotionEndDate sono entrambe impostate sul 14 febbraio, il testo "Valido 14 febbraio" potrebbe essere incluso nell'innalzamento di livello visualizzato. La data PromotionStartDate deve essere precedente o uguale alla data PromotionEndDate . Questa proprietà non sostituisce l'intervallo di recapito intrinseco per una promozione. Sia la promozione PromotionOccasion che la pianificazione determinano quando la promozione è idonea per essere visualizzata negli annunci. Se la data di fine è già passata per l'anno corrente, è necessario impostare ogni data di inizio e fine per le date dell'anno successivo. Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per eliminare la data di fine corrente e impostare in modo efficace nessuna data di fine, impostare Giorno, Mese e Anno su "0" (zero). Quando recuperi l'estensione dell'annuncio promozionale la prossima volta, questo elemento non verrà impostato.	Data
PromotionItem	Destinazione o elemento di promozione. Ad esempio, è possibile eseguire una promozione per "scarpe" con uno sconto di $20 o 20%. Per eseguire una promozione per "Fino a $ 20 off shoes", impostare PromotionItem su "shoes", impostare DiscountModifier su UpTo, impostare CurrencyCode su "USD" e impostare MoneyAmountOff su 20. La stringa può contenere un massimo di 20 caratteri. Aggiungere: Obbligatorio Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.	Stringa
PromotionOccasion	L'occasione di promozione. Sia gli elementi PromotionOccasion che Scheduling determinano quando la promozione è idonea per essere visualizzata negli annunci. La PromotionOccasion determina il periodo di tempo o la stagionalità, ad esempio WomensDay dal 15 febbraio al 31 marzo di ogni anno. La promozione verrà eseguita solo entro le date corrispondenti all'occasione impostata. Per informazioni dettagliate sull'intervallo di date definito per ogni occasione, vedere PromotionOccasion . La pianificazione può limitare la promozione a un intervallo di tempo più breve entro l'intervallo di date dell'occasione, ad esempio limitare la promozione dal 20 febbraio all'8 marzo. La pianificazione può essere usata anche per eseguire la stessa promozione per più anni, ad esempio, eseguire la promozione WomensDay ogni anno dal 15 febbraio al 31 marzo. Aggiungere: Opzionale. Se non si specifica questo elemento o lo si lascia vuoto, verrà impostato il valore predefinito None . Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento, anche PromotionStartDate e PromotionEndDate devono essere impostati per mantenere o aggiornare le impostazioni precedenti.	PromotionOccasion
PromotionStartDate	La data di inizio consente di informare la data di promozione o le date che verranno visualizzate nell'annuncio. Ad esempio, se le date PromotionStartDate e PromotionEndDate sono entrambe impostate sul 14 febbraio, il testo "Valido 14 febbraio" potrebbe essere incluso nell'innalzamento di livello visualizzato. La data PromotionStartDate deve essere precedente o uguale alla data PromotionEndDate . Questa proprietà non sostituisce l'intervallo di recapito intrinseco per una promozione. Sia la promozione PromotionOccasion che la pianificazione determinano quando la promozione è idonea per essere visualizzata negli annunci. Se la data di fine è già passata per l'anno corrente, è necessario impostare ogni data di inizio e fine per le date dell'anno successivo. Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per eliminare la data di fine corrente e impostare in modo efficace nessuna data di fine, impostare Giorno, Mese e Anno su "0" (zero). Quando recuperi l'estensione dell'annuncio promozionale la prossima volta, questo elemento non verrà impostato.	Data
TrackingUrlTemplate	Modello di rilevamento da usare come impostazione predefinita per tutti gli FinalUrl e FinalMobileUrls. 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 Aggiornamento: 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.	Stringa
UrlCustomParameters	Raccolta personalizzata di parametri chiave e valore per il rilevamento url. Microsoft Advertising accetterà i primi 3 oggetti CustomParameter inclusi nell'oggetto CustomParameters e tutti i parametri personalizzati aggiuntivi verranno ignorati. Ogni CustomParameter include elementi Key e Value . Per i clienti del progetto pilota Custom Parameters Limit Increase Phase 3 (GetCustomerPilotFeatures restituisce 635), Microsoft Advertising accetterà le prime 8 coppie di parametri personalizzati e valore incluse e, se si includono più di 8 parametri personalizzati, verrà restituito un errore. Aggiungere: Opzionale Aggiornamento: 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

L'oggetto PromotionAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

L'oggetto PromotionAdExtension deriva dall'oggetto AdExtension ed eredita gli elementi seguenti: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Le descrizioni seguenti sono specifiche di PromotionAdExtension e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto AdExtension .

Elemento	Descrizione	Tipo di dati
DevicePreference	Non supportato per questo tipo di estensione dell'annuncio.	long
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. Attualmente non sono presenti modifiche di compatibilità per l'oggetto AdExtension . Aggiungere: Sola lettura Aggiornamento: Sola lettura	Matrice KeyValuePairOfstringstring
Id	Identificatore univoco di Microsoft Advertising dell'estensione dell'annuncio. Aggiungere: Sola lettura Aggiornamento: Sola lettura e Obbligatorio	long
Pianificazione	Determina il giorno e gli intervalli di tempo del calendario quando l'estensione dell'annuncio è idonea per essere visualizzata negli annunci. Aggiungere: Opzionale Aggiornamento: Opzionale. Se imposti questo elemento null, qualsiasi set di pianificazione esistente per l'estensione dell'annuncio rimarrà invariato. Se imposti questo valore su qualsiasi oggetto Schedule non Null, sostituisci in modo efficace le impostazioni di pianificazione esistenti per l'estensione dell'annuncio. Per rimuovere tutta la pianificazione, impostare questo elemento su un oggetto Schedule vuoto.	Schedule
Stato	Stato dell'estensione dell'annuncio. Il valore sarà sempre attivo perché il servizio Campaign Management non restituisce le estensioni pubblicitarie eliminate. Aggiungere: Sola lettura Aggiornamento: Sola lettura	AdExtensionStatus
Digitare	Tipo di estensione dell'annuncio. Questo valore è PromotionAdExtension quando recuperi un'estensione dell'annuncio promozionale. Aggiungere: Sola lettura Aggiornamento: Sola lettura Per altre informazioni sui tipi di estensione degli annunci, vedi le osservazioni sull'oggetto dati dell'estensione per gli annunci.	Stringa
Versione	Tiene traccia del numero di volte in cui l'estensione dell'annuncio è stata aggiornata. La versione è impostata su 1 quando viene creata l'estensione dell'annuncio e viene incrementato di uno dopo ogni aggiornamento. Aggiungere: Non consentito Aggiornamento: Non consentito	int

Requisiti

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

Condividi tramite