Créer et gérer des offres dans Snowsight¶

Les fournisseurs peuvent créer des offres standard et privées.

Les offres standard sont affichées dans la section de tarification d’une liste. Avec les offres standard, les fournisseurs peuvent autoriser les achats en libre-service ou diriger les consommateurs vers leur équipe de vente à l’aide d’une option Contact sales.
Les offres privées sont uniquement visibles par les consommateurs ciblés. Avec les offres privées, les fournisseurs peuvent proposer des remises et des conditions personnalisées.

Conditions préalables¶

Un profil de fournisseur. Pour plus d’informations, voir Configuration d’un profil de fournisseur.
Une annonce publiée. Pour plus d’informations, voir `Créer une nouvelle liste `_.
Un compte qui autorise des paiements pour des annonces. Pour plus d’informations, voir Configurer Stripe pour être payé pour les annonces.

Privilèges requis¶

Vous devez utiliser le rôle ACCOUNTADMIN ou un rôle auquel les privilèges de fournisseur ont été accordés. Pour plus d’informations, voir Privilèges requis pour travailler avec des annonces.

Utilisation des offres¶

L’onglet Offers affiche une liste des offres standard et privées disponibles pour une liste. Le tableau comprend les informations suivantes sur chaque offre :

Les détails suivants sont disponibles pour les offres standard :

Nom d’offre

État (Brouillon, Actif, Retiré)

Type (libre-service ou axé sur les ventes)

Date de la dernière mise à jour

Ordre d’affichage

Les détails suivants sont disponibles pour les offres privées :

Nom d’offre
État (Brouillon, Actif, Supprimé, Expiré)
Date d’expiration
Consommateur cible
Conditions du plan tarifaire
Date de la dernière mise à jour

Chaque ligne d’une table Offers comprend un bouton d’action que vous pouvez sélectionner pour afficher des options supplémentaires pour la gestion de l’offre.

Les offres standard permettent d’effectuer les actions suivantes :

Voir les détails
Modifier l’offre
Ordre d’affichage (non disponible pour les offres Retired ou Draft)
Retirer l’offre (non disponible pour les offres Retired ou Draft)

Les offres privées permettent d’effectuer les actions suivantes :

Copier l’URL de l’offre
Voir les détails
Modifier l’offre (non disponible pour les offres Active)
Retirer l’offre (non disponible pour les offres Expired)

Limitations¶

Lorsque les fournisseurs incluent une remise dans une offre, la remise n’est pas automatiquement appliquée aux frais SYSTEM$CREATE_BILLING_EVENT.

Pour appliquer la remise, stockez le prix réduit dans votre application.

Vous pouvez également exécuter la commande SHOW OFFERS pour récupérer le montant de remise qui est inclus dans une offre.
Après avoir récupéré la remise, émettez le montant final en dollars dans l’appel SYSTEM$CREATE_BILLING_EVENT.

N’envoyez pas le prix sans la remise.

Pour plus d’informations sur la création d’événements de facturation, voir Exemples d’événements facturables.

Créer une offre standard¶

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Sur l’onglet Offers, Standard offers est sélectionné par défaut. Cliquez sur + Create offer.
Dans la boîte de dialogue Offer details, spécifiez les détails de l’offre.
1. Sélectionnez Standard offer.
2. Sélectionnez Purchase type :
  - Sélectionnez Self-serve pour permettre aux consommateurs de voir le prix et d’acheter la liste directement
  - Sélectionnez Sales-led pour demander aux consommateurs de vous contacter pour acheter la liste.
