Site index

Amperity Bridge

About Amperity BridgeSync with Databricks

How-tos

Add inbound bridgeAdd outbound bridgeAdd bridge to scheduled workflowDelete a bridgeDownload credentialsRename a bridgeSync a bridgeUpload credentials

Campaigns

About campaignsAbout the Campaigns page

Campaign features

AttributesAudiencesControl groupsDestinationsExclusion listsTreatment groupsSub-audiencesTiming and launch dates

Campaign types

One-time campaignsRecurring campaignsMultichannel campaigns

How-tos

Add a sub-audienceApply exclusion listArchive campaignBuild audienceChoose campaign typeConfigure a multichannel campaignConfigure a one-time campaignConfigure a recurring campaignCopy campaign IDDelete campaignDiscard campaignDuplicate campaignEdit attributeEdit campaignEdit sub-audienceEnable Campaign Recipients tableRemove sub-audienceSchedule campaignSelect destinationsSend campaign metadata to destinationSet campaign launch dateSet delivery scheduleSearch campaignsView campaignView campaign historyView delivery summaryView notificationsView workflow

Courier groups

Courier groupsAdd a courier groupCourier group settingsActivate courier groupCourier group alertsRun typesSchedulesTime zonesBridge syncsCouriersCourier alertsNumber of daysWait timesReview activations

How-tos

Activate courier groupAdd bridge to workflowAdd courier to workflowAdd a courier groupAdd data export to courier groupAdd orchestration to courier groupAdd orchestration group to courier groupAdd Profile API endpoint to courier groupAdd query to workflowAdd recurring campaign to workflowCopy courier groupDeactivate workflowDefine scheduleDelete courier groupEdit courier groupNotify when courier group runs slowlyPull files for previous 24 hours?Remove bridge from courier groupRemove courier from courier groupRun courier groupsWait for missing files

Couriers

About couriers

File couriers

About file couriersLoad settingsFile patternsWildcardsWildcards within archivesLiteral stringsDate componentsFile compression / archiveInput examplesfor single filesfor multiple files

API couriers

About API couriers

Snowflake couriers

About Snowflake couriersTable listsStage namesLoad operations

Load operation types

EmptyIncorrect feed IDLoad filesLoad ingest queryTruncate, then load

Examples

Apache AvroApache ParquetCampaign MonitorCBORCSVJSONNDJSONPSVSalesforce Commerce CloudSalesforce Sales CloudSnowflakeTSVXML

How-tos

Add courierAdd courier as copyAdd to courier groupDelete courierEdit courierLoad data onlyRun and only load filesRun for a specific dayRun for a time periodRun, but skip missing filesRestart jobView courier

Dashboards

AmpsUsage

Data exports

About data exports

How-tos

Add data exportAdd table exportAdd to orchestrationDelete data exportDiscard data exportSwitch databaseRemove tableView data exports

Data tables

About data tablesAbout the data model

The core data model for Amperity.

Note

Click this diagram to open it in your full browser window. Click HERE to open this diagram in a new tab or right-click that link to save a copy to your computer.

Data tables

Campaign RecipientsCustomer 360Customer AttributesDetailed ExamplesEmail Engagement AttributesEmail Engagement SummaryMerged CustomersPredicted AffinityPredicted CLV AttributesStitch Blocking KeysStitch ScoresTransaction AttributesTransaction Attributes ExtendedUnified Changes ClustersUnified Changes PKSUnified CoalescedUnified CustomerUnified Email EventsUnified Itemized TransactionsUnified Preprocessed RawUnified Product CatalogUnified ScoresUnified Transactions

Data templates

About data templatesFile templates

Common settings

.DONE filesEncoding methodsEscape charactersFile formatsFilename templatesHeader rowsLine endingsQuote modes

Specific settings

Amazon S3Azure Blob StorageGoogle Cloud StorageSFTPAPI templatesSnowflake templates

How-tos

Add data templateAllow to send queriesAllow to send PIIDelete data templateEdit data templateEnable success fileMap to external schemasMake available to campaigns

