Partilhar via

Registo do Grupo de Listagem de Hotéis do Ad Group - Em massa

  • Artigo

Define um grupo de listagem de hotéis de grupo de anúncios que pode ser carregado e transferido num ficheiro em massa.

Pode carregar registos do Grupo de Listagem de Hotéis do Ad Group para vários grupos de anúncios no mesmo ficheiro em massa, desde que as regras de validação sejam cumpridas conforme descrito abaixo.

  • No mínimo, tem de especificar, pelo menos, o nó raiz para a estrutura de árvore do grupo de listagem de hotéis. O nó raiz do grupo de listagem do hotel tem de ter o campo Atributo hotel definido como "Tudo" e Valor do Atributo hotel nulo ou vazio. Se estiver a licitar em todos os hotéis no catálogo de forma igual, defina o campo Sub-Tipo como Unidade. Se estiver a criar partições das ofertas com base em atributos de hotel mais específicos, defina o campo Sub type como Subdivisão, o ID do Critério Principal como nulo ou vazio e o ID para um valor negativo. Irá utilizar o valor negativo como ID de Critério Principal para todos os nós subordinados.

  • O nó raiz é considerado nível 0 e uma árvore pode ter ramos até 7 níveis de profundidade.

  • Por pedido de carregamento, pode incluir um máximo de 20 000 nós de árvore de grupo de listagem de hotéis por grupo de anúncios. Toda a contagem de nós de árvore do grupo de listagem de hotéis para um grupo de anúncios não pode exceder 20 000.

  • Os nós de árvore do grupo de listagem do hotel para a mesma árvore (mesmo grupo de anúncios) têm de ser agrupados no ficheiro.

  • A ordem dos nós do grupo de listagem de hotéis não é garantida durante a transferência e os nós principais podem ser fornecidos após os nós subordinados; no entanto, todos os nós do mesmo grupo de anúncios serão agrupados no ficheiro.

  • Se estiver a criar ou modificar a estrutura de árvore, os nós de árvore do grupo de listagem de hotéis principais têm de ser encomendados antes dos nós de árvore do grupo de listagem de hotéis subordinados; no entanto, a ordem não importa para alterações não estruturais, tais como a actualização da oferta. Por exemplo, se quiser atualizar as ofertas sem adicionar, eliminar ou atualizar a estrutura da árvore, só precisa de carregar os campos ID, ID Principal e Licitação .

  • Para atualizar o campo Atributo Hotel, Valor do Atributo Hotel ou Está Excluído , tem de eliminar o nó de árvore do grupo de listagem de hotéis existente e carregar um novo nó de árvore do grupo de listagem de hotéis que irá obter um novo identificador.

  • Se alguma ação falhar, todas as ações restantes que possam ter sido bem-sucedidas também falharão.

  • Todas as ações de adição e eliminação de nós de grupo de listagem de hotéis têm de resultar numa estrutura de árvore completa.

  • Todos os caminhos do nó raiz até ao fim de um ramo têm de terminar com um nó de folha (Sub Type=Unit). Cada Unidade tem de ter uma oferta, a menos que o campo É Excluído seja verdadeiro , o que significa que o nó é um critério de grupo de anúncios negativo.

  • Cada subdivisão tem de ter, pelo menos, um nó de folha que lance no resto das condições da subdivisão, ou seja, utilizar o mesmo operando que as unidades colaterais e definir o valor do atributo hotel nulo ou vazio.

  • Se estiver a adicionar partições com vários níveis em que o elemento principal ou o subordinado ainda não existem, utilize um valor int negativo como referência para identificar o elemento principal. Por exemplo, defina o ID do elemento principal e o campo ID do Critério Principal do menor para o mesmo valor negativo. Os IDs negativos só são válidos durante a chamada. Os identificadores de sistema exclusivos para cada critério de grupo de anúncios adicionado com êxito são devolvidos no ficheiro de resultado de carregamento.

  • O campo Licitação só é aplicável se o campo Is Excluded for false , o que significa que o nó é um critério de grupo de anúncios bidível. No entanto, a oferta é ignorada para nós de partição de subdivisão . Esses elementos só são relevantes para nós de partição de Unidade (folha).

  • Para colocar em pausa qualquer grupo de listagem de hotéis, tem de colocar todo o grupo de anúncios em pausa ao atualizar o campo Estado do Grupo de Anúncios para Colocado em Pausa. Pode colocar toda a campanha em pausa ao atualizar o campo Estado da Campanha para Em Pausa.

  • Para uma ação Eliminada , só precisa de especificar o ID e o ID Principal.

  • Se eliminar um grupo de listagem de hotéis principal, todos os respetivos filhos e descendentes também serão eliminados.

  • Não pode especificar atributos de hotel duplicados num ramo.

