Criação e gerenciamento de ofertas no Snowsight¶

Os provedores podem criar ofertas padrão e privadas.

As ofertas padrão são exibidas na seção de preços de uma listagem. Com as ofertas padrão, os provedores podem permitir compras por autoatendimento ou enviar os consumidores para sua equipe de vendas usando uma opção Contact sales.
As ofertas privadas são visíveis apenas para os consumidores segmentados. Com as ofertas privadas, os provedores podem oferecer descontos e termos personalizados.

Pré-requisitos¶

Um perfil de provedor. Para obter mais informações, consulte Definição de um perfil de provedor.
Uma listagem publicada. Para obter mais informações, consulte Criar uma nova listagem.
Uma conta que permite o pagamento de listagens. Para obter mais informações, consulte Configuração do Stripe para receber pagamentos das listagens.

Privilégios obrigatórios¶

Você deve usar a função ACCOUNTADMIN ou uma função que tenha recebido os privilégios de provedor. Para obter mais informações, consulte Privilégios necessários para trabalhar com listagens.

Trabalho com ofertas¶

A guia Offers mostra uma lista de ofertas padrão e privadas disponíveis para uma listagem. A tabela inclui as seguintes informações sobre cada oferta:

Os seguintes detalhes estão disponíveis para ofertas padrão:

Nome da oferta

Status (Rascunho, Ativa, Desativada)

Tipo (Autoatendimento ou Baseado em vendas)

Data da última atualização

Ordem de exibição

Os seguintes detalhes estão disponíveis para ofertas privadas:

Nome da oferta
Status (Rascunho, Ativa, Retirada, Expirada)
Data de expiração
Público-alvo
Plano de preçosTermos
Data da última atualização

Cada linha em uma tabela Offers inclui um botão de ação que você pode selecionar para visualizar opções adicionais para gerenciar a oferta.

As ofertas padrão oferecem as seguintes ações:

Ver detalhes
Editar oferta
Exibir pedido (não disponível para ofertas Retired ou Draft)
Retirar oferta (não disponível para ofertas Retired ou Draft)

As ofertas privadas oferecem as seguintes ações:

Copiar URL da oferta
Ver detalhes
Editar oferta (não disponível para ofertas Active)
Retirar oferta (não disponível para ofertas Expired)

Limitações¶

Quando os provedores incluem um desconto em uma oferta, o desconto não é aplicado automaticamente às cobranças de SYSTEM$CREATE_BILLING_EVENT.

Para aplicar o desconto, armazene o preço com desconto em seu app.

Você também pode executar o comando SHOW OFFERS para recuperar o valor do desconto incluído em uma oferta.
Após recuperar o desconto, emita o valor final em dólares na chamada SYSTEM$CREATE_BILLING_EVENT.

Não envie o preço sem desconto.

Para obter mais informações sobre como criar eventos de faturamento, consulte Exemplos de eventos faturáveis.

Criar uma oferta padrão¶

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Na guia Offers, Standard offers está selecionado por padrão. Clique em + Create offer.
Na caixa de diálogo Offer details, especifique os detalhes da oferta.
1. Selecione Standard offer.
2. Selecione Purchase type:
  - Selecione Self-serve para permitir que os consumidores vejam o preço e comprem a listagem diretamente.
  - Selecione Sales-led para exigir que os consumidores entrem em contato com você para comprar a listagem.
3. Especifique um nome para a oferta.
4. Selecione Next.
Na caixa de diálogo Billing and payments, selecione um plano de preços para vincular a esta oferta.
(Opcional) Especifique se os consumidores precisam cadastrar um cartão de crédito para comprar a listagem.
Selecione Next.
Na caixa de diálogo Description, insira as informações sobre a oferta que estarão à disposição dos usuários.
1. Especifique um nome para a oferta que será exibido aos consumidores.
2. Especifique o preço que será exibido aos consumidores.
3. (Opcional) Especifique um slogan para exibir aos consumidores.
4. Especifique o texto do botão que os consumidores clicam para comprar a listagem.
5. (Opcional) Especifique as propostas de valor para a oferta.
Selecione Next.
Revise o resumo da oferta e clique em Create offer.

