Oferta de catálogo única

Como funciona

Oferta de catálogo única — a possibilidade de exibir itens ocultos no catálogo para usuários que inseriram um código de oferta única. Se o código não for inserido, os itens não são exibidos.

Principais recursos:

• configurando a lista de itens que são exibidos após inserir o código
• configurando promoções para os itens que são exibidos depois de inserir o código
• configurando o número total de resgates de código dentro da campanha
• configurando o número de resgates de códigos por usuário dentro da campanha
• configurando restrições regionais ao solicitar

• gerando múltiplos códigos

• O usuário deve estar autorizado para usar o código.
• Se o código estiver associado com um item que possui restrições regionais, os usuários das regiões onde o item está indisponível não verão as ofertas únicas associadas com o código.
  Exemplo: Depois de inserir o código, Legendary Starter Pack deve ser exibido. O Legendary Starter Pack tem uma restrição regional — ele está disponível apenas nos EUA. Se um usuário fora dos EUA inserir o código, um erro será retornado na resposta ao método Verifique o código promocional, e o usuário não pode ver ou comprar o Legendary Starter Pack.

Fluxo do usuário

1. O usuário autorizado abre o catálogo de item e vê todos os itens, exceto as ofertas únicas.
2. O usuário insere o código em um campo especial no catálogo e o ativa.
3. O usuário vê os itens únicos que estão disponíveis para compra.
4. O usuário compra um item único, após o qual o código é considerado resgatado.

Fluxo de integração

1. Configuração de uma promoção com ofertas de catálogo únicas.
2. Implemente a exibição do catálogo ao usuário. Para fazer isso, use os métodos da subseção Catálogo no grupo de métodos Itens Virtuais e Moedas para construir o catálogo.
3. Implemente a exibição de um campo no catálogo onde o usuário insere um código.
4. Use o método Verifique o código promocional para validar o código.
5. Implemente a exibição do catálogo de itens levando em conta o código. Para fazer isso, passe o valor do código no parâmetro promo_code ao chamar os métodos para construir o catálogo da subseção Catalog no grupo de métodos Virtual Items & Currency.
6. Para criar um pedido com um item único, use o método Create order with specified item. Passe o valor do código no parâmetro promo_code no corpo da solicitação. Se você quiser usar um carrinho, passe o valor do código no parâmetro promo_code no corpo da solicitação ao criar um carrinho e criar um pedido.

Como obtê-lo

Pré-requisitos

1. Cadastre-se na Conta de Distribuidor.
2. Conecte a Store e configure os módulos Virtual Items, Virtual Currency ou Bundles.

Configurar uma promoção com ofertas de catálogo únicas

1. Crie uma promoção com uma oferta de catálogo única usando o método de promoção Create unique catalog offer. Na matriz items, passe os SKUs dos itens que são exibidos após o código ser ativado. Você também pode especificar:
   • O período da promoção passando:
     • a data inicial no parâmetro date_start.
     • a data final do parâmetro date_end. Se a data final não for especificada, a promoção tem validade indefinida.
   • Limites:
     • a quantidade de vezes que a promoção pode ser usada por um usuário específico no parâmetro redeem_user_limit
     • a quantidade de vezes que o código pode ser resgatado no parâmetro redeem_code_limit
     • a quantidade total de vezes que a promoção pode ser usada no parâmetro redeem_total_limit
2. Gere códigos para a promoção criada usando o método Generate unique catalog offer codes ou crie um código usando o método Create unique catalog offer code. Você pode gerar códigos adicionais se necessário. Para gerar códigos, use o método Get unique catalog offer codes.
3. Ative a promoção usando Activate unique catalog offer promotion.

Para gerenciar a promoção, use os seguintes métodos:

• Atualize a promoção de oferta de catálogo única
• Desative a promoção de oferta de catálogo única

Para obter informações sobre as ofertas de catálogo únicas, use os seguintes métodos:

• Obter a lista de promoções de oferta de catálogo únicas
• Obter promoção de oferta de catálogo única