Registo do Grupo de Ativos - Em massa

Artigo
02/13/2024

Define um grupo de recursos que pode ser transferido e carregado num ficheiro em massa.

Pode transferir todos os registos do Grupo de Recursos na conta ao incluir o valor DownloadEntity de AssetGroups 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.

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 BulkAssetGroup , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

Para um registo do Grupo de Recursos , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Grupo de Recursos
Nome da Empresa
Chamada à Ação
Campanha
ID de Cliente
Descrições
Estatuto de Recurso Editorial
Localização Editorial
Código do Motivo Editorial
Estado Editorial
Termo Editorial
Data de Fim
Final Url
Cabeçalhos
ID
Imagens
Cabeçalhos Longos
Url Final do Dispositivo Móvel
Hora da Modificação
ID principal
Caminho 1
Caminho 2
Estado
Data de Início

Grupo de Recursos

O nome do grupo de recursos.

Adicionar: Necessário
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 e Obrigatório

Nome da Empresa

O nome da empresa.

Consoante a colocação do seu público-alvo, o nome da sua empresa pode aparecer no seu anúncio.

O comprimento da cadeia está limitado a 25 carateres.

Adicionar: Necessário
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

Chamada à Ação

Uma breve razão para os clientes clicarem no seu anúncio neste momento.

Os valores possíveis são ActNow, AddToCart, ApplyNow, Automated, BetNow, BidNow, BookACar, BookHotel, BookNow, BookTravel, Browse, BuildNow, Buy, BuyNow, ChatNow, Compare, ContactUs, Cupão, Revendedores, Predefinição, Direções, Doar, Transferir, EmailNow, EnrollNow, Explorar, FileNow, FindJob, FindStore, FreePlay, FreeQuote, FreeTrial, GetDeals, GetDemo, GetNow, GetOffer, GetQuote, GoToDemo, Install, JoinNow, LearnMore, ListenNow, LogIn, Message, NewCars, NoButton, OpenLink, OrderNow, PlayGame, PlayNow, PostJob, Register, RegisterNow, RenewNow, RentACar, RentNow, Reordenar, Reserve, Sale, SaveNow, Schedule, SeeDemo, SeeMenu, SeeModels, SeeMore, SeeOffer, SeeOffers, SellNow, ShopNow, Showtimes, SignIn, SignUp, StartFree, StartNow, Subscribe, SwitchNow, TestDrive, TryNow, Unknown, UsedCars, ViewCars, ViewDemo, ViewNow, ViewPlans, VisitSite, VisitStore, VoteNow, Watch, WatchMore, WatchNow.

Adicionar: Obrigatório.
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 recursos.

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

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

Descrições

A lista de descrições que o Bing pode utilizar para otimizar o esquema de anúncios.

Para maximizar as impressões em todos os formatos de anúncios, as descrições podem nem sempre ser apresentadas no seu anúncio.

Do ponto de vista do modelo de dados, as descrições são armazenadas como recursos de texto. O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising.

Tem de definir entre 2 a 5 descrições. As descrições são representadas no ficheiro em massa como uma cadeia JSON. Estão incluídas duas descrições no JSON de exemplo abaixo e a primeira é afixada a uma posição específica. text E id são propriedades do recurso, enquanto as editorialStatusassetPerformanceLabel e são propriedades da ligação do elemento, ou seja, a relação entre o elemento e o anúncio. Para obter mais detalhes, veja assetPerformanceLabel, editorialStatus, id e texto abaixo.

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

Nota

No ficheiro em massa separado por vírgulas, terá de rodear a lista de ligações de recursos, cada chave de atributo e cada valor de cadeia de atributos com um conjunto extra de aspas duplas, por exemplo, a cadeia JSON acima seria escrita como "[{""text"":"Localizar Novos Clientes & Aumentar Vendas!"},{"texto":""Iniciar Publicidade na Contoso Hoje.""}]".