Databases

Core tables

About core tablesStandard core tablesCustom core tables

Core table how-tos Add custom core tableDelete custom core tableEdit custom core tableSearch core tablesView core tablesView SQL for core table

Databases

About databasesFlexible merge rulesCustomer 360 databaseEmpty databaseMultiple customer 360 databasesPassthrough databaseStitch QA databaseCustom SQLPassthroughVisual templates

Database how-tos Activate databaseAdd customer 360 databaseAdd empty databaseAdd passthrough databaseAdd Stitch QA databaseConfigure permissionsDelete databaseDownload schemaDuplicate databaseEdit databaseExplore databaseExport databaseRun databaseView all databasesView databaseView permissionsView recent activityView run history

Database table how-tos Add core table overrideAdd custom SQL tableAdd passthrough tableAdd visual template tableAllow table in segmentsApply table semantic tagsCopy database tableDelete database tableDiscard draft tableEdit database tableEnable table versioningEnforce static table schemasExport database tableHide database tableMark columns as PIIConfigure pick-listsSet validation rules

Profiles

Customer profilesAbout profile attributesRefresh customer profile icons

Domain tables

About domain tablesColumn typesCustomer recordsInteraction recordsCustom domain tablesDomain SQL

Domain SQL examples

Combine day, month, year as birthdateCombine five- and four-digit postal codesExtract first and last namesHash PII data that has been resent to AmperityParse fields with multiple separatorsSet non-US-ASCII email addresses to NULLStandardize values for USA states

How-tos

Add domain tableAdd custom domain tableDelete domain tableDelete recordsEdit domain tableExplore domain tableView sample dataView schemaPurge domain tableRename domain tableSearch domain tablesView domain tableView domain table history

Feeds

About feedsFeed EditorApply semantic tags

Field types

BooleanDateDatetimeDecimalFloatIntegerString

How-tos

Activate feedAdd columnAdd feeds from new sourcesAdd feeds from existing sourcesAdd fieldAdd foreign keyApply custom semantic tagsApply customer profile (PII) semantic tagsApply transaction semantic tagsEdit primary keyDelete columnsDelete fieldsEdit domain table nameGenerate combined keysGenerate customer keysGenerate foreign keysIncoming field namesLoad new dataMake available to StitchRename fieldsReplace data sourceResolve name conflictsSet error thresholdsSet last updated fieldSet error thresholdsTruncate feedView sample data

File formats

About file formatsApache AvroApache ParquetCBORCSVDATJSONNDJSONPSVStreaming JSONTSVXML

Ingest queries

About ingest queriesSpark SQL

Example courier load operations

Apache AvroApache ParquetCBORCSVJSONNDJSONPSVStreaming JSONTSVXML

Example ingest queries

Build birthdateConcatenate columnsExplode transactionsFind recordsFlatten with identifiersImport billing as addressJOIN datasetsParse nested recordsRemove fieldSelect all fields

How-tos

Add ingest queryAdd to courier as load operationDelete ingest queryEdit ingest query

Orchestration groups

About orchestration groupsRun after courier groupRun on a scheduleRun manually

Orchestrations

About orchestrations

How-tos

Add orchestrationAssign database exportAssign queryDelete orchestrationEdit orchestrationManuallyScheduled, always runScheduled, wait for changesWait for changes

Policies

About policiesHow policies work

Standard policies

Amp360 UserAmpIQ UserDataGrid AdministratorDataGrid Operator

Policy options

Allow API key administrationAllow Profile API administrationAllow sandbox administrationAllow source data deletionAllow user administrationRestrict data exportsRestrict download accessRestrict PII accessRestrict upload access

Read-only policies

Amp360 UserAmpIQ UserDataGrid Operator

Allowed actions

SourcesStitchCustomer 360QueriesSegmentsCampaignsDestinationsWorkflowsUsers & ActivityCredentialsData ExplorerSandboxes

Predictive models

Churn propensityPredicted CLVProduct affinityEvent propensity

