Record gruppo di asset - Bulk

Definisce un gruppo di asset che può essere scaricato e caricato in un file bulk.

È possibile scaricare tutti i record del gruppo di asset nell'account includendo il valore DownloadEntity di AssetGroups 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.

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAssetGroup , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

Per un record del gruppo di asset , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

• Gruppo di asset
• Nome dell'azienda
• Chiamata all'azione
• Campagna
• Client Id
• Descrizioni
• Stato di appello editoriale
• Posizione editoriale
• Codice motivo editoriale
• Stato editoriale
• Termine editoriale
• Data di fine
• URL finale
• Titoli
• Id
• Immagini
• Titoli lunghi
• URL finale per dispositivi mobili
• Ora modifica
• Parent Id
• Percorso 1
• Percorso 2
• Stato
• Data inizio

Gruppo di asset

Nome del gruppo di asset.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Elimina: Sola lettura e Obbligatorio

Nome dell'azienda

Nome dell'azienda.

A seconda del posizionamento dell'annuncio del pubblico, il nome dell'azienda può essere visualizzato nell'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.
Elimina: Sola lettura

Chiamata all'azione

Un breve e incisivio motivo per i clienti di fare clic sul tuo annuncio in questo momento.

I valori possibili sono ActNow, AddToCart, ApplyNow, Automated, BetNow, BidNow, BookACar, BookHotel, BookNow, BookTravel, Browse, BuildNow, Buy, BuyNow, ChatNow, Compare, ContactUs, Coupon, Dealer, Default, Directions, Donate, Download, EmailNow, EnrollNow, Explore, FileNow, FindJob, FindStore, FreePlay, FreeQuote, FreeTrial, GetDeals, GetDemo, GetNow, GetOffer, GetQuote, GoToDemo, Install, JoinNow, LearnMore, ListenNow, LogIn, Message, NewCars, NoButton, OpenLink, OrderNow, PlayGame, PlayNow, PostJob, Register, RegisterNow, RenewNow, RentACar, RentNow, Reorder, Reserve, Sale, SaveNow, Schedule, SeeDemo, SeeMenu, SeeModels, SeeMore, SeeOffer, SeeOffers, SellNow, ShopNow, Showtimes, SignIn, SignUp, StartFree, StartNow, Subscribe, SwitchNow, TestDrive, TryNow, Unknown, UsedCars, ViewCars, ViewDemo, ViewNow, ViewPlans, VisitSite, VisitStore, VoteNow, Watch, WatchMore, WatchNow.

Aggiungere: Obbligatorio.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Campagna

Nome della campagna che contiene il gruppo di asset.

Aggiungere: Sola lettura e Obbligatorio
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Campagna .

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. 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

Descrizioni

Elenco di descrizioni che Bing può usare per ottimizzare il layout degli annunci.

Per ottimizzare le impressioni in tutti i formati degli annunci, le descrizioni potrebbero non essere sempre visualizzate nell'annuncio.

Dal punto di vista del modello di dati, le descrizioni vengono archiviate come asset di testo. 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 2 e 5 descrizioni. Le descrizioni sono rappresentate nel file bulk come stringa JSON. Due descrizioni sono incluse nell'esempio JSON seguente e la prima viene aggiunta a una posizione specifica. text E id sono proprietà dell'asset, mentre e editorialStatusassetPerformanceLabel sono proprietà del collegamento dell'asset, ad esempio la relazione tra l'asset e l'annuncio. Per altri dettagli, vedere assetPerformanceLabel, editorialStatus, id e testo di seguito.

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

Nota

Nel file bulk separato da virgole è necessario racchiudere l'elenco di collegamenti agli 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 "[{""text":""Find New Customers & Increase Sales!""},{""text":""Start Advertising on Contoso Today.""}]".

Ecco un esempio di download bulk in cui si otterranno anche attributi di sola lettura, id ad esempio e editorialStatus:

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Aggiungere: Obbligatorio se la campagna padre non è associata a un archivio, facoltativo se la campagna padre viene associata a un archivio. Se la campagna padre viene associata a un archivio e si specificano le descrizioni, è necessario specificare anche Titoli, LongHeadlines e Immagini. Viene rispettato solo il testo . Anche se l'asset esiste già nel tuo account, l'ID, assetPerformanceLabel e editorialStatus verranno ignorati se li includi.
Aggiornamento: Opzionale. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare vuoto questo campo. Se imposti questo campo, tutte le descrizioni precedentemente collegate a questo annuncio verranno sostituite. Se si specifica questo campo, è necessario un elenco di 2-5 descrizioni. Viene rispettato solo il testo . Anche se l'asset esiste già nel tuo account, l'ID, assetPerformanceLabel e editorialStatus verranno ignorati se li includi.
Elimina: Sola lettura