Eis um exemplo de transferência em massa onde também irá obter atributos só de leitura, por exemplo, id e editorialStatus:

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Adicionar: Necessário se a campanha principal não se associar a uma loja, opcional se a campanha principal associar a uma loja. Se a campanha principal associar a uma loja e especificar Descrições, também tem de especificar Manchetes, LongHeadlines e Imagens. Apenas o texto é respeitado. Mesmo que o recurso já exista na sua conta, o ID, assetPerformanceLabel e editorialStatus serão ignorados se os incluir.
Atualização: Opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este campo vazio. Se definir este campo, todas as descrições anteriormente ligadas a este anúncio serão substituídas. Se especificar este campo, é necessária uma lista de descrições 2 a 5. Apenas o texto é respeitado. Mesmo que o recurso já exista na sua conta, o ID, assetPerformanceLabel e editorialStatus serão ignorados se os incluir.
Eliminar: Só de leitura

assetPerformanceLabel

Isto permite-lhe saber o desempenho do recurso.

O assetPerformanceLabel atributo é só de leitura quando transfere o anúncio de pesquisa reativa. Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Baixo	O desempenho deste recurso é baixo e recomendamos que substitua este recurso para melhorar o desempenho do seu anúncio.
Bom	Este recurso está a ter um bom desempenho. Recomendamos que mantenha este recurso e adicione mais recursos para melhorar o desempenho do seu anúncio.
Melhor	O desempenho deste recurso está entre os melhores e recomendamos que adicione mais recursos semelhantes.
Sem classificação	Não temos nenhuma classificação de desempenho para este recurso. Tal pode dever-se ao recurso estar inativo, não ter informações suficientes para determinar o seu desempenho ou se não existirem recursos semelhantes suficientes para comparar com o mesmo.
Aprendizagem	O desempenho do recurso está a ser avaliado ativamente. Assim que a avaliação estiver concluída, a classificação de recursos será Baixa, Boa, Melhor ou Sem Classificação.

editorialStatus

O editorialStatus atributo é só de leitura quando transfere o anúncio de pesquisa reativa. Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Ativo	O activo passou na revisão editorial.
ActiveLimited	O activo passou em revisão editorial em um ou mais mercados, e um ou mais elementos do activo estão a ser revistos editorialmente noutro mercado. Por exemplo, o recurso passou na revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado	O activo falhou na revisão editorial.
Inativo	Um ou mais elementos do recurso estão a ser analisados editorialmente.
Unknown	Reservado para utilização futura.

ID

O id atributo é um identificador exclusivo do Microsoft Advertising para o recurso numa conta do Microsoft Advertising.

O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising. Depois de carregar um recurso de texto, o ficheiro de resultado incluirá o identificador do recurso, por exemplo, ""id:""123, se o recurso é novo ou já existe na biblioteca de recursos da conta.

texto

O atributo de text cada descrição tem de conter, pelo menos, uma palavra. O comprimento máximo de entrada do atributo de text cada descrição é de 90 carateres. Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 45 carateres. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis.

O text atributo não pode conter o caráter newline (\n).

Estatuto de Recurso Editorial

Determina se pode recorrer das questões encontradas pela revisão editorial.

Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Apelativo	A questão editorial é apelativa.
Recurso Pendente	A questão editorial é recorrida e foi apresentado um recurso.
Não Aplicável	A questão editorial não é apelativa.

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

Localização Editorial

O componente ou propriedade do anúncio que falhou na revisão editorial.

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

Código do Motivo Editorial

Um código que identifica o motivo da falha. Para obter uma lista de possíveis códigos de motivos, consulte Códigos de Razão Editoriais.

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

Estado Editorial

O estado editorial do grupo de ativos.

Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Ativo	O grupo de activos passou na revisão editorial.
ActiveLimited	O grupo de activos passou a revisão editorial em um ou mais mercados, e um ou mais elementos do grupo de activos estão a ser analisados editorialmente noutro mercado. Por exemplo, o grupo de activos passou uma revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado	O grupo de activos falhou na revisão editorial.
Inativo	Um ou mais elementos do grupo de activos estão a ser analisados editorialmente.

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

Termo Editorial

O termo que falhou na revisão editorial.

Este campo não será definido se uma combinação de termos tiver causado a falha ou se a falha tiver sido baseada numa violação de política.

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

Data de Fim

A data em que o grupo de recursos irá expirar.

