Skip to main content

Partner attributes

Including rich, granular data in your SDK integration allows for enhanced targeting and better personalization capabilities—leading to more revenue and better customer experience. You should define these attributes as part of your Web, iOS, Android, or React Native integrations.

You can find the full list of predefined Rokt attributes in the sections below. You can also define any custom attributes to complement the standard integration.

Core attributes#

DescriptionAttribute nameFormatExpected valuesPayload example
Emailemailstringemail addressjohn.smith@rokt.com
Email (SHA-256)emailsha256stringSHA-256 hash string (lowercase raw email before hashing)F6191D8D6A0F75CA7D237ED07C
Amountamountdecimal300.5
Currencycurrencystring3-letter ISO currency codeUSD
Quantityquantityinteger2
Payment typepaymenttypestringVISA, AMEX, MC, Paypal, Credit Card, Klarna, Sofortüberweisung, Apple Pay, Android Pay, Amazon, Internal Credit, Gift Card, Voucher, Cash, Bank Transfer, Cheque, On Hold, Later, Diners Club, FamilyMart, Seven-Eleven, LAWSON, Other Convenience Store, Yahoo! Wallet, Pay-easy, Cash on delivery, Postpaid, Carrier settlement, Bank transfer, Mobile carrier payment, Rakuten, bitcoin, afterpay, Discover, Google Pay, Debit Card, Stripe, MINISTOP, DOCOMO Payment, Softbank, VenmoCredit Card
Credit card BINccbinstring6 digit string372888
Marginmargindecimal10.5
Confirmation referenceconfirmationrefstringXYZ123
First namefirstnamestringJohn
Last namelastnamestringSmith
Mobilemobilestringmobile format without country code7327572923
Mobile (SHA256)mobilesha256stringSHA-256 hash string (format number in E.164 format)cb6880e416769253645cb9c6b8989154bf66a56a77fc14c81fb1019663cbb928
TitletitlestringMr, Mrs, Ms, MissMs
GendergenderstringM, FF
Date of birthdobstringdate in format yyyymmdd19831215
Ageageinteger33
Languagelanguagestring2-letter ISO language code (examples here)EN
ExperienceexperiencestringPurchase
Unit numberunitnostring101
Address line 1address1string123 Fake Street
Address line 2address2stringBuilding A
ZIP or postal codezipcodestringFormat examples here10014
CitycitystringNew York
StatestatestringNY
Countrycountry2-letter ISO country code (examples here)US
Conversion typeconversiontypestringticketpurchase

Transactional/purchase data#

DescriptionAttribute nameTypePayload example
Major categorymajorcatstringElectronics
Major category IDmajorcatidstring10011
Minor categoryminorcatstringCameras
Minor category IDminorcatidstring10
Customer typecustomertypeguest / memberguest
Product name(s)productnamestringHX99 Compact Camera with 24-720mm zoom
Stock keeping unit (SKU)skustringDSC-HX99
Shipping typeshippingtypestringPriority Express

Food and beverage retail data#

NameAttributeFormatExpected valuesPayload example
Restaurant IDrestaurantidstring123xyz
DeliverydeliverybooleanYes, NoYes
Restaurant namerestaurantnamestringRokt Cafe
Delivery/pick-up addressdeliveryaddressstring175 Varick St, FL 10, 10014
CuisinecuisinestringJapanese
Delivery/pick-up timedeliverytimestring24 hour format1930
Delivery/pick-up datedeliverydatestringyyyymmdd20200822
Restaurant ZIP/postal coderestaurantzipcodestringFormat examples here10014

Event ticketing data#

NameAttributeFormatPayload example
Event nameeventnamestringJohn Smith featuring the Smiths: Live
Event descriptioneventdescriptionstringThe most incredible show on earth.
Event timeeventtime24 hour format0800
Event IDeventidstringE017448281A
Event dateeventdateyyyymmdd20200822
Event venueeventvenuestringAustin Big Stadium
Event cityeventcitystringNew York
Event stateeventstatestateNY
Event ZIP or postal codeeventzipcodezipcodeFormat examples here
Event countryeventcountrycountryExamples here
Event image URLeventimageurlhttps://www.rokt.com
Event URLeventurlurlhttps://www.rokt.com
Ticket URLticketurlurlhttps://www.rokt.com
Number of ticketsnoticketsnumber4
Seat location(s)seatlocationstringsection 2, row 10
Seat numberseatnumbernumber10B
Primary artist IDprimaryartistidstring1234abc
Primary artist nameprimaryartistnamestringJohn Mayer
Secondary artist IDsecondaryartistidstring1234xyz
Secondary artist namesecondaryartistnamestringAdele
PromoterpromoterstringPrudential
Promoter IDpromoteridstring1234xyz
Venue IDvenueidstring1234xyz
Venue map URLvenuemapurlhttps://goo.gl/maps/wJqryRvmvA82o3nC9

Media and entertainment#

NameAttributeFormatPayload example
SectionsectionstringTop row
Section IDsectionidstring1
Subsectionsubsectionstringleft of top row
Subsection IDsubsectionidstring12
Author nameauthorstringErin Meyer
Author IDauthoridstring123xyz
Subscribersubscriberstring
Subscription programsubscriptionstring

Travel data#

NameAttributeFormatPayload example
Number of passengerspaxnumber2
Travel classtravelclassstringBusiness
Trip typetriptypestringBusiness
RouteroutestringSingle
Loyalty programloyaltyprogramstringStar Alliance
Loyalty program IDloyaltyprogramidstring123-xyz-456
Loyalty tierloyaltytierstring1
CarriercarrierstringNippon Airways
Booked hotelbookedhotelbooleanYes
Purchased insurancepurchasedinsurancebooleanNo
Booked carcarbookedbooleanYes
Excess baggageexcessbaggagebooleanNo
Destination airportdestairportCode (IATA)Examples found here
Destination citydestcitystringNew York
Departure airportdepartairportCode (IATA)Examples found here
Departure citydepartcitystringSydney
Travel timetraveltime24 hour format1930
Travel datetraveldateyyyymmdd20200408
Departure airport ZIP or postal codedepartairportzipcodezipcodeExamples found here
Check-in URLcheckinurlurlhttps://www.rokt.com
Ticket URLticketurlurlhttps://www.rokt.com
Passenger namepassengernamenameJohn Doe
Was this article helpful?