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.
A published listing. For more information, see Create a new listing.
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¶

You must use the ACCOUNTADMIN role or a role that has been granted the provider privileges. For more information, see 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:

View details
Edit offer
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:

Copy offer URL
View details
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.

Create a standard offer¶

Faça login no Snowsight.
In the navigation menu, select 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.
In the Offer details dialog, specify details for the offer.
1. Select Standard offer.
2. Select the 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. Specify a name for the offer.
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. Specify the price to display to consumers.
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. (Optional) Specify any value propositions for the offer.
Selecione Next.
Review the offer summary, then click Create offer.

Create an offer manifest reference named 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

Create a private offer based on a pricing plan¶

Faça login no Snowsight.
In the navigation menu, select 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.
In the Create private offer pane, perform the following steps to create a private offer:
1. Na página Offer details, insira as seguintes informações:
  1. Select Private offer as the offer type.
  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. On the Billings and payments page, select an existing pricing plan` and enter the following information.
  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.
    
    For flat-fee plans, specifying a contract duration will auto-fill the total contract value based on the pricing plan details.
  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
    
    You can’t specify payment options for usage-based pricing plans.
  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.

Create an offer manifest reference named 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

Create a one-time pricing offer¶

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.
In the navigation menu, select 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.
In the Create private offer pane, run the following steps to create a private offer:
1. Na página Offer details, insira as seguintes informações:
  1. Select Private offer as the offer type.
  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. On the Billings and payments page, select Apple one-time pricing and enter the following information.
  1. Specify the total contract value.
  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.

Create an offer manifest reference named 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

Edit a standard offer¶

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

Faça login no Snowsight.
In the navigation menu, select Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
On the Offers tab, select the button for the standard offer you want to edit, and then select 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.
In the navigation menu, select Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
On the Offers tab, select Private offers, then select the button for the private offer you want to edit, and then select Edit.
Edit the private offer, and then click 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

View offer details¶

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

Faça login no Snowsight.
In the navigation menu, select Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Clique na guia Private Offers.
Click the button for the offer you want to view and then select View details.
Review the offer and click Close to return to the offers list.

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

SHOW OFFERS IN LISTING my_listing;

Copy

Retire a standard offer¶

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.
In the navigation menu, select Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Click the button for the standard offer you want to retire and then select 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.
In the navigation menu, select Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Clique na guia Private Offers.
Click the button for the private offer you want to view and then select Copy URL.

Revogação de uma oferta privada¶

Faça login no Snowsight.
In the navigation menu, select Marketplace » Provider Studio.
No painel direito, clique na guia Listings.
Selecione uma listagem paga na lista.
Clique na guia Private Offers.
Click the button for private offer you want to withdraw and then select Withdraw.
Clique em Withdraw offer.