Record annuncio di testo - Bulk
Definisce un annuncio di testo che può essere scaricato e caricato in un file bulk.
Importante
A partire da aprile 2020, la distribuzione di annunci di testo standart (STA) non è supportata.
Gli annunci di testo standard sono stati deprecati a favore degli annunci di testo espansi (EXTA). Il supporto per l'aggiunta e l'aggiornamento di annunci di testo standard è terminato il 31 luglio 2017. Ora, gli inserzionisti possono ottenere ed eliminare, ma non possono più aggiungere nuove autorità di sicurezza o aggiornare gli annunci di testo standard esistenti. Un'eccezione alla regola è che è comunque possibile aggiornare lo stato STA, ad esempio da Attivo a Sospeso. In caso contrario, i tentativi di aggiungere o aggiornare gli STA genereranno l'errore CampaignServiceAdTypeInvalid .
È possibile scaricare tutti i record di Annunci di testo nell'account includendo il valore DownloadEntity di TextAds 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 aggiunto un nuovo annuncio di testo se viene specificato un valore id padre valido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Text Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,contoso.com,,,All,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,,,,
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkTextAd , 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 BulkTextAd
var bulkTextAd = new BulkTextAd
{
// '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
// TextAd object of the Campaign Management service.
TextAd = new TextAd
{
// 'Ad Format Preference' column header in the Bulk file
AdFormatPreference = "All",
// 'Destination Url' column header in the Bulk file
DestinationUrl = null,
// 'Device Preference' column header in the Bulk file
DevicePreference = 0,
// 'Display Url' column header in the Bulk file
DisplayUrl = "contoso.com",
// '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"
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales!",
// 'Title' column header in the Bulk file
Title = "Contoso Quick Setup",
// '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(bulkTextAd);
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 di annunci di testo , i campi dell'attributo seguenti sono disponibili nello schema file bulk.
- Preferenza formato annuncio
- Gruppo di annunci
- Campagna
- Client Id
- Parametro personalizzato
- Preferenza dispositivo
- URL di visualizzazione
- Stato di appello editoriale
- Posizione editoriale
- Codice motivo editoriale
- Stato editoriale
- Termine editoriale
- URL finale
- Id
- URL finale per dispositivi mobili
- Ora modifica
- Parent Id
- Paesi di pubblicazione
- Stato
- Testo
- Titolo
- Modello di rilevamento
Preferenza formato annuncio
Il campo Preferenza formato annunci viene usato per indicare se preferisci o meno che la copia dell'annuncio venga visualizzata agli utenti come annuncio di ricerca o di pubblico. Gli annunci di ricerca tendono a essere scritti come un invito all'azione, mentre gli annunci del pubblico devono essere scritti in uno stile più informativo. Anche se hai la possibilità di usare gli annunci di testo di ricerca come annunci per il pubblico, la designazione di un annuncio come formato preferito per gli annunci audience ti consente di ottimizzare la messaggistica per la distribuzione nativa.
Importante
Devi definire almeno un annuncio di testo per gruppo di annunci che non preferisce gli annunci del pubblico, altrimenti la copia dell'annuncio di tutti gli annunci di testo sarà idonea sia per gli annunci di ricerca che per gli annunci del pubblico.
I valori possibili sono Audience Ad e All. Se impostato su Tutto, l'annuncio sarà idoneo per i formati di annunci sia di ricerca che di pubblico. Se impostato su Audience Ad, l'annuncio sarà idoneo solo per il formato degli annunci del pubblico.
Aggiungere: Non supportato
Aggiornamento: Non supportato
Elimina: Sola lettura
Gruppo di annunci
Nome del gruppo di annunci che contiene l'annuncio.
Aggiungere: Non supportato
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio
Nota
Per l'aggiornamento e l'eliminazione, è necessario specificare il campo Id padre o Gruppo di annunci .
Campagna
Nome della campagna che contiene il gruppo di annunci e l'annuncio.
Aggiungere: Non supportato
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: Non supportato
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: Non supportato
Aggiornamento: Non supportato
Elimina: Sola lettura
Preferenza dispositivo
Questo campo determina se la preferenza è che gli annunci di testo vengano visualizzati in tutti i dispositivi o solo nei dispositivi mobili.
I valori possibili sono Tutti e Dispositivi mobili, che differiscono dai valori usati nel servizio di gestione della campagna.
Il valore predefinito è All.
Nel file dei risultati di download e caricamento bulk questo campo non sarà mai vuoto. Se non è stata specificata una preferenza per il dispositivo, verrà restituito il valore predefinito All.If you did not specify a device preference, the default value of All will be returned.
Importante
Devi definire almeno un annuncio di testo per gruppo di annunci non preferito per dispositivi mobili, altrimenti la copia pubblicitaria di tutti gli annunci di testo sarà idonea per tutti i dispositivi.
Aggiungere: Non supportato
Aggiornamento: Non supportato
Elimina: Sola lettura
URL di visualizzazione
URL da visualizzare nell'annuncio.
La sottodirectory dell'URL di visualizzazione può contenere stringhe di testo dinamico, ad esempio {parola chiave}; Tuttavia, il nome host DELL'URL non può contenere testo dinamico. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.
La lunghezza di input massima dell'URL è di 200 caratteri e può contenere stringhe di testo dinamico. Tuttavia, l'annuncio non verrà visualizzato se l'URL supera i 35 caratteri dopo la sostituzione dinamica del testo.
Aggiungere: Non supportato
Aggiornamento: Non supportato
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.
Aggiungere: Non supportato
Aggiornamento: Sola lettura
Elimina: Sola lettura
Posizione editoriale
Componente o proprietà dell'annuncio che ha avuto esito negativo nella revisione editoriale.
Aggiungere: Non supportato
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: Non supportato
Aggiornamento: Sola lettura
Elimina: Sola lettura
Stato editoriale
Lo stato editoriale dell'annuncio.
I valori possibili sono descritti nella tabella seguente.
Aggiungere: Non supportato
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: Non supportato
Aggiornamento: Sola lettura
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 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: Non supportato
Aggiornamento: Non supportato
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 Text 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: Non supportato
Aggiornamento: Non supportato
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: Non supportato
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: Non supportato
Aggiornamento: Sola lettura
Elimina: Sola lettura
Nota
Per l'aggiornamento e l'eliminazione, è necessario specificare il campo Id padre o Gruppo di annunci .
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: Non supportato
Aggiornamento: Sola lettura
Elimina: Sola lettura
Stato
Stato dell'annuncio.
I valori possibili sono Attivo, Sospeso o Eliminato.
Aggiungere: Non supportato
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.
Testo
Copia dell'annuncio.
Il testo deve contenere almeno una parola e può contenere stringhe di testo dinamico, ad esempio {parola chiave}. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.
La lunghezza di input massima della copia è di 300 caratteri e può contenere stringhe di testo dinamiche. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera gli 80 caratteri dopo la sostituzione dinamica del testo. Si noti che per i gruppi di annunci che usano il cinese tradizionale la lunghezza di input massima della copia è di 150 caratteri e il testo è limitato a 40 caratteri dopo la sostituzione.
Il testo non può contenere il carattere di nuova riga (\n).
Aggiungere: Non supportato
Aggiornamento: Non supportato
Elimina: Sola lettura
Titolo
Titolo dell'annuncio.
Il titolo deve contenere almeno una parola. La copia e il titolo dell'annuncio combinati devono contenere almeno tre parole.
Il titolo può contenere stringhe di testo dinamico, ad esempio {keyword}. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.
La lunghezza massima di input del titolo è di 80 caratteri e può contenere stringhe di testo dinamiche. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 25 caratteri dopo la sostituzione dinamica del testo. Si noti che per i gruppi di annunci che usano il cinese tradizionale, il titolo è limitato a 15 caratteri dopo la sostituzione.
Il titolo non può contenere il carattere di nuova riga (\n).
Aggiungere: Non supportato
Aggiornamento: Non supportato
Elimina: Sola lettura
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: Non supportato
Aggiornamento: Non supportato
Elimina: Sola lettura