Se não especificar uma data de fim, o grupo de recursos não irá expirar. A data de fim pode ser prolongada para tornar um grupo de ativos elegível para entrega, mesmo depois de o grupo de ativos expirar.

A data de fim é inclusiva. Por exemplo, se definir Data de Fim para 31/12/2020, o grupo de ativos expirará às 23:59 a 31/12/2020. A hora baseia-se no fuso horário que especificar ao nível da campanha.

Adicionar: Opcional. Para não definir uma data de fim ao adicionar um grupo de recursos, não defina este campo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para eliminar a data de fim atual e definir efetivamente nenhuma data de fim, defina este campo como a cadeia "delete_value". Quando recuperar o grupo de recursos da próxima vez, este campo não será definido.
Eliminar: Só de leitura

Final Url

O URL da página de destino.

A parte do domínio do URL em combinação com as cadeias de caminho 1 e caminho 2 não pode exceder os 67 carateres.

As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.

O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.
Pode especificar até 10 itens para URLs Finais e URLs Móveis Finais; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.
Cada URL é delimitado por um ponto e vírgula e espaço ("; ").
A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo "{lpurl}".
Cada URL tem de ser um URL bem formado, começando com http:// ou https://.
Se especificar URLs Finais para Dispositivos Móveis, também tem de especificar Url Final.

Adicionar: Necessário
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

Cabeçalhos

A lista de cabeçalhos que o Bing pode utilizar para otimizar o esquema de anúncios.

Para maximizar o desempenho em todos os formatos de anúncios, os títulos podem nem sempre ser apresentados no seu anúncio.

Do ponto de vista do modelo de dados, as manchetes são armazenadas como recursos de texto. O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising.

Tem de definir entre 3 a 15 cabeçalhos. Os cabeçalhos são representados no ficheiro em massa como uma cadeia JSON. Estão incluídos dois cabeçalhos no JSON de exemplo abaixo. text E id são propriedades do recurso, enquanto as editorialStatusassetPerformanceLabel e são propriedades da ligação do elemento, ou seja, a relação entre o elemento e o anúncio. Para obter mais detalhes, veja assetPerformanceLabel, editorialStatus, id e texto abaixo.

[{
	"text": "Contoso",
},
{
	"text": "Seamless Integration"
}]

Nota

No ficheiro em massa separado por vírgulas, terá de rodear a lista de ligações de recursos, cada chave de atributo e cada valor de cadeia de atributos com um conjunto extra de aspas duplas, por exemplo, a cadeia JSON acima seria escrita como "[{""text"":""Contoso""},{""text"":""Integração Totalmente Integrada""}]".

Eis um exemplo de transferência em massa onde também irá obter atributos só de leitura, por exemplo, id e editorialStatus:

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Adicionar: Necessário se a campanha principal não se associar a uma loja, opcional se a campanha principal associar a uma loja. Se a campanha principal associar a uma loja e especificar Títulos, também tem de especificar LongHeadlines, Descrições e Imagens. Apenas o texto é respeitado. Mesmo que o recurso já exista na sua conta, o ID, assetPerformanceLabel e editorialStatus serão ignorados se os incluir.
Atualização: Opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este campo vazio. Se definir este campo, quaisquer cabeçalhos que tenham sido anteriormente ligados a este anúncio serão substituídos. Se especificar este campo, é necessária uma lista de 3 a 15 cabeçalhos. Apenas o texto é respeitado. Mesmo que o recurso já exista na sua conta, o ID, assetPerformanceLabel e editorialStatus serão ignorados se os incluir.
Eliminar: Só de leitura

assetPerformanceLabel

Isto permite-lhe saber o desempenho do recurso.

O assetPerformanceLabel atributo é só de leitura quando transfere o anúncio de pesquisa reativa. Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Baixo	O desempenho deste recurso é baixo e recomendamos que substitua este recurso para melhorar o desempenho do seu anúncio.
Bom	Este recurso está a ter um bom desempenho. Recomendamos que mantenha este recurso e adicione mais recursos para melhorar o desempenho do seu anúncio.
Melhor	O desempenho deste recurso está entre os melhores e recomendamos que adicione mais recursos semelhantes.
Sem classificação	Não temos nenhuma classificação de desempenho para este recurso. Tal pode dever-se ao recurso estar inativo, não ter informações suficientes para determinar o seu desempenho ou se não existirem recursos semelhantes suficientes para comparar com o mesmo.
Aprendizagem	O desempenho do recurso está a ser avaliado ativamente. Assim que a avaliação estiver concluída, a classificação de recursos será Baixa, Boa, Melhor ou Sem Classificação.

