Condividi tramite

Record di annunci reattivi - Bulk

  • Articolo

Definisce un annuncio reattivo che può essere scaricato e caricato in un file bulk.

Gli annunci reattivi si adattano automaticamente in base alle dimensioni e alle forme dei formati degli annunci del pubblico. Questi annunci funzionano meglio con testo informativo piuttosto che chiamate all'azione.

Nota

Questa funzionalità è attualmente disponibile negli Stati Uniti, in Canada, nel Regno Unito e in Australia. Se annunci negli Stati Uniti, in Canada, nel Regno Unito o in Australia e desideri acconsentire esplicitamente agli annunci del pubblico, contatta il supporto tecnico.

Nota

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

È possibile scaricare tutti i record degli annunci reattivi nell'account includendo il valore DownloadEntity di ResponsiveAds 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 aggiunge un nuovo annuncio reattivo se viene fornito un valore di ID padre valido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkResponsiveAd , 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 BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
    // '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 
    // ResponsiveAd object of the Campaign Management service.
    ResponsiveAd = new ResponsiveAd
    {
        // 'Call To Action' column header in the Bulk file
        CallToAction = CallToAction.AddToCart,
        // '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
        Headline = "Short Headline Here",
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Images' column header in the Bulk file
        Images = new[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new ImageAsset
                {
                    CropHeight = null,
                    CropWidth = null,
                    CropX = null,
                    CropY = null,
                    Id = landscapeImageMediaId,
                    SubType = "LandscapeImageMedia"
                },
            },
        },
        // 'Long Headline' column header in the Bulk file
        LongHeadlineString = "Long Headline Here",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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(bulkResponsiveAd);

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 reattivi , i campi di attributo seguenti sono disponibili nello schema file bulk.

Gruppo di annunci

Nome del gruppo di annunci che contiene l'annuncio.

Aggiungere: Sola lettura e Obbligatorio
Aggiornare: Sola lettura e Obbligatorio
Cancellare: Sola lettura e Obbligatorio

Nota

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

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
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

Chiamata all'azione

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

Ecco la chiamata alle azioni disponibili per gli annunci multimediali di ricerca:

Invito all'azione
Agisci ora
Applica ora
Scommetti ora
Fai un'offerta immediata
Prenota un'auto
Prenota hotel
Prenota ora
Compila ora
Acquista subito
Chat adesso
Confrontare
Contattaci
Rivenditori
Indicazioni
Donare
Scarica
Posta elettronica ora
Registra ora
File ora
Trova processo
Trova store
Gioco gratuito
Offerta gratuita
Versione di valutazione gratuita
Ottenere un coupon
Ottenere offerte
Get Demo
Ottieni ora
Ottenere un'offerta
Ottieni offerta
Vai alla demo
Iscriviti ora
Ulteriori informazioni
Ascolta ora
Accedi
Ordina ora
Gioco
Gioca ora
Post-processo
Registrazione
Rinnovare ora
Noleggia un'auto
Noleggia ora
Riordinare
Riservare
Salva ora
Pianificazione
Vedere la demo
Visualizza menu
Vedere i modelli
Vedere l'offerta
Vedi le offerte
Vedi vendita
Vendi ora
Acquista ora
Showtimes
Accesso
Effettuare la registrazione
Iniziare subito
Abbonati
Giro di prova
Provare ora
Visualizzare le automobili
Visualizzare la demo
Visualizzare i piani
Visita il negozio
Vota ora
Guarda
Guarda di più
Guarda il video

Aggiungere: Non applicabile per gli annunci del pubblico.
Aggiornare: Sola lettura
Cancellare: Sola lettura

Call To Action Langauge

Lingua in cui verrà servita la chiamata all'azione.

L'invito all'azione verrà sempre fornito in questa lingua, indipendentemente dalle impostazioni della lingua della campagna.

Ecco i linguaggi di invito all'azione disponibili per gli annunci multimediali di ricerca:

Invito all'azione
Lingua.albanese
Language.Arabic
Language.Bosnian
Lingua.Bulgaro
Lingua.Croato
Language.Czech
Lingua.Danese
Lingua.Olandese
Language.English
Lingua.Estone
Lingua.Finlandese
Lingua.Francese
Lingua.Tedesco
Lingua.Greco
Lingua.Ebraico
Lingua.Ungherese
Language.Icelandic
Lingua.Italiano
Lingua.Giapponese
Language.Lettone
Lingua.Lituano
Language.Macedonian
Language.Malta
Lingua.Norvegese
Language.Polish
Language.Portuguese
Lingua.Romeno
Lingua.Russo
Lingua.Serbo
Lingua.Slovacco
Lingua.Sloveno
Lingua.Spagnolo
Lingua.Svedese
Language.TraditionalChinese
Language.Turkish

