Esquema de Ficheiro em Massa
O esquema em massa define o conteúdo do ficheiro para transferência ou carregamento com a API em Massa. Para transferência e carregamento, o Serviço em massa suporta os tipos de ficheiro e os esquemas correspondentes no conjunto de valores DownloadEntity .
Para obter mais informações sobre como utilizar o Serviço em massa para gerir as suas campanhas, veja Transferência e Carregamento em Massa. Para obter mais informações sobre como compreender o conteúdo do ficheiro de dados, veja as secções abaixo.
- Esquema de Ficheiro
- Formatar Versões
- Tipos de Registo
- Hierarquia de Tipos
- Chaves de Referência
- Identificadores de Cliente
- Erros
Esquema de Ficheiro
Pode optar por transferir um conjunto delimitado por tabulações ou vírgulas de registos (linhas) e campos (colunas). O cabeçalho da primeira coluna tem o nome Tipo. Os restantes nomes das colunas mapeiam para propriedades dentro ou associadas ao tipo de registo correspondente.
Importante
Podem ser adicionados novos tipos de registo (linhas) e campos (colunas) em qualquer altura e não deve depender da ordem dos registos ou campos no ficheiro de resultados de transferência em massa ou carregamento em massa. Da mesma forma, salvo indicação em contrário na documentação de referência, não deve depender de um conjunto fixo de valores devolvidos em cada campo.
Da mesma forma, durante o carregamento, pode submeter os campos por qualquer ordem. A ordem de carregamento de registos é importante ao criar novas entidades, conforme descrito abaixo em Hierarquia do Tipo.
Formatar Versões
A versão de formato em massa é separada da versão da API de Anúncios do Bing. A versão de formato permite um caminho de atualização flexível para adotar as funcionalidades suportadas mais recentes sem interromper a sua aplicação. Como melhor prática, deve sempre atualizar para a versão de formato mais recente. Atualmente, a única versão de formato suportada é a 6.0.
Para especificar a versão do formato de ficheiro através da transferência em massa, defina FormatVersion como 6.0 no pedido DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds .
Para especificar a versão através do carregamento em massa, defina o campo Nome do registo Formatar Versão como 6.0.
Tipos de Registo
Os registos disponíveis para carregamento e transferência com o Formato Versão 6.0 estão detalhados na tabela abaixo.
Importante
Podem ser adicionados novos tipos de registo (linhas) e campos (colunas) em qualquer altura e não deve depender da ordem dos registos ou campos no ficheiro de resultados de transferência em massa ou carregamento em massa.
Hierarquia de Tipos
O ficheiro de transferência incluirá sempre um registo para os tipos de registo Formatar Versão e Conta . Para o carregamento, a Versão de Formato é necessária e tem de preceder todos os outros tipos de registo no ficheiro em massa.
Se uma entidade principal for criada no mesmo ficheiro, deve preceder quaisquer registos subordinados dependentes no ficheiro em massa. Por exemplo, conforme mostrado no diagrama abaixo, ao associar uma extensão de anúncio de ligação de site a uma campanha, o registo da Extensão do Ad sitelink da campanha tem de ser incluído no ficheiro após os registos da Extensão de Anúncios de Campanha e de Sitelink . Os campos ID e ID Principal do registo Extensão de Anúncio do Sitelink de Campanha devem ser definidos para o identificador dos registos Extensão de Anúncio e Campanha do Sitelink, respetivamente. Se os registos da Extensão do Ad do Sitelink e da Campanha também forem novos e ainda não tiverem atribuído identificadores do Microsoft Advertising, deve utilizar as Chaves de Referência.
Não é necessário incluir o registo de uma entidade principal à qual já foi atribuído um identificador de Publicidade da Microsoft válido.
O êxito parcial é suportado ao adicionar, atualizar e eliminar registos de ficheiros em massa. Por exemplo, se tentar adicionar três campanhas e apenas duas forem especificadas corretamente no ficheiro, serão adicionadas duas. O ficheiro de resultados incluirá detalhes para registos de Campanha bem-sucedidos, um registo de Campanha tentado e um registo de Erro de Campanha .
Se o novo identificador de campanha ainda não for conhecido, por exemplo, ao adicionar uma campanha, um grupo de anúncios, um anúncio de texto e uma palavra-chave no mesmo ficheiro, especifique o Nome da campanha como Chave de Referência Lógica para quaisquer registos subordinados. Não é necessário especificar um elemento principal existente no carregamento.
As atualizações parciais são suportadas para registos em massa, incluindo palavras-chave negativas, sites negativos e critérios de destino. Por exemplo, pode atualizar a oferta de um único critério de localização e não precisa de transferir e carregar todo o conjunto de critérios de destino para a campanha ou grupo de anúncios.
Ao atualizar um registo, é necessário o campo ID do registo atualizado. O ID Principal ou as Chaves de Referência do registo principal também são necessários.
Ao atualizar o nome da campanha ou do grupo de anúncios, é opcional especificar o novo nome para os registos subordinados se for fornecido o ID Principal correto.
Se estiver a substituir um conjunto de registos por outro conjunto, tem de especificar os registos eliminados antes do novo conjunto. Por exemplo, para substituir todas as Palavras-chave Negativas da Campanha existentes para uma determinada campanha, inclua primeiro uma Palavra-chave Negativa de Campanha com Estado definido como Eliminado e ID Principal definido para o ID de campanha. Se não especificar qualquer ID , ou seja, não tentar eliminar uma palavra-chave negativa de camapaign específica, esta ação eliminará efetivamente todas as Palavras-chave Negativas da Campanha para essa campanha. Por baixo do registo "eliminar tudo", pode incluir um ou mais novos registos de Palavras-chave Negativas da Campanha com todas as propriedades necessárias para a operação de adição de carregamento.
Se estiver a substituir um registo existente por um novo registo que tenha as mesmas propriedades exclusivas, tem de especificar o registo eliminado antes do novo registo. Por exemplo, para substituir um Destino de Anúncios de Pesquisa Dinâmica do Grupo de Anúncios existente para um determinado grupo de anúncios, inclua primeiro um Destino de Anúncio de Pesquisa Dinâmica do Grupo de Anúncios com o Estado definido como Eliminado, O ID definido para o ID de destino de anúncio dinâmico (critério de página Web) existente e o ID Principal definido para o ID do grupo de anúncios. Abaixo do registo eliminado, pode incluir um novo registo do Ad Group Dynamic Search Ad Target (presumivelmente com novas condições de página Web).
Nota
Na maioria dos casos, pode atualizar o registo existente em vez de submeter eliminações separadas e adicionar registos, por exemplo, pode atualizar o campo Ajuste da Oferta de um Critério de Género de Campanha existente.
Ao eliminar um registo, é necessário o campo ID . Também é necessária uma referência à entidade principal, quer o valor seja um identificador de sistema atribuído ao Microsoft Advertising ou uma Chave de Referência para o registo principal. Por exemplo, ao eliminar um grupo de anúncios, o campo ID Principal do registo do Grupo de Anúncios deve corresponder ao campo ID no registo campanha ou o campo Campanha do registo do Grupo de Anúncios deve corresponder ao campo Campanha no registo Campanha . Se ambos forem fornecidos, o campo ID Principal do registo do Grupo de Anúncios (Chaves de Referência) é ignorado.
Com algumas exceções, o ficheiro de resultados incluirá apenas as colunas que carregou. Por exemplo, se carregar uma nova Palavra-chave Negativa do Grupo de Anúncios sem o cabeçalho da coluna ID , o ficheiro de resultado não incluirá o identificador atribuído para a nova palavra-chave negativa. O ficheiro em massa deve conter a coluna ID ; no entanto, deve deixar o ID vazio para cada nova Palavra-chave Negativa do Grupo de Anúncios. As exceções a esta regra são campanhas, grupos de anúncios, anúncios e palavras-chave, caso em que o ficheiro de resultados irá conter todas as colunas, independentemente das colunas carregadas.
Atualizar com delete_value
Para remover uma definição existente, não deve escrever uma cadeia vazia ("") no ficheiro em massa porque essas cadeias são ignoradas pelo serviço em massa. Utilize a cadeia reservada "delete_value" para eliminar ou repor o valor de um campo opcional.
- Se utilizar a cadeia reservada "delete_value" num campo opcional, a definição anterior será eliminada. Por exemplo, se definir o campo Parâmetro Personalizado do registo do Grupo de Anúncios como "delete_value", todos os parâmetros personalizados anteriores serão eliminados do grupo de anúncios. Da mesma forma, se definir o campo Modelo de Controlo do registo do Grupo de Anúncios como "delete_value", o modelo de controlo anterior será eliminado do grupo de anúncios.
- Os SDKs de Anúncios do Bing para .NET, Java e Python escrevem automaticamente "delete_value" quando aplicável. Para obter mais detalhes, veja Bulk Service Manager – Atualizar com delete_value.
Se utilizar "delete_value" nos campos necessários, tenha em atenção o seguinte.
- Se utilizar a cadeia reservada "delete_value" em vez de um valor primitivo necessário, esta será ignorada. Embora o campo não tenha sido atualizado, a cadeia "delete_value" será transmitida através do ficheiro de resultados de carregamento. Por exemplo, se definir o campo Grupo de Anúncios (nome do grupo de anúncios) do registo do Grupo de Anúncios como "delete_value", o nome do grupo de anúncios não será atualizado.
- Se utilizar a cadeia reservada "delete_value" em vez de um conjunto de valores necessário, o campo será atualizado para o valor predefinido e o ficheiro de resultados refletirá essa alteração. Por exemplo, se definir o campo Distribuição de Rede do registo do Grupo de Anúncios como "delete_value", a distribuição de rede do grupo de anúncios será definida como OwnedAndOperatedAndSyndicatedSearch e o ficheiro de resultados de carregamento refletirá o mesmo.
Chaves de Referência
Ao referir-se a um registo anterior no ficheiro em massa que ainda não tem um identificador do Microsoft Advertising atribuído, pode utilizar uma chave de referência lógica ou uma chave de referência negativa consoante o tipo de registo.
Nota
Se a entidade principal for criada no mesmo ficheiro, deverá preceder todos os registos subordinados dependentes no ficheiro em massa.
Chave de Referência Negativa
Ao referir-se a um registo anterior no ficheiro em massa que ainda não tem um identificador do Microsoft Advertising atribuído, pode definir o campo ID da extensão para um número negativo à sua escolha. Este ID personalizado é conhecido como uma chave de referência negativa. Em seguida, pode utilizar a chave de referência negativa no campo ID de um registo dependente.
O primeiro exemplo mostra como criar um Grupo de Anúncios para uma nova Campanha. Defina o campo ID Principal no registo do Grupo de Anúncios para a chave de referência negativa da Campanha (-111). Se adicionar registos adicionais no mesmo ficheiro que deve ter o Grupo de Anúncios como o respetivo principal (por exemplo, Palavra-chave ou Extensão do Ad Group Callout Ad), também deve definir o campo ID no Grupo de Anúncios para um valor negativo, por exemplo , -1111 , que pode ser referenciado a partir dos registos subordinados.
| Tipo | ID | ID principal |
|---|---|---|
| Campanha | -111 | |
| Grupo de Anúncios | -1111 | -111 |
O segundo exemplo mostra como criar uma Extensão do Ad de Nota de Aviso de Campanha para uma nova Campanha e uma nova Extensão do Ad de Nota de Aviso. O exemplo também mostra como criar uma Extensão de Aviso de Grupo de Anúncios para um novo Grupo de Anúncios e outra nova Extensão do Ad de Nota de Aviso.
- Defina o campo ID Principal no registo Da Extensão do Anúncio de Nota de Aviso da Campanha para a chave de referência negativa da Campanha (-111) e defina o campo ID no registo Da Extensão de Nota de Aviso da Campanha para a chave de referência negativa da Extensão do Aviso de Aviso (-11).
- Defina o campo ID Principal no registo Da Extensão de Nota de Aviso do Grupo de Anúncios para a chave de referência negativa do Grupo de Anúncios (-1111) e defina o campo ID no registo da Extensão de Anúncios da Nota de Aviso do Grupo de Anúncios para a chave de referência negativa da Extensão do Anúncio de Nota de Aviso (-12).
| Tipo | ID | ID principal |
|---|---|---|
| Extensão do AD de Nota de Aviso | -11 | |
| Extensão do AD de Nota de Aviso | -12 | |
| Campanha | -111 | |
| Grupo de Anúncios | -1111 | -111 |
| Extensão de Anúncio de Nota de Aviso de Campanha | -11 | -111 |
| Extensão do Ad Group Callout | -12 | -1111 |
Chave de Referência Lógica
Ao referir-se a um novo registo de Campanha ou Grupo de Anúncios , pode utilizar o nome da campanha e do grupo de anúncios em vez de definir o campo ID Principal para uma Chave de Referência Negativa no registo subordinado. Por exemplo, para adicionar um novo grupo de anúncios a uma nova campanha e adicionar uma nova palavra-chave ao novo grupo de anúncios, defina os campos Campanha e Grupo de Anúncios nos registos subordinados, conforme mostrado no exemplo seguinte.
| Tipo | Campanha | Grupo de Anúncios |
|---|---|---|
| Campanha | Sapatos femininos | |
| Grupo de Anúncios | Sapatos femininos | Venda de Sapatos Vermelhos Femininos |
Identificadores de Cliente
Os identificadores de cliente podem ser utilizados para associar registos de entrada no ficheiro de carregamento em massa a registos de saída no ficheiro de resultados. Por exemplo, ao adicionar novos registos, pode definir o campo ID de Cliente para um valor de cadeia à sua escolha. O sistema de Publicidade da Microsoft não efetua modificações aos identificadores do cliente e transmite-os para o ficheiro de resultados do registo correspondente.
Erros
O ficheiro de transferência em massa ou o ficheiro de resultados de carregamento em massa podem conter registos onde o campo Tipo correspondente inclui o sufixo Erro. Por exemplo, um tipo de registo Erro de Anúncio de Produto representa um erro de anúncio do produto. As colunas Erro e Número de Erro irão conter detalhes sobre o erro.
Nota
O ficheiro de resultados do carregamento pode incluir vários registos de erro correspondentes a um registo carregado.
Os erros relacionados com novas funcionalidades, como URLs Finais, incluirão detalhes adicionais sobre onde ocorreu o erro na coluna Caminho do Campo . Cada nome de caminho de campo corresponde a um elemento de um dos objetos de dados do Serviço de Gestão de Campanhas . Por exemplo, se o campo Modelo de Controlo de um registo de Campanha não começar com http:// ou https://, {lpurl}, ou {unescapedlpurl}, o valor deste valor de Caminho de Campo é TrackingTemplate. TrackingUrlTemplate é um elemento do objeto de dados Campanha disponível com o Serviço de Gestão de Campanhas.
| Tipo | Modelo de Controlo | Erro | Número de Erro | Caminho do Campo |
|---|---|---|---|---|
| Erro de Campanha | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | InvalidUrlScheme | 4600 | TrackingTemplate |
| Erro de Campanha | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | CampaignServiceInvalidUrl | 2611 | TrackingTemplate |
Importante
O valor Caminho do Campo está sujeito a alterações, pelo que não deve assumir uma dependência no formato de cadeia atual. O Caminho do Campo não é suportado para todos os erros. É suportado para os campos Url Final móvel, Url Final, Modelo de Controlo e Parâmetro Personalizado dos respetivos registos Campanha, Grupo Ad, Anúncio de Texto Expandido, Anúncio de Produto, Partição de Produto do Grupo de Anúncios, Palavra-chave e Extensão de Anúncio de Sitelink . Também é suportado para erros relacionados com todos os campos da Extensão do Ad de Nota de Aviso e Rever registos da Extensão do Ad .
Se o problema estiver relacionado com um erro editorial, as colunas Localização Editorial, Termo Editorial, Código do Motivo Editorial e Países do Publicador também poderão conter mais informações sobre o erro.