Utilizando parâmetros de pesquisa

Ao promover uma página nas mídias sociais ou nas campanhas de e-mail, você pode usar parâmetros de pesquisa no link do site para fornecer aos usuários acesso rápido à funcionalidade da Web Shop. Usando parâmetros de pesquisa, você pode criar uma configuração para que as seguintes ações sejam realizadas quando um usuário segue o link:

• Autenticação automática usando o ID do usuário ou link profundo.
• Redirecionamento ao cartão de um item específico. Se o usuário já está autenticado no site, ele prosseguirá com a compra do item.
• Abertura da interface de pagamento para comprar o item ou assinatura. Com esse link, o usuário será automaticamente logado no site.
• Sobrepor o país de usuário, independentemente do país detectado por endereço IP.
• Aplicação automática de um código promocional ao catálogo ou resgate de um cupom com uma recompensa.

Configurando autorização

Autorização via ID de usuário

Use um link com um parâmetro de pesquisa para a autorização automática de usuários ao navegar pelo site. Essa opção é adequada se seu site estiver configurado para a autorização via ID de usuário.

Para autenticar um usuário automaticamente via ID de usuário:

1. Copie o link ao site.
2. No final do link, adicione ?user-id=<user_ID>, onde <user_ID> é o ID de usuário para quem você está enviando o link.

• Exemplo: https://webshop-external-demo.xsolla.site/?user-id=12345

3. Envie links individuais aos usuários.

Após o usuário clicar no link, ele será redirecionado ao site e autenticado automaticamente.

Autorização via link profundo

Use um link com um parâmetro de pesquisa para a autorização automática de usuários ao navegar pelo site. Essa opção é adequada se seu site estiver configurado para a autenticação via link profundo.

Para autenticar um usuário automaticamente via link profundo:

1. Copie o link ao site.
2. Ao final do link, adicione ?deeplink=true.

• Exemplo: https://webshop-external-demo.xsolla.site/?deeplink=true

3. Compartilhe o link em materiais públicos ou envie links individuais aos usuários.

Após o usuário clicar no link, ele será redirecionado ao site e autenticado automaticamente.

Configuração da transição a um cartão de item

Use um link com um parâmetro de pesquisa para redirecionar o usuário diretamente ao item desejado ao abrir o site. Para um usuário autorizado, um cartão com informações sobre o item especificado no parâmetro de pesquisa será aberto. Se o usuário já estiver logado no site, a interface de pagamento para a compra do item será aberta ao clicar no link.

Para direcionar um usuário a um item especificado:

1. Copie o link ao site.
2. No final do link, adicione ?purchase-sku=<item_SKU>, onde <item_SKU> é o SKU do item desejado.

• Para encontrar o SKU do item (usando um item virtual como exemplo):
  1. Abra seu projeto na Conta de Distribuidor, acesse a seção Items catalog > All items > Virtual item.
  2. Navegue ao grupo de itens onde o item se encontra.
  3. Copie o SKU da linha do item especificado abaixo do seu nome.
  Exemplo: https://webshop-external-demo.xsolla.site/?purchase-sku=my-awesome-crystal

3. Compartilhe o link em materiais públicos ou envie links individuais aos usuários.

Depois que os usuários clicam no link, eles serão direcionados ao site, onde o cartão do item com informações detalhadas sobre o item será exibido, ou à interface de pagamento para comprar o item. Isso depende do usuário estar autenticado ou não no site.

Configuração da transição para a compra de um item

Use um link com parâmetros de pesquisa para redirecionar o usuário à interface de pagamento para a compra do item específico ao abrir o site. O link para comprar o item também inclui um dos parâmetros da autorização, permitindo que o usuário faça login automaticamente.

Para configurar:

1. Copie o link ao site.
2. Adicione um dos parâmetros de autenticação no final do link: ?user-id=<user_ID> ou ?deeplink=true.
3. Após o parâmetro de autenticação, adicione ?purchase-sku=<item_SKU>, onde <item_SKU> é o SKU do item.

• Para encontrar o SKU do item (usando um item virtual como exemplo):
  1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual item.
  2. Navegue ao grupo de itens onde o item se encontra.
  3. Copie o SKU na linha do item específico abaixo de seu nome.

• Exemplo: https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-sku=my-awesome-crystal

4. Compartilhe o link em materiais públicos ou envie links individuais aos usuários.

Configuração de transição à compra de assinatura

Use um link com parâmetros de pesquisa para redirecionar o usuário à interface de pagamento para a compra de itens específicos ao abrir o site. O link para comprar o item também inclui um dos parâmetros da autorização, permitindo que o usuário faça login automaticamente.

Para configurar:

1. Copie o link ao site.
2. Adicione um dos parâmetros de autenticação ao final do link: ?user-id=<user_ID> ou ?deeplink=true.
3. Após o parâmetro de autenticação, adicione &purchase-subscription=<plan_ID>, onde <plan_ID> é o ID do plano de assinatura.

1. Para encontrar o ID do plano de assinatura:
   1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > Subscriptions.
   2. Copie o ID na linha do plano de assinatura específico acima de seu nome.

1. Exemplo: https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-subscription=8Mp0MT9R

4. Compartilhe o link em materiais públicos ou envie links individuais aos usuários.

Configuração do país de compra

Use um link com o parâmetro de pesquisa purchase-country para explicitamente especificar o país do usuário ao acessar a Web Shop. Esse parâmetro define o país durante a compra, independentemente do país automaticamente detectado pelo endereço IP.

Para configurá-lo:

1. Copie o link ao site.
2. Adicione um dos parâmetros de autenticação ao final do link: ?user-id=<user_ID> ou ?deeplink=true.
3. Após o parâmetro de autenticação, adicione &purchase-sku=<ITEM_SKU>&purchase-country=<COUNTRY_CODE>, onde:
   • <ITEM_SKU> é o SKU do item.
   • <COUNTRY_CODE> é um código de país de duas letras no formato ISO 3166-1 alpha-2. O parâmetro afeta a moeda exibida, impostos e os métodos de pagamento disponíveis na Web Shop.

Exemplo: https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-sku=8Mp0MT9R&purchase-country=MY

Configuração da aplicação de um código promocional ou cupom

Use um link com um parâmetro de pesquisa para aplicar um código promocional ou cupom pelo usuário. O código pode ser aplicado automaticamente depois de navegar pelo site ou clicando no botão Redeem do código. Você também pode adicionar parâmetros ao link para um dos métodos de autenticação. Para usar um link com o parâmetro de código, configure os códigos promocionais e cupons no projeto.

1. Copie o link ao site.
2. Ao final do link, adicione um dos seguintes parâmetros de pesquisa:
   • ?redeem-code=<promo_code> — para o resgate automático de códigos.
   • ?insert-code=<promo_code> — para resgate ao clicar no botão.

• Em vez de <promo_code>, especifique o código promocional ou cupom que foi gerado na Conta de Distribuidor ou que você configurou você mesmo.

• Exemplo: https://xsolla.webshop.com/?redeem-code=promo777

• Se você quiser que o usuário seja autenticado automaticamente no site, adicione um dos parâmetros de autenticação antes do parâmetro do código no link: ?user-id=<user_ID> ou ?deeplink=true.

• Exemplo: https://webshop-external-demo.xsolla.site/?user-id=12345&redeem-code=TESTCOUPON

3. Compartilhe o link em materiais públicos ou envie links individuais aos usuários.

Quando o usuário autenticado clicar no link, ele será direcionado ao site, onde o código será ativado automaticamente ou o usuário terá a opção de resgatar o código manualmente.