Crie uma referência do manifesto da oferta chamada PRICING_PLAN_1_DEFAULT_OFFER.

Nota

O nome da oferta deve estar em letras maiúsculas.

access_start_date_preference: SPECIFIC_DATE
comment: An internal note
contract_value: 120.12
contract_type: LIMITED_TIME
contract_duration_months: 12
discount: 0.0
invoice_start_date_preference: SPECIFIC_DATE
invoice_start_time: 1731102884579
is_default: false
display_name: Display name of the offer
expiration_time: 1762638884579
payment_terms:
  payment_type: FULL
pricing_plan_name: PRICING_PLAN_1
access_end_time: 1762638884579
access_start_time: 1731102884579
state: PUBLISHED
terms_of_service:
  type: DEFAULT

Copy

Crie uma referência do manifesto da listagem que inclua a oferta.

title: my_listing
subtitle: Subtitle for my_listing
description: Description for my_listing
listing_terms:
  type: OFFLINE
targets:
  regions: PUBLIC.AWS_US_EAST_1
usage_examples:
  - title: this is a test sql
    description: Simple example
    query: select *
offers:
  - name: PRICING_PLAN_1_DEFAULT_OFFER
    type: FILE
    path: offers/PRICING_PLAN_1_DEFAULT_OFFER.yaml

Copy

Prepare os arquivos de referência do manifesto da oferta e da listagem.

PUT file:///local/path/to/PRICING_PLAN_1_DEFAULT_OFFER.yaml @DB.SCHEMA.STAGE/offers/PRICING_PLAN_1_DEFAULT_OFFER
  SOURCE_COMPRESSION=NONE AUTO_COMPRESS=FALSE OVERWRITE=TRUE;

PUT file:///local/path/to/manifest.yaml @DB.SCHEMA.STAGE/listings/my_manifest
  SOURCE_COMPRESSION=NONE AUTO_COMPRESS=FALSE OVERWRITE=TRUE;

Copy

Crie uma listagem que use os arquivos de manifesto carregados na área de preparação.

CREATE EXTERNAL LISTING my_listing
  FROM @DB.SCHEMA.STAGE/listings/my_manifest
  REVIEW = TRUE
  PUBLISH = FALSE;

Copy

Criar uma oferta privada com base em um plano de preços¶

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Na guia Offers, selecione Private offers e clique em + Create offer.
No painel Create private offer, execute as seguintes etapas para criar uma oferta privada:
1. Na página Offer details, insira as seguintes informações:
  1. Selecione Private offer como o tipo de oferta.
  2. Especifique o identificador de conta de compartilhamento de dados para o consumidor que receberá esta oferta.
  3. Especifique um nome e uma data de expiração para a oferta.
  4. Selecione Next.
