Condividi tramite

Dynamic Search Ad Record - Bulk

  • Articolo

Definisce un annuncio di ricerca dinamica che può essere scaricato e caricato in un file bulk.

Con gli annunci di ricerca dinamica, il titolo e l'URL di visualizzazione vengono generati automaticamente in base al dominio del sito Web e alla lingua di destinazione. La combinazione degli elementi Path1, Path2 e Text rende univoco l'annuncio di ricerca dinamica. Facoltativamente, è possibile fornire un titolo statico usando i feed di pagina.

Nota

Questa funzionalità è attualmente disponibile nei seguenti paesi: Albania (AL), Andorra (AD), Argentina (AR), Aruba, Australia (AU), Austria (AT), Bahamas (BS), Bangladesh(BD), Belgio (BE), Bolivia(BO), Bosnia ed Erzegovina (BA), Brasile (BR), Brunei(BN), Bulgaria (BG), Canada (CA), Isole Cayman(KY), Cile(CL), Colombia(CO), Costa Rica(CR), Croazia (HR), Cipro (CY), Repubblica Ceca (CZ), Danimarca (DK), Dominica (DM), Repubblica Dominicana(DO), Ecuador(EC), El Salvador(SV), Estonia (EE), Figi (FJ), Finlandia (FI), Francia (FR), Guyana francese (GF), Polinesia francese (PF), Germania (DE), Grecia (GR), Guam (GU), Guatemala (GT), Guyana (GY), Haiti (HT), Honduras (HN), Ungheria (HU), Islanda (IS), India (IN), Indonesia (ID), Irlanda (IE), Italia (IT), Lettonia (LV), Liechtenstein (LI), Lituania (LT), Lussemburgo (LU), Malaysia (MY), Maldive (MV), Malta (MT), Martinica (MQ), Messico (MX), Monaco (MC), Mongolia (MN), Montenegro (ME), Montserrat (MS), Nepal (NP), Paesi Bassi (NL) Nuova Caledonia (NC), Nuova Zelanda (NZ), Repubblica di Macedonia del Nord (MK), Norvegia (NO), Panama (PA), Paraguay (PY), Papua Nuova Guinea (PG), Perù (PE), Filippine (PH), Polonia (PO), Portogallo (PT), PortoRico, Romania (RO), San Marino (SM), Serbia (RS), Singapore(SG), Slovacchia (SK), Slovenia (SI), Sudafrica (ZA), Spagna (ES), Spagna(ES), Sri Lanka (LK), Svezia (SE), Svizzera (CH), Thailandia (TH), Trinidad e Tobago(TT), Türkiye (TR), Città del Vaticano (VA), Vietnam (VN), Regno Unito (Regno Unito), Stati Uniti (STATI Uniti), Uruguay (UY) e Venezuela (VE).

Il record dell'annuncio di ricerca dinamica può essere creato solo all'interno di campagne di ricerca con impostazioni di annunci di ricerca dinamica valide (inclusi i campi Lingua di dominio, Descrizione dinamica abilitata, ID feed di pagina, Origine e Sito Web ). L'ID esperimento della campagna deve essere impostato e il tipo di gruppo di annunci deve essere impostato su "SearchDynamic".

Nota

Non è più possibile aggiungere, aggiornare o recuperare campagne che supportano solo gli annunci di ricerca dinamica. Il tipo di campagna delle campagne esistenti è stato aggiornato da "DynamicSearchAds" a "Search". I gruppi di annunci sono ora considerati gruppi di annunci "dinamici", ma non ci sono modifiche strutturali, ad esempio contengono gli stessi obiettivi automatici e gli annunci di ricerca dinamica di prima.

È possibile scaricare tutti i record di Active Directory di Ricerca dinamica nell'account includendo il valore DownloadEntity di DynamicSearchAds 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 dinamica se viene fornito un valore di ID padre valido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,
Dynamic Search Ad,Active,,-1113,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,,,,,,,,,,,,{_promoCode}=PROMO1; {_season}=summer,,,seattle,shoe sale