3. Spécifiez un nom pour l’offre.
4. Sélectionnez Next.
Dans la boîte de dialogue Billing and payments, sélectionnez un plan tarifaire à associer à cette offre.
(Facultatif) Spécifiez s’il convient de demander aux consommateurs d’enregistrer une carte de crédit pour acheter la liste.
Sélectionnez Next.
Dans la boîte de dialogue Description, saisissez les informations sur l’offre que les utilisateurs verront.
1. Spécifiez un nom d’offre à afficher pour les consommateurs.
2. Spécifiez le prix à afficher pour les consommateurs.
3. (Facultatif) Spécifiez une accroche à afficher pour les consommateurs.
4. Spécifiez le texte du bouton sur lequel les consommateurs cliqueront pour acheter l’annonce.
5. (Facultatif) Spécifiez toute proposition de valeur pour l’offre.
Sélectionnez Next.
Consultez le résumé de l’offre, puis cliquez sur Create offer.

Créer une référence de manifeste d’offre nommée PRICING_PLAN_1_DEFAULT_OFFER.

Note

Le nom de l’offre doit être en majuscules.

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

Créer une référence de manifeste d’annonce qui comprend l’offre.

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

Mettre en zone de préparation l’offre et les fichiers de référence du manifeste d’annonce.

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

Créer une annonce qui utilise les fichiers manifestes chargés dans la zone de préparation.

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

Copy

Créer une offre privée basée sur un plan tarifaire¶

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Sur l’onglet Offers, sélectionnez Private offers, puis cliquez sur + Create offer.
Dans le panneau Create private offer, effectuez cette procédure pour créer une offre privée :
1. Sur la page Offer details, saisissez les informations suivantes :
  1. Sélectionnez Private offer comme type d’offre.
  2. Spécifiez l’identificateur du compte de partage de données pour le consommateur qui recevra cette offre.
  3. Indiquez le nom et la date d’expiration de l’offre.
  4. Sélectionnez Next.