assetPerformanceLabel

In questo modo è possibile conoscere le prestazioni dell'asset.

L'attributo assetPerformanceLabel è di sola lettura quando si scarica l'annuncio di ricerca reattivo. I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Bassa	Le prestazioni di questo asset sono basse e ti consigliamo di sostituire questo asset per migliorare le prestazioni degli annunci.
Buone	Le prestazioni di questo asset sono buone. Ti consigliamo di mantenere questo asset e aggiungere altri asset per migliorare le prestazioni degli annunci.
Elevate	Le prestazioni di questo asset sono tra le migliori ed è consigliabile aggiungere asset più simili.
Unrated	Non è disponibile alcuna valutazione delle prestazioni per questo asset. Ciò può essere dovuto al fatto che l'asset è inattivo, non ha informazioni sufficienti per determinarne le prestazioni o se non sono presenti asset simili sufficienti per confrontarlo.
Formazione	Le prestazioni dell'asset vengono valutate attivamente. Al termine della valutazione, la valutazione dell'asset sarà Bassa, Buona, Migliore o Non calcolata.

editorialStatus

L'attributo editorialStatus è di sola lettura quando si scarica l'annuncio di ricerca reattivo. I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Attivazione	L'asset ha superato la revisione editoriale.
ActiveLimited	L'asset ha superato la revisione editoriale in uno o più mercati e uno o più elementi dell'asset sono sottoposti a revisione editoriale in un altro mercato. Ad esempio, l'asset ha superato la revisione editoriale per il Canada ed è ancora in attesa di revisione nel Stati Uniti.
Approvato	L'asset ha fallito la revisione editoriale.
Inattivo	Uno o più elementi dell'asset sono in fase di revisione editoriale.
Unknown	Parametro riservato per utilizzi futuri.

id

L'attributo id è un identificatore univoco di Microsoft Advertising per l'asset in un account Microsoft Advertising.

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. Dopo aver caricato un asset di testo, il file dei risultati includerà l'identificatore dell'asset, ""id:""123ad esempio , se l'asset è nuovo o già esistente nella raccolta di asset dell'account.

testo

L'attributo di text ogni descrizione deve contenere almeno una parola. La lunghezza di input massima dell'attributo di text ogni descrizione è di 90 caratteri. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 45 caratteri. 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.

L'attributo text non può contenere il carattere di nuova riga (\n).

Stato di appello editoriale

Determina se è possibile fare ricorso ai problemi rilevati dalla recensione editoriale.

I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Utilizzabile	La questione editoriale è di grande interesse.
AppelloPending	La questione editoriale è impugnabile ed è stato presentato un ricorso.
NotAppealable	La questione editoriale non è utilizzabile.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

Posizione editoriale

Componente o proprietà 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 del gruppo di asset.

I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Attivazione	Il gruppo di asset ha superato la revisione editoriale.
ActiveLimited	Il gruppo di asset ha superato la revisione editoriale in uno o più mercati e uno o più elementi del gruppo di asset sono sottoposti a revisione editoriale in un altro mercato. Ad esempio, il gruppo di asset ha superato la revisione editoriale per il Canada ed è ancora in attesa di revisione nel Stati Uniti.
Approvato	La revisione editoriale del gruppo di asset non è riuscita.
Inattivo	Uno o più elementi del gruppo di asset sono in fase di revisione editoriale.

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

Data di scadenza del gruppo di asset.

Se non si specifica una data di fine, il gruppo di asset non scadrà. La data di fine può essere estesa per rendere un gruppo di asset idoneo per il recapito, anche dopo la scadenza del gruppo di asset.

La data di fine è inclusiva. Ad esempio, se si imposta Data di fine sul 31/12/2020, il gruppo di asset scadrà alle 23:59 del 31/12/2020. L'ora si basa sul fuso orario specificato a livello di campagna.

Aggiungere: Opzionale. Per impostare nessuna data di fine quando si aggiunge un gruppo di asset, non impostare questo campo.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per eliminare la data di fine corrente e impostare di fatto nessuna data di fine, impostare questo campo sulla stringa "delete_value". Quando si recupera il gruppo di asset la prossima volta, questo campo non verrà impostato.
Elimina: Sola lettura

