Carte regalo (o voucher)

Questa guida illustra i requisiti, i consigli per la modellazione dei dati e le best practice per l'implementazione delle carte regalo (note anche come voucher) nel feed delle offerte. Questi consigli integrano la documentazione standard del Centro azioni e riguardano aspetti di integrazione specifici delle carte regalo.

Modalità di offerta e categorizzazione

Quando invii l'inventario delle carte regalo, assicurati che i seguenti attributi principali siano configurati correttamente:

  • Offer Mode (Modalità offerta): offer_modes deve sempre essere impostato come array singleton contenente "OFFER_MODE_GIFT_CARD_PURCHASE":

    "offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]

  • Voucher con valore memorizzato e sconti immediati per i clienti di passaggio:

    • gift_card_info è strettamente riservato a voucher e carte regalo con valore memorizzato preacquistati (OFFER_MODE_GIFT_CARD_PURCHASE).
    • Se un cliente paga direttamente alla cassa del negozio fisico sul posto per uno sconto immediato senza acquistare un codice voucher da richiedere o utilizzare in un secondo momento, modella l'offerta come uno sconto standard per i clienti di passaggio (OFFER_MODE_WALK_IN) e ometti completamente il messaggio gift_card_info.

  • Modellazione del taglio: il taglio della carta regalo deve rappresentare il valore del voucher (per cosa può essere utilizzato), non l'importo pagato dall'utente (l'utente paga il prezzo scontato).

  • Consolidamento di più tagli: più voucher che condividono esattamente la stessa percentuale di sconto e gli stessi termini, ma che differiscono nel valore nominale, devono essere raggruppati in una singola voce dell'offerta. Poiché denomination_type opera come oneof, i partner devono scegliere tra l'impostazione di fixed_denominations o di un custom_range:

    • Importi fissi: da utilizzare quando vengono offerti importi discreti e preimpostati per le carte regalo (ad es. 500 ₹, 1000 ₹ e 2000 ₹, tutti con uno sconto fisso del 10%). Assicurati che le denominazioni fisse esaurite o non disponibili sulla pagina di destinazione siano escluse esplicitamente dagli invii dei feed.
    • Intervallo personalizzato: da utilizzare solo quando gli utenti possono inserire liberamente qualsiasi valore nominale entro limiti definiti nella pagina di acquisto (ad es. qualsiasi valore tra 100 ₹ e 5000 ₹ con uno sconto del 5%). Se la pagina di destinazione offre importi discreti preimpostati, modella l'inventario rigorosamente in base a fixed_denominations. Inoltre, se per un'offerta sono disponibili sia tagli fissi sia tagli personalizzati, i partner devono impostare l'intervallo personalizzato flessibile.

Gestire catene con più sedi

Per i buoni regalo validi in grandi catene di vendita al dettaglio o ristorazione in cui i termini sono identici in più punti di interesse, non fornire un oggetto Offerta separato per ogni singolo negozio. Utilizza invece un approccio di alimentazione aggregata fornendo un singolo oggetto Offer contenente un elenco di tutti gli ID entità negozio partecipanti (entity_ids).

Branding del portale (brand_id)

Alcuni coupon vengono offerti tramite portali bancari o fedeltà specifici (ad es. programmi fedeltà bancari o piattaforme partner) anziché il sito principale del commerciante. Per garantire un branding accurato per questi portali, i partner devono compilare il campo brand_id negli oggetti Offerta di primo livello.

Sebbene l'omissione di brand_id corrisponda al brand principale dell'account (e brand_id non sia obbligatorio quando si utilizza il brand predefinito dell'account), il popolamento esplicito di brand_id associa con precisione l'inventario al portale brandizzato corrispondente, garantendo che agli utenti vengano visualizzati i loghi e i nomi specifici del partner corretti. Ulteriori istruzioni sulla configurazione dei brand sono disponibili in Configurazione dei brand.

Struttura di validità (ValidityScope)

Le carte regalo hanno una struttura di validità unica che distingue il periodo di tempo per acquistare l'offerta dalla durata per utilizzare la carta. I partner devono sempre utilizzare i valori di enumerazione ValidityScope pertinenti:

  • VALIDITY_SCOPE_CLAIM: definisce il periodo di tempo in cui l'offerta di carte regalo è disponibile per l'acquisto sulla piattaforma partner. Questa voce deve essere sempre presente. Quando invii i feed, compila il periodo di validità della rivendicazione a partire dalla data esatta di invio del feed. Inoltre, non lasciare mai periodi di rivendicazione aperti se la pagina di destinazione pubblicizza esplicitamente una data di fine della campagna; associa valid_through_time alla data di scadenza pubblicizzata.
  • VALIDITY_SCOPE_REDEEM: definisce la durata del riscatto post-acquisto (il periodo di tempo in cui gli utenti devono riscattare il coupon nel negozio dopo averlo acquistato, che può essere specificato come durata o periodo di tempo).

Mappatura del tipo di azione

I partner spesso classificano i coupon utilizzando costrutti come "utilizzabile online/offline", "online/outlet" o "in negozio". Negli invii dei feed, questo valore deve essere mappato all'enumerazione ActionType per definire con precisione la modalità di consumo del prodotto:

  • Verticale Ristorazione / Cibo: mappa le carte regalo "Cena in loco" su ACTION_TYPE_DINING. Mappa le carte regalo "Consegna" a ACTION_TYPE_FOOD_DELIVERY. Mappa le carte regalo "Asporto" su ACTION_TYPE_FOOD_TAKEOUT.
  • Verticale vendita al dettaglio Shopping: mappa le carte regalo "In negozio" su ACTION_TYPE_SHOPPING_IN_STORE. (Nota: i voucher per la vendita al dettaglio solo online non sono supportati).
  • Mappatura di un singolo canale: ogni offer_id può appartenere a un solo ActionType. Se un articolo di inventario supporta più canali di evasione (ad es. consegna di cibo e da asporto), crea oggetti Offerta distinti con ID univoci per ogni modalità.

Sconti a più livelli e offerte di componenti aggiuntivi

  • Sconti a più livelli per i metodi di pagamento: se vengono offerti diversi sconti percentuali in base allo strumento di pagamento specifico utilizzato (ad es. uno sconto maggiore per un e-wallet rispetto alle carte di credito), questi devono essere modellati come oggetti Offerta separati. I partner devono fornire una copertura promozionale esaustiva per tutti gli strumenti di pagamento supportati (ad es. e-wallet, carte di credito, carte di debito, Net Banking) per garantire un'esperienza di risparmio affidabile. Se un'offerta si applica universalmente a tutti i metodi di pagamento accettati sulla piattaforma, il campo dello strumento di pagamento non deve essere impostato.
  • Struttura delle offerte aggiuntive: per rappresentare i vantaggi cumulativi, ad esempio punti premio specifici della banca o cashback extra applicabile all'acquisto di una carta regalo, inviali come offerte aggiuntive completamente separate utilizzando l'enum OfferCategory appropriato: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER. Descrivi il premio all'interno di OfferDetails.other_offer_details_text (ad es. "Fino a 5 volte i punti premio") e collegalo all'offerta della carta regalo di base compilando OfferRestrictions.combinable_offer_ids con l'offer_id della carta regalo di base.

Termini e condizioni speciali

I partner devono fare affidamento a terms.terms_and_conditions per fornire i Termini e condizioni legali completi della carta regalo o del voucher. Consolida tutte le istruzioni e le linee guida per l'utilizzo rivolte agli utenti in questo campo.

Se le limitazioni critiche richiedono una visibilità dedicata nell'interfaccia utente (ad esempio scadenza del saldo monouso, non rimborsabilità o limiti di combinazione delle transazioni come "È possibile combinare un massimo di 2 voucher per fattura"), evidenziale in offer_restrictions.special_conditions.

Suggerimenti per il titolo dell'offerta

La lunghezza del titolo dell'offerta deve rimanere rigorosamente inferiore a 40 caratteri. Rimuovi i nomi dei brand dei commercianti da offer_display_text, poiché le offerte vengono visualizzate direttamente nella scheda dedicata del commerciante. Ti consigliamo i seguenti formati per i titoli:

Caso d'uso Titolo consigliato
Sconto fisso sui coupon X% off on Gift Cards
Sconto variabile in base al metodo di pagamento X% off on Gift Cards using {e-wallet}
Sconti variabili su tagli diversi X% off on Gift Cards (Invia sconti diversi come offerte separate)
Carte regalo B2B2C X% off on Gift Cards (il branding viene mostrato tramite la miniatura utilizzando brand_id)
Offerte di componenti aggiuntivi Flat/Up to 5X reward points/ <Platform> coins

Requisito della pagina di destinazione

Ogni offer_url pubblicizzato deve restituire direttamente HTTP 200 OK senza reindirizzamenti intermedi e risolversi in una pagina di destinazione attiva che dimostri l'offerta.

Il feed non deve includere tagli esauriti o non disponibili. Mantieni una sincronizzazione rigorosa dell'inventario tra i campi della denominazione del feed e le opzioni di acquisto in tempo reale nella pagina di destinazione.

La pagina di destinazione deve indicare chiaramente che l'offerta si applica specificamente a carte regalo o voucher.

Ad esempio, se una pagina di destinazione del partner mostra solo inviti all'azione di pagamento generici come "Paga fattura" senza indicare esplicitamente in anticipo che il completamento della transazione emette un voucher regalo a valore memorizzato, gli utenti reindirizzati da Google che si aspettano di acquistare una carta regalo potrebbero essere confusi o abbandonare la procedura. Anche se una notifica del coupon viene visualizzata in un passaggio di pagamento successivo, è necessaria chiarezza nella pagina di destinazione iniziale.

Offerte con codici coupon

Alcune offerte richiedono l'inserimento di un codice coupon da parte dell'utente, ad esempio "Applica il codice SCONTO20 per ottenere il 20% di sconto sul totale della fattura". È importante notare che Google non mostra i codici coupon della definizione di coupon. I partner possono includere queste informazioni in OfferDetails.offer_display_text da mostrare agli utenti. Le offerte basate su coupon rientrano generalmente in due categorie:

  • Offerte in cui il coupon viene presentato automaticamente al momento del pagamento a qualsiasi utente che arriva da Google. Questi sono consentiti.
  • Le offerte che richiedono all'utente di inserire il codice coupon al momento del pagamento, ma non forniscono istruzioni su come applicare il codice coupon nella pagina di destinazione dell'URL dell'offerta o non applicano automaticamente il coupon quando si segue l'URL dell'offerta, non sono consentite.

Esempio di JSON per l'offerta di una carta regalo

{
  "data": [
    {
      "offer_id": "example-dining-gift-card-10off",
      "entity_ids": [
        "dining-1",
        "dining-2"
      ],
      "offer_modes": [
        "OFFER_MODE_GIFT_CARD_PURCHASE"
      ],
      "action_type": "ACTION_TYPE_DINING",
      "offer_source": "OFFER_SOURCE_AGGREGATOR",
      "offer_category": "OFFER_CATEGORY_BASE_OFFER",
      "offer_details": {
        "offer_display_text": "10% off on Gift Cards",
        "discount_percent": 10.0,
        "gift_card_info": {
          "fixed_denominations": {
            "amounts": [
              {
                "units": 500,
                "currency_code": "INR"
              },
              {
                "units": 1000,
                "currency_code": "INR"
              },
              {
                "units": 2000,
                "currency_code": "INR"
              }
            ]
          }
        }
      },
      "offer_restrictions": {
        "combinable_with_other_offers": false,
        "special_conditions": [
          "Single-use balance expiration applies",
          "Maximum 2 gift card vouchers can be combined per bill",
          "No cash refund will be provided against this voucher"
        ]
      },
      "terms": {
        "restricted_to_certain_users": false,
        "terms_and_conditions": "1. Redeemable exclusively at participating dining outlets.\n2. Single-use balance expiration applies.\n3. Maximum 2 gift card vouchers can be combined per bill.\n4. No cash refund will be provided against this voucher."
      },
      "validity_periods": [
        {
          "valid_period": {
            "valid_from_time": {
              "seconds": "1774934350"
            },
            "valid_through_time": {
              "seconds": "1806470350"
            }
          },
          "validity_scope": "VALIDITY_SCOPE_CLAIM"
        },
        {
          "validity_duration_in_days": 365,
          "validity_scope": "VALIDITY_SCOPE_REDEEM"
        }
      ],
      "offer_url": "https://www.example-portal.com/dining-gift-cards/buy"
    }
  ]
}