2. Sur la page Billings and payments, sélectionnez un plan tarifaire existant` et saisissez les informations suivantes.
  1. Vérifiez les détails des prix négociés dans le tableau Plan components.
    
    En option : Passez la souris sur une ligne dans le tableau Plan components et sélectionnez l’icône:ui:Edit pour modifier les détails du composant.
    - Pour les plans basés sur l’utilisation, vous pouvez modifier les frais d’accès mensuels ou appliquer une remise. Vous pouvez également modifier le prix par requête et la limite mensuelle.
    - Pour les plans à tarifs fixes, vous pouvez modifier le prix des frais d’accès ou appliquer un pourcentage de remise.
  2. Indiquez le type de contrat :
    - Limited-time : L’accès est accordé pendant une période donnée, par exemple 30 jours. Les consommateurs peuvent être facturés au préalable ou en plusieurs versements.
    - Recurring (Subscription) : L’accès est permanent. Les consommateurs sont facturés à la fréquence choisie pour la durée du contrat, et l’abonnement est automatiquement renouvelé jusqu’à ce que le consommateur annule l’achat.
    Note
    
    Vous ne pouvez pas spécifier un type de contrat pour des plans tarifaires basés sur l’utilisation.
  1. Saisissez une durée de contrat pour indiquer la durée pendant laquelle l’offre est valable.
    
    Pour les plans à tarifs fixes, spécifier une durée de contrat remplira automatiquement la valeur totale du contrat sur la base des détails du plan tarifaire.
  2. Précisez les options de paiement de l’offre :
    
    Require full payment upfront : Le consommateur paie la valeur totale du contrat (TCV) au début du contrat.
    
    Accept installments : Le consommateur est autorisé à payer en plusieurs versements mensuels égaux. Vous pouvez également spécifiez des montants de versements personnalisés.
    
    Si vous sélectionnez l’option Accept installments, vous pouvez spécifier le nombre de versements et le montant de ces versements.
    
    Note
    
    Vous ne pouvez pas spécifier d’options de paiement pour les plans tarifaires basés sur l’utilisation.
  3. Indiquez la première date de facturation.
    
    La première date de facturation est la date à laquelle le consommateur sera facturé pour la première fois.
  4. Indiquez si une carte de crédit doit être enregistrée dans le fichier.
  5. Sélectionnez Next.
3. Sur la page Access and terms, indiquez la date de début d’accès et les conditions de service de l’offre.
  
  La date de début d’accès est la date à laquelle le consommateur peut commencer à utiliser le produit. Vous pouvez définir ce paramètre sur When offer accepted pour permettre au consommateur de commencer à utiliser le produit immédiatement après avoir accepté l’offre, ou vous pouvez configurer une date de début spécifique.
4. Sélectionnez Next.
5. Sur la page Summary, examinez les détails de l’offre, puis sélectionnez Done.

Une fois que vous avez terminé, l’offre apparaît dans l’onglet Private offers. L’état initial affichera Active, indiquant que l’offre est prête à être acceptée par le consommateur. Le consommateur peut soit accepter, soit refuser l’offre, et l’état de celle-ci sera mis à jour en conséquence.

Créer une référence de manifeste d’offre nommée PRIVATE_OFFER_PRICING_PLAN.

Note

Le nom de l’offre doit être en majuscules.

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

Créer une référence de manifeste d’annonce qui comprend l’offre privée.

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

Mettre en zone de préparation l’offre et les fichiers de référence du manifeste d’annonce.

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

Créer une annonce qui utilise les fichiers manifestes chargés dans la zone de préparation.

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

Copy

Créer une offre tarifaire unique¶

Les plans tarifaires uniques permettent aux fournisseurs de créer une offre privée qui n’est pas liée à un plan tarifaire. Lorsque vous proposez une offre tarifaire unique à un consommateur, ce dernier est soumis à des frais uniques et initiaux pour l’accès au produit de données pendant une durée déterminée.

Les étapes ci-dessous décrivent comment créer une offre tarifaire unique.

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Sur l’onglet Offers, sélectionnez Private offers, puis cliquez sur + Create offer.
Dans le panneau Create private offer, suivez les étapes suivantes pour créer une offre privée :
1. Sur la page Offer details, saisissez les informations suivantes :
  1. Sélectionnez Private offer comme type d’offre.
  2. Spécifiez l’identificateur du compte de partage de données pour le consommateur qui recevra cette offre.
  3. Indiquez le nom et la date d’expiration de l’offre.
  4. Sélectionnez Next.
2. Sur la page Billings and payments, sélectionnez Apple one-time pricing et saisissez les informations suivantes.
  1. Spécifiez la valeur totale du contrat.
  2. Indiquez le type de contrat :
    - Limited-time : L’accès est accordé pendant une période donnée, par exemple 30 jours. Les consommateurs peuvent être facturés au préalable ou en plusieurs versements.
    - Recurring (Subscription) : L’accès est permanent. Les consommateurs sont facturés à la fréquence choisie pour la durée du contrat, et l’abonnement est automatiquement renouvelé jusqu’à ce que le consommateur annule l’achat.
  3. Saisissez une durée de contrat pour indiquer la durée pendant laquelle l’offre est valable.
  4. Précisez les options de paiement de l’offre :
    - Require full payment upfront : Le consommateur paie la valeur totale du contrat (TCV) au début du contrat.
    - Accept installments : Le consommateur est autorisé à payer en plusieurs versements mensuels égaux. Vous pouvez également spécifiez des montants de versements personnalisés.
      
      Si vous sélectionnez l’option Accept installments, vous pouvez spécifier le nombre de versements et le montant de ces versements.
  5. Indiquez la première date de facturation.
    
    La première date de facturation est la date à laquelle le consommateur sera facturé pour la première fois.
  6. Indiquez si une carte de crédit doit être enregistrée dans le fichier.
  7. Sélectionnez Next.
3. Sur la page Access and terms, indiquez la date de début d’accès et les conditions de service de l’offre.
  
  La date de début d’accès est la date à laquelle le consommateur peut commencer à utiliser le produit. Vous pouvez définir ce paramètre sur When offer accepted pour permettre au consommateur de commencer à utiliser le produit immédiatement après avoir accepté l’offre, ou vous pouvez configurer une date de début spécifique.
4. Sélectionnez Next.
5. Sur la page Summary, examinez les détails de l’offre, puis sélectionnez Done.

Créer une référence de manifeste d’offre nommée ONE_TIME_PRICING_OFFER.

Note

Le nom de l’offre doit être en majuscules.

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

Créer une référence de manifeste d’annonce qui comprend l’offre de tarifaire unique.

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

Mettre en zone de préparation l’offre et les fichiers de référence du manifeste d’annonce.

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

Créer une annonce qui utilise les fichiers manifestes chargés dans la zone de préparation.

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

Copy

Modifier une offre standard¶

Les étapes ci-dessous décrivent comment modifier une offre standard.

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Dans l’onglet Offers , sélectionnez le bouton de l’offre standard que vous souhaitez modifier, puis sélectionnez Edit offer.

Créez une version en direct de votre annonce et téléchargez la référence du manifeste d’offre.

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

Modifiez la référence au manifeste d’offre.

Téléchargez les fichiers de référence du manifeste d’offre et des annonces et validez la modification.

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

ALTER LISTING my_listing COMMIT;

Copy

Modifier une offre privée¶

Les étapes ci-dessous décrivent comment modifier une offre privée. Seules les offres privées qui ont le statut suivant peuvent être modifiées :

DRAFT
EXPIRED
WITHDRAWN

Note

Il peut s’écouler jusqu’à 10 minutes avant que les modifications apportées aux offres privées soient visibles par les consommateurs.

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Dans l’onglet Offers, sélectionnez Private offers, puis sélectionnez le bouton de l’offre privée que vous souhaitez modifier, puis sélectionnez Edit.
Modifiez l’offre privée, puis cliquez sur Edit offer.

Créez une version en direct de votre annonce et téléchargez la référence du manifeste d’offre.
Modifiez la référence au manifeste d’offre.

Téléchargez les fichiers de référence du manifeste d’offre et des annonces et validez la modification.

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

ALTER LISTING my_listing COMMIT;

Copy

Voir les détails de l’offre¶

Vous pouvez voir les détails des offres standard et privées.

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Cliquez sur l’onglet Private Offers.
Cliquez sur le bouton de l’offre que vous souhaitez voir, puis sélectionnez View details.
Consultez l’offre et cliquez sur Close pour revenir à la liste des offres.

Pour voir les détails d’une offre dans votre annonce, exécutez la commande SHOW OFFERS.

SHOW OFFERS IN LISTING my_listing;

Copy

Retirer une offre standard¶

Le retrait d’une offre standard active la rend indisponible pour les nouveaux achats. Les consommateurs existants qui ont déjà acheté l’offre peuvent continuer à l’utiliser jusqu’à l’expiration de leur contrat.

Note

Cette action est irréversible.

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Cliquez sur le bouton de l’offre standard que vous souhaitez retirer, puis sélectionnez Retire offer.
Une boîte de dialogue de confirmation s’ouvre. Cliquez sur Retire offer pour confirmer.

Copier l’URL d’une offre privée¶

Copiez l’URL d’une offre privée et fournissez-la aux consommateurs afin qu’ils puissent l’examiner et l’accepter ou la refuser.

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Cliquez sur l’onglet Private Offers.
Cliquez sur le bouton pour trouver l’offre privée que vous souhaitez voir, puis sélectionnez Copy URL.

Retirer une offre privée¶

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Marketplace » Provider Studio.
Dans le volet de droite, cliquez sur l’onglet Listings.
Sélectionnez une annonce payante dans la liste.
Cliquez sur l’onglet Private Offers.
Cliquez sur le bouton de l’offre privée que vous souhaitez retirer, puis sélectionnez Withdraw.
Cliquez sur Withdraw offer.