Presto SQL

About Presto SQL

General recommendations

General recommendationsCommasIndentationNaming conventionsNULL valuesReserved wordsOne-way SHA-256 hashesWhitespace

SELECT statements, operators, and clauses

WITH clauseSELECT statementSELECT DISTINCT statementFROM clauseLEFT JOIN clauseWHERE clauseCASE expressionGROUP BY clauseHAVING clauseUNION clauseUNNEST clauseVALUES clauseWindow functionsORDER BY clauseLIMIT clauseOperatorsPIVOT operator

Functions

ARRAY_AGG()ARRAY_JOIN()AVG()CAST()CHR()COALESCE()CONCAT()COUNT()CURRENT_DATECURRENT_TIMESTAMPDATE_DIFF()DATE_FORMAT()DATE_TRUNC()DAY(), MONTH(), YEAR()DENSE_RANK()FROM_UNIXTIME()GREATEST()IF()LEAST()LENGTH()LOWER()MAX()MEDIAN()MIN()NOW()NTILE()PERCENT_RANK()PERCENTILE()RANK()REGEXP_EXTRACT()REGEXP_LIKE()REGEXP_REPLACE()REPLACE()ROUND()SPLIT()SPLIT_PART()SUBSTR()SUM()TO_HEX()TO_UNIXTIME()TRIM()TRY_CAST()UPPER()

Queries

About queriesQueries page

Data explorer

About the data explorerDocked modeFull screen modeTable schemaCompletionCardinality vs. uniquenessTable examplesTable details

Query editor

Query editorAbout Presto SQLValidate queries

How-tos

Add comment to queryAdd as SQL queryAdd as visual queryAdd to orchestrationAutocomplete table namesBrowse tables and columnsComment linesCopy column namesAdd as copyCopy SELECT statementDelete queryDiscard a draft queryDownload queryEdit queryEnable query alertsFormat SQLOpen queryOrganize queriesAdd folderAdd subfolderMove queryPreview resultsRefresh query automaticallyRename queryRun queryRun selectionSelect databaseUncomment linesUse keyboard shortcutsView notificationsView recently edited queriesView related orchestrationsView queryView query details

Recent activity

About notifications

Sandboxes

About sandboxesAllow sandbox administrationAbout sandbox workflows

Best practices

Continuous validationData across environmentsRun partial workflowsShort-lived sandboxes

How-tos

Access a sandboxAdd a sandboxDelete a sandboxEdit sandbox detailsOpen a sandboxPull updates from productionPromote changesResolve validation issuesReview changesView sandbox detailsView validation details

Segments

About the Segments pageRecommended segmentsSegment tabsSummary tabBreakdown tabCompare tabCustomers tab

Segment Editor

Segment namesInclusionsExclusionsAND vs. ORSegment conditionsAttributesCustomer listsPurchase behaviorsOperatorsBooleanDateDatetimeDecimalIntegerStringNULL and NOT NULL valuesRelative datesSegment insightsDatabases and tablesSQL Editor

How-tos:

Add attribute from tableAdd conditionsAdd exclusionsAdd foldersAdd purchase behaviorsUse queryAdd sectionsUse segmentAdd subfoldersUse uploaded fileBulk delete segmentsBulk move segmentsChoose AND/OR from toggleChange comparison date rangeChange insights date rangeChange baseline comparisonChange database sourceAdd comment to SQL segmentCompare segment insightsSet recommended segmentsCopy a column to the clipboardCopy a segment IDCopy a SQL QueryCreate a campaignCustomer listsNew segment from intersectionCreate SQL segment in a folderCreate segment in a folderCustomize comparison chartsDelete a segmentDownload segmentDuplicate segmentEdit segment from Segments pageEdit segment from Segment EditorExpand a graphExplore a segment copyFormat a SQL segmentMove segmentOrganize segmentsRename a segmentRerun a segmentSave segment to a folderSearch segmentsConfigure overlap chartSelect databaseSelect multiple valuesSet default chartsShow columnsSwitch to SQL segmentUse relative datesView a segmentView edit historyView matching recordsView overlap between segmentsFor attribute chartsFor revenue treeFor statistics