Aggiungere: Non applicabile per gli annunci del pubblico; Obbligatorio per gli annunci multimediali.
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

Campagna

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

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: 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
Aggiornare: Opzionale
Cancellare: 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
Aggiornare: 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.
Cancellare: Sola lettura

Descrizioni

A seconda del posizionamento dell'annuncio del pubblico, questo testo verrà visualizzato sotto o adiacente al titolo lungo o breve dell'annuncio.

Hai più spazio per i caratteri da usare nel testo dell'annuncio che nel titolo. Quindi, una volta che le immagini e il titolo hanno un potenziale attenzione del cliente, il testo dell'annuncio deve convincerli a fare clic su di esso. Cosa distingue il prodotto o il servizio?

Il testo deve contenere almeno una parola.

Il limite massimo delle descrizioni è 5. La lunghezza della stringa è limitata a 90 caratteri. Il formato dei dati dei titoli è incluso nell'esempio JSON seguente.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Aggiungere: Obbligatorio per gli annunci del pubblico e gli annunci multimediali. Non applicabile per gli annunci video. Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Cancellare: 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
Appellabile 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
Aggiornare: Sola lettura
Cancellare: Sola lettura

Posizione editoriale

Componente o proprietà dell'annuncio che ha avuto esito negativo nella revisione editoriale.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: 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
Aggiornare: Sola lettura
Cancellare: 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
Aggiornare: Sola lettura
Cancellare: 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
Aggiornare: Sola lettura
Cancellare: 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
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

Suffisso URL finale

Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche.

Aggiungere: Opzionale
Aggiornare: 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.
Cancellare: Sola lettura
Okay

Titolo

Questo è uno dei due titoli possibili che potrebbero apparire nei tuoi annunci video.

Poiché gli annunci video sono reattivi, sono necessari più titoli in modo che possano essere pubblicati in modo flessibile in diversi editori e posizionamenti.

La lunghezza della stringa è limitata a 30 caratteri.

Aggiungere: Obbligatorio per gli annunci video. Non applicabile per gli annunci multimediali e gli annunci del pubblico. Aggiornare: Opzionale. Deprecato per gli annunci multimediali e di pubblico. Usare invece i titoli.
Cancellare: Sola lettura

Titoli

Poiché gli annunci del pubblico sono reattivi, sono necessari più titoli in modo che possano essere pubblicati in modo flessibile in diversi editori e posizionamenti.

Il limite superiore dei titoli è 15. E la lunghezza di ogni titolo è limitata a 30 caratteri. Il formato dei dati dei titoli è incluso nell'esempio JSON seguente.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Aggiungere: Obbligatorio per gli annunci multimediali e gli annunci del pubblico. Non applicabile per gli annunci video. Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

Id

Identificatore generato dal sistema dell'annuncio.

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. Un identificatore negativo impostato per l'annuncio può quindi essere fatto riferimento nel campo Id padre dei tipi di record dipendenti, ad esempio Responsive 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.
Aggiornare: Sola lettura e Obbligatorio
Cancellare: Sola lettura e Obbligatorio

Immagini

Poiché gli annunci del pubblico sono reattivi, è possibile creare più asset di immagini con dimensioni e proporzioni diverse in modo che possano essere visualizzati in modo flessibile tra diversi editori e posizionamenti.

Nota

Al momento, SubType OriginalImage sostituisce il ruolo di LandscapeImageMedia come immagine predefinita per ResponsiveAd of Audience Campaign.

È necessario specificare solo un asset OriginalImage, ad esempio questo campo deve contenere un asset immagine con sottoTipo impostato su OriginalImage. Le dimensioni consigliate per OriginalImage sono 1200 larghezza x 628 altezza. Facoltativamente, è possibile includere collegamenti di asset aggiuntivi, ad esempio un asset immagine per ogni sottotipo supportato. Per qualsiasi sottotipo di asset di immagine non impostato in modo esplicito, Microsoft Advertising creerà automaticamente collegamenti agli asset di immagine ritagliando l'immagine originale.

Nota

Se questo campo è impostato (non vuoto), l'ID del supporto immagine orizzontale e l'ID del supporto immagine quadrata vengono entrambi ignorati.

