Oggetto dati SitelinkAdExtension - Campaign Management

Definisce un oggetto con un sitelink per ogni estensione dell'annuncio. Puoi usare il sitelink per promuovere determinati prodotti, servizi o sezioni del tuo sito Web e portare i potenziali clienti esattamente alle informazioni che stavano cercando. Ciò può aumentare sia la frequenza di clic che le conversioni.

Puoi associare un'estensione pubblicitaria sitelink 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 sitelink.

Sintassi

<xs:complexType name="SitelinkAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Description1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Description2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q49="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q49:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q50="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q50:ArrayOfstring" />
        <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 SitelinkAdExtension include gli elementi seguenti: Description1, Description2, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descrizione	Tipo di dati
Descrizione1	Riga 1 della descrizione del collegamento al sito. La lunghezza massima di input è di 35 caratteri. Se sono inclusi caratteri cinesi tradizionali, il limite è di 15 caratteri. Ogni carattere cinese tradizionale conta come due caratteri e ogni carattere inglese verrà conteggiato solo come un carattere. Se si specifica Description1 , è necessario Description2 . Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.	Stringa
Descrizione2	Riga 2 della descrizione del collegamento al sito. La lunghezza massima di input è di 35 caratteri. Se sono inclusi caratteri cinesi tradizionali, il limite è di 15 caratteri. Ogni carattere cinese tradizionale conta come due caratteri e ogni carattere inglese verrà conteggiato solo come un carattere. Se si specifica Description2 , è necessario Description1 . 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
DestinationUrl	URL della pagina Web a cui vengono assegnati gli utenti quando fanno clic sul collegamento al sito. Importante: Se attualmente si usano gli URL di destinazione, è necessario sostituirli con URL finali. Per altre informazioni, vedere Rilevamento url con URL aggiornati. L'URL può contenere parametri dinamici, ad esempio {MatchType}. Per un elenco dei parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?. L'URL può contenere un massimo di 1.024 caratteri. Se l'URL non specifica un protocollo, il sistema usa il protocollo HTTP quando un utente fa clic sull'annuncio. Se l'URL specifica il protocollo HTTP quando si aggiunge un annuncio, il servizio rimuoverà la stringa del protocollo http:// (la stringa del protocollo HTTP non viene conteggiata rispetto al limite di 1.024 caratteri); tuttavia, il servizio non rimuoverà una stringa di protocollo HTTPS (https://) dall'URL. Aggiungere: Non consentito. L'URL di destinazione è deprecato ed è invece necessario impostare l'elemento FinalUrls . Aggiornamento: Opzionale. L'URL di destinazione è deprecato ed è invece necessario impostare l'elemento FinalUrls . È possibile lasciare vuoto questo elemento o impostarlo su una stringa vuota.	Stringa
Displaytext	Testo del collegamento al sito visualizzato nell'annuncio. Se si specifica Description1 o Description2, il testo visualizzato può contenere un massimo di 25 caratteri; in caso contrario, il testo visualizzato può contenere un massimo di 35 caratteri. Se sono inclusi caratteri cinesi tradizionali, i limiti sono 11 caratteri specificati Description1 o Description2 e 15 caratteri in caso contrario. Ogni carattere cinese tradizionale conta come due caratteri e ogni carattere inglese verrà conteggiato solo come un carattere. Aggiungere: Obbligatorio Aggiornamento: Obbligatorio	Stringa
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. - Non è possibile specificare FinalMobileUrls se DevicePreference è impostato su 30001 (mobile). Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.	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. - Non è possibile specificare FinalMobileUrls se DevicePreference è impostato su 30001 (mobile). Aggiungere: Obbligatorio Aggiornamento: Obbligatorio	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, l'impostazione precedente viene rimossa.	Stringa
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, l'impostazione precedente viene rimossa.	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, l'impostazione precedente viene rimossa.	CustomParameters

L'oggetto SitelinkAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

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

Elemento	Descrizione	Tipo di dati
DevicePreference	Questo elemento determina se la preferenza è che l'estensione dell'annuncio venga visualizzata nei dispositivi mobili o in tutti i dispositivi. Per specificare una preferenza per i dispositivi mobili, impostare questo elemento su 30001. Per specificare tutti i dispositivi, impostare questo elemento su 0 (zero) o lasciare l'elemento nil. Per impostazione predefinita, questo elemento sarà nil. Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.	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 è SitelinkAdExtension quando si recupera un'estensione pubblicitaria sitelink. 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