Record gruppo elenco hotel gruppo di annunci - Bulk

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

Puoi caricare i record del gruppo di annunci di Ad Group Hotel per più gruppi di annunci nello stesso file bulk, purché le regole di convalida siano soddisfatte come descritto di seguito.

• È almeno necessario specificare almeno il nodo radice per la struttura ad albero del gruppo elenco hotel. Il nodo radice del gruppo elenco hotel deve avere il campo Attributo hotel impostato su "Tutto" e Valore attributo hotel null o vuoto. Se si esegue un'offerta equa per tutti gli hotel del catalogo, impostare il campo Sottotipo su Unità. Se si partizionano le offerte in base a attributi di hotel più specifici, impostare il campo Sottotipo su Suddivisione, l'ID criterio padre su Null o vuoto e l'ID su un valore negativo. Il valore negativo verrà usato come ID criterio padre per tutti i nodi figlio.

• Il nodo radice è considerato di livello 0 e un albero può avere rami fino a 7 livelli in profondità.

• Per ogni richiesta di caricamento, puoi includere un massimo di 20.000 nodi dell'albero del gruppo di annunci per gruppo di annunci. Il numero di nodi dell'albero dell'elenco di hotel per un gruppo di annunci non può superare i 20.000.

• I nodi dell'albero del gruppo elenco hotel per lo stesso albero (stesso gruppo di annunci) devono essere raggruppati nel file.

• L'ordine dei nodi del gruppo elenco hotel non è garantito durante il download e i nodi padre potrebbero essere forniti dopo i nodi figlio; tuttavia, tutti i nodi per lo stesso gruppo di annunci verranno raggruppati nel file.

• Se si crea o si modifica la struttura ad albero, è necessario ordinare i nodi dell'albero del gruppo di elenchi di hotel padre prima dei nodi dell'albero dell'elenco di hotel figlio; tuttavia, l'ordine non è rilevante per le modifiche non strutturali, ad esempio l'aggiornamento dell'offerta. Ad esempio, se si desidera aggiornare le offerte senza aggiungere, eliminare o aggiornare la struttura ad albero, è sufficiente caricare i campi ID, ID padre e Offerta .

• Per aggiornare il campo Attributo hotel, Valore attributo hotel o Escluso , è necessario eliminare il nodo dell'albero del gruppo elenco hotel esistente e caricare un nuovo nodo dell'albero del gruppo elenco hotel che otterrà un nuovo identificatore.

• Se un'azione ha esito negativo, anche tutte le azioni rimanenti che potrebbero avere avuto esito positivo avranno esito negativo.

• Tutte le azioni di aggiunta ed eliminazione del nodo elenco hotel devono comportare una struttura ad albero completa.

• Ogni percorso dal nodo radice alla fine di un ramo deve terminare con un nodo foglia (Sub Type=Unit). Ogni unità deve avere un'offerta, a meno che il campo È escluso sia true , il che significa che il nodo è un criterio di gruppo di annunci negativo.

• Ogni suddivisione deve avere almeno un nodo foglia che effettua un'offerta nella parte restante delle condizioni della suddivisione, ad esempio usare lo stesso operando delle unità di pari livello e impostare il valore dell'attributo hotel null o vuoto.

• Se si aggiungono partizioni con più livelli in cui non esiste ancora né l'elemento padre né il valore figlio, usare un valore int negativo come riferimento per identificare l'elemento padre. Impostare, ad esempio, sia l'ID dell'elemento padre che il campo Id criterio padre dell'elemento figlio sullo stesso valore negativo. Gli ID negativi sono validi solo per la durata della chiamata. Gli identificatori di sistema univoci per ogni criterio del gruppo di annunci aggiunto correttamente vengono restituiti nel file dei risultati del caricamento.

• Il campo Offerta è applicabile solo se il campo È escluso è false , il che significa che il nodo è un criterio del gruppo di annunci che può essere offerto. L'opzione Bid viene tuttavia ignorata per i nodi di partizione di suddivisione. Questi elementi sono rilevanti solo per i nodi di partizione Unit (foglia).

• Per sospendere qualsiasi gruppo di annunci di hotel, devi sospendere l'intero gruppo di annunci aggiornando il campo Stato del gruppo di annunci in Pausa. È possibile sospendere l'intera campagna aggiornando il campo Stato della campagna in Pausa.

• Per un'azione Eliminata è sufficiente specificare l'ID e l'ID padre.

• Se elimini un gruppo di annunci di hotel padre, verranno eliminati anche tutti i relativi figli e discendenti.

• Non è possibile specificare attributi di hotel duplicati in un ramo.

È possibile scaricare tutti i record del gruppo di annunci di Ad Group Hotel nell'account includendo il valore DownloadEntity di AdGroupHotelListingGroups 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 gruppo di inserzioni di hotel del gruppo di annunci se viene fornito un valore id padre valido.

