QuickStart

pdf

School

University of California, Los Angeles *

*We aren’t endorsed by this school

Course

10A

Subject

Information Systems

Date

Oct 30, 2023

Type

pdf

Pages

Uploaded by archietush22

Ticketmaster SDK Quick Start Guide 1. Add Frameworks to your Project folder 1. Create a new sub folder somewhere in your project folder to hold these additional frameworks. 1. We’ve named the folder “AdditionalFrameworks” here, but the name can be anything that makes sense to you. 2. Copy the required Ticketmaster frameworks into this new folder 1. Required for both Presence SDK and Purchase SDK: 1. TicketmasterFoundation 2. TicketmasterSecureEntry 3. PresenceSDK 2. If using Purchase SDK, also add: 1. TicketmasterDiscoveryAPI 2. TicketmasterPurchase 3. Example: WG O EIEET EGIOES > 07 PresenceSDK.xcframework > I TicketmasterDiscoveryAPl.xcframework > 07 TicketmasterFoundation.xcframework > [ TicketmasterPurchase.xcframework > T TicketmasterSecureEntry.xcframework s+ AppDelegate.swift > [ Assets.xcassets > [ Base.lproj ¢ Info.plist = SceneDelegate.swift s ViewController.swift

2. Add Frameworks to your Project file Select the General Tab B = r eve (] m X T QA O g P B v &2 QuickSDKIntegration v @ QuickSDKIntegration 3 AppDelegate.swift 3 SceneDelegate.swift 3 ViewController.swift ~. Main.storyboard (G Assets.xcassets ». LaunchScreen.storyboard EH Info.plist v @ QuickSDKIntegrationTests 3 QuickSDKIntegrationTes... In Xcode, select your Project Select your deployment Target B A A A A M A A v @ QuickSDKIntegrationUlITests 3 QuickSDKIntegrationUIT... 3 QuickSDKIntegrationUIT... > > D I,J (0 Click the + button under Frameworks, Libraries, and Embedded Content g:sl::p':sm(lnte"' ) f An..64) QuickSDKIntegration: Ready | Today at 11:00 AM + 1 B QuickSDKIntegration. xcodeproj g ¥ QuickSDKIntegrati g & Capabilities Resource Tags Info Build Settings Build Phases Build Rules General PROJECT QuickSDKIntegrati... 2 TARGETS QuickSDKIntegrati. Add intents eligible for in-app handling here Frameworks, Libraries, and Embedded Content &% QuickSDKIntegrati... ®O0 QuickSDKIntegrati... Name Embed 4 Add frameworks, libraries, and embedded content here Development Assets Add development assets here (B

5. On the Choose Frameworks popup that appears, click the Add Other... drop-down 6. Choose Add Files... option @ 1 » QuickSDKIinte... = = o : S| Todsual 2 Choose frameworks and libraries to add: . QuickSDKIntegration ‘ Q| ) QuickSDKIntegration Id Settings AppDelegate.swift v QuickSDKIntegration Project SceneDelegate.swift & QuickSDKIntegrationTests.xctest ig ViewController.swift 80 QuickSDKIntegrationUITests.xctest o' . Main.storyboard v ¥&i0815.2 Assets xcassets &= Accelerate.framework e ed Content - g LaunchScreen.storyboard e/ censEnity Tamework &= Accounts.framework [F ACIPCBTLib.tbd Info.plist QuickSDKIntegrationTests QuickSDKIntegrationTes... i sddiRsaRROk IEEnGWOlK s, QuickSDKIntegrationUITests . ActrsaaRookllifmesor QuickSDKIntegrationUIT... QuickSDKIntegrationUIT... & AdSupport.framework 5 &= AppClip.framework & AdServices.framework [F] AppleConverg &= AppTrac PN Add Other... @ o Add Package Dependency... Build Phases Embed Build Rules

Your preview ends here

Eager to read complete document? Join bartleby learn and gain access to the full version

Access to all documents
Unlimited textbook solutions
24/7 expert homework help

7. Find and select the sub folder where you copied the frameworks earlier 8. Select all the .xcframework folders inside 9. Click Open Choose frameworks and libraries to add: [ AdditionalFrameworks Kintegration > T AdditionalFrameworks M PresenceSDK.xcframework Kinte...tion.xcodeproj s AppDelegate.swift i : KintegrationTests > T Assets.xcassets KintegrationU|Tests > T Base.lproj = Info.plist +» SceneDelegate.swift > ViewControlIer.swi*’8

At this point, all of the required xcframework files should be added to your project. Please make sure that both: 10. Frameworks appear in the Framework list as “Embed & Sign” 11. Frameworks appear in the Project Navigator list @ e [ = P ?llllllctl‘(SDKlnte... Y 77 Any..m64) QuickSDKIntegration: Ready | Today at 11:11 AM + (B @ BN T Q A © & O 3 &8 | < &8 QuickSDKIntegration.xcodeproj e @ g 2 [%¥ QuickSDKIntegration v B3 QuickSDKIntegration M @ 9 v @& QuickSDKIntegration o General Signing & Capabilities Resource Tags Info Build Settings Build Phases Build Rules 3 AppDelegate.swift A PROJECT 3 SceneDelegate.swift A Class Name Authentication i . QuickSDKIntegrati.. 3 ViewController.swift A Main.storyboard A TARGETS Add intents eligible for in-app handling here (EJ Assets.xcassets M i ickSDKIntegrati... LaunchScreen.storyboard A 1 0 ickSDKIntegrati.. E2 Info.plist A 20 Quic v @ QuickSDKIntegrationTests Frameworks, Libraries, and Embedded Content 3 QuickSDKIntegrationTests.swift A v @@= QuickSDKIntegrationUlITests 3 QuickSDKIntegrationU|Tests.swift 1 1 . ' == TicketmasterDiscoveryAPl.xcframework Embed & Sign £ 3 QuickSDKIntegrationUITe nch.. A 5 g & TicketmasterFoundation.xcframework Embed & Sign £ > & Products . . £ == TicketmasterPurchase.xcframework Embed & Sign $ v @m Frameworks & TicketmasterSecureEntry.xcframework Embed & Sign £ Name Embed & PresenceSDK.xcframework Embed & Sign & &= PresenceSDK.xcframework == TicketmasterDiscoveryAPl.xcframework % &= TicketmasterFoundation.xcframework R e D == TicketmasterPurchase.xcframework &= TicketmasterSecureEntry.xcframework @ 08 w =3 If you have additional deployment Targets, you will need to add these frameworks to each of those Targets as well by repeating steps 1 through 4. The new frameworks will now appear on the list, so you won’t need to repeat steps 5 to 11.

3. Import and Configure SDKs Now that you have added the frameworks to your Project folder and Project file, it is time to configure the SDKs. It can be done at the launch of the app (in the AppDelegate or SceneDelegate) or it can be done later after your App is setup, but before you actually present the SDK’s UL. Import module for PresenceSDK Import module for TicketmasterPurchase (if you are using the Purchase SDK) Enter your API Key 1. provided by the Ticketmaster Client Support Team or created at https://developer-acct.ticketmaster.com/user/register Determine .US or .UK Host: 1. UK, Ireland, and SportXR clients should use .UK 2. Everyone else should use .US 5. Set your App/Team/Venue name 6. Set configuration on Presence SDK 7. Set configuration on Purchase SDK (if you are using the Purchase SDK) > wh= import UIKit // 1. import Presence module import PresenceSDK // 2. import Purchase module (if needed) import TicketmasterPurchase class ViewController: UIViewController { override func viewDidLoad() { super.viewDidLoad() // 3. set your Ticketmaster API Key let apiKey = "12345" // from: https://developer-acct.ticketmaster.com/user/register // build configuration let presenceConfig = PSDK.Configuration(consumerKey: apiKey, hostEnvironment: .US, // 4. select US or UK displayName: "Local All-Stars") // 5. App/Team/Venue Name // 6. configure Presence SDK PSDK.shared.setConfiguration(presenceConfig) // 7. configure Purchase SDK (if needed) TMPurchase.shared.apiKey = apiKey

Your preview ends here

Eager to read complete document? Join bartleby learn and gain access to the full version

Access to all documents
Unlimited textbook solutions
24/7 expert homework help

4. Present the Presence SDK Now that the SDKs are configured, it’s time to present the SDK UlI. The Presence SDK is used to show Purchased Events (including Orders for those Events, Tickets, and Barcodes). 1. Create a PresenceViewController 2. Present PresenceViewController @IBAction func presentPresenceSDK(_ sender: Any) { // 1. build Presence ViewController let presenceVC = PresenceViewController() // 2. present Presence SDK present(presenceVC, animated: true, completion: nil)

5. Present the Purchase SDK Now that the SDKs are configured, it’s time to present the SDK UlI. The Purchase SDK is used to show new Events to be purchased (including Smart Queue, Special Offers, Delivery Options, and the user’s Payment Wallet). 1. Determine which Event ID to purchase. 1. This ID can be hard-coded, or fetched from the Discovery API 2. This works for both classic Host IDs (“07005CA5DEBD61A6”) and Discovery IDs (“vvG1jZ919rRpkd”) Create a TMPurchaseWebsiteConfiguration (aka Club Site Configuration) Create a TMPurchaseNavigationController Connect Purchase SDK to Presence SDK (for login purposes) Present TMPurchaseNavigationController o kN @IBAction func presentPurchaseSDK(_ sender: Any) { // 1. determine Event ID // The Smashing Pumpkins, Fiserv Forum (Oct 30, 2022): let eventID = "©7005CASDEBD61A6" // or "vvGljZ919rRpkJ" // 2. configure Purchase SDK for this particular Event let clubSiteConfig = TMPurchaseWebsiteConfiguration(eventID: eventID) // 3. build Purchase ViewController let purchaseVC = TMPurchaseNavigationController(configuration: clubSiteConfig) // 4. connect Presence SDK login to Purchase SDK purchaseVC.oauthDelegate = PSDK.shared.oauthProvider // 5. present Purchase SDK present(purchaseVC, animated: true, completion: nil) Step 4 is very important, as it connects the Presence SDK’s Login Ul/State to the Purchase SDK. 4 4 \ | Y = g : 3 — - Ky\u_liliillinghgi ’ 2 Tickets v ‘ l == Filters @ VIP Packages 0.00-5645 00 More Info [Sec 208, Row 9 $44.00/ea Standard Admission Sec 208, Row 10 $44.00/e0 Standard Admission Sec 208, Row 11 $44.00/e0 Standard Admission Sec 208, Row 12 $44.00/cq Standard Admission

6. User Logout The Purchase SDK and Presence SDK will prompt the user to login when needed. However, you may want to allow the user to logout as well (usually to switch accounts). 1. Call PSDK.shared.logout() @IBAction func logoutUser(_ sender: Any) { // 1. log user out of Presence SDK (includes Purchase SDK) PSDK.shared.logOut { hostSuccess, hostError, teamSuccess, teamError, sportXRSuccess, sportXRError in if hostSuccess &&% teamSuccess && sportXRSuccess { // logout worked! } else { // OAuth 2.8 error // user is still logged in OAuth 2.0 protocol requires a logout operation to complete, logging the user out of his account across all applications and websites. This function can safely be called multiple times as needed, even if the user is not logged in.

Your preview ends here

Eager to read complete document? Join bartleby learn and gain access to the full version

Access to all documents
Unlimited textbook solutions
24/7 expert homework help

7. Next Steps This Quick Start guide has provided you with the bare minimum steps to integrate the Ticketmaster Purchase and Presence SDKs. However, there is more optional parts to learn: 1. Additional Purchase and Presence configuration options allowing you to customize the user experience inside these SDKs. 2. Delegate callbacks and Notifications to inform your App when the user performs interesting actions, like purchasing Tickets, or viewing Orders. These options are documented in: 1. the public source-code interfaces 2. The source code of the Purchase Sample App & the Presence Demo App 1. available at: https://developer.ticketmaster.com/products-and-docs/sdks/presence-sdk/ 3. full documentation: 1. available at: https://developer.ticketmaster.com/products-and-docs/sdks/presence-sdk/