editorialStatus

O editorialStatus atributo é uma cadeia só de leitura quando transfere o anúncio de pesquisa reativa. Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Ativo	O activo passou na revisão editorial.
ActiveLimited	O ativo passou a revisão editorial em um ou mais mercados, e um ou mais elementos do ativo estão a ser revistos editorialmente noutro mercado. Por exemplo, o recurso passou na revisão editorial do Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado	O activo falhou na revisão editorial.
Inativo	Um ou mais elementos do recurso estão a ser submetidos a uma revisão editorial.
Unknown	Reservado para utilização futura.

ID

O id atributo é um identificador exclusivo do Microsoft Advertising para o recurso numa conta do Microsoft Advertising.

texto

O atributo de text cada cabeçalho tem de conter, pelo menos, uma palavra. O comprimento máximo de entrada do atributo de text cada cabeçalho é de 30 carateres. Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 15 carateres. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis.

O text atributo não pode conter o caráter newline (\n).

ID

O identificador gerado pelo sistema do grupo de recursos.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. 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

Imagens

Crie múltiplos recursos de imagem com diferentes tamanhos e proporções para que possam ser apresentados de forma flexível em vários editores e posicionamentos.

Tem de fornecer, pelo menos, 1 LandscapeImageMedia e 1 SquareImageMedia. Um total de até 20 imagens e um total de até 5 logótipos podem ser guardados.

Os recursos de imagem são representados no ficheiro em massa como uma cadeia JSON. Estão incluídas nove imagens no exemplo JSON abaixo e apenas o LandscapeImageMedia subType não é recortado. O id é uma propriedade do recurso, enquanto que , cropHeightcropWidth, cropX, cropYe subType são propriedades da ligação do elemento, ou seja, a relação entre o elemento e o anúncio. Para obter mais detalhes, veja cropHeight, cropWidth, cropX, cropY, id e subType abaixo.

[{
	"id": 1234567890000,
	"subType": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 200,
	"cropHeight": 50
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 120,
	"cropHeight": 120
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"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": "ImageMedia1x2",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 500,
	"cropHeight": 1000
},
{
	"id": 1234567890000,
	"subType": "ImageMedia4x1",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1000,
	"cropHeight": 250
}]

Nota

No ficheiro em massa separado por vírgulas, terá de colocar a lista de ligações de recursos, cada chave de atributo e cada valor de cadeia de atributo com um conjunto extra de aspas duplas, por exemplo, a cadeia JSON acima seria escrita como "[{""id"":1234567890000,""subType"":""LandscapeImageMedia""},{"id"":1234567890000,""subType"":""SquareImageMedia"","cropX":286,""cropY":0,""cropWidth"":628,""cropHeight"":628},{"id"":1234567890000, ""subType"":""LandscapeLogoMedia"",""cropX":70,""cropY":0,""cropWidth"":200,""cropHeight"":50},{"id"":1234567890000 ,""subType"":""SquareLogoMedia"",""cropX":308,""cropY":0,""cropWidth"":120,""cropHeight"":120},{"id"":1234567890000,""subType":""ImageMedia15X10"","cropX"":129,""cropY":0,""cropWidth"":942,""cropHeight"":628},{"""id"":1234567890000,""subType"":""ImageMedia133X100"","cropX":183,""cropY"":0,""cropWidth"":835,""cropHeight"" :628},{""id"":1234567890000,""subType":""ImageMedia178X100"","cropX"":41,""cropY"":0,""cropWi "":1118,""cropHeight"":628},{"id":1234567890000,""subType":""ImageMedia1X2"","cropX""::41,""cropY":0,""cropWidth"":500,""cropHeight"":1000},{""id"":1234567890000,""subType""::""ImageMedia4X1"","cropX":60,""cropY":0,""cropWidth"":1000,""cropHeight"":250}]".