Se si usano gli SDK Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkDynamicSearchAd , 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 BulkDynamicSearchAd
var bulkDynamicSearchAd = new BulkDynamicSearchAd
{
    // '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 
    // DynamicSearchAd object of the Campaign Management service.
    DynamicSearchAd = new DynamicSearchAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // '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,
        // '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(bulkDynamicSearchAd);

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 active directory di ricerca dinamica , i campi dell'attributo seguenti sono disponibili nello schema file bulk. La combinazione dei campi Percorso 1, Percorso 2 e Testo rende univoco l'annuncio di ricerca dinamica.

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 .

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

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

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

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 Etichetta annuncio ricerca dinamica. 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

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 .

Percorso 1

La prima parte del percorso facoltativo che verrà aggiunta alla parte di dominio dell'URL visualizzato. L'URL di visualizzazione, ad esempio www.contoso.com , verrà generato dal dominio dell'URL visualizzato. 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 il dominio è contoso.com, path 1 è impostato su subdirectory1 e Path 2 è impostato su subdirectory2, l'URL visualizzato verrà www.contoso.com/subdirectory1/subdirectory2.

La lunghezza massima di input del percorso è di 15 caratteri. Si noti che per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input del percorso è di 7 caratteri.

Il percorso può contenere funzioni IF e countdown . Indipendentemente dalla lunghezza totale di tutti i parametri del conto alla rovescia non sostitutivi, il conto alla rovescia visualizzato finale userà sempre 8 caratteri dei caratteri totali disponibili. Per altri dettagli, vedere Personalizzazione del conto alla rovescia.

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

Percorso 2

La seconda parte del percorso facoltativo che verrà aggiunta alla parte del dominio dell'URL visualizzato. L'URL visualizzato, ad esempio www.contoso.com verrà generato dal dominio delle impostazioni a livello di campagna degli annunci di ricerca dinamica. 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 il dominio è contoso.com, path 1 è impostato su subdirectory1 e Path 2 è impostato su subdirectory2, l'URL visualizzato verrà www.contoso.com/subdirectory1/subdirectory2.

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

La lunghezza massima di input del percorso è di 15 caratteri. Si noti che per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input del percorso è di 7 caratteri.

Il percorso può contenere funzioni IF e countdown . Indipendentemente dalla lunghezza totale di tutti i parametri del conto alla rovescia non sostitutivi, il conto alla rovescia visualizzato finale userà sempre 8 caratteri dei caratteri totali disponibili. Per altri dettagli, vedere Personalizzazione del conto alla rovescia.

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

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.

Testo

La prima parte della descrizione dell'annuncio.

Il testo deve contenere almeno una parola.

La lunghezza massima di input della copia è di 90 caratteri. Si noti che per i gruppi di annunci che usano il cinese tradizionale la lunghezza di input massima della copia è di 45 caratteri.

Il testo può contenere funzioni IF e countdown . Indipendentemente dalla lunghezza totale di tutti i parametri del conto alla rovescia non sostitutivi, il conto alla rovescia visualizzato finale userà sempre 8 caratteri dei caratteri totali disponibili. Per altri dettagli, vedere Personalizzazione del conto alla rovescia.

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

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

Parte 2 del testo

Seconda parte della descrizione dell'annuncio.

Il testo deve contenere almeno una parola.

La lunghezza massima di input della copia è di 90 caratteri. Si noti che per i gruppi di annunci che usano il cinese tradizionale la lunghezza di input massima della copia è di 45 caratteri.

Il testo può contenere funzioni IF e countdown . Indipendentemente dalla lunghezza totale di tutti i parametri del conto alla rovescia non sostitutivi, il conto alla rovescia visualizzato finale userà sempre 8 caratteri dei caratteri totali disponibili. Per altri dettagli, vedere Personalizzazione del conto alla rovescia.

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

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