Registo de Itens de Feed - Em massa
Define um item de feed que pode ser transferido e carregado num ficheiro em massa.
Sugestão
Para obter uma descrição geral de como utilizar feeds e itens de feed, veja os Guias técnicos de Feeds de Personalizador de Anúncios, Feeds de Inventário Automático e Feeds de Página .
Nota
- Atualize os anúncios de texto expandidos para anúncios de pesquisa reativos até 1 de fevereiro de 2023. Após esta data, deixará de poder criar anúncios de texto expandido novos ou editar existentes. Para obter mais informações, consulte Acerca dos anúncios de pesquisa reativos.
- Os feeds agendados continuarão a ser executados e os anúncios de texto expandido existentes através de feeds personalizadores de anúncios continuarão a servir. Poderá ver relatórios sobre o desempenho dos mesmos.
- Continuará a poder colocar em pausa, executar ou remover os feeds personalizadores de anúncios existentes. Caso contrário, as tentativas de criar ou editar personalizadores de anúncios existentes para anúncios de texto expandido resultarão num
CustomerNotEligibleForAdCustomizersFeed
erro. - Saiba mais sobre esta alteração.
Se estiver a criar novas entidades principais e subordinadas no mesmo ficheiro em massa, os registos dependentes têm de ser incluídos após as dependências de acordo com a hierarquia:
Pode ter 100 feeds por conta (este número máximo inclui todos os tipos de feed) e o número máximo de itens de feed (linhas) por conta é de 5 milhões.
Pode transferir todos os registos de Itens de Feed na conta ao incluir o valor DownloadEntity de FeedItems 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 feed de páginas e um Feed personalizador de anúncios com um item de feed para cada um.
Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Target Campaign Id,Target Ad Group Id,Client Id,Modified Time,Start Date,End Date,Device Preference,Keyword,Match Type,Target,Physical Intent,Name,Ad Schedule,Audience Id,Feed Name,Custom Attributes
Format Version,,,,,,,,,,,,,,,,,,6,,,,
Feed,Active,-20,,PageFeed,,,,,PageFeedClientIdGoesHere,,,,,,,,,,,,MyPageFeedName,"[{""name"":""Page Url"",""feedAttributeType"":""Url"",""isPartOfKey"":true},{""name"":""Custom Label"",""feedAttributeType"":""StringList""},{""name"":""Ad Title"",""feedAttributeType"":""String""}]"
Feed,Active,-21,,AdCustomizerFeed,,,,,AdCustomizerFeedClientIdGoesHere,,,,,,,,,,,,MyAdCustomizerFeedName,"[{""name"":""DateTimeName"",""feedAttributeType"":""DateTime""},{""name"":""Int64Name"",""feedAttributeType"":""Int64""},{""name"":""PriceName"",""feedAttributeType"":""Price""},{""name"":""StringName"",""feedAttributeType"":""String"",""isPartOfKey"":true}]"
Feed,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,-21,,DynamicDataAutosListingFeed,,"[{""name"":""Vehicle ID""},{""name"":""Final URL""},{""name"":""Image URL""},{""name"":""Make""},{""name"":""Model""},{""name"":""Price""},{""name"":""Title""},{""name"":""Target campaign""},{""name"":""Target ad group""},{""name"":""Latitude""},{""name"":""Longitude""},{""name"":""Mileage value""},{""name"":""Mileage unit""},{""name"":""Year""},{""name"":""Fuel type""},{""name"":""Transmission""},{""name"":""City""},{""name"":""VIN""},{""name"":""State of vehicle""}]"
Feed Item,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,,-21,,,"{""Vehicle Id"":""2g161290-1d13"",""""Final Url"""":""https:\/\/www.contoso.com\/used-Redmond1"",""Image Urls"":""https:\/\/www.contoso.com\/inventoryphotos\/01.jpg;https:\/\/www.contoso.com\/inventoryphotos\/02.jpg"",""Make"":""Contoso"",""Model"":""SUV"",""Price"":""65495.00 USD"",""Title"":""2020 SUV"",""Target campaign"":""CampaignName"",""Target ad group"":"""",""Latitude"":"""",""Logitude"":"""",""Mileage Value"":""13000"",""Mileage Unit"":""MI"",""Year"":""2020"",""Fuel Type"":"""",""Transmission"":"""",""City"":""Redmond"",""Vin"":""SALLJGML8HA004044"",""State of Vehicle"":""USED"",""Trim"":""HSE""}"
Feed Item,Active,-200,-20,,,,20;200,,2020/06/22 00:00:00,2020/06/30 00:00:00,,,,,,,,,,"{""Page Url"":""https://contoso.com/3001"",""Custom Label"":[""Label_1_3001"",""Label_2_3001""],""Ad Title"":""An ad title""}"
Feed Item,Active,-210,-21,,,,21;210,,2020/06/22 00:00:00,2020/06/30 00:00:00,,value,Broad,,PeopleIn,,(Sunday[09:00-17:00]),,,"{""DateTimeName"":""2020/06/22 00:00:00"",""Int64Name"":237601,""PriceName"":""$601"",""StringName"":""s237601""}"
Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkFeedItem , 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 BulkFeedItem
var bulkAdCustomizerFeedItem = new BulkFeedItem
{
// 'Parent Id' column header in the Bulk file
FeedId = adCustomizerFeedIdKey,
// 'Custom Attributes' column header in the Bulk file
CustomAttributes = adCustomizerFeedItemCustomAttributesJson,
// 'Id' column header in the Bulk file
Id = null,
// 'Target Ad Group Id' column header in the Bulk file
AdGroupId = null,
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// 'Audience Id' column header in the Bulk file
AudienceId = null,
// 'Target Campaign Id' column header in the Bulk file
CampaignId = null,
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Ad Schedule' column header in the Bulk file
DayTimeRanges = new[]
{
// Each day and time range is delimited by a semicolon (;) in the Bulk file
// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
new DayTime
{
Day = Day.Monday,
StartHour = 9,
StartMinute = Minute.Zero,
EndHour = 21,
EndMinute = Minute.Zero,
},
},
// 'End Date' column header in the Bulk file
EndDate = null,
// 'Start Date' column header in the Bulk file
StartDate = null,
// 'Physical Intent' column header in the Bulk file
IntentOption = IntentOption.PeopleIn,
// 'Keyword' column header in the Bulk file
Keyword = "insurance",
// 'Target' column header in the Bulk file
LocationId = 190,
// 'Match Type' column header in the Bulk file
MatchType = MatchType.Exact,
// 'Device Preference' column header in the Bulk file
DevicePreference = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkAdCustomizerFeedItem);
// Map properties in the Bulk file to the BulkFeedItem
var bulkPageFeedItem = new BulkFeedItem
{
// 'Parent Id' column header in the Bulk file
FeedId = pageFeedIdKey,
// 'Custom Attributes' column header in the Bulk file
CustomAttributes = pageFeedItemCustomAttributesJson,
// 'Id' column header in the Bulk file
Id = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkPageFeedItem);
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 de Item de Feed , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
- Grupo de Anúncios
- Agenda de Anúncios
- ID da Audiência
- Campanha
- ID de Cliente
- Custom Attributes
- Preferência do Dispositivo
- Data de Fim
- ID
- Palavra-chave
- Tipo de Correspondência
- Hora da Modificação
- ID principal
- Intenção Física
- Data de Início
- Estado
- Target
- ID do Grupo de Anúncios de Destino
- ID da Campanha de Destino
Grupo de Anúncios
O nome do grupo de anúncios utilizado para direcionar o item de feed. Se este campo estiver definido, o item de feed só será elegível para o grupo de anúncios especificado.
Nota
Este campo só é aplicável a feeds personalizadores de anúncios.
Adicionar: Opcional. Se incluir este campo, o campo Campanha também tem de ser definido e o grupo de anúncios tem de existir dentro da campanha especificada. Se os campos Grupo de Anúncios e ID do Grupo de Anúncios de Destino estiverem definidos, é devolvido um erro para este registo no ficheiro em massa.
Atualização: Opcional. Se incluir este campo, o campo Campanha também tem de ser definido e o grupo de anúncios tem de existir dentro da campanha especificada. Se os campos Grupo de Anúncios e ID do Grupo de Anúncios de Destino estiverem definidos, é devolvido um erro para este registo no ficheiro em massa. 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
Agenda de Anúncios
A lista de intervalos de dia e hora que pretende que o item de feed seja apresentado com os seus anúncios. Cada dia e intervalo de tempo inclui o dia agendado da semana, a hora de início/fim e o minuto de início/fim. Cada dia e intervalo de tempo é colocado entre parênteses esquerdo e direito e separado de outros intervalos de dia e hora com um delimitador de ponto e vírgula (;). Dentro de cada dia e intervalo de tempo, o formato é Day[StartHour:StartMinue-EndHour:EndMinute].
Nota
Este campo só é aplicável a feeds personalizadores de anúncios.
Os valores possíveis de StartHour variam entre 00 e 23, em que 00 é equivalente a 00:00 e 12 é 12:00PM.
Os valores possíveis de EndHour variam entre 00 e 24, em que 00 é equivalente a 12:00 E 12 é 12:00PM.
Os valores possíveis de StartMinute e EndMinute variam entre 00 e 60.
O exemplo seguinte demonstra os intervalos de dias e horas durante os dias úteis das 9:00 às 21:00: (Segunda-feira[09:00-21:00]);( Terça-feira[09:00-21:00]); (Quarta-feira[09:00-21:00]); (Quinta-feira[09:00-21:00]); (Sexta-feira[09:00-21:00])
Adicionar: Opcional. Se não definir este campo, o item de feed será elegível para agendamento em qualquer altura durante as datas de início e de fim do calendário.
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 os intervalos de dia e de tempo individuais. Pode atualizar efetivamente os intervalos de dia e hora ao enviar um novo conjunto que deve substituir o conjunto anterior. Se não definir este campo, as definições existentes serão mantidas. Se definir este campo como delete_value, está efetivamente a remover todos os intervalos de dias e de tempo existentes.
Eliminar: Só de leitura
ID da Audiência
O identificador do Microsoft Advertising da audiência, por exemplo, a lista de remarketing utilizada para direcionar o item de feed. Se este campo estiver definido, o item de feed só será elegível para a audiência especificada.
Nota
Este campo só é aplicável a feeds personalizadores de anúncios.
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
Campanha
O nome da campanha utilizada para direcionar o item de feed. Se este campo estiver definido, o item de feed só será elegível para a campanha especificada.
Nota
Este campo só é aplicável a feeds personalizadores de anúncios.
Adicionar: Opcional. Se os campos Campanha e ID da Campanha de Destino estiverem definidos, é devolvido um erro para este registo no ficheiro em massa.
Atualização: Opcional. Se os campos Campanha e ID da Campanha de Destino estiverem definidos, é devolvido um erro para este registo no ficheiro em massa. 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 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
Custom Attributes
Os atributos são personalizados para cada Subtipo de feed e definem as informações sobre os seus produtos ou serviços que pretende inserir nos seus anúncios.
Para o Sub type do feed AdCustomizerFeed, pode incluir até 100 atributos personalizados por item de feed em que cada nome de atributo personalizado é exclusivo.
Para o subtipo DynamicDataAutosListingFeed , pode incluir até 100 atributos personalizados por item de feed em que cada nome de atributo personalizado é exclusivo.
Para o Sub type do feed PageFeed, pode incluir um ou dois atributos personalizados por item de feed em que cada nome de atributo personalizado é exclusivo.
Os atributos personalizados são representados no ficheiro em massa como uma cadeia JSON. Para obter mais detalhes, veja feedAttributeType, isPartOfKey e o nome abaixo.
Eis alguns atributos personalizados de exemplo que pode carregar para um feed de página.
Nota
No ficheiro em massa separado por vírgulas, terá de colocar a lista de atributos, cada chave de atributo e cada valor de atributo com um conjunto extra de aspas duplas, por exemplo, a cadeia JSON acima seria escrita como "[{""name"":""Url de Página"","feedAttributeType""":""Url"",""isPartOfKey""":true},{"name"":""Etiqueta Personalizada"",""feedAttributeType"":""StringList""},{""name"":""Título do Anúncio"","feedAttributeType"":""Cadeia""}]".
[
{
"name": "Page Url",
"feedAttributeType": "Url",
"isPartOfKey": true
},
{
"name": "Custom Label",
"feedAttributeType": "StringList"
},
{
"name": "Ad Title",
"feedAttributeType": "String"
}
]
Eis alguns atributos personalizados de exemplo que pode carregar para um feed personalizador de anúncios.
{
"DateTimeName": "2020/06/22 00:00:00",
"Int64Name": 237601,
"PriceName": "$601",
"StringName": "s237601"
}
Adicionar: Obrigatório. Para um personalizador de anúncios e o item de feed DynamicDataAutosListing, tem de definir pelo menos um atributo com um par de chave e valor válido. Para um feed de página, tem de definir pelo menos um atributo com o nome definido como "Url de Página".
Atualização: Opcional. Para manter todos os atributos personalizados existentes para o item de feed, defina ou deixe este campo vazio. Se definir este campo, todos os atributos personalizados que foram definidos anteriormente para este item de feed serão substituídos.
Eliminar: Só de leitura
feedAttributeType
O tipo de dados de cada atributo personalizado. Defina o tipo de dados no registo de feed e, em seguida, defina valores no item de feed. Desde que cada nome de atributo personalizado seja exclusivo no feed, pode definir múltiplos atributos com o mesmo tipo de dados.
Existem quatro tipos de dados diferentes feedAttributeType
que pode definir para feeds personalizadores de anúncios:
feedAttributeType | Casos de utilização | Valores de itens de feed aceites |
---|---|---|
Cadeia | Nomes de produtos, categorias de produtos, descrições | Quaisquer letras, números ou símbolos |
Int64 | Contagem de inventário, número de cores disponíveis | Qualquer número inteiro |
Preço | Custo do produto, desconto de venda | Qualquer número (incluindo decimais) e carateres de moeda válidos |
DateTime | Hora de início do evento, último dia de uma venda | aaaa/mm/dd HH:mm:ss Por predefinição, até à meia-noite no início do dia, pode omitir a parte HH:mm:ss. |
Por exemplo, podemos definir os atributos personalizados de um feed personalizador de anúncios.
[
{
"name": "DateTimeName",
"feedAttributeType": "DateTime"
},
{
"name": "Int64Name",
"feedAttributeType": "Int64"
},
{
"name": "PriceName",
"feedAttributeType": "Price"
},
{
"name": "StringName",
"feedAttributeType": "String",
"isPartOfKey": true
}
]
Em seguida, podemos mapear cada nome de feed, ou seja, "DateTimeName", "Int64Name", "PriceName" e "StringName" no carregamento do item de feed:
{
"DateTimeName": "2020/06/22 00:00:00",
"Int64Name": 237601,
"PriceName": "$601",
"StringName": "s237601"
}
Existem seis tipos de dados diferentes feedAttributeType
que pode definir para feeds DynamicDataAutosListing:
feedAttributeType | Casos de utilização | Valores de itens de feed aceites |
---|---|---|
Cadeia | Nome do veículo, categoria do veículo, descrição | Quaisquer letras, números ou símbolos |
Int64 | ano do veículo, motor | Qualquer número inteiro |
Preço | Custo do veículo, desconto de venda | Qualquer número (incluindo decimais) e carateres de moeda válidos |
DateTime | Hora de início do evento, último dia de uma venda | aaaa/mm/dd HH:mm:ss Por predefinição, até à meia-noite no início do dia, pode omitir a parte HH:mm:ss. |
URL | Contém o URL do seu site a incluir no feed. | Tem de incluir um URL por Item de Feed. |
StringList | Etiquetas que lhe permitem agrupar os URLs no feed. | Pode incluir entre uma a dez etiquetas personalizadas por Item de Feed. Cada etiqueta personalizada é representada como um item de lista na notação JSON. Por exemplo, a parte da etiqueta personalizada do Item de Feed pode ser escrita como ""Etiqueta Personalizada":[""Label_1_3001"",""Label_2_3001"""] |
Por exemplo, podemos definir os atributos personalizados de um feed DynamicDataAutosListing.
[
{
"name": "DateTimeName",
"feedAttributeType": "DateTime"
},
{
"name": "Int64Name",
"feedAttributeType": "Int64"
},
{
"name": "PriceName",
"feedAttributeType": "Price"
},
{
"name": "StringName",
"feedAttributeType": "String",
"isPartOfKey": true
},
{
"name": "Page Url",
"feedAttributeType": "Url",
"isPartOfKey": true
},
{
"name": "Custom Label",
"feedAttributeType": "StringList"
}
]
Em seguida, podemos mapear cada nome de feed, ou seja, "DateTimeName", "Int64Name", "PriceName" e "StringName" no carregamento do Item do Feed :
{
"DateTimeName": "2020/06/22 00:00:00",
"Int64Name": 237601,
"PriceName": "$601",
"StringName": "s237601",
"Page Url": "https://contoso.com/3001",
"Custom Label": [
"Label_1_3001",
"Label_2_3001"
],
}
Estes são os feedAttributeType
tipos de dados que pode definir para feeds de página:
feedAttributeType | Casos de utilização | Valores de itens de feed aceites |
---|---|---|
Cadeia | Cabeçalho estático que é apresentado em vez do cabeçalho gerado dinamicamente. | Todas as letras, números ou símbolos até 63 carateres. Pode incluir um título de anúncio por item de feed. |
StringList | Etiquetas que lhe permitem agrupar os URLs no feed. | Pode incluir entre uma a dez etiquetas personalizadas por Item de Feed. Cada etiqueta personalizada é representada como um item de lista na notação JSON. Por exemplo, a parte da etiqueta personalizada do Item de Feed pode ser escrita como ""Etiqueta Personalizada":[""Label_1_3001"",""Label_2_3001"""] |
URL | Contém o URL do seu site a incluir no feed. | Tem de incluir um URL por Item de Feed. |
Por exemplo, podemos definir os atributos personalizados do feed de páginas.
Nota
O feedAttributeType
é opcional para feeds de página. Se definir o feedAttributeType
, tem de ser definido como "URL" para "Url de Página", "StringList" para "Etiqueta Personalizada" e "Cadeia" para os atributos nomeados "Título do Anúncio".
[
{
"name": "Page Url",
"feedAttributeType": "Url",
"isPartOfKey": true
},
{
"name": "Custom Label",
"feedAttributeType": "StringList"
},
{
"name": "Ad Title",
"feedAttributeType": "String"
}
]
Em seguida, podemos mapear cada nome de feed, ou seja, "Url de Página", "Etiqueta Personalizada" e "Título do Anúncio" no carregamento do Item de Feed :
{
"Page Url": "https://contoso.com/3001",
"Custom Label": [
"Label_1_3001",
"Label_2_3001"
],
"Ad Title": "Find New Customers & Increase Sales!",
}
isPartOfKey
O isPartOfKey
determina se os valores de um atributo personalizado têm ou não de ser exclusivos em todos os registos de itens de feed que se acumulam no feed. Se estiver isPartOfKey
definido como "verdadeiro", os valores têm de ser exclusivos e, caso contrário, pode carregar valores duplicados para o mesmo atributo personalizado.
Para feeds personalizadores de anúncios e itens de feed, uma Cadeia com o nome "ID Personalizado" é sempre tratada como uma chave exclusiva, ou seja, a isPartOfKey
é sempre "true". O atributo "ID Personalizado" é atualmente a única forma de definir uma chave exclusiva para feeds personalizadores de anúncios através da aplicação Web Microsoft Advertising. Com a API em Massa, tem mais flexibilidade para utilizar qualquer nome de atributo como uma chave exclusiva.
Para feeds de páginas e itens de feed, o "URL da Página" é sempre tratado como uma chave exclusiva, ou seja, o isPartOfKey
é sempre "verdadeiro".
Para feeds DynamicDataAutosListing e itens de feed, o "VehicleId" é sempre tratado como uma chave exclusiva, ou seja, o isPartOfKey
é sempre "verdadeiro".
nome
O name
atributo é utilizado para mapear um atributo personalizado distinto no item Feed e feed. Efetivamente, é assim que garante que um item de feed específico é adicionado à mesma "coluna" no feed. No exemplo de personalizador de anúncios acima dos nomes "DateTimeName", "Int64Name", "PriceName" e "StringName" são utilizados no feed e no item de feed.
Preferência do Dispositivo
Este campo determina se a preferência é que o item de feed seja apresentado em dispositivos móveis ou em todos os dispositivos.
Nota
Este campo só é aplicável a feeds personalizadores de anúncios.
Os valores possíveis são All e Mobile, que diferem dos valores utilizados no serviço de gestão de campanhas.
O valor predefinido é Tudo.
No ficheiro de transferência e carregamento de resultados em massa, este campo nunca estará vazio. Se não tiver especificado uma preferência de dispositivo, será devolvido o valor predefinido de Todos .
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. Se definir este campo como delete_value, está efetivamente a repor para o valor predefinido de Todos.
Eliminar: Só de leitura
Data de Fim
A cadeia de data de fim agendada do item de feed formatada como aaaa/mm/dd HH:mm:ss. Por predefinição, até à meia-noite no início do dia, pode omitir a parte HH:mm:ss.
Nota
Este campo só é aplicável a feeds personalizadores de anúncios.
A data de fim é inclusiva. Por exemplo, se definir este campo como 2020/12/31 00:00:00, o item de feed deixará de ser elegível às 00:00 a 31/12/2020.
Adicionar: Opcional. Se não especificar uma data de fim, o item de feed continuará a ser entregue, a menos que coloque em pausa as campanhas, grupos de anúncios ou anúncios associados.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. A data de fim pode ser abreviada ou prolongada, desde que a data de início seja nula ou ocorra antes da nova data de fim. Se não definir este campo, as definições existentes serão mantidas. Se definir este campo como delete_value, está efetivamente a remover a data de fim e o item de feed continuará a ser entregue, a menos que coloque em pausa as campanhas, grupos de anúncios ou anúncios associados.
Eliminar: Só de leitura
ID
O identificador gerado pelo sistema do feed.
Adicionar: Só de leitura
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório
Palavra-chave
O texto da palavra-chave.
O texto pode conter um máximo de 100 carateres.
Deve especificar a palavra-chave na região do Idioma da campanha de destino ou do grupo de anúncios.
Adicionar: Necessário
Atualização: Só de leitura
Eliminar: Só de leitura
Tipo de Correspondência
O tipo de correspondência para comparar a palavra-chave e o termo de pesquisa do utilizador.
Os valores de tipo de correspondência suportados para uma palavra-chave são Largo, Exato e Expressão.
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 principal
O identificador gerado pelo sistema do Feed principal.
Os Atributos Personalizados e o Subtipo do feed principal determinam que Atributos Personalizados são válidos para este item de feed. Atualmente, os feeds personalizadores de anúncios e os feeds de página são suportados e outros tipos de feed podem ser adicionados no futuro.
Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura
Intenção Física
Determina se uma pessoa tem de estar fisicamente localizada na localização de destino para que o item de feed seja elegível.
Por predefinição, o item de feed pode ser apresentado às pessoas em, à procura ou à visualização de páginas sobre a sua localização de destino. Defina este campo como PeopleIn se apenas pretender que o item de feed seja apresentado às pessoas fisicamente localizadas na localização de destino.
Adicionar: Opcional. Se definir este campo , a Localização de destino também tem de ser definida.
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. Se definir este campo como delete_value, está efetivamente a repor para o valor predefinido de PeopleIn.
Eliminar: Só de leitura
Data de Início
A cadeia de data de início agendada do item de feed formatada como aaaa/mm/dd HH:mm:ss. Por predefinição, até à meia-noite no início do dia, pode omitir a parte HH:mm:ss.
A data de início é inclusiva. Por exemplo, se definir este campo como 06/2020/15 00:00:00, o item de feed começará a ser elegível às 00:00 de 15 de junho de 2020.
Adicionar: Opcional. Se não especificar uma data de início, o item de feed é imediatamente elegível para ser agendado durante o dia e os intervalos de tempo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. A data de início pode ser abreviada ou prolongada, desde que a data de fim seja nula ou ocorra após a nova data de início. Se não definir este campo, as definições existentes serão mantidas. Se definir este campo como delete_value, está efetivamente a remover a data de início e o item de feed é imediatamente elegível para ser agendado durante os intervalos de dia e hora.
Eliminar: Só de leitura
Estado
O estado do item de feed.
Os valores possíveis são Ativos ou Eliminados.
Adicionar: Opcional. O valor predefinido é Ativo.
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.
Target
O identificador da localização utilizada para direcionar o item de feed. Se este campo estiver definido, o item de feed só será elegível para a localização especificada.
Se quiser direcionar apenas as pessoas fisicamente para uma localização, também terá de definir o campo Intenção Física .
O identificador de localização corresponde ao campo ID de Localização do ficheiro de localizações geográficas. Para obter mais informações, veja Geographical Location Codes and GetGeoLocationsFileUrl (Códigos de Localização Geográfica e GetGeoLocationsFileUrl).
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 do Grupo de Anúncios de Destino
O identificador do grupo de anúncios utilizado para direcionar o item de feed. Se este campo estiver definido, o item de feed só será elegível para o grupo de anúncios especificado.
Nota
Este campo só é aplicável a feeds personalizadores de anúncios.
Adicionar: Opcional. Se também definir o campo Campanha (não necessário), o grupo de anúncios tem de existir dentro da campanha especificada. Se os campos Grupo de Anúncios e ID do Grupo de Anúncios de Destino estiverem definidos, é devolvido um erro para este registo no ficheiro em massa.
Atualização: Opcional. Se também definir o campo Campanha (não necessário), o grupo de anúncios tem de existir dentro da campanha especificada. Se os campos Grupo de Anúncios e ID do Grupo de Anúncios de Destino estiverem definidos, é devolvido um erro para este registo no ficheiro em massa. 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 da Campanha de Destino
O identificador da campanha utilizada para direcionar o item de feed. Se este campo estiver definido, o item de feed só será elegível para a campanha especificada.
Nota
Este campo só é aplicável a feeds personalizadores de anúncios.
Adicionar: Opcional. Se os campos Campanha e ID da Campanha de Destino estiverem definidos, é devolvido um erro para este registo no ficheiro em massa.
Atualização: Opcional. Se os campos Campanha e ID da Campanha de Destino estiverem definidos, é devolvido um erro para este registo no ficheiro em massa. 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