Migrar para os rótulos do feed

Use o campo feedLabel para adicionar um rótulo aos seus produtos e feeds de dados.

Os rótulos do feed podem ter o seguinte formato:

  • String de tipo
  • Menor ou igual a 20 caracteres
  • Letras maiúsculas (A-Z)
  • Números (0 a 9)
  • Traços (-)

O feedLabel está disponível nos seguintes recursos:

REST ID

feedLabel substitui targetCountry em IDs REST para novos produtos.

Em vez de online:language:targetCountry:offerId, o ID REST agora é formado como online:language:feedLabel:offerId para novos produtos. Isso não muda o ID REST dos seus produtos atuais.

Receber e listar produtos

O campo feedLabel é sempre preenchido para todos os produtos retornados.

Se feedLabel for um código de território CLDR válido, vamos preencher automaticamente o campo targetCountry para compatibilidade. Se o feedLabel não for um código de território CLDR válido, vamos deixar targetCountry vazio.

As mesmas mudanças se aplicam aos endpoints productstatuses.

Os campos específicos do país ficam vazios para ofertas com um feedLabel que não é um código de território CLDR.

Inserir e atualizar produtos

É necessário feedLabel ou targetCountry para inserir novos produtos. Se você inserir ou atualizar produtos com um feedLabel e um targetCountry, os valores precisam corresponder.

Você vai receber um erro da API se os campos estiverem vazios ou se os valores não corresponderem.

Consulte Usar rótulos para anunciar produtos de feeds específicos para mais detalhes.

Segmentação por país

Use uma das seguintes opções para garantir que seus produtos segmentem os países certos:

Produtos

O campo targetCountry para products foi descontinuado. Em vez disso, use o campo shipping para especificar os países de destino.

Se quiser segmentar vários países, continue usando shipping para adicionar mais regiões.

Consulte Segmentar anúncios em vários países para mais informações.

Feeds de dados

Agora é possível saber quais países um datafeed segmenta explicitamente em targets. Isso se aplica quando você usa feedLabel em vez de country na configuração datafeedtarget.

Também adicionamos o campo targetCountries para datafeeds, assim você pode configurar o direcionamento para datafeeds diretamente. Você ainda pode configurar a segmentação fora do feed, por exemplo, definindo o atributo shipping do recurso "products".

Conversão de UK para GB

No momento, permitimos o valor UK para o campo targetCountry, mesmo que não seja um código de país válido. Convertemos automaticamente UK para GB. Os produtos com UK como targetCountry são armazenados com GB no ID REST e offerId.

Se você definir UK como o valor de feedLabel, ele não será convertido automaticamente para GB. UK e GB são strings diferentes para feedLabel e vão criar ofertas diferentes.

Se você inserir um targetCountry de UK e o convertermos para GB, atualize o ID REST do produto para incluir GB em vez de UK e recupere o produto com o método get.