Distribuire app negli Stati Uniti che forniscono un link per gli acquisti esterni

Oltre al sistema di acquisto in-app pratico, sicuro e protetto di Apple, le app sull’App Store degli Stati Uniti che offrono acquisti in-app possono utilizzare anche l’autorizzazione StoreKit External Purchase Link (USA) per includere un link al sito web dello sviluppatore dove sono indicati altri modi per acquistare beni o servizi digitali. Per utilizzare l’autorizzazione dovrai inviare una richiesta, abilitare l’autorizzazione in Xcode e usare le API StoreKit necessarie. Apple esaminerà l’app per verificare che rispetti i termini e le condizioni dell’autorizzazione, nonché le linee guida per la revisione per l’App Store e il contratto di licenza dell’Apple Developer Program.

Richiedere un’autorizzazione

Chi desidera utilizzare l’autorizzazione StoreKit External Purchase Link (USA) per l’app può iniziare inviando il modulo di richiesta di autorizzazione. Sarà necessario essere titolare dell’account nell’Apple Developer Program, fornire informazioni quali l’ID del pacchetto dell’app, il dominio del sito web e il fornitore di servizi di pagamento, oltre ad accettare i termini e le condizioni dell’autorizzazione.

Per essere idonea a usufruire dell’autorizzazione, la tua app deve:

  • essere disponibile sull’App Store iOS o iPadOS degli Stati Uniti;
  • offrire acquisti in-app se distribuita tramite l’App Store iOS o iPadOS degli Stati Uniti; e
  • non partecipare né al Video Partner Program, né al News Partner Program.

Inserire le informazioni dell’app

Nome e descrizione dell’app. Inserisci il nome della tua app, poi descrivi lo scopo principale della tua app e il suo funzionamento.

ID pacchetto. Inserisci l’ID pacchetto (l’identificatore univoco dell’app) che intendi utilizzare. Le richieste di autorizzazione vengono effettuate per ID pacchetto e le autorizzazioni assegnate possono essere utilizzate esclusivamente con il singolo file binario associato all’ID pacchetto.

Inserire le informazioni del proprio sito web

URL di destinazione. Indica l’URL esatto da cui gli utenti effettueranno acquisti sul tuo sito web.

Sito web dell’assistenza clienti. Inserisci l’URL del sito web dell’assistenza clienti dove gli utenti possono ricevere supporto tempestivo per gli acquisti effettuati tramite il sistema di pagamento esterno.

Configurare e abilitare l’autorizzazione in Xcode

Dopo aver ricevuto per email la conferma che l’autorizzazione è stata assegnata al tuo account e dopo aver configurato l’App ID in Certificates, Identifiers & Profiles (Certificati, identificatori e profili) per supportare tale autorizzazione, dovrai aggiornare il progetto Xcode, il file plist entitlements e il file Info.plist per riportare l’autorizzazione e i metadati.

Il profilo di autorizzazione è compatibile e può essere utilizzato solo con le applicazioni distribuite tramite l’App Store degli Stati Uniti, su dispositivi con iOS o iPadOS 15.4 o versioni successive.

Screenshot dell’abilitazione dell’autorizzazione in XcodeScreenshot dell’abilitazione dell’autorizzazione in Xcode
  1. Nello strumento di selezione dei progetti, seleziona il file .entitlements. In Xcode 14 o versioni successive, il nome del file è preceduto dall’icona sigillo con segno di spunta giallo.
  2. Nel file plist entitlements, aggiungi una nuova coppia di chiavi per l’autorizzazione tenendo il puntatore sulla riga Entitlements File (File autorizzazioni) e facendo clic sul pulsante Aggiungi (+).
  3. Inserisci i valori seguenti per l’autorizzazione:
    1. Key (Chiave): com.apple.developer.storekit.external-purchase-link
    2. Type (Tipo): Boolean (Booleano)
    3. Value (Valore): True (Vero)
  4. Inserisci i metadati richiesti nel file Info.plist, come descritto in Aggiornare il file Info.plist.

Nella build successiva sul tuo dispositivo o nella richiesta di distribuzione in Xcode Organizer, Xcode rileverà che il file .entitlements e il profilo di provisioning nella cache non corrispondono, quindi richiederà un nuovo profilo di provisioning in base all’ultima configurazione dell’App ID per completare il processo di firma del codice.