Pode transferir todos os registos do Ad Group Hotel Listing Group na conta ao incluir o valor DownloadEntity de AdGroupHotelListingGroups no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.

O seguinte exemplo de CSV em Massa adicionaria um novo grupo de listagem de hotéis do grupo de anúncios se for fornecido um valor de ID Principal válido.

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 estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo com o BulkServiceManager para carregar e transferir o objeto BulkAdGroupProductPartition , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

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();

Para um registo Ad Group Hotel Listing Group , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiros em Massa.

Grupo de Anúncios

O nome do grupo de anúncios que contém o grupo de listagem de hotéis.

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Licitação

O montante a licitar no leilão. Isto é utilizado quando o esquema de licitação de campanha é ManualCpc.

Adicionar: Necessário se For Excluído for falso e o Subtipo for Unidade, caso contrário, a oferta não é permitida.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Percentagem de Licitação

O montante a licitar no leilão. Isto é utilizado quando o esquema de licitação de campanha é PercentCpc ou Comissão.

Adicionar: Necessário se For Excluído for falso e o Subtipo for Unidade, caso contrário, a oferta não é permitida.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Campanha

O nome da campanha que contém o grupo de anúncios e o grupo de listagem de hotéis.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

ID de Cliente

Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.

Adicionar: Opcional
Atualização: Opcional
Eliminar: Só de leitura

Parâmetro Personalizado

A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.

Num ficheiro em massa, a lista de parâmetros personalizados é formatada da seguinte forma.

  • Formate cada par de parâmetros personalizado como Key=Value, por exemplo {_promoCode}=PROMO1.

  • O Microsoft Advertising aceitará os primeiros oito pares de chave e valor personalizados que incluir e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro.

  • Cada par chave e valor é delimitado por um ponto e vírgula e espaço ("; "), por exemplo {_promoCode}=PROMO1; {_season}=verão.

  • Uma Chave não pode conter um ponto e vírgula. Se um Valor contiver um ponto e vírgula, tem de ser escapado como '\;'. Além disso, se o Valor contiver uma barra invertida, também terá de ser escapado como "\".

  • A Chave não pode exceder os 16 bytes UTF-8 e o Valor não pode exceder os 250 bytes UTF-8. A Chave é necessária e o Valor é opcional. O tamanho máximo da Chave não inclui as chavetas e o caráter de sublinhado, ou seja, "{", "_" e "}".

    Nota

    Com o serviço em massa, a Chave tem de ser formatada com chavetas adjacentes e um caráter de sublinhado à esquerda, por exemplo, se a Chave for promoCode, tem de ser formatada como {_promoCode}. Com o serviço Gestão de Campanhas, não pode especificar as chavetas adjacentes e o caráter de sublinhado.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para remover todos os parâmetros personalizados, defina este campo como delete_value. A palavra-chave delete_value remove a definição anterior. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter e omita os que não pretende manter. O novo conjunto de parâmetros personalizados substituirá qualquer conjunto de parâmetros personalizados anterior.
Eliminar: Só de leitura

Sufixo de URL Final

O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema do grupo de listagem de hotéis.

Adicionar: Só de leitura
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Está Excluído

Determina se o grupo de listagem de hotéis representa um critério bidível ou negativo.

Se definido como verdadeiro , é um critério negativo e, caso contrário, se for falso , é um critério bidível.

Adicionar: Necessário
Atualização: Só de leitura
Eliminar: Só de leitura

Hora da Modificação

A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).

Nota

O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

ID do Critério Principal

O identificador de critério do grupo de listagem do hotel principal.

Este campo em massa mapeia para ParentNodeId e tem de ser nulo para apontar para o nó raiz.

Nota

Este campo não é aplicável ao nó do grupo de listagem de raiz da árvore, que não tem um elemento principal.

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura
Eliminar: Só de leitura

ID principal

O identificador gerado pelo sistema do grupo de anúncios que contém o grupo de listagem de hotéis.

Este campo em massa mapeia para o campo ID do registo do Grupo de Anúncios .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de grupo de anúncios existente ou especificar um identificador negativo que seja igual ao campo ID do registo do Grupo de Anúncios principal. Isto é recomendado se estiver a adicionar novos grupos de listagem de hotéis a um novo grupo de anúncios no mesmo Ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Atributo Hotel

O operando da condição. Os operandos incluem implicitamente o operador de igual. Por exemplo, pode ler Marca como Marca=.

Utilize o Atributo Hotel como operando do Valor do Atributo hotel.

Podem ser especificados vários atributos de hotel para cada campanha e grupo de anúncios. Cada condição é cumprida se o valor do atributo do hotel for igual ao valor do atributo do operando. Por exemplo, se operando estiver definido como Marca e o atributo estiver definido como Contoso, a condição será cumprida se o valor do atributo Marca do catálogo hoteleiro for igual a Contoso.