Gli asset di immagine sono rappresentati nel file bulk come stringa JSON. Nell'esempio JSON seguente sono incluse nove immagini e solo OriginalImage 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": "OriginalImage"
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 512,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 128,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

Nota

Nel file bulk separato da virgole è necessario racchiudere l'elenco di collegamenti di asset, ogni chiave di attributo e ogni valore stringa di attributo con un set aggiuntivo di virgolette doppie, ad esempio la stringa JSON precedente verrà scritta come "[{""id"":1234567890000,""subType":""OriginalImage""},{""id"":1234567890000,""subType"":""LandscapeLogoMedia"",""cropX"":0,""cropY"":0,""cropWidth":512,""cropHeight"":128},{""id"":1234567890000, ""subType":""SquareLogoMedia"",""cropX"":0,""cropY"":0,""cropWidth"":128,""cropHeight"":128},{""id"":1234567890000,""subType"":""SquareImageMedia"",""cropX"":286,""cropY"":0,""cropWidth"":628,""cropHeight"":628},{""id"":1234567890000,"""subType"":""ImageMedia169X100"","cropX"":70,""cropY"":0,""cropWidth"":1061,""cropHeight"":628},{""id"":1234567890000,""subType":""ImageMedia93X100"","cropX"":308,""cropY"":0,""cropWidth"":584,""cropHeight"":628},{""id"":1234567890000,""subType":"ImageMedia15X10"",""cropX"":129,""cropY"":0,""cropWidth"":942,""cropHeight":628},{""id"":1234567890000,""subType"":"ImageMedia155X100"","cropX"":114,""cropY"":0,""cropWidth"":973,"""cropHeight"":628},{""id"":1234567890000,""subType":""ImageMedia133X100"",""cropX"":183,""cropY"":0,""cropWidth""::835,""cropHeight"":628},{""id"":1234567890000,""subType":""ImageMedia178X100"",""cropX"":41,""cropY"":0,"" cropWidth"":1118,""cropHeight":628},{""id"":1234567890000,""subType":""ImageMedia172X100"","cropX"":60,""cropY"":0,""cropWidth"":1080,""cropHeight"":628}]".

Dato l'esempio JSON della risposta di caricamento precedente, tenere presente quanto segue:

  • Lo stesso identificatore di asset di immagine (ad esempio, 1234567890000) viene usato per tutti i sottotipi di asset immagine generati automaticamente. Indipendentemente dal fatto che microsoft advertising generi automaticamente le immagini ritagliate, l'ID non deve essere univoco tra gli asset di immagine collegati allo stesso annuncio.
  • Poiché l'annuncio in questo esempio è stato creato senza impostazioni di ritaglio per il sottotipo di asset immagine OriginalImage, tutti gli asset immagine vengono ritagliati ad eccezione dell'immagine associata OriginalImage.
  • Indipendentemente dal fatto che OriginalImage abbia impostazioni di ritaglio personalizzate, Microsoft Advertising usa la vera altezza dell'immagine associata a OriginalImage per tutte le impostazioni di ritaglio predefinite. In questo esempio l'altezza del ritaglio per tutti gli asset di immagine generati dal sistema è 628 e possiamo dedurre che il sottotipo OriginalImage (OriginalImage) con proporzioni 1.91:1 ha larghezza e altezza pari a 1200x628. Anche se il collegamento asset OriginalImage è stato creato con impostazioni di ritaglio, ad esempio 703x368, le impostazioni di ritaglio degli asset immagine generati automaticamente sono basate sulle dimensioni complete di OriginalImage (anche in questo esempio sarebbe 1200x628).
  • Anche se nell'API Bing Ads versione 12 è possibile usare l'ID immagine orizzontale e l'ID del supporto immagine quadrata, questi campi sono deprecati e verranno rimossi in una versione futura. Si ha maggiore flessibilità e controllo delle immagini ritagliate tramite il campo Immagini .

cropHeight

Numero di pixel da usare dall'origine dell'asset dell'immagine, a partire dalla posizione cropY e spostandosi verso l'alto.

cropWidth

Numero di pixel da usare dall'origine dell'asset dell'immagine, a partire dalla posizione cropX e passando a destra.

cropX

A partire dall'angolo inferiore sinistro dell'origine dell'asset dell'immagine, si tratta del numero di pixel da ignorare a destra sull'asse x prima di applicare cropWidth.

cropY