Aggiornare il file Info.plist

Ogni autorizzazione ha requisiti univoci per i dati da inserire nel file Info.plist dell’app. Per i dettagli sulla gestione del file Info.plist, consulta la documentazione.

StoreKit External Purchase Link

  1. Seleziona il file Info.plist dallo strumento di selezione dei progetti nella destinazione iOS.
  2. Inserisci i valori seguenti per questa autorizzazione:
    1. Key (Chiave): SKExternalPurchaseLink
    2. Type (Tipo): dizionario con valori di tipo stringa
      1. Key (Chiave): un singolo codice ISO 3166-1 alpha-2 degli Stati Uniti, us
      2. Value (Valore): un singolo URL di destinazione

L’URL di destinazione (ossia il link del tuo sito web) indicato nel file Info.plist in Xcode deve sempre corrispondere al valore indicato nel file binario dell’app che hai inviato al team addetto alla revisione delle app. Assicurati che ogni valore sia una stringa che:

  • utilizza lo schema https;
  • forma un URL assoluto valido;
  • non contiene parametri di query; e
  • contiene al massimo 1000 caratteri ASCII.

Conoscere i requisiti relativi alle app e ai link

Oltre a utilizzare l’autorizzazione StoreKit External Purchase Link (USA) e le API StoreKit necessarie, dovrai osservare i requisiti di utilizzo stabiliti per contribuire a proteggere la privacy e la sicurezza delle persone, prevenire attività fraudolente e truffe e mantenere la qualità complessiva dell’esperienza utente.

La tua app deve offrire acquisti in-app in conformità al contratto di licenza dell’Apple Developer Program e alle linee guida per la revisione per l’App Store e non può scoraggiare l’esecuzione di acquisti in-app da parte degli utenti finali.

Prima di ogni istanza di collegamento dall’app StoreKit External Purchase Link (USA) a un sito web esterno per gli acquisti, devi:

  • chiamare l’API canMakePayments e stabilire che l’utente può autorizzare i pagamenti; e
  • chiamare l’API StoreKit External Purchase Link e stabilire che si tratta di un utente dell’App Store degli Stati Uniti; in tal caso, presentare l’informativa di sistema associata.

Il link fornito nella tua app:

  • deve rimandare direttamente al tuo sito web senza link di reindirizzamento, link intermedi o landing page;
  • deve aprire una nuova finestra nel browser predefinito sul dispositivo e non una visualizzazione web;
  • non deve passare parametri aggiuntivi nell’URL al fine di tutelare l’utente (ad esempio, la sua privacy);
  • deve essere definito staticamente nel valore <<SKExternalPurchaseLink>> del file Info.plist dell’app prima dell’invio all’App Store;
  • deve essere inviato all’App Store insieme all’app e l’invio deve essere ripetuto in caso di modifiche all’URL;
  • rispettare i requisiti per la progettazione e la lingua (vedi sotto);
  • non deve imitare il sistema di acquisti in-app di Apple né scoraggiarne l’uso da parte degli utenti;
  • deve essere visualizzato non più di una volta nell’app, su non più di una pagina dell’app tra quelle visitate dall’utente (non una pagina interstiziale, modale o a comparsa), in un’unica posizione specifica su tale pagina, senza persistere oltre tale pagina; e
  • non può essere visualizzato su alcuna pagina inclusa in un flusso in-app per commercializzare o avviare un acquisto utilizzando acquisti in-app.

Non puoi includere informazioni sull’acquisto sul tuo sito web né un link al tuo sito web per l’acquisto sulla pagina prodotto della tua app sull’App Store.

I beni e i servizi digitali venduti sul tuo sito web tramite link esterni che sono commercializzati come destinati all’uso in un’app devono essere disponibili per l’uso in tale app.

Se la tua app è coinvolta in pratiche di mercato fuorvianti, ad esempio attività ingannevoli, truffe o attività fraudolente, sarà rimossa dall’App Store e il tuo account potrebbe essere eliminato dall’Apple Developer Program.

Linee guida per la progettazione e la lingua

Schermata di accesso

Schermata dell’account

Pagina dell’app

Modelli