Semantic tags

About semantic tagsBlocklistComplianceCustomDatabaseEmail eventsEmail opt-in statusEmail summaryKeysLoyalty programsProfile (PII)SMS opt-in statusStitch labelsTransactions

Settings

User settings

About user settingsAdd usersDelete usersEdit usersRevoke tenant accessAllowed domains

Security settings

About security settingsAbout SSO group mappingsAbout resource groups“All resource groups”Custom resource groupsAssign users to resource groupsDatabase permissionsMulti-brand tenantsAbout API keys

Credentials

About credentials

Sandbox settings

About sandbox settings

Integrations

About integrationsAbout BI ConnectAdd BI Connect usersAbout Slack

Activity logs

About activity logsDownload user activityUser activity event types

Single sign-on (SSO)

About single sign-on (SSO)How SSO works (with Amperity)Use casesRequest to enable

Spark SQL

About Spark SQL

General recommendations

General recommendationsAdd commentsAvoid low cardinalityAvoid multiple passesCommasEscape charactersDaisy-chain LEFT JOINsFaster operations are betterFilter, then combineIdentifiersIndentationLimit expensive operationsLimit extra workLimit tablesLoad sizesNaming conventionsNULL valuesOne-way SHA-256 hashesReserved wordsSubqueriesTemporary tablesWhitespace

SELECT statements, operators, and clauses

WITH clauseLATERAL VIEW clauseSELECT statementSELECT DISTINCT statementFROM clauseJOIN clausesWHERE clauseCASE expressionGROUP BY clauseHAVING clauseWindow functionsORDER BY clauseLIMIT clauseOperatorsPIVOT operator

Functions

ABS()AVG()CAST()COALESCE()COLLECT_LIST()COLLECT_SET()CONCAT()COUNT()COUNT(DISTINCT)CURRENT_DATE()CURRENT_TIMESTAMP()DATE()DATE_ADD()DATE_TRUNC()DATEDIFF()DECODE()DENSE_RANK()EXPLODE()FIRST_VALUE()IF()ISNOTNULL()ISNULL()LAST()LEAST()LEFT()LENGTH()LOCATELOWER()MAX()MIN()MONTHS_BETWEEN()NOW()NTILE()NULLIF()RAND()RANK()REGEXP_EXTRACT()REGEXP_REPLACE()RLIKE()ROUND()ROW_NUMBER()SHA2()SPLIT()STRPOS()SUBSTR()SUBSTRING()SUM()TO_DATE()TO_TIMESTAMP()TRANSLATE()TRIM()UPPER()

Stitch

About StitchRun StitchSelect domain tables

Stitch results

About Stitch resultsExplore Stitch resultsExplore by Amperity IDExplore by data sourceExplore previous Stitch resultsExplore semanticsView cluster graphView deduplication rateView pairwise connectionsView Stitch metricsView stitched records

Unified ID 2.0 (UID2)

About Unified ID 2.0 (UID2)How UID2 worksAbout UID2 workflows

Prerequisites

About prerequisitesGet access to UID2Participate in UID2Get Mapper credentials

Configure Amperity

Configure AmperityAdd Mapper credentialsEnable UID2 token generationAdd UID2 table to database

Workflows

About workflowsAbout the Workflows pageAbout workflow alerts

Common resolutions

Ignore missing fileRestart workflowRetry taskSkip a taskUpdate credentialsUpdate error threshold

Context-specific resolutions

for campaignsfor courier groupsfor databasesfor destinationsfor scheduled orchestration groupsfor sourcesfor Stitch

How-tos

Configure runtime alertsFilter workflowsHide skipped tasksResolve workflowsSearch workflowsSend alerts to email addressesSend alerts to Slack channelsView all workflowsView detailsView resolutionsView workflow graphs

Open workflow alerts

from email alertsfrom Recent activity panefrom Slack alertsfrom Workflow page