Condividi tramite

Oggetto dati ImageAdExtension - Campaign Management

  • Articolo

Definisce un'estensione pubblicitaria che specifica un'immagine con testo alternativo da includere in un annuncio di testo espanso.

Puoi associare un'estensione dell'annuncio immagine all'account o alle campagne e ai gruppi di annunci nell'account. Per ogni account, solo 1.000 campagne e 1.000 gruppi di annunci possono essere associati alle estensioni degli annunci immagine. Ogni entità (account, campagna o gruppo di annunci) può essere associata a un massimo di 6 estensioni di annunci immagine.

Sintassi

<xs:complexType name="ImageAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="AlternativeText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Description" 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: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="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q43="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q43:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q44="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q44:ArrayOfstring" />
        <xs:element xmlns:q45="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImageMediaIds" nillable="true" type="q45:ArrayOflong" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element xmlns:q46="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Layouts" nillable="true" type="q46:ArrayOfstring">
          <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="SourceType" nillable="true" type="xs:string">
          <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="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 ImageAdExtension include gli elementi seguenti: AlternativeText, Description, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ImageMediaIds, Images, Layouts, SourceType, TrackingUrlTemplate, UrlCustomParameters.

Elemento Descrizione Tipo di dati
AlternativeText Descrizione alternativa del supporto dell'immagine per l'usabilità. Se non è possibile visualizzare l'immagine, viene usato il testo alternativo.

La lunghezza massima per questo elemento è di 35 caratteri.

Aggiungere: Obbligatorio
Aggiornare: Obbligatorio		 corda
Descrizione Descrizione che può essere usata dall'inserzionista, dall'agenzia o dall'account manager per tenere traccia, etichettare o gestire i supporti immagine.

Questa descrizione non viene visualizzata con l'annuncio o l'immagine.

La lunghezza massima per questo elemento è di 100 caratteri.

Aggiungere: Opzionale
Aggiornare: Opzionale. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.		 corda
DestinationUrl URL della pagina Web a cui consentire all'utente di fare clic sull'immagine.

L'URL può contenere stringhe di testo dinamico, ad esempio {parola chiave}. Per altre informazioni, vedere 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.

Se l'URL non è specificato per l'estensione dell'annuncio immagine, viene usato l'URL dell'annuncio.

Aggiungere: Opzionale
Aggiornare: Opzionale. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.		 corda
DisplayText Testo visualizzato dell'estensione dell'immagine.

La lunghezza massima per questo elemento è di 35 caratteri.

Aggiungere: Obbligatorio quando i layout contengono SearchMultiple, altrimenti Facoltativo.
Aggiornare: Obbligatorio quando i layout contengono SearchMultiple, altrimenti Facoltativo. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.		 corda
FinalAppUrls Per uso futuro. 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
Aggiornare: 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: Opzionale
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.		 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
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.		 corda
ImageMediaIds Identificatori delle immagini da includere nell'annuncio. Non è possibile specificare identificatori multimediali per più immagini delle stesse proporzioni. In altre parole, ognuna delle immagini a cui si fa riferimento deve avere proporzioni diverse.

È possibile specificare fino a quattro (4) identificatori multimediali dell'immagine. Anche se il valore minimo richiesto è un ID multimediale dell'immagine, per qualificarti per tutti i posizionamenti degli annunci devi fornire quattro identificatori di supporti immagine, dove ogni ID corrisponde a un'immagine di uno dei quattro tipi di contenuti multimediali supportati (proporzioni). Le proporzioni supportate per gli annunci del pubblico sono 16:9, 1.5:1, 4:3 e 1.2:1. Per altre informazioni, vedere la documentazione di riferimento dell'oggetto dati Image .

È possibile ottenere l'identificatore di ogni immagine quando le si aggiunge alla libreria di immagini chiamando l'operazione AddMedia . In caso contrario, dopo aver aggiunto il supporto alla libreria di immagini, è possibile ottenere gli identificatori multimediali con l'operazione GetMediaMetaDataByAccountId .

Aggiungere: Obbligatorio
Aggiornare: Obbligatorio		 matrice long
Immagini Gli asset di immagine con dimensioni e proporzioni diverse consentono di visualizzare in modo flessibile diversi editori e posizionamenti.

Includere uno o più oggetti AssetLink che contengono ognuno un oggetto ImageAsset con sottotipo e impostazioni di ritaglio che corrispondono alle proporzioni desiderate.

Aggiungere: Obbligatorio
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si includono immagini durante l'aggiornamento, tutte le immagini impostate in precedenza verranno sostituite.		 Matrice AssetLink
Layout Elenco dei layout di immagine idonei.

I valori supportati sono SearchSingle e SearchMultiple. È possibile aggiungere nuovi layout in futuro, quindi non è consigliabile assumere alcuna dipendenza da un set fisso di valori.

Aggiungere: Obbligatorio
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si includono layout durante l'aggiornamento, tutti i layout impostati in precedenza verranno sostituiti.		 matrice di stringhe
SourceType Specifica il tipo di origine. corda
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
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.		 corda
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
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, l'impostazione precedente viene rimossa.		 CustomParameters

L'oggetto ImageAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

L'oggetto ImageAdExtension deriva dall'oggetto AdExtension ed eredita gli elementi seguenti: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Le descrizioni seguenti sono specifiche di ImageAdExtension 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
Aggiornare: Sola lettura		 Matrice KeyValuePairOfstringstring
Id Identificatore univoco di Microsoft Advertising dell'estensione dell'annuncio.

Aggiungere: Sola lettura
Aggiornare: 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
Aggiornare: 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
Aggiornare: Sola lettura		 AdExtensionStatus
Tipo Tipo di estensione dell'annuncio. Questo valore è ImageAdExtension quando recuperi un'estensione dell'annuncio immagine.

Aggiungere: Sola lettura
Aggiornare: Sola lettura

Per altre informazioni sui tipi di estensione degli annunci, vedi le osservazioni sull'oggetto dati dell'estensione per gli annunci.		 corda
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
Aggiornare: Non consentito		 int

Requisiti

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