Usa i modelli che meglio si adattano al tuo caso d’uso. A parte il prezzo, la percentuale di sconto e l’URL del tuo sito web, la lingua utilizzata nella tua app deve corrispondere alla lingua del modello. Non modificare o utilizzare il modello in modo fuorviante per la clientela.

Modello di acquisto:

Acquista dal sito web su www.example.com Icona di link esternoIcona di link esterno

Modello di offerta speciale:

Per le offerte speciali, vai su www.example.com Icona di link esternoIcona di link esterno

Per un’offerta speciale, vai su www.example.com Icona di link esternoIcona di link esterno

Modello di prezzo più basso:

Prezzi più bassi offerti su www.example.com Icona di link esternoIcona di link esterno

Prezzo più basso offerto su www.example.com Icona di link esternoIcona di link esterno

Modello di percentuale di sconto:

Per ottenere uno sconto del XX%, vai su www.example.com Icona di link esternoIcona di link esterno

Modello di prezzo specifico:

Compra al prezzo di $ X,XX su www.example.com Icona di link esternoIcona di link esterno

Stile e icona

Il tuo link deve rispettare lo stile pulsante semplice, come specificato nel documento Human Interface Guidelines. Non può essere racchiuso in una forma che usa un riempimento di sfondo a contrasto. Lo sfondo che circonda il testo deve corrispondere allo sfondo della pagina dell’app. L’icona di link esterno fornita da Apple deve essere visualizzata immediatamente a destra dell’URL del tuo sito web. Le dimensioni dell’icona devono corrispondere visivamente alle dimensioni del testo.

www.example.com Icona di link esternoIcona di link esterno

Scheda dell’informativa di sistema in-app

Ogni volta che la tua app chiama l’API StoreKit External Purchase Link, viene visualizzata la scheda dell’informativa di sistema presentata dal sistema stesso (iOS 15.4 e/o iPadOS 15.4 o versioni successive). La scheda spiega all’utente che lascerà l’app e passerà a un sito web esterno per effettuare un acquisto tramite un'entità non appartenente a Apple. Quando l’utente tocca il pulsante Continue (Continua), verrà indirizzato o indirizzata al tuo sito web all’interno di un browser web.

Inviare l’app per la revisione in App Store Connect

Quando invii il nuovo file binario dell’app per la revisione in App Store Connect, assicurati di rispettare i requisiti di invio riportati sotto, nonché i termini e le condizioni dell’autorizzazione, le linee guida per la revisione per l’App Store e il contratto di licenza dell’Apple Developer Program.

  • La tua app e la scheda dell’informativa in-app per il flusso di pagamento esterno devono essere implementati e testati correttamente.
  • Assicurati che il link venga visualizzato solo nell’App Store degli Stati Uniti.
  • Il sito web a cui la tua app si collega per gli acquisti e il supporto deve essere perfettamente funzionante.
  • Con l’invio devono essere inclusi gli screenshot dell’interfaccia utente della tua app che mostrano dove viene visualizzato il link.
  • Indica il nome del tuo fornitore di servizi di pagamento (PSP) nelle note per la revisione. Assicurati che il PSP sia pronto a completare le transazioni generate dalla tua app. Il PSP deve:
    • soddisfare i requisiti di conformità PCI (Payment Card Industry) di livello 1 per la gestione dei dati delle carte di credito e debito;
    • mettere a disposizione degli utenti un processo di assistenza clienti, incluso un processo per contestare eventuali transazioni non autorizzate, gestire gli abbonamenti (se applicabile) e richiedere i rimborsi; e
    • specificare tutti i prezzi per la vendita di beni e servizi digitali in dollari statunitensi.

L’app TestFlight può essere utilizzata per il beta testing del profilo di autorizzazione StoreKit External Purchase Link (USA), a condizione che tutte le transazioni sostenute in tale test vengano fornite gratuitamente ai tester.

Un invio incompleto potrebbe causare ritardi nei tempi di revisione dell’app o il rifiuto dell’app. Al termine della verifica dell’app, lo stato in App Store Connect verrà aggiornato e riceverai una notifica.

Commissioni, report sulle transazioni e pagamenti

