Record dell'estensione dell'annuncio immagine - Bulk
Definisce un'estensione dell'annuncio immagine che può essere scaricata e caricata in un file bulk.
Puoi associare un'estensione dell'annuncio immagine all'account o alle campagne e ai gruppi di annunci nell'account. Ogni account può avere fino a 250.000 associazioni di estensione dell'immagine della campagna e fino a 250.000 associazioni di estensione dell'immagine del gruppo di annunci. Ogni entità (account, campagna o gruppo di annunci) può essere associata a un massimo di 25 estensioni di annunci immagine. Usa l'estensione dell'annuncio immagine dell'account, l'estensione dell'annuncio immagine del gruppo di annunci pubblicitari e i record dell'estensione dell'annuncio dell'immagine della campagna per gestire le associazioni di estensione dell'annuncio immagine.
È possibile scaricare tutti i record dell'estensione Image Ad nell'account includendo il valore DownloadEntity di ImageAdExtensions nella richiesta di servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.
Nell'esempio csv bulk seguente viene aggiunta una nuova estensione per annunci immagine alla libreria condivisa dell'account.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Alternative Text,Media Ids,Final Url Suffix
Format Version,,,,,,,,,,,6.0,,,,,
Image Ad Extension,Active,-14,0,,,ClientIdGoesHere,,,,,,,FALSE,ImageAdExtension Alternative Text,ImageMediaIdHere,
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkImageAdExtension , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkImageAdExtension
var bulkImageAdExtension = new BulkImageAdExtension
{
// 'Parent Id' column header in the Bulk file
AccountId = 0,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// ImageAdExtension object of the Campaign Management service.
ImageAdExtension = new ImageAdExtension
{
// 'Alternative Text' column header in the Bulk file
AlternativeText = "ImageAdExtension Alternative Text",
// 'Destination Url' column header in the Bulk file
DestinationUrl = null,
// 'Id' column header in the Bulk file
Id = imageAdExtensionIdKey,
// 'Media Ids' column header in the Bulk file
ImageMediaIds = new long[] { ImageMediaIdHere },
// 'Status' column header in the Bulk file
Status = AdExtensionStatus.Active,
},
};
uploadEntities.Add(bulkImageAdExtension);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Per un record image ad extension , i campi dell'attributo seguenti sono disponibili nello schema file bulk.
- Pianificazione annunci
- Testo alternativo
- Client Id
- Parametro personalizzato
- URL di destinazione
- Visualizza testo
- Posizione editoriale
- Codice motivo editoriale
- Stato editoriale
- Termine editoriale
- Data di fine
- URL finale
- Suffisso URL finale
- Id
- Immagini
- Layout
- ID multimediali
- URL finale per dispositivi mobili
- Ora modifica
- Parent Id
- Paesi di pubblicazione
- Data inizio
- Stato
- Modello di rilevamento
- Usare il fuso orario del searcher
- Versione
Pianificazione annunci
Elenco degli intervalli di giorno e di ora in cui vuoi che l'estensione dell'annuncio venga visualizzata con i tuoi annunci. Ogni giorno e intervallo di tempo include il giorno pianificato della settimana, l'ora di inizio/fine e il minuto di inizio/fine. Ogni intervallo di giorno e ora è racchiuso tra parentesi sinistra e destra e separato da altri intervalli di giorno e ora con un punto e virgola (;) delimitatore. All'interno di ogni giorno e intervallo di tempo il formato è Day[StartHour:StartMinue-EndHour:EndMinute].
I valori possibili di StartHour sono compresi tra 00 e 23, dove 00 equivale alle 12:00 e 12 alle 12:00.
I valori possibili di EndHour sono compresi tra 00 e 24, dove 00 equivale alle 12:00 e 12 :00.
I valori possibili di StartMinute e EndMinute sono compresi tra 00 e 60.
L'esempio seguente illustra gli intervalli di giorno e di ora durante i giorni feriali dalle 9:00 alle 21:00: (lunedì[09:00-21:00]);( martedì[09:00-21:00]); (Mercoledì[09:00-21:00]); (Giovedì[09:00-21:00]); (Venerdì[09:00-21:00])
Aggiungere: Opzionale. Se non imposti questo campo, l'estensione dell'annuncio sarà idonea per la pianificazione in qualsiasi momento durante le date di inizio e fine del calendario.
Aggiornamento: Opzionale. I singoli intervalli di giorno e ora non possono essere aggiornati. È possibile aggiornare in modo efficace gli intervalli di giorno e di ora inviando un nuovo set che deve sostituire il set precedente. I campi Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia tutti questi campi vuoti durante l'aggiornamento, nessuno di essi viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per tutti questi campi vengono rimossi o sostituiti. Per rimuovere tutte le impostazioni di pianificazione precedenti, impostare ognuno di questi campi su delete_value.
Elimina: Sola lettura
Testo alternativo
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 campo è di 90 caratteri.
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
ID Client
Usato per associare i record nel file di caricamento bulk ai record nel file dei risultati. Il valore di questo campo non viene utilizzato o archiviato dal server; viene semplicemente copiato dal record caricato nel record di risultati corrispondente. Può essere qualsiasi stringa valida fino a 100 di lunghezza.
Aggiungere: Opzionale
Aggiornamento: Opzionale
Elimina: Sola lettura
Parametro personalizzato
Raccolta personalizzata di parametri chiave e valore per il rilevamento url.
In un file bulk l'elenco dei parametri personalizzati viene formattato come segue.
Formattare ogni coppia di parametri personalizzata come Key=Value, ad esempio {_promoCode}=PROMO1.
Microsoft Advertising accetterà le prime 3 coppie di chiavi e valori dei parametri personalizzati incluse e tutti i parametri personalizzati aggiuntivi verranno ignorati. 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.
Ogni coppia chiave/valore è delimitata da un punto e virgola e da uno spazio ("; "), ad esempio {_promoCode}=PROMO1; {_season}=summer.
Una chiave non può contenere un punto e virgola. Se un valore contiene un punto e virgola, deve essere preceduto da caratteri di escape come '\;'. Inoltre, se il valore contiene una barra rovesciata, deve anche essere preceduto da escape come '\'.
La chiave non può superare i 16 byte UTF-8 e il valore non può superare i 200 byte UTF-8. Per i clienti del progetto pilota Custom Parameters Limit Increase Phase 3 (GetCustomerPilotFeatures restituisce 635), il limite valore aumenta a 250 byte UTF-8. La chiave è obbligatoria e il valore è facoltativo. Le dimensioni massime della chiave non includono le parentesi graffe e il carattere di sottolineatura, ad esempio '{', '_' e '}'.
Nota
Con il servizio bulk la chiave deve essere formattata con parentesi graffe circostanti e un carattere di sottolineatura iniziale, ad esempio se la chiave è promoCode, deve essere formattata come {_promoCode}. Con il servizio Campaign Management non è possibile specificare le parentesi graffe e il carattere di sottolineatura circostanti.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per rimuovere tutti i parametri personalizzati, impostare questo campo su delete_value. La parola chiave delete_value rimuove l'impostazione precedente. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere e omettere eventuali parametri che non si desidera mantenere. Il nuovo set di parametri personalizzati sostituirà qualsiasi set di parametri personalizzato precedente.
Elimina: Sola lettura
URL di destinazione
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.
Nota
Se l'URL non è specificato per l'estensione dell'annuncio immagine, viene usato l'URL dell'annuncio.
Aggiungere: Opzionale.
Nota: Questo campo è necessario per le estensioni di annunci multi-immagine.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Nota: Questo campo è necessario per le estensioni di annunci multi-immagine.
Elimina: Sola lettura
Visualizza testo
Testo visualizzato dell'estensione dell'immagine.
La lunghezza massima per questo campo è di 35 caratteri.
Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Posizione editoriale
Componente o proprietà dell'estensione dell'annuncio che ha avuto esito negativo nella revisione editoriale.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Codice motivo editoriale
Codice che identifica il motivo dell'errore. Per un elenco dei possibili codici motivo, vedere Codici motivo editoriali.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Stato editoriale
Stato editoriale dell'estensione dell'annuncio.
I valori possibili sono descritti nella tabella seguente.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Termine editoriale
Il termine che ha fallito revisione editoriale.
Questo campo non verrà impostato se una combinazione di termini ha causato l'errore o se l'errore è stato basato su una violazione dei criteri.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Data di fine
Stringa della data di fine pianificata dell'estensione dell'annuncio formattata come MM/DD/AAAAA.
La data di fine è inclusiva. Ad esempio, se imposti questo campo sul 31/12/2020, le estensioni dell'annuncio smetteranno di essere visualizzate alle 23:59 del 31/12/2020.
Aggiungere: Opzionale. Se non specifichi una data di fine, l'estensione dell'annuncio continuerà a essere recapitata a meno che non sospendi le campagne, i gruppi di annunci o gli annunci associati.
Aggiornamento: Opzionale. La data di fine può essere abbreviata o estesa, purché la data di inizio sia Null o si verifichi prima della nuova data di fine. Se si imposta questo campo sulla stringa delete_value , la data di fine verrà effettivamente rimossa. I campi Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia tutti questi campi vuoti durante l'aggiornamento, nessuno di essi viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per tutti questi campi vengono rimossi o sostituiti. Per rimuovere tutte le impostazioni di pianificazione precedenti, impostare ognuno di questi campi su delete_value.
Elimina: Sola lettura
URL finale
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 l'URL finale che per l'URL finale per dispositivi mobili. 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.
- Ogni URL è delimitato da un punto e virgola e da uno spazio ("; ").
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}.
- Gli URL finali devono essere ognuno un URL ben formato a partire da http:// o https://.
- Se si specifica l'URL finale per dispositivi mobili, è necessario specificare anche l'URL finale.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Suffisso URL finale
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.
Nota
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 campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura
Id
Identificatore generato dal sistema dell'estensione dell'annuncio.
Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. È quindi possibile fare riferimento a un identificatore negativo impostato per l'estensione dell'annuncio nel campo Id dei tipi di record dipendenti, ad esempio l'estensione annunci immagine del gruppo di annunci pubblicitari e l'estensione dell'annuncio dell'immagine della campagna. Questa operazione è consigliata se si aggiungono nuove estensioni pubblicitarie e nuovi record dipendenti nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio
Immagini
Gli asset di immagine con dimensioni e proporzioni diverse consentono di visualizzare in modo flessibile diversi editori e posizionamenti.
È necessario fornire solo un asset immagine orizzontale, ad esempio questo campo deve contenere un asset immagine con sottoTipo impostato su LandscapeImageMedia. Le dimensioni consigliate per LandscapeImageMedia 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 di asset immagine ritagliando LandscapeImageMedia.
Gli asset di immagine sono rappresentati nel file bulk come stringa JSON. Nell'esempio JSON seguente sono incluse sette immagini e solo LandscapeImageMedia subType non viene ritagliato.
id è una proprietà dell'asset, mentre cropHeight, cropWidth, cropXcropY, e subType sono proprietà del collegamento dell'asset, ad esempio la relazione tra l'asset e l'annuncio. Per altri dettagli, vedere cropHeight, cropWidth, cropX, cropY, id e subType di seguito.
[{
"id": 1234567890000,
"subType": "LandscapeImageMedia"
},
{
"id": 1234567890000,
"subType": "SquareImageMedia",
"cropX": 286,
"cropY": 0,
"cropWidth": 628,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia169X100",
"cropX": 70,
"cropY": 0,
"cropWidth": 1061,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia93X100",
"cropX": 308,
"cropY": 0,
"cropWidth": 584,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia15X10",
"cropX": 129,
"cropY": 0,
"cropWidth": 942,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia155X100",
"cropX": 114,
"cropY": 0,
"cropWidth": 973,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia133X100",
"cropX": 183,
"cropY": 0,
"cropWidth": 835,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia178X100",
"cropX": 41,
"cropY": 0,
"cropWidth": 1118,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia172X100",
"cropX": 60,
"cropY": 0,
"cropWidth": 1080,
"cropHeight": 628
}]
Nota
Nel file bulk separato da virgole è necessario racchiudere l'elenco di collegamenti di asset, ogni chiave di attributo e ogni valore stringa di attributo con un set aggiuntivo di virgolette doppie, ad esempio la stringa JSON precedente verrà scritta come "[{""id"":1234567890000,""subType":""LandscapeImageMedia""},{""id"":1234567890000,""subType"":"SquareImageMedia"",""cropX"":286,""cropY"":0,""cropWidth"":628,""cropHeight"":628},{""id"":1234567890000, ""subType":""ImageMedia169X100"","cropX"":70,""cropY"":0,""cropWidth"":1061,""cropHeight"":628},{""id"":1234567890000,""subType":""ImageMedia93X100"","cropX"":308,""cropY"":0,""cropWidth"":584,""cropHeight"":628},{""" id"":1234567890000,""subType":""ImageMedia15X10"","cropX"":129,""cropY":0,""cropWidth"":942,""cropHeight"":628},,{""id"":1234567890000,""subType":""ImageMedia155X100"",""cropX"":114,""cropY"":0,""cropWidth"":973,""cropHeight"" :628},{""id":1234567890000,""subType":""ImageMedia133X100"",""cropX"":183,""cropY"":0,""" cropWidth"":835,""cropHeight"":628},{""id"":1234567890000,""subType"":""ImageMedia178X100"",""cropX""":41,""cropY"":0,""cropWidth":1118,""cropHeight"":628},{""id"":1234567890000,""subType"":" ImageMedia172X100"",""cropX"":60,""cropY"":0,""cropWidth"":1080,""cropHeight"":628}]".
Dato l'esempio JSON della risposta di caricamento precedente, 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 LandscapeImageMedia, tutti gli asset immagine vengono ritagliati ad eccezione dell'immagine orizzontale originale.
- Indipendentemente dal fatto che l'immagine orizzontale abbia impostazioni di ritaglio personalizzate, Microsoft Advertising usa la vera altezza dell'immagine orizzontale 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 l'immagine orizzontale (sottotipo LandscapeImageMedia) con proporzioni 1.91:1 ha larghezza e altezza pari a 1200x628. Anche se il collegamento asset immagine orizzontale è stato creato con le impostazioni di ritaglio, ad esempio 703x368, le impostazioni di ritaglio degli asset immagine generati automaticamente si basano sulle dimensioni complete dell'immagine orizzontale (anche in questo esempio sarebbe 1200x628).
cropHeight
Numero di pixel da usare dall'origine dell'asset dell'immagine, a partire dalla posizione cropY e spostandosi verso l'alto.
cropWidth
Numero di pixel da usare dall'origine dell'asset dell'immagine, a partire dalla posizione cropX e passando a destra.
cropX
A partire dall'angolo inferiore sinistro dell'origine dell'asset dell'immagine, si tratta del numero di pixel da ignorare a destra sull'asse x prima di applicare cropWidth.
cropY
A partire dall'angolo inferiore sinistro dell'origine dell'asset dell'immagine, si tratta del numero di pixel da ignorare verso l'alto sull'asse y prima di applicare cropHeight.
id
L'attributo id è un identificatore univoco di Microsoft Advertising per l'asset in un account Microsoft Advertising.
Lo stesso identificatore di asset di immagine può essere usato più volte nello stesso annuncio per proporzioni diverse e può essere usato anche da più annunci nello stesso account Microsoft Advertising. L'identificatore dell'asset immagine con SubType impostato su LandscapeImageMedia viene usato per tutti i sottotipi di asset immagine generati automaticamente all'interno dello stesso annuncio. 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.
Puoi creare immagini per le estensioni degli annunci di immagini tramite il record in blocco Immagine . È quindi possibile usare l'identificatore multimediale restituito come ID asset dell'immagine. Le proporzioni dell'immagine aggiunta devono essere supportate per il sottotipo dell'asset dell'immagine.
Sottotipo
L'attributo subType rappresenta le proporzioni per questo asset immagine.
Le proporzioni reali dell'immagine archiviata nella libreria multimediale a livello di account possono variare, a condizione che le dimensioni risultanti comportino le proporzioni previste per ogni sottotipo. Se non si specificano le impostazioni di ritaglio, il servizio verrà automaticamente visualizzato fino all'area massima possibile dal centro dell'immagine. Ad esempio, data un'immagine di 1000x1000 pixel, per le proporzioni 1.91:1, l'impostazione di ritaglio automatico sarà cropWidth=1000, cropHeight=524, cropX=0 e cropY=238.
I possibili valori di sottotipo includono LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia93X100, ImageMedia15X10, ImageMedia155X100, ImageMedia133X100, ImageMedia178X100 e ImageMedia172X100. In futuro potrebbero essere aggiunti nuovi sottotipi, pertanto non è consigliabile assumere alcuna dipendenza da un set fisso di valori.
| 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 |
Aggiungere: Obbligatorio. Per ogni collegamento di asset sono necessari solo l'ID e il sottoTipo .
Aggiornamento: Opzionale. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare vuoto questo campo. Se imposti questo campo, tutte le immagini precedentemente collegate a questo annuncio verranno sostituite. Se si imposta questo campo, per ogni collegamento di asset sono necessari solo l'ID e il sottoTipo .
Elimina: Sola lettura
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.
In un file bulk, l'elenco di stringhe di layout è delimitato da un punto e virgola (;).
Aggiungere: Opzionale. Se non si imposta questo campo, tutti i layout supportati correnti e futuri verranno impostati per impostazione predefinita.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura
ID multimediali
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 di immagine . Anche se il valore minimo richiesto è un ID multimediale dell'immagine, per qualificarti per tutti i posizionamenti degli annunci devi fornire quattro identificatori multimediali dell'immagine.
In un file bulk, l'elenco di identificatori multimediali è delimitato da un punto e virgola (;).
Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
URL finale per dispositivi mobili
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 l'URL finale che per l'URL finale per dispositivi mobili. 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.
- Ogni URL è delimitato da un punto e virgola e da uno spazio ("; ").
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}.
- Gli URL finali devono essere ognuno un URL ben formato a partire da http:// o https://.
- Se si specifica l'URL finale per dispositivi mobili, è necessario specificare anche l'URL finale.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura
Ora modifica
Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).
Nota
Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Parent Id
Identificatore generato dal sistema dell'account che contiene l'estensione dell'annuncio.
Questo campo bulk esegue il mapping al campo ID del record account .
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Paesi di pubblicazione
Elenco di paesi o aree di pubblicazione le cui linee guida editoriali non consentono il termine specificato.
In un file bulk l'elenco di paesi o aree di pubblicazione è delimitato da un punto e virgola (;).
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Data inizio
Stringa della data di inizio pianificata dell'estensione dell'annuncio formattata come MM/DD/AAAAA.
La data di inizio è inclusiva. Ad esempio, se imposti StartDate sul 5/5/2020, le estensioni dell'annuncio inizieranno a essere visualizzate alle 12:00 del 5/5/2020.
Aggiungere: Opzionale. Se non specifichi una data di inizio, l'estensione dell'annuncio è immediatamente idonea per essere pianificata.
Aggiornamento: Opzionale. La data di inizio può essere abbreviata o estesa, purché la data di fine sia Null o si verifichi dopo la nuova data di inizio. Se imposti questo campo sulla stringa delete_value , stai effettivamente rimuovendo la data di inizio e l'estensione dell'annuncio è immediatamente idonea per essere pianificata. I campi Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia tutti questi campi vuoti durante l'aggiornamento, nessuno di essi viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per tutti questi campi vengono rimossi o sostituiti. Per rimuovere tutte le impostazioni di pianificazione precedenti, impostare ognuno di questi campi su delete_value.
Elimina: Sola lettura
Stato
Stato dell'estensione dell'annuncio.
I valori possibili sono Attivo o Eliminato.
Aggiungere: Opzionale. Il valore predefinito è Attivo.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.
Modello di rilevamento
Modello di rilevamento da usare per gli URL di promozione.
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?
I modelli di rilevamento definiti per le entità di livello inferiore, ad esempio gli annunci, sostituiscono quelli impostati per 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 è
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}e non vengono definiti {_season} o {_promocode} 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 campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura
Usare il fuso orario del searcher
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 vuoi che le estensioni dell'annuncio vengano visualizzate nel fuso orario dell'utente di ricerca e in caso contrario impostarla su FALSE.
Aggiungere: Opzionale. Se non si specifica questo campo o lo si lascia vuoto, verrà impostato il valore predefinito FALSE e verrà usato il fuso orario dell'account.
Aggiornamento: Opzionale. Se si imposta questo campo sulla stringa delete_value , si reimposta in modo efficace il valore predefinito FALSE. I campi Pianificazione annunci, Data di fine, Data di inizio e Usa fuso orario searcher dipendono l'uno dall'altro e vengono aggiornati insieme. Se si lascia tutti questi campi vuoti durante l'aggiornamento, nessuno di essi viene aggiornato. Se si includono valori per uno di questi campi, i valori precedenti per tutti questi campi vengono rimossi o sostituiti. Per rimuovere tutte le impostazioni di pianificazione precedenti, impostare ognuno di questi campi su delete_value.
Elimina: Sola lettura
Versione
Numero di volte in cui il contenuto dell'estensione dell'annuncio è stato aggiornato. La versione è impostata su 1 quando si aggiunge l'estensione e viene incrementata ogni volta che viene rivista.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per