URL finale

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 gli URL finali che per gli URL finali per dispositivi mobili. 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.

• 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}".

• Ogni URL deve essere un URL ben formato a partire da http:// o https://.

• Se si specificano gli URL finali per dispositivi mobili, è necessario specificare anche l'URL finale.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Titoli

Elenco di titoli che Bing può usare per ottimizzare il layout degli annunci.

Per ottimizzare le prestazioni in tutti i formati degli annunci, i titoli potrebbero non essere sempre visualizzati nell'annuncio.

Dal punto di vista del modello di dati, i titoli vengono archiviati come asset di testo. 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 3 e 15 titoli. I titoli sono rappresentati nel file bulk come stringa JSON. Due titoli sono inclusi nell'esempio JSON seguente. text E id sono proprietà dell'asset, mentre e editorialStatusassetPerformanceLabel sono proprietà del collegamento dell'asset, ad esempio la relazione tra l'asset e l'annuncio. Per altri dettagli, vedere assetPerformanceLabel, editorialStatus, id e testo di seguito.

[{
	"text": "Contoso",
},
{
	"text": "Seamless Integration"
}]

Nota

Nel file bulk separato da virgole è necessario racchiudere l'elenco di collegamenti di asset, ogni chiave di attributo e ogni valore di stringa di attributo con un set aggiuntivo di virgolette doppie, ad esempio, la stringa JSON precedente verrà scritta come "[{"text"":"Contoso""},{"text":""Seamless Integration""}]".

Ecco un esempio di download bulk in cui si otterranno anche attributi di sola lettura, id ad esempio e editorialStatus:

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Aggiungere: Obbligatorio se la campagna padre non è associata a un archivio, facoltativo se la campagna padre viene associata a un archivio. Se la campagna padre viene associata a un archivio e si specificaNoti, è necessario specificare anche LongHeadlines, Descriptions e Images.If the parent campaign associates to a store and you specify Headlines, you must also specify LongHeadlines, Descriptions, and Images. Viene rispettato solo il testo . Anche se l'asset esiste già nel tuo account, l'ID, assetPerformanceLabel e editorialStatus verranno ignorati se li includi.
Aggiornamento: Opzionale. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare vuoto questo campo. Se imposti questo campo, tutti i titoli precedentemente collegati a questo annuncio verranno sostituiti. Se si specifica questo campo, è necessario un elenco di 3-15 titoli. Viene rispettato solo il testo . Anche se l'asset esiste già nel tuo account, l'ID, assetPerformanceLabel e editorialStatus verranno ignorati se li includi.
Elimina: Sola lettura

assetPerformanceLabel

In questo modo è possibile conoscere le prestazioni dell'asset.

L'attributo assetPerformanceLabel è di sola lettura quando si scarica l'annuncio di ricerca reattivo. I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Bassa	Le prestazioni di questo asset sono basse e ti consigliamo di sostituire questo asset per migliorare le prestazioni degli annunci.
Buone	Le prestazioni di questo asset sono buone. Ti consigliamo di mantenere questo asset e aggiungere altri asset per migliorare le prestazioni degli annunci.
Elevate	Le prestazioni di questo asset sono tra le migliori ed è consigliabile aggiungere asset più simili.
Unrated	Non è disponibile alcuna valutazione delle prestazioni per questo asset. Ciò può essere dovuto al fatto che l'asset è inattivo, non ha informazioni sufficienti per determinarne le prestazioni o se non sono presenti asset simili sufficienti per confrontarlo.
Formazione	Le prestazioni dell'asset vengono valutate attivamente. Al termine della valutazione, la valutazione dell'asset sarà Bassa, Buona, Migliore o Non calcolata.

editorialStatus

L'attributo editorialStatus è una stringa di sola lettura quando si scarica l'annuncio di ricerca reattivo. I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Attivazione	L'asset ha superato la revisione editoriale.
ActiveLimited	L'asset ha superato la revisione editoriale in uno o più mercati e uno o più elementi dell'asset sono in fase di revisione editoriale in un altro mercato. Ad esempio, l'asset ha superato la revisione editoriale per il Canada ed è ancora in attesa di revisione nel Stati Uniti.
Approvato	L'asset ha fallito la revisione editoriale.
Inattivo	Uno o più elementi dell'asset sono in fase di revisione editoriale.
Unknown	Parametro riservato per utilizzi futuri.