Adicionar: Necessário se a campanha principal não se associar a uma loja, opcional se a campanha principal associar a uma loja. Se a campanha principal associar a uma loja e especificar Imagens, também tem de especificar Manchetes, LongHeadlines e Descrições. Apenas o ID e o subtipo são necessários para cada ligação de recurso.
Atualização: Opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este campo vazio. Se definir este campo, todas as imagens anteriormente ligadas a este anúncio serão substituídas. Se definir este campo, apenas o ID e o subtipo são necessários para cada ligação de recurso.
Eliminar: Só de leitura

cropHeight

O número de píxeis a utilizar a partir da origem do recurso de imagem, começando pela posição cropY e movendo-se para cima.

cropWidth

O número de píxeis a utilizar a partir da origem do recurso de imagem, começando pela posição cropX e movendo-se para a direita.

cropX

A partir do canto inferior esquerdo da origem do recurso de imagem, este é o número de píxeis a ignorar para a direita no eixo x antes de aplicar a cropWidth.

recortarY

A partir do canto inferior esquerdo da origem do recurso de imagem, este é o número de píxeis a saltar para cima no eixo y antes de aplicar o cropHeight.

ID

O id atributo é um identificador exclusivo do Microsoft Advertising para o recurso numa conta do Microsoft Advertising.

O mesmo identificador de recurso de imagem pode ser utilizado várias vezes no mesmo anúncio para diferentes proporções e também pode ser utilizado por vários anúncios na mesma conta microsoft Advertising. Pode criar imagens para anúncios reativos através do registo em massa Imagem . Em seguida, pode utilizar o identificador de multimédia devolvido como o ID do recurso de imagem. A proporção da imagem que adicionou tem de ser suportada para o subtipo de recurso de imagem.

subtipo

O subType atributo representa a proporção deste recurso de imagem.

A verdadeira proporção da Imagem armazenada na biblioteca de multimédia ao nível da conta pode variar, desde que as dimensões resultantes resultem na proporção esperada por subtipo.

Os valores de subtipo possíveis incluem LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 e ImageMedia4X1. Poderão ser adicionados novos subtipos no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores.

Subtipo	Proporção	Dimensões mínimas em píxeis
LandscapeImageMedia	1.91:1	703 largura x 368 alturas
SquareImageMedia	1:1	300 largura x 300 alturas
LandscapeLogoMedia	4:1	160 largura x 40 alturas
SquareLogoMedia	1:1	40 largura x 40 altura
ImagemMedia15x10	1.5:1	300 largura x 200 alturas
ImagemMedia133x100	1.33:1	100 larguras x 75 alturas
ImagemMedia178x100	1.78:1	624 largura x 350 alturas
ImageMedia1x2	1:2	470 largura x 940 altura
ImagemMedia4x1	4:1	608 largura x 152 alturas

Cabeçalhos Longos

A lista de títulos longos que o Bing pode utilizar para otimizar o esquema de anúncios.

Para maximizar o desempenho em todos os formatos de anúncios, os títulos longos podem nem sempre ser apresentados no seu anúncio.

Do ponto de vista do modelo de dados, as manchetes longas são armazenadas como recursos de texto. O mesmo recurso pode ser utilizado por vários anúncios. Por exemplo, se a "Integração Totalmente Integrada" for um recurso de texto, terá o mesmo identificador de recurso em todos os anúncios na mesma conta do Microsoft Advertising.

Tem de definir entre 1 a 5 títulos longos. Os títulos longos são representados no ficheiro em massa como uma cadeia JSON. Estão incluídos dois títulos longos no JSON de exemplo abaixo. text E id são propriedades do recurso, enquanto as editorialStatusassetPerformanceLabel e são propriedades da ligação do elemento, ou seja, a relação entre o elemento e o anúncio. Para obter mais detalhes, veja assetPerformanceLabel, editorialStatus, id e texto abaixo.

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

Nota

Eis um exemplo de transferência em massa onde também irá obter atributos só de leitura, por exemplo, id e editorialStatus:

