Record degli annunci di ricerca reattiva - Bulk

Definisce un formato di annuncio di ricerca reattivo per gli annunci di testo nella rete di ricerca che possono essere scaricati e caricati in un file bulk.

Nota

Gli annunci di ricerca reattivi duplicati sono consentiti nello stesso gruppo di annunci.

Gli annunci di ricerca reattivi consentono di impostare tra 3-15 titoli pubblicitari univoci (ad esempio "titoli") e descrizioni di annunci da 2 a 4 all'interno di un singolo annuncio. Da qui, Bing selezionerà la combinazione di titolo e descrizione più rilevante per ogni query specificata e l'utente di ricerca corrispondente. Consentendo a Bing IA di selezionare il titolo e la descrizione più rilevanti per ogni query, ci assicuriamo che il messaggio giusto venga inviato a ogni potenziale cliente, al momento giusto, attraverso tutti i possibili segnali di finalità.

Gli annunci reattivi visualizzati agli utenti appaiono identici agli annunci di testo espansi, ad esempio fino a 3 titoli (parti del titolo tramite annunci di testo espansi) e 2 descrizioni (parti di testo tramite annunci di testo espansi). Tuttavia, a seconda delle dimensioni dello schermo, l'annuncio potrebbe essere visualizzato senza il terzo titolo o la seconda descrizione.

Quando crei annunci di ricerca reattivi, gli elenchi Descrizione e Titolo vengono archiviati come asset di testo che possono essere condivisi da qualsiasi annuncio di ricerca reattivo all'interno dell'account. Ad esempio, se "Seamless Integration" è un asset di testo, si noterà che ha lo stesso identificatore di asset in tutti gli annunci che si collegano a "Seamless Integration" 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.

Nota

Gli annunci di ricerca reattivi possono essere creati solo nelle campagne di ricerca in cui il tipo di gruppo di annunci è impostato su "SearchStandard". Se il tipo di gruppo di annunci è impostato su "SearchDynamic", il gruppo di annunci non supporta gli annunci di ricerca reattivi.

È possibile scaricare tutti i record degli annunci di ricerca reattiva nell'account includendo il valore DownloadEntity di ResponsiveSearchAds 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.

L'esempio csv bulk seguente aggiungerebbe un nuovo annuncio di ricerca reattivo se viene fornito un valore di ID padre valido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Description,Path 1,Path 2,Domain,Headline
Format Version,,,,,,,,,6.0,,,,,,,,,,,,
Responsive Search Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,,{_promoCode}=PROMO1; {_season}=summer,"[{""text"":""Find New Customers & Increase Sales!"",""pinnedField"":""Description1""},{""text"":""Start Advertising on Contoso Today.""}]",seattle,shoe sale,,"[{""text"":""Contoso"",""pinnedField"":""Headline1""},{""text"":""Quick & Easy Setup""},{""text"":""Seamless Integration""}]"

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkResponsiveSearchAd , 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 BulkResponsiveSearchAd
var bulkResponsiveSearchAd = new BulkResponsiveSearchAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ResponsiveSearchAd object of the Campaign Management service.
    ResponsiveSearchAd = new ResponsiveSearchAd
    {
        // 'Description' column header in the Bulk file
        Descriptions = new AssetLink[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Find New Customers & Increase Sales!"
                },
                PinnedField = "Description1"
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Start Advertising on Contoso Today."
                },
            },
        },
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Headline' column header in the Bulk file
        Headlines = new AssetLink[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Contoso"
                },
                PinnedField = "Headline1"
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Quick & Easy Setup"
                },
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Seamless Integration"
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = responsiveSearchAdIdKey,
        // 'Path 1' column header in the Bulk file
        Path1 = "seattle",
        // 'Path 2' column header in the Bulk file
        Path2 = "shoe sale",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkResponsiveSearchAd);

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 ad ricerca reattiva , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

• Gruppo di annunci
• Campagna
• Client Id
• Parametro personalizzato
• Descrizione
• Dominio
• Stato di appello editoriale
• Posizione editoriale
• Codice motivo editoriale
• Stato editoriale
• Termine editoriale
• URL finale
• Titolo
• Suffisso URL finale
• Id
• URL finale per dispositivi mobili
• Ora modifica
• Parent Id
• Percorso 1
• Percorso 2
• Paesi di pubblicazione
• Stato
• Modello di rilevamento

Gruppo di annunci

Nome del gruppo di annunci che contiene l'annuncio.

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 Gruppo di annunci .

Campagna

Nome della campagna che contiene il gruppo di annunci e l'annuncio.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
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 8 coppie chiave parametro e valore personalizzate 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 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

Descrizione

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.

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 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 4 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 editorialStatuspinnedField sono proprietà del collegamento dell'asset, ad esempio la relazione tra l'asset e l'annuncio. Per altri dettagli, vedere editorialStatus, id, pinnedField e testo di seguito.

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

Nota

Nel file bulk separato da virgole è necessario racchiudere l'elenco di collegamenti di asset, ogni chiave di attributo e ogni valore della 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!"",""pinnedField"":""Description1""},{""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",
	"pinnedField": "Description1",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Aggiungere: Obbligatorio. È necessario l'elenco di 2-4 descrizioni. Vengono rispettati solo il campo aggiunto e 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-4 descrizioni. Vengono rispettati solo il campo aggiunto e 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 negli 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.

