Para participar do recurso de disponibilidade e preços regionais (RAAP), você precisa configurar regiões, adicionar inventário regional e atualizar a página de destino.
Nesta página
Configurar regiões
Ativar o complemento Regiões
Confira se o recurso RAAP está disponível no seu país de destino para ativar o complemento "Regiões".
Etapas para ativar o complemento Região
- Acesse Complementos em "Configurações"
no menu de navegação à esquerda.
- Selecione o card do complemento Regiões na guia "Descobrir".
- Selecione Ativar.
Para concluir a integração, siga estas etapas:
- Criar regiões na conta do Merchant Center
- Fazer upload da fonte de dados de inventário regional
- Atualizar as páginas de destino
Criar e gerenciar regiões
Definições, requisitos e granularidade de suporte das regiões
Uma região é usada para definir uma área geográfica em que os produtos compartilham o mesmo preço on-line, disponibilidade ou ambos, que não são nacionais. As regiões são usadas tanto pelo recurso disponibilidade e preços regionais quanto pelo frete regional.
Se você usar os dois recursos, dependendo do seu modelo de negócios, talvez precise apenas de um conjunto de regiões para ambos ou pode criar regiões separadas para cada um.
Uma região é definida da seguinte maneira:
- Uma área geográfica definida por um conjunto de CEPs, estados ou províncias.
- Um ID da região que identifica exclusivamente cada região. Ele é usado para indicar a região na fonte de dados de inventário regional.
Se você estiver configurando as regiões na página "Regiões", defina o CEP/código postal ou as áreas com base no estado/província na guia "Regiões", na página "Informações comerciais" da conta do Merchant Center.
As regiões podem ser configuradas em uma única conta usando CEPs e fronteiras de estado/província. Embora seja necessário selecionar um tipo de granularidade para cada região distinta, a conta pode acomodar os dois simultaneamente.
Suporte à granularidade da região: todos os países qualificados para RAAP oferecem suporte a regiões com base em estado ou província, e alguns países também oferecem suporte a regiões com base em CEPs/códigos postais mais granulares.
| CEP | Argentina (AR), Austrália (AU), Brasil (BR), Canadá (CA), Chile (CL), Colômbia (CO), Suíça (CH), Alemanha (DE), Dinamarca (DK), França (FR), Grã-Bretanha (GB*), Hungria (HU), Indonésia (ID), Índia (IN), Itália (IT), Japão (JP), México (MX), Países Baixos (NL), Nova Zelândia (NZ) (somente lista de permissão), África do Sul (SA), Estados Unidos (US) e Vietnã (VN) |
| Estado ou província | Argélia (DZ), Angola (AO), Argentina (AR), Austrália (AU), Áustria (AT), Bahrein (BH), Bangladesh (BD), Belarus (BY), Bélgica (BE), Brasil (BR), Camboja (KH), Camarões (CM), Canadá (CA), Chile (CL), Colômbia (CO), Costa Rica (CR), Costa do Marfim (CI), República Tcheca (CZ), Dinamarca (DK), República Dominicana (DO), Equador (EC), Egito (EG), El Salvador (SV), Etiópia (ET), Finlândia (FI), França (FR), Geórgia (GE), Alemanha (DE), Gana (GH), Grécia (GR), Grã-Bretanha (GB), Guatemala (GT), Hungria (HU), Índia (IN), Irlanda (IE), Israel (IL), Japão (JP), Jordânia (JO), Cazaquistão (KZ), Quênia (KE), Kuwait (KW), Líbano (LB), Madagascar (MG), Malásia (MY), Maurício (MU), México (MX), Marrocos (MA), Moçambique (MZ), Myanmar (Birmânia) (MM), Nepal (NP), Países Baixos (NL), Nova Zelândia (NZ), Nicarágua (NI), Nigéria (NG), Noruega (NO), Omã (OM), Paquistão (PK), Panamá (PA), Paraguai (PY), Peru (PE), Filipinas (PH), Polônia (PL), Portugal (PT), Romênia (RO), Arábia Saudita (SA), Senegal (SN), Singapura (SG), Eslováquia (SK), Coreia do Sul (KR), Espanha (ES), Sri Lanka (LK), Suécia (SE), Suíça (CH), Tanzânia (TZ), Tailândia (TH), Tunísia (TN), Turquia (TR), Uganda (UG), Ucrânia (UA), Emirados Árabes Unidos (AE), Estados Unidos (US), Uruguai (UY), Uzbequistão (UZ), Venezuela (VE), Zâmbia (ZM), Zimbábue (ZW). |
Observação: *no Canadá, apenas os três primeiros caracteres dos códigos postais FSA (Forward Sortation Area) são aceitos. **Na Grã-Bretanha, apenas os primeiros 3 a 4 caracteres dos códigos postais são aceitos.
Exemplos:
- Canadá: no código postal "K1A 0B1", "K1A" são os caracteres aceitos.
- Os caracteres curinga são aceitos para os primeiros 1 ou 2 caracteres do código externo. Por exemplo, aceitamos "K1*" e "K*", mas não "K1A*".
- Grã-Bretanha: no código postal "SW1A 1AA", "SW1" e "SW1A" são os caracteres aceitos.
- Também aceitamos caracteres curinga (*) na parte do código externo ou do distrito. Por exemplo, aceitamos S* e SW*, mas SW1* não é permitido.
- Observe que os caracteres curinga são puramente baseados em strings. Por exemplo, B* abrangeria todos os BA*, BD*, BH* e assim por diante.
- O intervalo de código postal não é aceito na Grã-Bretanha.
Requisitos e práticas recomendadas para regiões
- A moeda usada para uma região precisa ser igual à utilizada na oferta nacional do produto.
- As regiões precisam atender aos requisitos mínimos de tamanho geográfico e população. Elas precisam cobrir uma área de 3 quilômetros quadrados e representar locais de pelo menos 1.000 pessoas.
- O ideal é que as regiões sejam geograficamente contíguas. Cada área contígua dentro de uma região está individualmente sujeita aos limites de tamanho e população mencionados no item acima. Evite adicionar áreas não anexadas pequenas a uma região. É possível estender uma pequena área. Para isso, basta agrupá-la com CEPs/códigos postais ao redor dela. Se a região não atender a esses requisitos, uma mensagem de erro será exibida na coluna "Problema", na página "Regiões".
Requisitos do ID da região
- Pode ser um CEP/código postal.
- Pode ser alfanumérico.
- Não pode ter símbolos além de "_".
- Limite de 2 a 100 caracteres.
- Somente letras minúsculas.
Práticas recomendadas
- Evite incluir uma área (como CEP/código postal, estado ou oblast) em mais de uma região. Se duas regiões se sobrepuserem e houver um conflito de preço ou disponibilidade regional, vamos escolher uma região e o preço ou disponibilidade correspondente no momento da veiculação.
- Não é necessário configurar regiões para o país inteiro. Só é preciso cobrir as áreas que exigem uma substituição regional para uma oferta.
- Se você tiver um armazém físico ou um hub de entrega, recomendamos que as regiões sejam baseadas nesses locais.
- Caso você defina o ID da região como um CEP/código postal ou código da loja já usado internamente pelo seu site, a integração da página de destino será mais fácil.
Criar uma região
As regiões são configuradas no nível da conta individual, o que pode ser feito na página "Regiões" do Merchant Center, na API Content ou na API Merchant. Para criar uma região no Merchant Center, siga estas etapas:
- Na sua conta do Merchant Center, selecione Configurações
- Selecione Informações comerciais
e depois Regiões.
- Selecione Adicionar região para criar uma nova região.
- Insira os valores em "ID da região", "Nome da região" e "País".
- O ID precisa ser exclusivo para cada região e pode ser alfanumérico, com tamanho entre 2 e 100 caracteres. É permitido usar sublinhados ("_") e apenas letras minúsculas.
- O nome ajuda a identificar a área geográfica que você quer incluir na sua região.
- Use o menu suspenso ao lado de "País" para selecionar a que país essa região será aplicada.
- Crie a região usando códigos postais ou estados ou províncias.
- Para usar CEPs/códigos postais, insira uma entrada por linha em um dos seguintes estilos:
- Um código postal (por exemplo, 75008).
- Intervalo de códigos postais (por exemplo: 2000 - 2500).
- Um intervalo de códigos postais usando um prefixo com um caractere curinga (*) (por exemplo, 94*).
- Um intervalo de códigos postais usando dois prefixos com caracteres curingas (*) e com o mesmo número de dígitos para os dois prefixos (por exemplo, 94* - 95*).
- Observe que há um limite padrão de 50 mil entradas por ID do Merchant Center. Uma entrada pode ser um código postal individual (94043), um caractere curinga (940*), um intervalo (94000-95000), uma área administrativa de nível 1 (por exemplo, "São Paulo") ou uma área de raio. Se precisar aumentar o limite, entre em contato com nossa equipe de suporte por formulário.
- Para estados ou províncias, verifique se as opções corretas foram selecionadas.
Editar uma região
- Na sua conta do Merchant Center, selecione Configurações
- Selecione Informações comerciais
- Selecione a região que você quer editar em "Nome da região" e, em "Editar região", faça as mudanças no campo relevante.
- Atualize separadamente o ID da região na fonte de dados de inventário regional para refletir os IDs atualizados, caso tenha mudado esse campo aqui.
- Para editar a área geográfica:
- Códigos postais:
- Adicione novos códigos exatamente como você fez quando criou a região, com um intervalo por linha. Selecione Adicionar código postal.
- Para remover um código postal, selecione o X ao lado dele ou Remover tudo para excluir todos.
- Estados ou províncias:
- Marque ou desmarque as caixas de seleção.
Remover uma região
Antes de remover uma região, verifique se ela não está mais sendo utilizada.
- Na sua conta do Merchant Center, selecione Configurações
- Selecione Informações comerciais
Configurar inventário regional
É possível configurar sua fonte de dados regional no Merchant Center, na API Content ou na API Merchant. Os dados regionais precisam ser atualizados pelo menos uma vez a cada 14 dias. Caso contrário, eles serão considerados desatualizados.
Para configurar usando a fonte de dados do Merchant Center, siga as etapas abaixo:
- Na sua conta do Merchant Center, selecione Configurações
- Selecione Origens de dados e clique na guia Fontes complementares.
- Observe que a guia "Fontes complementares" só aparece quando você ativa o complemento "Gerenciamento avançado de fontes de dados".
- Selecione Adicionar inventário regional.
- Faça upload da fonte de dados do seu inventário regional usando um arquivo. Escolha um dos seguintes métodos para fazer upload de um arquivo:
- Insira um link para o arquivo.
- Recomendamos usar o método de entrada de busca programada, que permite hospedar a fonte de dados XML em um URL e especificar quando o Google precisa fazer a busca. O local do arquivo precisa começar com "http://", "https://" ou "sftp://".
- Adicione um arquivo usando SFTP ou o Google Cloud Storage.
- Selecione "Ver detalhes do SFTP e do Google Cloud Storage" para criar uma senha e ativar sua conta do SFTP ou adicionar a conta do Cloud Storage, caso ainda não tenha feito isso.
- Faça o upload de um arquivo do seu computador.
- Configure as opções da fonte de dados para o método escolhido. Se você estiver usando a busca programada, faça o seguinte:
- Insira o URL do arquivo.
- Selecione o ícone de lápis
no campo "Editar programação" e escolha a frequência e o horário das buscas no menu suspenso. Depois, clique em Salvar.
- Caso seu URL esteja protegido por senha, forneça suas informações de login.
- Selecione Continuar.
As fontes de dados de inventário regionais aceitam os seguintes atributos obrigatórios:
- Código
[id](código da oferta) - ID da região
[region_id](corresponde ao valor definido pelo varejista enviado no menu "Regiões")
Elas também são compatíveis com estes atributos opcionais:
- Preço [price]
- Preço promocional [sale_price]
- Data de vigência do preço promocional [sale_price_effective_date]
- Disponibilidade [availability] (observação: somente os valores
in_stockeout_of_stocksão aceitos) - Programa de fidelidade
[loyalty_program]
in_stock e out_of_stock para o atributo disponibilidade [availability]. Os valores preorder e backorder não são aceitos.Exemplos de configurações
Como é possível definir diferentes níveis de disponibilidade regional para seus produtos, é importante determinar com antecedência o tipo de configurações e granularidade de inventário regional que você precisa. Exemplo:
- Seu produto está disponível em um subconjunto de códigos postais em um estado? Em caso afirmativo, confira abaixo se o país de destino é compatível no nível da região ou do código postal
- Todos os seus produtos têm preços ou disponibilidade regionais, ou ambos, ou apenas um subconjunto?
Use a tabela abaixo como orientação sobre possíveis maneiras de configurar sua fonte de dados regional:
| Fonte de dados de produtos nacional | Fonte de dados de inventário regional | |||
| Disponibilidade | Preço | Disponibilidade | Preço | |
| Preço e disponibilidade de todos os produtos por região | Em falta | O maior dos preços regionais | Em estoque | Preço regional |
| Disponibilidade regional de todos os produtos | Em falta | Preços nacionais | Em estoque | Em branco |
| Preço regional de todos os produtos | Em estoque | O maior dos preços regionais | Em branco | Preço regional |
Para ofertas sem substituições regionais, continue gerenciando o preço e a disponibilidade nacional (in_stock ou out_of_stock) na fonte de dados principal como faria normalmente.
As ofertas estão disponíveis nacionalmente, exceto em alguns estados ou áreas
out_of_stock para essas regiões.| Fonte de dados de produtos nacional | Fonte de dados de inventário regional | ||
| Disponibilidade | Preço | Disponibilidade | Preço |
in_stock |
Preço nacional | out_of_stock |
Em branco |
As ofertas estão disponíveis apenas em alguns estados ou áreas, e não em todo o país
in_stock para essas regiões.| Fonte de dados de produtos nacional | Fonte de dados de inventário regional | ||
| Disponibilidade | Preço | Disponibilidade | Preço |
out_of_stock |
Preço nacional | in_stock |
Em branco |
As ofertas têm preços regionais para alguns ou todos os estados ou áreas
| Fonte de dados de produtos nacional | Fonte de dados de inventário regional | ||
| Disponibilidade | Preço | Disponibilidade | Preço |
out_of_stock |
Preço nacional* | Em branco | Preço regional |
*Use preços realistas. Não use valores de R$ 0,00 ou R$ 1,00.
As ofertas estão disponíveis apenas em alguns estados ou áreas, e não em todo o país, e têm preços regionais
in_stock para essas regiões e fornecer preços regionais.
| Fonte de dados de produtos nacional | Fonte de dados de inventário regional | ||
| Disponibilidade | Preço | Disponibilidade | Preço |
in_stock |
Preço nacional* | in_stock |
Preço regional |
*Use preços realistas. O preço mais comum em estados ou áreas.
Atualizar a página de destino
O preço e a disponibilidade na sua página de destino precisam corresponder ao preço ou à disponibilidade regional mostrados nas plataformas do Google da sua fonte de dados regional. Para garantir uma experiência precisa na página de destino, o Google anexa o region_id correspondente ao local do comprador como um parâmetro ao URL de clique. Ajuste suas páginas de destino para que elas aceitem esse parâmetro e renderizem uma página de destino do produto que mostre o preço e a disponibilidade correspondentes.
O URL deve ser atualizado na fonte de dados principal. Se for adicionado à fonte de dados regional, os produtos podem não aparecer.
Exemplo:
Valor informado no atributo de link: https://mystorewebsite.com/p/myproductlandingpage
URL final: https://mystorewebsite.com/p/myproductlandingpage?region_id=123456
Valor fornecido no atributo de link: https://mystorewebsite.com/p?offer=myproduct
URL final: https://mystorewebsite.com/p?offer=myproduct®ion_id=123456
Práticas recomendadas
Se os IDs da região forem CEPs/códigos postais ou IDs internos de lojas existentes e sua página de destino já tiver um seletor de local ou loja, será possível simplificar a integração da página de destino transmitindo o ID da região diretamente para a lógica do seletor existente para atualizar o preço e a disponibilidade.
- Para ofertas esgotadas, o botão "Comprar" precisa estar esmaecido na página de destino.
- Recomendamos que você siga as práticas recomendadas para as páginas de destino.
- Para evitar problemas de rastreamento, verifique a marcação schema.org.
- Você pode usar a ferramenta de pesquisa aprimorada para testar suas páginas de destino.
- Mantenha uma experiência de página de destino estável para o usuário e garanta que o parâmetro region_id não seja substituído por cookies, visitas anteriores ou detecção de IP.
- Mostre o mesmo preço e disponibilidade na página do produto e na fonte de dados regional, mesmo que a oferta esteja definida como esgotada.
- Se você usa dados estruturados, anote cada página regional (o URL inclui region_id=XXXXX) com as informações de preço e disponibilidade correspondentes.
Políticas
Os URLs regionais precisam ter uma página de destino válida, em que os detalhes regionais possam ser verificados. Os URLs regionais precisam carregar ou redirecionar para uma página da Web no mesmo site, onde os usuários podem encontrar o preço e a disponibilidade regionais adequados da oferta. Siga os requisitos da página de destino.
Nossos rastreadores verificam ocasionalmente a disponibilidade e os preços dos produtos fornecidos por você na fonte de dados do produto. Inconsistências de preço ou disponibilidade podem levar a reprovações no nível do item ou da conta. Saiba mais sobre os problemas no Merchant Center.