Tutti gli sviluppatori e le sviluppatrici che operano nell’App Store (anche quelli e quelle che inseriscono pulsanti o link con inviti all’azione nelle loro app) usufruiscono di tecnologie e strumenti proprietari di Apple protetti da proprietà intellettuale, oltre che dell’accesso alla relativa base di utenti. Questo comprende gli investimenti di Apple in strumenti di sviluppo, SDK, API e aggiornamenti alla piattaforma stessa. Apple fornisce inoltre un’esperienza sicura e affidabile sulla propria piattaforma, in cui utenti, sviluppatori e sviluppatrici effettuano liberamente transazioni.

Apple addebita una commissione sugli acquisti digitali effettuati entro sette giorni dal clic sul link esterno, come descritto di seguito. Questo strumento, anche se non include tutte le transazioni che Apple ha facilitato tramite l’App Store, permette di rappresentare in modo soddisfacente il valore sostanziale che Apple offre a sviluppatori e sviluppatrici (incluse le transazioni facilitate tramite link).

La commissione di Apple ammonta al 27% dei ricavi che ottieni grazie alle vendite (“transazioni”) di beni o servizi digitali realizzate sul tuo sito web dopo un clic su link esterno (ossia dopo che l’utente ha fatto tap su “Continue” [Continua] nella scheda dell’informativa di sistema), a condizione che la vendita sia stata avviata entro sette giorni e che i beni o servizi digitali possano essere utilizzati in un’app. Ciò include (a) le imposte applicabili e (b) gli adeguamenti per rimborsi, storni e riaccrediti. Per quanto riguarda gli abbonamenti con rinnovo automatico: (i) una vendita avviata (anche con un’offerta o una demo gratuita) entro sette giorni dal clic sul link esterno è considerata una transazione; e (ii) anche ogni successivo rinnovo automatico dopo l’avvio dell’abbonamento è considerato una transazione.

Se partecipi allo Small Business Program, oppure se la transazione è un rinnovo automatico durante il secondo anno o un anno successivo di un abbonamento con rinnovo automatico, la commissione sarà del 12%.

Queste commissioni vengono applicate a tutti gli importi pagati da ogni utente al netto delle imposte sulle transazioni che addebiti. Sarai responsabile della riscossione e della corresponsione di qualsiasi imposta applicabile per le vendite elaborate da un fornitore di servizi di pagamento esterno.

Se decidi di adottare questa autorizzazione, ti verrà richiesto di fornire report sulle transazioni entro 15 giorni civili dopo la fine di ogni mese solare. Anche se non ci sono state transazioni, hai l’obbligo di fornire un report che documenti tale situazione. Se la frequenza richiesta dovesse variare, aggiorneremo questa pagina. Per maggiori dettagli sulle informazioni da includere nel report, visualizza degli esempi di report. In futuro, qualora Apple sviluppasse un’API per facilitare la creazione di report, ti verrà richiesto di adottare tale API entro 30 giorni con un aggiornamento della tua app e di rispettare le tempistiche e i requisiti indicati.

Se è dovuto un pagamento a Apple, riceverai una fattura basata sui report e ti verrà richiesto di effettuare il pagamento a Apple per l’importo fatturato entro 30 giorni dall’emissione della fattura. In caso di ritardo, ai pagamenti sarà applicato un’interesse a un tasso dell’uno percento (1%) al mese o al tasso più alto consentito dalla legge, a seconda di quale sia il valore minore.

Apple ha il diritto di esigere la revisione contabile in base ai termini dell’autorizzazione. Ciò consentirà a Apple di esaminare l’accuratezza del tuo registro delle transazioni digitali, verificando che sia stata versata una commissione adeguata a Apple. I pagamenti in ritardo maturano interessi. La mancata corresponsione della commissione di Apple potrebbe comportare la sottrazione dei ricavi degli acquisti in-app che ti spettano oppure altre conseguenze come l’eliminazione dell’app dall’App Store o la rimozione dall’Apple Developer Program.

Assistenza clienti

Se usi questa autorizzazione, è tua responsabilità fornire assistenza tempestiva alla clientela in caso di domande o problemi correlati ai pagamenti effettuati al di fuori dell’App Store. Apple non sarà in grado di assistere la clientela in relazione a rimborsi, cronologia dei pagamenti, gestione degli abbonamenti e altri problemi insorti durante l’acquisto di beni e servizi digitali. Sarai responsabile della risoluzione di questi problemi con la clientela.