Type,Name,Campaign,Time Zone,Campaign Type,Language,Sub Type,Budget Id,Budget,Budget Type,Bid Strategy Type,Bid Strategy PercentMaxCpc,Ad Schedule Use Searcher Time Zone,Client Id,Id,Parent ID,Parent Criterion Id,Ad Group,Ad Group Type,Search Network,Content Network,Percent Cpc Bid,Hotel Ad Group Type,Percent Bid,Hotel Attribute,Hotel Attribute Value,Is Excluded
Format Version,6,,,,,,,,,,,,,,,,,,,,,,,,,
Campaign,,Test Hotel Campaign HLG,PacificTimeUSCanadaTijuana,Hotel,All,,delete_value,25,DailyBudgetStandard,PercentCpc,8.3,false,0,,,,,,,,,,,,,,
AdGroup,,Test Hotel Campaign HLG,,,,,,,,,,,,,,,Test Hotel AdGroup,Hotel,On,Off,3.74,HotelAd,,,,,
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Subdivision,,,,,,,,-1,,,Test Hotel AdGroup,,,,,HotelAd,,All,,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-2,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,Marriott,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-3,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,Hilton,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-4,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,,false

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupProductPartition , 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 BulkAdGroupProductPartition
var bulkAdGroupProductPartition = new BulkAdGroupProductPartition
{
    // Map properties in the Bulk file to the BiddableAdGroupCriterion or
    // NegativeAdGroupCriterion object of the Campaign Management service.
    // Use the BiddableAdGroupCriterion to set the 'Is Excluded' field in the Bulk file to true,
    // and otherwise use the NegativeAdGroupCriterion to set the 'Is Excluded' field to false.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new HotelListingGroup { 
            Condition = new HotelListingCondition
            {
                // 'Hotel Attribute Value' column header in the Bulk file
                Attribute = null,
                // 'Hotel Attribute' column header in the Bulk file
                Operand = "All",
            },
            // 'Parent Criterion Id' column header in the Bulk file
            ParentCriterionId = null
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        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"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupProductPartition);

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

• Gruppo di annunci
• Offerta
• Percentuale offerta
• Campagna
• Client Id
• Parametro personalizzato
• Suffisso URL finale
• Id
• È escluso
• Ora modifica
• ID criterio padre
• Parent Id
• Attributo hotel
• Valore attributo hotel
• Stato
• Sottotipo
• Modello di rilevamento

Gruppo di annunci

Nome del gruppo di annunci che contiene il gruppo di annunci di hotel.

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

Offerta

Importo da presentare all'asta. Questo viene usato quando lo schema di offerta della campagna è ManualCpc.

Aggiungere: Obbligatorio se è escluso è false e il sottotipo è Unità e in caso contrario l'offerta non è consentita.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Percentuale offerta

Importo da presentare all'asta. Questo viene usato quando lo schema di offerta della campagna è PercentCpc o Commission.

Aggiungere: Obbligatorio se è escluso è false e il sottotipo è Unità e in caso contrario l'offerta non è consentita.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Campagna

Nome della campagna che contiene il gruppo di annunci e il gruppo di annunci di hotel.

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

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 del gruppo elenco hotel.

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

È escluso

Determina se il gruppo di annunci di hotel rappresenta un criterio di offerta o negativo.

Se impostato su true è un criterio negativo e in caso contrario, se false è un criterio che può essere offerto.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Elimina: Sola lettura

Ora modifica

Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

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

ID criterio padre

Identificatore del criterio del gruppo di annunci di hotel padre.

Questo campo bulk esegue il mapping a ParentNodeId e deve essere null per puntare al nodo radice.

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

Parent Id

Identificatore generato dal sistema del gruppo di annunci che contiene il gruppo di annunci di hotel.

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 gruppi di annunci di hotel a un nuovo gruppo di annunci 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

Attributo hotel

Operando della condizione. Gli operandi includono in modo implicito l'operatore uguale. Ad esempio, è possibile leggere Brand come Brand=.

Usare l'attributo Hotel come operando per il valore dell'attributo hotel.

È possibile specificare più attributi di hotel per ogni campagna e gruppo di annunci. Ogni condizione viene soddisfatta se il valore dell'attributo dell'hotel è uguale al valore dell'attributo dell'operando. Ad esempio, se l'operando è impostato su Brand e l'attributo è impostato su Contoso, la condizione viene soddisfatta se il valore dell'attributo Brand del catalogo hotel è uguale a Contoso.

Nelle tue campagne gli attributi dell'hotel possono essere impostati a livello di campagna e gruppo di annunci. La tabella seguente descrive le regole di business dell'attributo hotel (operando) e dell'attributo hotel (attributo) per i record del gruppo di annunci di hotel ad gruppo .

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura. Non è possibile aggiornare i campi condizione o valore. Per aggiornare le condizioni è necessario eliminare il gruppo di annunci di hotel e aggiungerne uno nuovo.
Elimina: Sola lettura

Valore attributo hotel

Valore dell'attributo della condizione.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura. Non è possibile aggiornare i campi condizione o valore. Per aggiornare le condizioni è necessario eliminare il gruppo di annunci di hotel e aggiungerne uno nuovo.
Elimina: Sola lettura

Stato

Stato del gruppo di annunci dell'hotel.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Opzionale. L'unico stato possibile è Attivo. Se si imposta lo stato su Eliminato , verrà ignorato e il record restituito avrà lo stato impostato su Attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Sottotipo

Tipo di gruppo di annunci di hotel.

I valori possibili sono Suddivisione e Unità.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Elimina: Sola lettura

Modello di rilevamento

I modelli di rilevamento possono essere usati insieme all'URL specificato nel campo "Collegamento" per l'offerta di hotel inviata tramite l'API Contenuto. Combinando l'URL del feed con il modello di rilevamento, l'URL della pagina di destinazione viene assemblato in cui un utente viene indirizzato dopo aver fatto clic sull'annuncio. Quando usi il campo Modello di rilevamento per aggiornare i parametri URL invece di aggiornarli nell'URL del feed, l'URL del feed non deve passare attraverso la revisione editoriale e gli annunci continueranno a essere pubblicati senza interruzioni. Ad esempio, se l'URL dell'offerta dell'hotel nel feed di catalogo è , è https://contoso.com/possibile specificare il modello di rilevamento seguente: {lpurl}?matchtype={matchtype}&device={device}.

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