A partire dall'angolo inferiore sinistro dell'origine dell'asset dell'immagine, si tratta del numero di pixel da ignorare verso l'alto sull'asse y prima di applicare cropHeight.

id

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

Lo stesso identificatore di asset di immagine può essere usato più volte nello stesso annuncio per proporzioni diverse e può essere usato anche da più annunci nello stesso account Microsoft Advertising. L'identificatore dell'asset immagine con SubType impostato su LandscapeImageMedia viene usato per tutti i sottotipi di asset immagine generati automaticamente all'interno dello stesso annuncio. Indipendentemente dal fatto che microsoft advertising generi automaticamente le immagini ritagliate, l'ID non deve essere univoco tra gli asset di immagine collegati allo stesso annuncio.

È 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. Se non si specificano le impostazioni di ritaglio, il servizio verrà automaticamente visualizzato fino all'area massima possibile dal centro dell'immagine. Ad esempio, data un'immagine di 1000x1000 pixel, per le proporzioni 1.91:1, l'impostazione di ritaglio automatico sarà cropWidth=1000, cropHeight=524, cropX=0 e cropY=238.

I possibili valori di sottotipo includono OriginalImage, LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia4x1, ImageMedia1x2, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100 e ImageMedia153X100. 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
OriginalImage N/D 703 larghezza x 368 altezza
LandscapeImageMedia 1.91:1 300 larghezza x 157 altezza
SquareImageMedia 1:1 114 larghezza x 114 altezza
ImageMedia4x1 4:1 608 larghezza x 152 altezza
ImageMedia1x2 1:2 470 larghezza x 940 altezza
ImageMedia201X100 2.01:1 612 larghezza x 304 altezza
ImageMedia120X100 1.2:1 300 larghezza x 250 altezza
ImageMedia200X100 2:1 200 larghezza x 100 altezza
ImageMedia169X100 1.69:1 628 larghezza x 372 altezza
ImageMedia124X100 1.24:1 104 larghezza x 84 altezza
ImageMedia153X100 1.53:1 306 larghezza x 200 altezza

Aggiungere: Obbligatorio se l'ID multimediale dell'immagine orizzontale è vuoto. Per ogni collegamento di asset sono necessari solo l'ID e il sottoTipo .
Aggiornare: 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 .
Cancellare: Sola lettura

URL di rilevamento impressioni

URL per i pixel di rilevamento delle impressioni 1x1. Ogni pixel segnalerà le impressioni di Microsoft Audience Network al tuo strumento di creazione di report pubblicitari di terze parti.

Puoi includere fino a 2 URL di rilevamento delle impressioni per ogni annuncio reattivo. Ogni URL è delimitato da un punto e virgola e da uno spazio ("; ").

Ogni URL deve essere accessibile. La lunghezza dell'URL è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.

Per ogni impressione di Microsoft Audience Network, Microsoft eseguirà il ping dell'URL per abilitare il rilevamento delle impressioni nello strumento di creazione di report pubblicitari di terze parti. Il rilevamento utenti di livello avanzato, ad esempio il rilevamento o il rilevamento delle conversioni in base ai cookie o agli indirizzi IP, non è supportato.

Aggiungere: Opzionale
Aggiornare: 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.
Cancellare: Sola lettura

ID multimediale immagine orizzontale

Identificatore dell'asset di immagine usato per le immagini orizzontali con proporzioni 1.91:1 che potrebbero essere visualizzate negli annunci del pubblico.

Le proporzioni del supporto dell'immagine archiviata possono variare, purché le impostazioni di ritaglio dell'asset di immagine comportino le proporzioni supportate per questo campo. Per confermare le proporzioni effettive con le impostazioni di ritaglio, usare il campo Immagini .

Nota

Anche se nell'API Bing Ads versione 12 è possibile usare l'ID del supporto immagine orizzontale e SquareImageMediaId, questi campi sono deprecati e verranno rimossi in una versione futura. Si ha maggiore flessibilità e controllo delle immagini ritagliate tramite il campo Immagini .

Aggiungere: Obbligatorio se images non è impostato. Se images è impostato, questo campo viene ignorato.
Aggiornare: Opzionale. Se images è impostato, questo campo viene ignorato. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

ID multimediale del logo orizzontale

Questo campo è riservato per l'uso interno e verrà rimosso da una versione futura dell'API Bing Ads.

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

Titolo lungo

Questo è uno dei due titoli possibili che potrebbero apparire negli annunci del pubblico.

Poiché gli annunci del pubblico sono reattivi, sono necessari più titoli in modo che possano essere pubblicati in modo flessibile in diversi editori e posizionamenti.