2. Na página Billings and payments, selecione um plano de preços existente ` e insira as seguintes informações.
  1. Revise os detalhes do preço negociado na tabela Plan components.
    
    Opcional: passe o cursor sobre uma linha na tabela Plan components e selecione o ícone Edit para modificar os detalhes do componente.
    - Para planos baseados em uso, você pode editar a taxa de acesso mensal ou aplicar um desconto. Você também pode editar o preço por consulta e o limite mensal.
    - Para planos com taxa fixa, você pode editar o preço da taxa de acesso ou aplicar uma porcentagem de desconto.
  2. Especificar o tipo de contrato:
    - Limited-time: concede acesso por um período fixo, como 30 dias. Cobranças ao consumidor podem ser feitas antecipadamente ou em parcelas
    - Recurring (Subscription): concede acesso contínuo. As cobranças ao consumidor são feitas na frequência escolhida para a duração do contrato, e a assinatura é renovada automaticamente até que o consumidor cancele a compra.
    Nota
    
    Não é possível especificar um tipo de contrato para planos de preços baseados no uso.
  1. Insira uma duração de contrato para indicar o período em que a oferta é válida.
    
    Para planos com taxa fixa, a especificação de uma duração do contrato preencherá automaticamente o valor total do contrato com base nos detalhes do plano de preços.
  2. Especifique opções de pagamento para a oferta:
    
    Require full payment upfront: o consumidor paga o valor total do contrato (TCV) no início do contrato.
    
    Accept installments: permita que o consumidor pague em parcelas mensais iguais ou especifique valores de parcelamento personalizados.
    
    Se você selecionar a opção Accept installments, poderá especificar o número de parcelas e o valor de cada parcela.
    
    Nota
    
    Não é possível especificar opções de pagamento para planos de preços baseados no uso.
  3. Especifique a data da primeira fatura.
    
    A data da primeira fatura é a data em que o consumidor será faturado pela primeira vez.
  4. Selecione se será necessário que um cartão de crédito esteja cadastrado.
  5. Selecione Next.
3. Na página Access and terms, especifique a data de início do acesso e os termos de serviço da oferta.
  
  A data de início do acesso é a data em que o consumidor pode começar a usar o produto. Ela pode ser definida como When offer accepted para permitir que o consumidor comece a usar o produto imediatamente após aceitar a oferta, ou você pode configurar uma data de início específica.
4. Selecione Next.
5. Na página Summary, revise os detalhes da oferta e depois selecione Done.

Após a conclusão, a oferta aparece na guia Private offers. O status inicial mostrará Active, indicando que a oferta está pronta para ser aceita pelo consumidor. O consumidor pode aceitar ou rejeitar a oferta e o status será atualizado de acordo.

Crie uma referência do manifesto da oferta chamada PRIVATE_OFFER_PRICING_PLAN.

Nota

O nome da oferta deve estar em letras maiúsculas.

version: V2
access_start_date_preference: SPECIFIC_DATE
comment: Private offer for specific consumer
contract_type: LIMITED_TIME
contract_duration_months: 12
discount: 10.0
invoice_start_date_preference: SPECIFIC_DATE
invoice_start_time: 1731102884579
is_default: false
display_name: Private Offer Display Name
expiration_time: 1762638884579
payment_terms:
  payment_type: FULL
pricing_plan_details:
  type: DEFAULT
  name: PRICING_PLAN_1
access_end_time: 1762638884579
access_start_time: 1731102884579
state: PUBLISHED
target_consumer: ORGANIZATION_NAME.ACCOUNT_NAME
terms_of_service:
  type: DEFAULT

Copy

Crie uma referência do manifesto da listagem que inclua a oferta privada.

title: my_listing
subtitle: Subtitle for my_listing
description: Description for my_listing
listing_terms:
  type: OFFLINE
targets:
  regions: PUBLIC.AWS_US_EAST_1
usage_examples:
  - title: this is a test sql
    description: Simple example
    query: select *
offers:
  - name: PRIVATE_OFFER_PRICING_PLAN
    type: FILE
    path: offers/PRIVATE_OFFER_PRICING_PLAN.yaml

Copy

Prepare os arquivos de referência do manifesto da oferta e da listagem.

PUT file:///local/path/to/PRIVATE_OFFER_PRICING_PLAN.yaml @DB.SCHEMA.STAGE/offers/PRIVATE_OFFER_PRICING_PLAN
  SOURCE_COMPRESSION=NONE AUTO_COMPRESS=FALSE OVERWRITE=TRUE;

PUT file:///local/path/to/manifest.yaml @DB.SCHEMA.STAGE/listings/my_manifest
  SOURCE_COMPRESSION=NONE AUTO_COMPRESS=FALSE OVERWRITE=TRUE;

Copy

Crie uma listagem que use os arquivos de manifesto carregados na área de preparação.

CREATE EXTERNAL LISTING my_listing
  FROM @DB.SCHEMA.STAGE/listings/my_manifest
  REVIEW = TRUE
  PUBLISH = FALSE;

Copy

Criar uma oferta de preço único¶

Os planos de preço único permitem que os provedores criem uma oferta privada que não esteja vinculada a um plano de preços. Ao estender uma oferta de preço único a um consumidor, ele paga uma taxa única e antecipada pelo acesso ao produto de dados por um período especificado.

As etapas abaixo descrevem como criar uma oferta de preço único.

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Na guia Offers, selecione Private offers e clique em + Create offer.
No painel Create private offer, execute as seguintes etapas para criar uma oferta privada:
1. Na página Offer details, insira as seguintes informações:
  1. Selecione Private offer como o tipo de oferta.
  2. Especifique o identificador de conta de compartilhamento de dados para o consumidor que receberá esta oferta.
  3. Especifique um nome e uma data de expiração para a oferta.
  4. Selecione Next.
2. Na página Billings and payments, selecione Apple one-time pricing e insira as seguintes informações.
  1. Especifique o valor total do contrato.
  2. Especificar o tipo de contrato:
    - Limited-time: concede acesso por um período fixo, como 30 dias. Cobranças ao consumidor podem ser feitas antecipadamente ou em parcelas
    - Recurring (Subscription): concede acesso contínuo. As cobranças ao consumidor são feitas na frequência escolhida para a duração do contrato, e a assinatura é renovada automaticamente até que o consumidor cancele a compra.
  3. Insira uma duração de contrato para indicar o período em que a oferta é válida.
  4. Especifique opções de pagamento para a oferta:
    - Require full payment upfront: o consumidor paga o valor total do contrato (TCV) no início do contrato.
    - Accept installments: permita que o consumidor pague em parcelas mensais iguais ou especifique valores de parcelamento personalizados.
      
      Se você selecionar a opção Accept installments, poderá especificar o número de parcelas e o valor de cada parcela.
  5. Especifique a data da primeira fatura.
    
    A data da primeira fatura é a data em que o consumidor será faturado pela primeira vez.
  6. Selecione se será necessário que um cartão de crédito esteja cadastrado.
  7. Selecione Next.
3. Na página Access and terms, especifique a data de início do acesso e os termos de serviço da oferta.
  
  A data de início do acesso é a data em que o consumidor pode começar a usar o produto. Ela pode ser definida como When offer accepted para permitir que o consumidor comece a usar o produto imediatamente após aceitar a oferta, ou você pode configurar uma data de início específica.
4. Selecione Next.
5. Na página Summary, revise os detalhes da oferta e depois selecione Done.

Crie uma referência do manifesto da oferta chamada ONE_TIME_PRICING_OFFER.

Nota

O nome da oferta deve estar em letras maiúsculas.

version: V2
access_start_date_preference: SPECIFIC_DATE
comment: One-time pricing offer for specific consumer
contract_type: LIMITED_TIME
contract_duration_months: 12
contract_value: 5000.00
invoice_start_date_preference: SPECIFIC_DATE
invoice_start_time: 1731102884579
is_default: false
display_name: One-Time Pricing Offer
expiration_time: 1762638884579
payment_terms:
  payment_type: FULL
access_end_time: 1762638884579
access_start_time: 1731102884579
state: PUBLISHED
target_consumer: ORGANIZATION_NAME.ACCOUNT_NAME
terms_of_service:
  type: DEFAULT

Copy

Crie uma referência do manifesto da listagem que inclua a oferta de preço único.

title: my_listing
subtitle: Subtitle for my_listing
description: Description for my_listing
listing_terms:
  type: OFFLINE
targets:
  regions: PUBLIC.AWS_US_EAST_1
usage_examples:
  - title: this is a test sql
    description: Simple example
    query: select *
offers:
  - name: ONE_TIME_PRICING_OFFER
    type: FILE
    path: offers/ONE_TIME_PRICING_OFFER.yaml

Copy

Prepare os arquivos de referência do manifesto da oferta e da listagem.

PUT file:///local/path/to/ONE_TIME_PRICING_OFFER.yaml @DB.SCHEMA.STAGE/offers/ONE_TIME_PRICING_OFFER
  SOURCE_COMPRESSION=NONE AUTO_COMPRESS=FALSE OVERWRITE=TRUE;

PUT file:///local/path/to/manifest.yaml @DB.SCHEMA.STAGE/listings/my_manifest
  SOURCE_COMPRESSION=NONE AUTO_COMPRESS=FALSE OVERWRITE=TRUE;

Copy

Crie uma listagem que use os arquivos de manifesto carregados na área de preparação.

CREATE EXTERNAL LISTING my_listing
  FROM @DB.SCHEMA.STAGE/listings/my_manifest
  REVIEW = TRUE
  PUBLISH = FALSE;

Copy

Editar uma oferta padrão¶

As etapas abaixo descrevem como editar uma oferta padrão.

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Na guia Offers, selecione o botão da oferta padrão que você deseja editar e, em seguida, Edit offer.

Crie uma versão ativa da listagem e baixe a referência do manifesto da oferta.

ALTER LISTING my_listing ADD LIVE VERSION FROM LAST;
GET snow://listing/my_listing/versions/live/offers/STANDARD_OFFER.yml file:///Users/my_username/

Copy

Edite a referência do manifesto da oferta.

Carregue os arquivos de referência do manifesto da oferta e da listagem e confirme a mudança.

PUT file:///Users/my_username/STANDARD_OFFER.yaml snow://listing/my_listing/versions/live/offers AUTO_COMPRESS = false;

ALTER LISTING my_listing COMMIT;

Copy

Edição de uma oferta privada¶

As etapas abaixo descrevem como editar ofertas privadas. Somente ofertas privadas com o seguinte status podem ser editadas:

DRAFT
EXPIRED
WITHDRAWN

Nota

Pode levar até 10 minutos para que as edições nas ofertas privadas fiquem visíveis para os consumidores.

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Na guia Offers, selecione Private offers, depois o botão da oferta privada que deseja editar e, por fim, Edit.
Edite a oferta privada e clique em Edit offer.

Crie uma versão ativa da listagem e baixe a referência do manifesto da oferta.
Edite a referência do manifesto da oferta.

Carregue os arquivos de referência do manifesto da oferta e da listagem e confirme a mudança.

PUT file:///Users/my_username/PRIVATE_OFFER.yaml snow://listing/my_listing/versions/live/offers AUTO_COMPRESS = false;

ALTER LISTING my_listing COMMIT;

Copy

Visualizar detalhes da oferta¶

Você pode visualizar os detalhes de ofertas padrão e privadas.

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Clique na guia Private Offers.
Clique no botão da oferta que deseja visualizar e selecione View details.
Revise a oferta e clique em Close para retornar à lista de ofertas.

Para ver os detalhes de uma oferta em sua listagem, execute o comando SHOW OFFERS.

SHOW OFFERS IN LISTING my_listing;

Copy

Desativar uma oferta padrão¶

Desativar uma oferta padrão ativa a torna indisponível para novas compras. Os consumidores existentes que já compraram a oferta podem continuar a usá-la até o vencimento do contrato.

Nota

Essa ação não pode ser desfeita.

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Clique no botão da oferta padrão que deseja desativar e selecione Retire offer.
Uma caixa de diálogo de confirmação será exibida. Clique em Retire offer para confirmar.

Cópia do URL de uma oferta privada¶

Copie o URL de uma oferta privada e forneça-o aos consumidores para que eles possam avaliar essa oferta e aceitá-la ou rejeitá-la.

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Clique na guia Private Offers.
Clique no botão da oferta privada que deseja visualizar e selecione Copy URL.

Revogação de uma oferta privada¶

Faça login no Snowsight.
No menu de navegação, selecione Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Clique na guia Private Offers.
Clique no botão da oferta privada que deseja cancelar e selecione Withdraw.
Clique em Withdraw offer.