Nas suas campanhas, os atributos do hotel podem ser definidos ao nível da campanha e do grupo de anúncios. A tabela seguinte descreve as regras de negócio do Hotel Attribute (operando) e do Hotel Attribute Value (atributo) para os registos do Ad Group Hotel Listing Group .

Nota

O Atributo Hotel tem de ser "Tudo" quando o Valor do Hotel estiver definido como nulo ou vazio para o nó de raiz.

Atributo Hotel (Operando) Descrição do Valor do Atributo hotel (Atributo) Regras de Grupo de Listagem de Hotéis do Ad Group
Todos Não aplicável. Para os grupos de listagem de hotéis de um grupo de anúncios, o nó raiz tem de ter o operando definido como "Tudo" e atributo definido como nulo ou vazio.
Marca Fabricante, marca ou fabricante do hotel.

Um máximo de 200 carateres.		 O operando Marca pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
Categoria Uma categoria de hotel, como "Inn", "Motel", "Resort", etc.

Um máximo de 200 carateres.		 Não aplicável.
Localidade A cidade onde o hotel está localizado. Não aplicável.
País/Região O país ou região onde se encontra o hotel. Não aplicável.
CustomLabel0-4

Estão disponíveis cinco valores de operando de etiqueta personalizada, ou seja, CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 e CustomLabel4.		 Cada um dos operandos CustomLabel pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo. Por exemplo, um ramo pode conter CustomLabel0 e CustomLabel1, mas pode não conter outro nó com o operando CustomLabel1 .

Um máximo de 200 carateres.		 Não aplicável.
HotelId O identificador do hotel.

Um máximo de 1024 carateres.		 O operando ID pode ser utilizado em vários ramos, mas só pode ser especificado uma vez por ramo.
StarRating Uma classificação de hotel de 1 a 5 estrelas. Não aplicável.
Estado O estado onde o hotel está localizado. Não aplicável.

Adicionar: Necessário
Atualização: Só de leitura. Não é possível atualizar os campos de condição ou valor. Para atualizar as condições, tem de eliminar o grupo de listagem de hotéis e adicionar um novo.
Eliminar: Só de leitura

Valor do Atributo Hotel

O valor do atributo da condição.

Adicionar: Necessário
Atualização: Só de leitura. Não é possível atualizar os campos de condição ou valor. Para atualizar as condições, tem de eliminar o grupo de listagem de hotéis e adicionar um novo.
Eliminar: Só de leitura

Estado

O estado do grupo de listagem de hotéis.

Os valores possíveis são Ativos ou Eliminados.

Adicionar: Opcional. O único estado possível é Ativo. Se definir o estado como Eliminado , este será ignorado e o registo devolvido terá o estado definido como Ativo.
Atualização: Opcional
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Subtipo

O tipo de grupo de listagem de hotéis.

Os valores possíveis são Subdivisão e Unidade.

Adicionar: Necessário
Atualização: Só de leitura
Eliminar: Só de leitura

Modelo de Controlo

Os modelos de controlo podem ser utilizados em conjunto com o URL especificado no campo "Ligação" da oferta hoteleira que submeteu através da API de Conteúdo. Ao combinar o URL do feed com o modelo de controlo, o URL da página de destino é montado onde um utilizador é direcionado depois de clicar no anúncio. Quando utiliza o campo Modelo de Controlo para atualizar os parâmetros do URL em vez de os atualizar no URL do feed, o URL do feed não precisa de passar pela revisão editorial e os anúncios continuarão a servir ininterruptamente. Por exemplo, se o URL da oferta do hotel no feed de catálogo for https://contoso.com/, pode especificar o seguinte modelo de controlo: {lpurl}?matchtype={matchtype}&device={device}.

As seguintes regras de validação aplicam-se aos modelos de controlo. Para obter mais detalhes sobre os modelos e parâmetros suportados, consulte o artigo de ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?

  • Os modelos de controlo definidos para entidades de nível inferior, por exemplo, os anúncios substituem os conjuntos de entidades de nível superior, por exemplo, campanha. Para obter mais informações, veja Limites de Entidades.

  • O comprimento do modelo de controlo está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.

  • O modelo de controlo tem de ser um URL bem formado, começando por um dos seguintes: http://, https://, {lpurl} ou {unescapedlpurl}.

  • O Microsoft Advertising não valida se existem parâmetros personalizados. Se utilizar parâmetros personalizados no seu modelo de controlo e estes não existirem, o URL da página de destino incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o seu modelo de controlo for https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, critério, palavra-chave ou nível de anúncio, o URL da página de destino será o mesmo.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura