Oggetto dati ResponsiveAd - Campaign Management
Un formato di annunci reattivo per gli annunci del pubblico e gli annunci multimediali.
L'oggetto ResponsiveAd viene usato sia per gli annunci multimediali nella rete di ricerca che per gli annunci audience in Microsoft Audience Network. Per informazioni dettagliate sui principali differenziatori, vedere la sezione osservazioni seguente.
Nota
Gli annunci reattivi duplicati sono consentiti nello stesso gruppo di annunci.
Sintassi
<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Ad">
<xs:sequence>
<xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
<xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
<xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4: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="LongHeadline" nillable="true" type="tns:AssetLink" />
<xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="LongHeadlines" 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 minOccurs="0" name="Text" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
<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="Videos" 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:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Elementi
L'oggetto ResponsiveAd include gli elementi seguenti: BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headline, Headlines, Images, ImpressionTrackingUrls, LongHeadline, LongHeadlines, LongHeadlineString, Text, VerifiedTrackingSettings, Videos.
| Elemento | Descrizione | Tipo di dati |
|---|---|---|
| BusinessName | Nome dell'azienda. Il nome dell'azienda può essere visualizzato nell'annuncio, a seconda del posizionamento dell'annuncio. La lunghezza della stringa è limitata a 25 caratteri. Aggiungere: Obbligatorio Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
Stringa |
| CallToAction | Un breve e incisivio motivo per i clienti di fare clic sul tuo annuncio in questo momento. Viene visualizzato nel pulsante di chiamata all'azione. Aggiungere: Non applicabile per gli annunci del pubblico; Obbligatorio per gli annunci multimediali Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
CallToAction |
| CallToActionLanguage | Lingua in cui verrà servita la chiamata all'azione. L'invito all'azione verrà sempre fornito in questa lingua, indipendentemente dalle impostazioni della lingua della campagna. Aggiungere: Non applicabile per gli annunci del pubblico; Obbligatorio per gli annunci multimediali Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
LanguageName |
| Descrizioni | Le descrizioni visualizzate sotto il percorso nell'annuncio. Per ottimizzare le impressioni in tutti i formati degli annunci, le descrizioni potrebbero non essere sempre visualizzate nell'annuncio. Per ottimizzare le impressioni in tutti i formati degli annunci, le descrizioni potrebbero non essere sempre visualizzate nell'annuncio. A meno che non si apporti una delle descrizioni a una posizione specifica, Bing ottimizzi dinamicamente il layout degli annunci con i titoli e le descrizioni migliori per la query di ricerca dell'utente. Dal punto di vista del modello di dati, le desriptions e i titoli vengono archiviati come asset di testo, ad esempio un TextAsset per AssetLink. Lo stesso asset può essere usato da più annunci. Ad esempio, se "Seamless Integration" è un asset di testo, avrà lo stesso identificatore di asset in tutti gli annunci nello stesso account Microsoft Advertising. È necessario impostare tra 1 e 5 descrizioni. Il testo di ogni descrizione deve contenere almeno una parola. Per un uso efficiente delle risorse, è consigliabile usare stringhe di testo dinamico come {keyword} invece di creare una nuova copia pubblicitaria per ogni parola chiave. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico. La lunghezza massima di input del testo di ogni descrizione è di 1.000 caratteri, incluse le stringhe di testo dinamiche, e di questi 1.000 non sono consentiti più di 90 caratteri finali dopo la sostituzione. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 90 caratteri dopo la sostituzione dinamica del testo. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 500 caratteri, incluse le stringhe di testo dinamiche, e di questi 500 non sono consentiti più di 45 caratteri finali dopo la sostituzione. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 45 caratteri dopo la sostituzione dinamica del testo. I caratteri a larghezza doppia sono determinati dai caratteri usati anziché dal set di caratteri delle impostazioni della lingua della campagna o del gruppo di annunci. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji. Il testo non può contenere il carattere di nuova riga (\n). Aggiungere: Obbligatorio per gli annunci multimediali e gli annunci del pubblico. Non applicabile per gli annunci video. Aggiornamento: Opzionale. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare l'elemento nil. Se imposti questo elemento, tutte le descrizioni precedentemente collegate a questo annuncio verranno sostituite. |
Matrice AssetLink |
| Titolo | I titoli sono il testo più importante che appare nel tuo annuncio, quindi dovresti sfruttare al meglio i caratteri disponibili. Sono necessari più titoli in modo che l'annuncio possa essere visualizzato in modo flessibile tra diversi editori e posizionamenti. La lunghezza della stringa è limitata a 30 caratteri. Aggiungere: Obbligatorio per gli annunci video. Non applicabile per gli annunci multimediali e gli annunci del pubblico. Aggiornamento: Opzionale. Deprecato per gli annunci multimediali e di pubblico. Usare invece i titoli. |
Stringa |
| Titoli | I titoli sono il testo più importante che appare nel tuo annuncio, quindi dovresti sfruttare al meglio i caratteri disponibili. Sono necessari più titoli in modo che l'annuncio possa essere visualizzato in modo flessibile tra diversi editori e posizionamenti. A meno che non si apporti uno dei titoli a una posizione specifica, Bing ottimizzi dinamicamente il layout degli annunci con i titoli e le descrizioni migliori per la query di ricerca dell'utente. Dal punto di vista del modello di dati, le desriptions e i titoli vengono archiviati come asset di testo, ad esempio un TextAsset per AssetLink. Lo stesso asset può essere usato da più annunci. Ad esempio, se "Seamless Integration" è un asset di testo, avrà lo stesso identificatore di asset in tutti gli annunci nello stesso account Microsoft Advertising. È necessario impostare tra 1 e 15 titoli. Il testo di ogni titolo deve contenere almeno una parola. Per un uso efficiente delle risorse, è consigliabile usare stringhe di testo dinamico come {keyword} invece di creare una nuova copia pubblicitaria per ogni parola chiave. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico. La lunghezza massima di input del testo di ogni titolo è di 1.000 caratteri, incluse le stringhe di testo dinamiche, e di questi 1.000 non sono consentiti più di 30 caratteri finali dopo la sostituzione. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 30 caratteri dopo la sostituzione dinamica del testo. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 500 caratteri, incluse le stringhe di testo dinamiche, e di questi 500 non sono consentiti più di 15 caratteri finali dopo la sostituzione. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 15 caratteri dopo la sostituzione dinamica del testo. I caratteri a larghezza doppia sono determinati dai caratteri usati anziché dal set di caratteri delle impostazioni della lingua della campagna o del gruppo di annunci. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji. Il testo non può contenere il carattere di nuova riga (\n). Aggiungere: Obbligatorio per gli annunci multimediali e gli annunci del pubblico. Non applicabile per gli annunci video. Aggiornamento: Opzionale. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare l'elemento nil. Se imposti questo elemento, tutti i titoli precedentemente collegati a questo annuncio verranno sostituiti. |
Matrice AssetLink |
| 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. Per altre informazioni, vedere le osservazioni seguenti. Aggiungere: Obbligatorio Aggiornamento: 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 |
| ImpressionTrackingUrls | URL per i pixel di rilevamento delle impressioni 1x1. Ogni pixel segnalerà le impressioni di Microsoft Audience Network al tuo strumento di creazione di report pubblicitari di terze parti. Puoi includere fino a 2 URL di rilevamento delle impressioni per ogni annuncio reattivo. Ogni URL deve essere accessibile. 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. Per ogni impressione di Microsoft Audience Network, Microsoft eseguirà il ping dell'URL per abilitare il rilevamento delle impressioni nello strumento di creazione di report pubblicitari di terze parti. Il rilevamento utenti di livello avanzato, ad esempio il rilevamento o il rilevamento delle conversioni in base ai cookie o agli indirizzi IP, non è supportato. Questo elemento non viene restituito per impostazione predefinita. Per ottenere questo elemento, includere il valore ImpressionTrackingUrls nell'elemento ReturnAdditionalFields quando si chiamano le operazioni del servizio GetAdsByAdGroupId, GetAdsByEditorialStatus e GetAdsByIds . Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per rimuovere gli URL di rilevamento impressioni, impostare questo elemento su una matrice di stringhe vuota. |
matrice di stringhe |
| LongHeadline | Per le campagne Audience, LongHeadline è il più lungo di due possibili titoli di annunci reattivi. | AssetLink |
| LongHeadlines | È necessario impostare un valore compreso tra 1 e 5 titoli lunghi. Il testo di ogni titolo deve contenere almeno una parola. Il testo non può contenere il carattere di nuova riga (\n). Se la campagna padre viene associata a un archivio e si specificaNoti LongHeadlines, è necessario specificare anche Titoli, Descrizioni e Immagini. Aggiungi: facoltativo se la campagna padre viene associata a un archivio, obbligatorio se la campagna padre non è associata a un archivio. Userà LongHeadlineString se vuoto. Aggiornamento: facoltativo. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare l'elemento nil. Se si imposta un valore per questo elemento, tutti i titoli collegati in precedenza a questo gruppo di asset verranno sostituiti. Se la campagna padre viene associata a un archivio e si imposta questo elemento su un elenco vuoto, l'impostazione precedente verrà eliminata. |
Matrice AssetLink |
| LongHeadlineString | I titoli sono il testo più importante che appare nel tuo annuncio, quindi dovresti sfruttare al meglio i caratteri disponibili. Sono necessari più titoli in modo che l'annuncio possa essere visualizzato in modo flessibile tra diversi editori e posizionamenti. La lunghezza della stringa è limitata a 90 caratteri. Aggiungere: Opzionale. Ignorato quando vengono fornite le linee longhead . Se LongHeadlines è vuoto, verrà compilato LongHeadlines con LongHeadlineString. Non applicabile per gli annunci multimediali. Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
Stringa |
| Testo | Questo testo verrà visualizzato sotto o adiacente al titolo lungo o breve dell'annuncio, a seconda del posizionamento dell'annuncio. Hai più spazio per i caratteri da usare nel testo dell'annuncio che nel titolo. Quindi, una volta che le immagini e il titolo hanno un potenziale attenzione del cliente, il testo dell'annuncio deve convincerli a fare clic su di esso. Cosa distingue il prodotto o il servizio? Il testo deve contenere almeno una parola. La lunghezza della stringa è limitata a 90 caratteri. Il testo non può contenere il carattere di nuova riga (\n). Aggiungere: Obbligatorio per gli annunci video. Non applicabile per gli annunci multimediali e gli annunci del pubblico. Aggiornamento: Facoltativo per gli annunci video. Usa le descrizioni invece per gli annunci del pubblico o gli annunci multimediali (deprecati). |
Stringa |
| VerifiedTrackingSettings | VerifiedTrackingSetting mette in relazione le impostazioni di misurazione di terze parti. In questo modo è possibile tenere traccia della visibilità, della sicurezza del marchio e delle metriche del traffico non valide tramite un provider di verifica di terze parti, ad esempio Integral Ad Science. Questa funzionalità è disponibile per gli annunci video nativi, visualizzati e online usando la strategia di offerta CPM. Nota: attualmente, IAS è l'unico fornitore supportato (vendorName), ma gli altri provider di verifica saranno presto disponibili. L'esempio seguente riguarda IAS. Sono disponibili 3 coppie chiave-valore per IAS:
|
VerifiedTrackingSetting |
| Video | Gli asset video 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 VideoAsset con un sottotipo. Aggiungere: Obbligatorio per gli annunci video Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si includono video durante un aggiornamento, tutti i video impostati in precedenza verranno sostituiti. |
Matrice AssetLink |
L'oggetto ResponsiveAd include elementi ereditati.
Elementi ereditati
Elementi ereditati da Ad
L'oggetto ResponsiveAd deriva dall'oggetto Ad ed eredita gli elementi seguenti: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Le descrizioni seguenti sono specifiche di ResponsiveAd e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto Ad .
| Elemento | Descrizione | Tipo di dati |
|---|---|---|
| AdFormatPreference | Non supportato per questo tipo di annuncio. | Stringa |
| DevicePreference | Non supportato per questo tipo di annuncio. | long |
| EditorialStatus | Lo stato di revisione editoriale dell'annuncio, che indica se l'annuncio è in sospeso, è stato approvato o non è stato approvato. Aggiungere: Sola lettura Aggiornamento: Sola lettura |
AdEditorialStatus |
| FinalAppUrls | Non supportato per questo tipo di annuncio. | Matrice AppUrl |
| FinalMobileUrls | URL della pagina di destinazione per 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 elementi 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 per una potenziale compatibilità in avanti. - 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 la preferenza del dispositivo è impostata su mobile. Questo URL viene usato solo se la parola chiave non specifica un URL per dispositivi mobili finale. 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. La parte di dominio dell'URL in combinazione con le stringhe path 1 e path 2 non può superare i 67 caratteri. 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 elementi 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 per una potenziale compatibilità in avanti. - 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 la preferenza del dispositivo è impostata su mobile. Si noti anche che se l'elemento TrackingUrlTemplate o UrlCustomParameters di questo annuncio è impostato, è necessario almeno un URL finale. Questo URL viene usato solo se la parola chiave non specifica un URL finale. Aggiungere: Obbligatorio Aggiornamento: Opzionale |
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. 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 |
| 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 |
| Id | Identificatore univoco di Microsoft Advertising dell'annuncio. Aggiungere: Sola lettura Aggiornamento: Obbligatorio e Read-Only |
long |
| Stato | Stato dell'annuncio. Puoi impostare lo stato dell'annuncio su Attivo o In pausa. Aggiungere: Opzionale Aggiornamento: Opzionale |
Adstatus |
| TrackingUrlTemplate | Modello di rilevamento da usare come impostazione predefinita per tutti gli URL della pagina di destinazione. 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 |
| Tipo | Tipo di annuncio. Questo valore è ResponsiveAd quando recuperi un annuncio reattivo. Per altre informazioni sui tipi di annunci, vedi Le osservazioni sull'oggetto ad data. Aggiungere: Sola lettura Aggiornamento: Sola lettura |
AdType |
| 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 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 |
Osservazioni
L'oggetto ResponsiveAd viene usato per gli annunci multimediali nella rete di ricerca e per gli annunci audience in Microsoft Audience Network.
La maggior parte delle proprietà supportate è la stessa, ma di seguito sono riportati alcuni dei principali fattori di differenziazione.
- Per gli annunci del pubblico imposterai BusinessName, Headlines, Images, ImpressionTrackingUrls, LongHeadlines e Descriptions.
- Per gli annunci multimediali si imposteranno BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headlines, Images e LongHeadlines.
Nota
Il provisioning dei dati per Le immagini viene eseguito tramite l'operazione AddMedia . È possibile usare i tipi MIME GIF, JPEG o PNG. Le immagini con animazione non sono supportate. Anche se è possibile aggiungere elementi multimediali solo con alcune proporzioni tramite l'operazione AddMedia , è possibile usare le impostazioni di ritaglio ImageAsset per determinare le proporzioni effettive nel contesto di ogni assetlink ad reattivo. Le proporzioni dell'immagine archiviata rimangono invariate nella libreria multimediale a livello di account.
La dimensione massima del file è di 5 MB. La larghezza e l'altezza massime in pixel sono 2592 e 2048 in modo indipendente ed è comunque necessario mantenere una delle proporzioni supportate. Ad esempio, se l'asset immagine con sottotipo LandscapeImageMedia ha una larghezza di 2592, l'altezza deve essere 1357.
Immagini di annunci multimediali
Per gli annunci multimediali si creeranno più asset di immagini con dimensioni e proporzioni diverse. È necessario aggiungere almeno 1 immagine con proporzioni 1,91:1 e 1 immagine con proporzioni 1:1.
Nell'elemento Images includere uno o più oggetti AssetLink . Ogni collegamento di asset contiene un elemento ImageAsset con SubType impostato su uno dei valori stringa nella tabella seguente.
| Sottotipo | Proporzioni | Dimensioni minime in pixel |
|---|---|---|
| LandscapeImageMedia | 1.91:1 | 703 larghezza x 368 altezza |
| ImageMedia4x1 | 4:1 | 608 larghezza x 152 altezza |
| SquareImageMedia | 1:1 | 470 larghezza x 470 altezza |
| ImageMedia1x2 | 1:2 | 470 larghezza x 940 altezza |
Logo degli annunci multimediali
Per gli annunci multimediali si creeranno più asset di logo con dimensioni, proporzioni e impostazioni di ritaglio diverse, in modo che possano essere visualizzati in modo flessibile nell'elenco delle anteprime.
| Sottotipo | Proporzioni | Dimensioni minime in pixel |
|---|---|---|
| SquareImageMedia | 1:1 | 128 larghezza x 128 altezza |
| ImageMedia4x1 | 4:1 | 512 larghezza x 128 altezza |
Immagini degli annunci del pubblico
Per gli annunci del pubblico, creerai più asset di immagini con dimensioni, proporzioni e impostazioni di ritaglio diverse, in modo che possano essere visualizzati in modo flessibile tra diversi editori e posizionamenti.
Nell'elemento Images includere uno o più oggetti AssetLink . Ogni collegamento di asset contiene un elemento ImageAsset con SubType impostato su uno dei valori stringa nella tabella seguente.
Nota
I sottotipi di immagine e nella tabella seguente per gli annunci audience versione 2 e sono attualmente in fase pilota.
| Sottotipo | Proporzioni | Dimensioni minime in pixel |
|---|---|---|
| OriginalImage | N/D | 703 larghezza x 368 altezza |
| LandscapeImageMedia | 1.91:1 | 300 larghezza x 157 altezza |
| SquareImageMedia | 1:1 | 114 larghezza x 114 altezza |
| ImageMedia201X100 | 2.01:1 | 612 larghezza x 304 altezza |
| ImageMedia120X100 | 1.2:1 | 300 larghezza x 250 altezza |
| ImageMedia200X100 | 2:1 | 200 larghezza x 100 altezza |
| ImageMedia169X100 | 1.69:1 | 628 larghezza x 372 altezza |
| ImageMedia124X100 | 1.24:1 | 104 larghezza x 84 altezza |
| ImageMedia153X100 | 1.53:1 | 306 larghezza x 200 altezza |
Nota
I sottotipi di immagine nella tabella seguente sono per gli annunci audience versione 1.
| Sottotipo | Dimensioni minime in pixel |
|---|---|
| LandscapeImageMedia | 703 larghezza x 368 altezza Aspect radio 1.91:1 |
| SquareImageMedia | 300 larghezza x 300 altezza Aspect radio 1:1 |
| ImageMedia169X100 | 622 larghezza x 368 altezza Aspect radio 1.69:1 |
| ImageMedia93X100 | 311 larghezza x 333 altezza Aspect radio 0.93:1 |
| ImageMedia15X10 | 300 larghezza x 200 altezza Aspect radio 1.5:1 |
| ImageMedia155X100 | 300 larghezza x 194 altezza Aspect radio 1.55:1 |
| ImageMedia133X100 | 100 larghezza x 75 altezza Aspect radio 1.33:1 |
| ImageMedia178X100 | 624 larghezza x 350 altezza Aspect radio 1.78:1 |
| ImageMedia172X100 | 300 larghezza x 174 altezza Aspect radio 1.72:1 |
È necessario fornire solo un asset immagine OriginalImage predefinito (l'immagine predefinita era in precedenza LandscapeImageMedia). Nell'elemento Images è incluso un assetLink che contiene un elemento ImageAsset con SubType impostato su OriginalImage. Le dimensioni consigliate per OriginalImage sono 1200 larghezza x 628 altezza. Facoltativamente, è possibile includere collegamenti di asset aggiuntivi, ad esempio un asset immagine per ogni sottotipo supportato. Per qualsiasi sottotipo di asset di immagine non impostato in modo esplicito, Microsoft Advertising creerà automaticamente collegamenti agli asset di immagine ritagliando l'immagine originale.
Dato l'esempio di risposta GetAdsByAdGroupId riportato di seguito, tenere presente quanto segue:
- Lo stesso identificatore di asset di immagine (ad esempio, 1234567890000) viene usato per tutti i sottotipi di asset immagine generati automaticamente. Indipendentemente dal fatto che microsoft advertising generi automaticamente le immagini ritagliate, l'ID non deve essere univoco tra gli asset di immagine collegati allo stesso annuncio.
- Poiché l'annuncio in questo esempio è stato creato senza impostazioni di ritaglio per il sottotipo di asset immagine OriginalImage, tutti gli asset immagine vengono ritagliati ad eccezione dell'immagine associata OriginalImage.
- Microsoft Advertising userà le impostazioni di ritaglio di OriginalImage per tutte le impostazioni di ritaglio predefinite. In questo esempio l'altezza del ritaglio per tutti gli asset di immagine generati dal sistema è 628 e possiamo dedurre che il sottotipo OriginalImage (OriginalImage) con proporzioni 1.91:1 ha larghezza e altezza pari a 1200x628. Le impostazioni di ritaglio degli asset immagine generati automaticamente si basano sulle impostazioni di ritaglio del collegamento asset OriginalImage.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
</s:Header>
<s:Body>
<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Ad i:type="ResponsiveAd">
<AdFormatPreference i:nil="true"/>
<DevicePreference>0</DevicePreference>
<EditorialStatus>Inactive</EditorialStatus>
<FinalAppUrls i:nil="true"/>
<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>https://mobile.contoso.com/womenshoesale</a:string>
</FinalMobileUrls>
<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>https://www.contoso.com/womenshoesale</a:string>
</FinalUrls>
<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
<Id>9876543210000</Id>
<Status>Active</Status>
<TrackingUrlTemplate i:nil="true"/>
<Type>ResponsiveAd</Type>
<UrlCustomParameters i:nil="true"/>
<BusinessName>Contoso</BusinessName>
<CallToAction>AddToCart</CallToAction>
<Headline>Fast & Easy Setup</Headline>
<Images>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight i:nil="true"/>
<CropWidth i:nil="true"/>
<CropX i:nil="true"/>
<CropY i:nil="true"/>
<SubType>OriginalImage</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>628</CropWidth>
<CropX>286</CropX>
<CropY>0</CropY>
<SubType>SquareImageMedia</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>942</CropWidth>
<CropX>129</CropX>
<CropY>0</CropY>
<SubType>ImageMedia15X10</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>835</CropWidth>
<CropX>183</CropX>
<CropY>0</CropY>
<SubType>ImageMedia133X100</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>1118</CropWidth>
<CropX>41</CropX>
<CropY>0</CropY>
<SubType>ImageMedia178X100</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
</Images>
<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
<LandscapeLogoMediaId i:nil="true"/>
<LongHeadline>Find New Customers & Increase Sales!</LongHeadline>
<SquareImageMediaId>1234567890000</SquareImageMediaId>
<SquareLogoMediaId i:nil="true"/>
<Text>Find New Customers & Increase Sales! Start Advertising on Contoso Today.</Text>
</Ad>
</Ads>
</GetAdsByAdGroupIdResponse>
</s:Body>
</s:Envelope>
Requisiti
Servizio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13