id

L'attributo id è un identificatore univoco di Microsoft Advertising per l'asset in un account Microsoft Advertising.

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. Dopo aver caricato un asset di testo, il file dei risultati includerà l'identificatore dell'asset, ""id:""123ad esempio , se l'asset è nuovo o già esistente nella raccolta di asset dell'account.

testo

L'attributo di text ogni titolo deve contenere almeno una parola. La lunghezza massima di input dell'attributo di text ogni titolo è di 30 caratteri. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 15 caratteri. 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.

L'attributo text non può contenere il carattere di nuova riga (\n).

Id

Identificatore generato dal sistema del gruppo di asset.

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Immagini

Creare più asset di immagini con dimensioni e proporzioni diverse in modo che possano essere visualizzati in modo flessibile tra diversi editori e posizionamenti.

È necessario fornire almeno 1 LandscapeImageMedia e 1 SquareImageMedia. È possibile salvare un totale di fino a 20 immagini e un totale di un massimo di 5 loghi.

Gli asset di immagine sono rappresentati nel file bulk come stringa JSON. Nell'esempio JSON seguente sono incluse nove 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": "LandscapeLogoMedia",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 200,
	"cropHeight": 50
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 120,
	"cropHeight": 120
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"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": "ImageMedia1x2",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 500,
	"cropHeight": 1000
},
{
	"id": 1234567890000,
	"subType": "ImageMedia4x1",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1000,
	"cropHeight": 250
}]

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"":""LandscapeLogoMedia"",""cropX"":70,""cropY"":0,""cropWidth"":200,""cropHeight"":50},{""id"":1234567890000," ""subType":""SquareLogoMedia"",""cropX"":308,""cropY"":0,""cropWidth"":120,""cropHeight"":120},{""id"":1234567890000 0,""cropHeight"":120},{""id"":0,""cropHeight"":120},{""id"":0,"""subType":"SquareLogoMedia"",""cropX"":308,""cropY"":0,"cropWidth"":120,""cropHeight"":120},{""id"":0,""cropHeight"":120},{""id"",""subType":""ImageMedia15X10"","cropX"":129,""cropY"":0,""cropWidth"":942,""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":""ImageMedia1X2"",""cropX""":41,""cropY"":0,""cropWidth":500,""cropHeight":1000},{""id"":1234567890000,""subType":::""ImageMedia4X1"",""cropX"":60,""cropY"":0,""cropWidth"":1000,""cropHeight"":250}]".

Aggiungere: Obbligatorio se la campagna padre non è associata a un archivio, facoltativo se la campagna padre viene associata a un archivio. Se la campagna padre viene associata a un archivio e si specifica Immagini, è necessario specificare anche Titoli, LongHeadlines e Descrizioni. 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

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. È possibile creare immagini per gli annunci reattivi 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.

I possibili valori di sottotipo includono LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 e ImageMedia4X1. In futuro potrebbero essere aggiunti nuovi sottotipi, pertanto non è consigliabile assumere alcuna dipendenza da un set fisso di valori.

Sottotipo	Proporzioni	Dimensioni minime in pixel
LandscapeImageMedia	1.91:1	703 larghezza x 368 altezza
SquareImageMedia	1:1	300 larghezza x 300 altezza
LandscapeLogoMedia	4:1	160 larghezza x 40 altezza
SquareLogoMedia	1:1	40 larghezza x 40 altezza
ImageMedia15x10	1.5:1	300 larghezza x 200 altezza
ImageMedia133x100	1.33:1	100 larghezza x 75 altezza
ImageMedia178x100	1.78:1	624 larghezza x 350 altezza
ImageMedia1x2	1:2	470 larghezza x 940 altezza
ImageMedia4x1	4:1	608 larghezza x 152 altezza

Titoli lunghi

Elenco di titoli lunghi che Bing può usare per ottimizzare il layout degli annunci.

Per ottimizzare le prestazioni in tutti i formati di annunci, i titoli lunghi potrebbero non essere sempre visualizzati nell'annuncio.

Dal punto di vista del modello di dati, i titoli lunghi vengono archiviati come asset di testo. 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 un valore compreso tra 1 e 5 titoli lunghi. I titoli lunghi sono rappresentati nel file bulk come stringa JSON. Due titoli lunghi sono inclusi nell'esempio JSON seguente. text E id sono proprietà dell'asset, mentre e editorialStatusassetPerformanceLabel sono proprietà del collegamento dell'asset, ad esempio la relazione tra l'asset e l'annuncio. Per altri dettagli, vedere assetPerformanceLabel, editorialStatus, id e testo di seguito.

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

Nota

Nel file bulk separato da virgole è necessario racchiudere l'elenco di collegamenti agli 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 "[{""text":""Find New Customers & Increase Sales!""},{""text":""Start Advertising on Contoso Today.""}]".

Ecco un esempio di download bulk in cui si otterranno anche attributi di sola lettura, id ad esempio e editorialStatus:

[{
	"id": 1,
	"text": "Find New Customers & Increase Sales!",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Start Advertising on Contoso Today",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Aggiungere: Obbligatorio se la campagna padre non è associata a un archivio, facoltativo se la campagna padre viene associata a un archivio. Se la campagna padre viene associata a un archivio e si specificaNoti LongHeadlines, è necessario specificare anche Titoli, Descrizioni e Immagini. Viene rispettato solo il testo . Anche se l'asset esiste già nel tuo account, l'ID, assetPerformanceLabel e editorialStatus verranno ignorati se li includi.
Aggiornamento: Opzionale. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare vuoto questo campo. Se imposti questo campo, tutti i titoli precedentemente collegati a questo annuncio verranno sostituiti. Se si specifica questo campo, è necessario un elenco di 1-5 titoli. Viene rispettato solo il testo . Anche se l'asset esiste già nel tuo account, l'ID, assetPerformanceLabel e editorialStatus verranno ignorati se li includi.
Elimina: Sola lettura

assetPerformanceLabel

In questo modo è possibile conoscere le prestazioni dell'asset.

L'attributo assetPerformanceLabel è di sola lettura quando si scarica l'annuncio di ricerca reattivo. I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Bassa	Le prestazioni di questo asset sono basse e ti consigliamo di sostituire questo asset per migliorare le prestazioni degli annunci.
Buone	Le prestazioni di questo asset sono buone. Ti consigliamo di mantenere questo asset e aggiungere altri asset per migliorare le prestazioni degli annunci.
Elevate	Le prestazioni di questo asset sono tra le migliori ed è consigliabile aggiungere asset più simili.
Unrated	Non è disponibile alcuna valutazione delle prestazioni per questo asset. Ciò può essere dovuto al fatto che l'asset è inattivo, non ha informazioni sufficienti per determinarne le prestazioni o se non sono presenti asset simili sufficienti per confrontarlo.
Formazione	Le prestazioni dell'asset vengono valutate attivamente. Al termine della valutazione, la valutazione dell'asset sarà Bassa, Buona, Migliore o Non calcolata.

editorialStatus

L'attributo editorialStatus è una stringa di sola lettura quando si scarica l'annuncio di ricerca reattivo. I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Attivazione	L'asset ha superato la revisione editoriale.
ActiveLimited	L'asset ha superato la revisione editoriale in uno o più mercati e uno o più elementi dell'asset sono in fase di revisione editoriale in un altro mercato. Ad esempio, l'asset ha superato la revisione editoriale per il Canada ed è ancora in attesa di revisione nel Stati Uniti.
Approvato	L'asset ha fallito la revisione editoriale.
Inattivo	Uno o più elementi dell'asset sono in fase di revisione editoriale.
Unknown	Parametro riservato per utilizzi futuri.

id

L'attributo id è un identificatore univoco di Microsoft Advertising per l'asset in un account Microsoft Advertising.

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. Dopo aver caricato un asset di testo, il file dei risultati includerà l'identificatore dell'asset, ""id:""123ad esempio , se l'asset è nuovo o già esistente nella raccolta di asset dell'account.

testo

Ogni attributo del text titolo lungo deve contenere almeno una parola. La lunghezza massima di input dell'attributo di text ogni titolo è di 90 caratteri. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 45 caratteri. 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.

L'attributo text non può contenere il carattere di nuova riga (\n).

URL finale per dispositivi mobili

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 gli URL finali che per gli URL finali per dispositivi mobili. 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.

• 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}".

• Ogni URL deve essere un URL ben formato a partire da http:// o https://.

• Se si specificano gli URL finali 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 della campagna che contiene il gruppo di asset.

Questo campo bulk viene mappato al campo Id del record Campagna .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore campagna esistente o un identificatore negativo uguale al campo Id del record campagna padre. Questa opzione è consigliata se si aggiungono nuovi gruppi di annunci a una nuova campagna 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

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Campagna .

Percorso 1

La prima parte del percorso facoltativo che verrà aggiunta alla parte di dominio dell'URL visualizzato. La parte relativa al dominio dell'URL visualizzato, ad esempio https://www.contoso.com , verrà generata dal dominio dell'URL finale (campo URL finale ). Quindi, se è stato specificato un valore per Path 1 , verrà aggiunto all'URL di visualizzazione. Se è stato specificato anche un valore per Path 2, verrà aggiunto anche all'URL di visualizzazione dopo Path 1. Ad esempio, se l'URL finale contiene https://www.contoso.com, il percorso 1 è impostato su sottodirectory1 e il percorso 2 è impostato su sottodirectory2, l'URL visualizzato sarà https://www.contoso.com/subdirectory1/subdirectory2.

Il percorso 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?.

La lunghezza massima di input è di 1.000 caratteri se si includono stringhe di testo dinamiche. Non è possibile immettere più di 15 caratteri finali (non di testo dinamico). L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza del dominio URL finale e dei percorsi combinati supera i 67 caratteri.

Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 1.000 caratteri se si includono stringhe di testo dinamiche. Non è possibile inserire più di 7 caratteri finali (non di testo dinamico). L'annuncio non verrà visualizzato o verrà usato il testo predefinito se la lunghezza del dominio URL finale e i percorsi combinati superano i 33 caratteri. 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 asset. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji.

Il percorso non può contenere i caratteri barra (/) o nuova riga (\n).

Se il percorso include uno spazio, verrà sostituito con un carattere di sottolineatura (_) quando viene visualizzato l'annuncio.

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

Percorso 2

La seconda parte del percorso facoltativo che verrà aggiunta alla parte del dominio dell'URL visualizzato. La parte relativa al dominio dell'URL visualizzato, ad esempio https://www.contoso.com , verrà generata dal dominio dell'URL finale (campo URL finale ). Quindi, se è stato specificato un valore per Path 1 , verrà aggiunto all'URL di visualizzazione. Se è stato specificato anche un valore per Path 2, verrà aggiunto anche all'URL di visualizzazione dopo Path 1. Ad esempio, se l'URL finale contiene https://www.contoso.com, il percorso 1 è impostato su sottodirectory1 e il percorso 2 è impostato su sottodirectory2, l'URL visualizzato sarà https://www.contoso.com/subdirectory1/subdirectory2.

È possibile specificare il percorso 2 solo se è impostato anche il percorso 1 .

Il percorso 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?.

La lunghezza massima di input è di 1.000 caratteri se si includono stringhe di testo dinamiche. Non è possibile immettere più di 15 caratteri finali (non di testo dinamico). L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza del dominio URL finale e dei percorsi combinati supera i 67 caratteri.

Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 1.000 caratteri se si includono stringhe di testo dinamiche. Non è possibile inserire più di 7 caratteri finali (non di testo dinamico). L'annuncio non verrà visualizzato o verrà usato il testo predefinito se la lunghezza del dominio URL finale e i percorsi combinati superano i 33 caratteri. 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 asset. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji.

Il percorso non può contenere i caratteri barra (/) o nuova riga (\n).

Se il percorso include uno spazio, verrà sostituito con un carattere di sottolineatura (_) quando viene visualizzato l'annuncio.

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

Stato

Stato del gruppo di asset.

I valori possibili sono Attivo, Eliminato, Scaduto o Sospeso. Lo stato Scaduto è di sola lettura.

Aggiungere: Opzionale. Il valore predefinito è Paused.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Data inizio

Data in cui il gruppo di asset può iniziare a servire; in caso contrario, il servizio può iniziare a servire il gruppo di asset il giorno in cui il gruppo di asset diventa attivo.

La data di inizio è inclusiva. Ad esempio, se si imposta Data di inizio sul 5/5/2020, il gruppo di asset inizierà alle 12:00 del 5/5/2020. L'ora si basa sul fuso orario specificato a livello di campagna.

Aggiungere: Opzionale. Se non si imposta questo campo o se la data da inviare è precedente alla data odierna, verrà impostata la data odierna e il servizio potrà iniziare a servire il gruppo di asset non appena lo stato del gruppo di asset è attivo.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. La data di inizio non può essere aggiornata dopo l'invio del gruppo di asset, ad esempio dopo l'arrivo della data di inizio.
Elimina: Sola lettura