La lunghezza della stringa è limitata a 90 caratteri.

Aggiungere: Obbligatorio
Aggiornare: Deprecato. Usare invece Titoli lunghi.
Cancellare: Sola lettura

Titoli lunghi

Poiché gli annunci del pubblico sono reattivi, sono necessari più titoli in modo che possano essere pubblicati in modo flessibile in diversi editori e posizionamenti.

Il limite superiore dei titoli lunghi è 5. E la lunghezza di ogni titolo è limitata a 90 caratteri. Il formato dei dati dei titoli lunghi è incluso nell'esempio JSON seguente.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Aggiungere: Obbligatorio per gli annunci multimediali e gli annunci del pubblico. Non applicabile per gli annunci video. Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

Stringa titolo lungo

I titoli sono il testo più importante che appare nel tuo annuncio, quindi dovresti sfruttare al meglio i caratteri disponibili. Poiché gli annunci del pubblico sono reattivi, sono necessari più titoli in modo che possano essere pubblicati in modo flessibile in diversi editori e posizionamenti.

La lunghezza di ogni titolo è limitata a 90 caratteri. Il formato dei dati dei titoli lunghi è incluso nell'esempio JSON seguente.

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

Aggiungere: Obbligatorio per gli annunci del pubblico e video. Non applicabile per gli annunci multimediali. Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

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
Aggiornare: 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.
Cancellare: 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
Aggiornare: Sola lettura
Cancellare: 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.
Aggiornare: Sola lettura
Cancellare: Sola lettura

Nota

Per aggiungere, aggiornare ed eliminare, è 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: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Stato

Stato dell'annuncio.

I valori possibili sono Attivo, Sospeso o Eliminato.

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

ID supporto immagine quadrata

Identificatore dell'asset di immagine usato per le immagini quadrate con proporzioni 1:1 che potrebbero essere visualizzate negli annunci del pubblico.

Le proporzioni del supporto dell'immagine archiviata possono variare, purché le impostazioni di ritaglio dell'asset di immagine comportino le proporzioni supportate per questo campo. Per confermare le proporzioni effettive con le impostazioni di ritaglio, usare il campo Immagini .

Nota

Anche se nell'API Bing Ads versione 12 è possibile usare l'ID del supporto immagine orizzontale e SquareImageMediaId, questi campi sono deprecati e verranno rimossi in una versione futura. Si ha maggiore flessibilità e controllo delle immagini ritagliate tramite il campo Immagini .

Aggiungere: Opzionale. Se images è impostato, questo campo viene ignorato e Microsoft Advertising creerà automaticamente un nuovo asset immagine quadrata ritagliando l'asset immagine LandscapeImageMedia. Se Immagini non è impostato e non si imposta questo campo, Microsoft Advertising creerà automaticamente un nuovo asset di immagine quadrata ritagliando l'ID multimediale dell'immagine orizzontale.
Aggiornare: Opzionale. Se images è impostato, questo campo viene ignorato e Microsoft Advertising creerà automaticamente un nuovo asset immagine quadrata ritagliando l'asset immagine LandscapeImageMedia. Se Immagini non è impostato e non si imposta questo campo, Microsoft Advertising creerà automaticamente un nuovo asset di immagine quadrata ritagliando l'ID multimediale dell'immagine orizzontale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

ID supporto logo quadrato

Questo campo è riservato per l'uso interno e verrà rimosso da una versione futura dell'API Bing Ads.

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

Testo

A seconda del posizionamento dell'annuncio video, questo testo verrà visualizzato sotto o adiacente al titolo lungo o breve dell'annuncio.

Hai più spazio per i caratteri da usare nel testo dell'annuncio che nel titolo. Quindi, una volta che le immagini e il titolo hanno un potenziale attenzione del cliente, il testo dell'annuncio deve convincerli a fare clic su di esso. Cosa distingue il prodotto o il servizio?

Il testo deve contenere almeno una parola.

La lunghezza della stringa è limitata a 90 caratteri.

Il testo non può contenere il carattere di nuova riga (\n).

Aggiungere: Obbligatorio per gli annunci video. Non applicabile agli annunci del pubblico o agli annunci multimediali. Aggiornare: Facoltativo per gli annunci video. Usa le descrizioni invece per gli annunci del pubblico o gli annunci multimediali (deprecati).
Cancellare: 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: Opzionale
Aggiornare: 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.
Cancellare: Sola lettura