[{
	"id": 1,
	"text": "Find New Customers & Increase Sales!",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Start Advertising on Contoso Today",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Adicionar: Necessário se a campanha principal não se associar a uma loja, opcional se a campanha principal associar a uma loja. Se a campanha principal associar a uma loja e especificar LongHeadlines, também tem de especificar Manchetes, Descrições e Imagens. Apenas o texto é respeitado. Mesmo que o recurso já exista na sua conta, o ID, assetPerformanceLabel e editorialStatus serão ignorados se os incluir.
Atualização: Opcional. Para manter todas as ligações de recursos existentes, defina ou deixe este campo vazio. Se definir este campo, quaisquer cabeçalhos que tenham sido anteriormente ligados a este anúncio serão substituídos. Se especificar este campo, é necessária uma lista de 1 a 5 cabeçalhos. Apenas o texto é respeitado. Mesmo que o recurso já exista na sua conta, o ID, assetPerformanceLabel e editorialStatus serão ignorados se os incluir.
Eliminar: Só de leitura

assetPerformanceLabel

Isto permite-lhe saber o desempenho do recurso.

O assetPerformanceLabel atributo é só de leitura quando transfere o anúncio de pesquisa reativa. Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Baixo	O desempenho deste recurso é baixo e recomendamos que substitua este recurso para melhorar o desempenho do seu anúncio.
Bom	Este recurso está a ter um bom desempenho. Recomendamos que mantenha este recurso e adicione mais recursos para melhorar o desempenho do seu anúncio.
Melhor	O desempenho deste recurso está entre os melhores e recomendamos que adicione mais recursos semelhantes.
Sem classificação	Não temos nenhuma classificação de desempenho para este recurso. Tal pode dever-se ao recurso estar inativo, não ter informações suficientes para determinar o seu desempenho ou se não existirem recursos semelhantes suficientes para comparar com o mesmo.
Aprendizagem	O desempenho do recurso está a ser avaliado ativamente. Assim que a avaliação estiver concluída, a classificação de recursos será Baixa, Boa, Melhor ou Sem Classificação.

editorialStatus

O editorialStatus atributo é uma cadeia só de leitura quando transfere o anúncio de pesquisa reativa. Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Ativo	O activo passou na revisão editorial.
ActiveLimited	O ativo passou a revisão editorial em um ou mais mercados, e um ou mais elementos do ativo estão a ser revistos editorialmente noutro mercado. Por exemplo, o recurso passou na revisão editorial do Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado	O activo falhou na revisão editorial.
Inativo	Um ou mais elementos do recurso estão a ser submetidos a uma revisão editorial.
Unknown	Reservado para utilização futura.

ID

O id atributo é um identificador exclusivo do Microsoft Advertising para o recurso numa conta do Microsoft Advertising.

texto

O atributo de text cada título longo tem de conter, pelo menos, uma palavra. O comprimento máximo de entrada do atributo de text cada cabeçalho é de 90 carateres. Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 45 carateres. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de anúncios. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis.

O text atributo não pode conter o caráter newline (\n).

Url Final do Dispositivo Móvel

O URL da página de destino móvel.

As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.

O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.
Pode especificar até 10 itens para URLs Finais e URLs Móveis Finais; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.
Cada URL é delimitado por um ponto e vírgula e espaço ("; ").
A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo "{lpurl}".
Cada URL tem de ser um URL bem formado, começando com http:// ou https://.
Se especificar URLs Finais para Dispositivos Móveis, também tem de especificar Url Final.

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

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 principal

O identificador gerado pelo sistema da campanha que contém o grupo de recursos.

Este campo em massa mapeia para o campo ID do registo campanha .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de campanha existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Campanha principal. Isto é recomendado se estiver a adicionar novos grupos de anúncios a uma nova campanha 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 Campanha .

Caminho 1

A primeira parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. A parte do domínio do URL de apresentação, por exemplo, https://www.contoso.com será gerada a partir do domínio do URL Final (campo URL Final ). Em seguida, se tiver especificado um valor para o Caminho 1 , será acrescentado ao URL de apresentação. Se também tiver especificado um valor para o Caminho 2, também será acrescentado ao URL de apresentação após o Caminho 1. Por exemplo, se o Url Final contiver https://www.contoso.com, o Caminho 1 estiver definido como subdiretório1 e o Caminho 2 estiver definido como subdiretório2, o URL apresentado será https://www.contoso.com/subdirectory1/subdirectory2.

O caminho pode conter parâmetros dinâmicos, como {MatchType}. Para obter uma lista dos parâmetros suportados, veja o artigo ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?.

O comprimento máximo de entrada é de 1000 carateres se incluir cadeias de texto dinâmicas. Não podem ser introduzidos mais de 15 carateres finais (não de texto dinâmico). O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento do domínio de URL final e os caminhos combinados excederem os 67 carateres.

Para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada é de 1000 carateres se incluir cadeias de texto dinâmicas. Não podem ser introduzidos mais de 7 carateres finais (não de texto dinâmico). O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento do domínio de URL final e os caminhos combinados excederem os 33 carateres. Os carateres de largura dupla são determinados pelos carateres que utiliza em vez do conjunto de carateres das definições de idioma da campanha ou do grupo de recursos. Os carateres de largura dupla incluem carateres de idiomas coreano, japonês e chinês, bem como Emojis.

O caminho não pode conter os carateres de barra (/) ou newline (\n).

Se o caminho incluir um espaço, será substituído por um caráter de sublinhado (_) quando o anúncio for apresentado.

Caminho 2

A segunda parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. A parte do domínio do URL de apresentação, por exemplo, https://www.contoso.com será gerada a partir do domínio do URL Final (campo URL Final ). Em seguida, se tiver especificado um valor para o Caminho 1 , será acrescentado ao URL de apresentação. Se também tiver especificado um valor para o Caminho 2, também será acrescentado ao URL de apresentação após o Caminho 1. Por exemplo, se o Url Final contiver https://www.contoso.com, o Caminho 1 estiver definido como subdiretório1 e o Caminho 2 estiver definido como subdiretório2, o URL apresentado será https://www.contoso.com/subdirectory1/subdirectory2.

Só pode especificar o Caminho 2 se o Caminho 1 também estiver definido.

O caminho não pode conter os carateres de barra (/) ou newline (\n).

Se o caminho incluir um espaço, será substituído por um caráter de sublinhado (_) quando o anúncio for apresentado.

Estado

O estado do grupo de recursos.

Os valores possíveis são Ativo, Eliminado, Expirado ou Em Pausa. O estado Expirado é só de leitura.

Adicionar: Opcional. O valor predefinido é Pausado.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Data de Início

A data em que o grupo de ativos pode começar a servir; caso contrário, o serviço pode começar a servir o grupo de recursos no dia em que o grupo de ativos se tornar ativo.

A data de início é inclusiva. Por exemplo, se definir Data de Início para 5/5/2020, o grupo de ativos começará às 00:00 a 5/05/2020. A hora baseia-se no fuso horário que especificar ao nível da campanha.

Adicionar: Opcional. Se não definir este campo ou se a data que submeter for anterior à data de hoje, a data de hoje será definida e o serviço pode começar a servir o grupo de ativos assim que o estado do grupo de ativos estiver ativo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Não é possível atualizar a data de início depois de o grupo de recursos ser submetido, ou seja, depois de chegar a data de início.
Eliminar: Só de leitura

Partilhar via

Registo do Grupo de Ativos - Em massa

Grupo de Recursos

Nome da Empresa

Chamada à Ação

Campanha

ID de Cliente

Descrições

assetPerformanceLabel

editorialStatus

ID

texto

Estatuto de Recurso Editorial

Localização Editorial

Código do Motivo Editorial

Estado Editorial

Termo Editorial

Data de Fim

Final Url

Cabeçalhos

assetPerformanceLabel

editorialStatus

ID

texto

ID

Imagens

cropHeight

cropWidth

cropX

recortarY

ID

subtipo

Cabeçalhos Longos

assetPerformanceLabel

editorialStatus

ID

texto

Url Final do Dispositivo Móvel

Hora da Modificação

ID principal

Caminho 1

Caminho 2

Estado

Data de Início

Comentários

Recursos adicionais