pinnedField

Per aggiungere un asset a una posizione di descrizione specifica, impostare l'attributo pinnedField su "Description1" o "Description2". A meno che non si disponga di un requisito specifico per un asset di testo, non aggiungerlo e consentire a Bing IA di ottimizzare il posizionamento del testo.

Almeno un asset di testo idoneo deve essere disponibile per ogni posizione di descrizione, quindi non è possibile aggiungere tutti gli asset alla stessa posizione. Ad esempio, è possibile aggiungere 3 asset di testo a Description1, purché sia presente almeno un asset di testo nell'elenco Descrizione dell'annuncio di ricerca reattivo che non è stato aggiunto o aggiunto a Description2.

Quando si scarica un asset non aggiunto, l'attributo pinnedField non viene restituito.

Testo

L'attributo di text 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 dell'attributo di text 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.

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

Dominio

URL che verrà visualizzato anziché l'URL finale. L'URL finale verrà comunque usato per l'URL della pagina di destinazione.

Riservato per un utilizzo pilota limitato, ad esempio clienti farmaceutici.

La parte di dominio dell'URL in combinazione con le stringhe path 1 e path 2 non può superare i 67 caratteri.

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

Lo stato editoriale dell'annuncio.

I valori possibili sono descritti nella tabella seguente.

Valore	Descrizione
Attivazione	L'annuncio ha superato la revisione editoriale.
ActiveLimited	L'annuncio ha superato la revisione editoriale in uno o più mercati e uno o più elementi dell'annuncio sono sottoposti a revisione editoriale in un altro mercato. Ad esempio, l'annuncio ha superato la revisione editoriale per il Canada ed è ancora in attesa di revisione negli Stati Uniti.
Approvato	La recensione editoriale dell'annuncio non è riuscita.
Inattivo	Uno o più elementi dell'annuncio 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

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.

Si noti inoltre che se i campi Modello di rilevamento o Parametro personalizzato sono impostati, è necessario almeno un URL finale.

Nota

Questo URL viene usato solo se la parola chiave non specifica un URL finale.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale
Elimina: Sola lettura

Titolo

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

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, 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. Tre titoli sono inclusi nell'esempio JSON seguente e solo il primo titolo viene aggiunto a una posizione specifica. text E id sono proprietà dell'asset, mentre e editorialStatuspinnedField sono proprietà del collegamento dell'asset, ad esempio la relazione tra l'asset e l'annuncio. Per altri dettagli, vedere editorialStatus, id, pinnedField e testo di seguito.

[{
	"text": "Contoso",
	"pinnedField": "Headline1"
},
{
	"text": "Quick & Easy Setup"
},
{
	"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 stringa di attributo con un set aggiuntivo di virgolette doppie, ad esempio, la stringa JSON precedente verrà scritta come "[{""text":"Contoso"",""pinnedField"":""Headline1""},{""text":""Quick & Easy Setup"""},{""text":""Seamless Integration""}]".

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

[{
	"id": 3,
	"text": "Contoso",
	"pinnedField": "Headline1",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 4,
	"text": "Quick & Easy Setup",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 5,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Aggiungere: Obbligatorio. L'elenco di 3-15 titoli è obbligatorio. Vengono rispettati solo il campo aggiunto e 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. Vengono rispettati solo il campo aggiunto e 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 negli 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.

pinnedField

Per aggiungere un asset a una posizione del titolo specifica, impostare il valore stringa pinnedField su "Headline1", "Headline2" o "Headline3". A meno che non si disponga di un requisito specifico per un asset di testo, non aggiungerlo e consentire a Bing IA di ottimizzare il posizionamento del testo.

Almeno un asset di testo idoneo deve essere disponibile per ogni posizione del titolo, quindi non è possibile aggiungere tutti gli asset alla stessa posizione. Ad esempio, è possibile aggiungere 3 asset di testo a Headline1 e 3 asset di testo aggiunti a Headline2, purché almeno un asset di testo nell'elenco Titolo dell'annuncio di ricerca reattivo non sia aggiunto o aggiunto a Headline3.

Quando si scarica un asset non aggiunto, l'attributo pinnedField non viene restituito.

Testo

L'attributo di text 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 dell'attributo di text 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.

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

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.

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

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. È quindi possibile fare riferimento a un identificatore negativo impostato per l'annuncio nel campo Id padre dei tipi di record dipendenti, ad esempio Responsive Search Ad Label. Questa operazione è consigliata se si aggiungono nuovi annunci 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

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.

Nota

Questo URL viene usato solo se la parola chiave non specifica un URL finale per dispositivi mobili.

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 del gruppo di annunci che contiene l'annuncio.

Questo campo bulk viene mappato al campo Id del record gruppo di annunci .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore del gruppo di annunci esistente o un identificatore negativo uguale al campo Id del record gruppo di annunci padre. Questo è consigliato se si aggiungono nuovi annunci a un nuovo gruppo di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura
Elimina: Sola lettura

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .

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

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

Stato

Stato dell'annuncio.

I valori possibili sono Attivo, Sospeso 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 come impostazione predefinita per l'URL specificato con FinalUrls.

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