Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update AWS Entity Resolution integration doc for public ADX listing #378

Merged
merged 7 commits into from
Dec 1, 2023

Conversation

asloobq
Copy link
Contributor

@asloobq asloobq commented Dec 1, 2023

1] Customers can use the public ADX listing instead of the private offers
2] Updated guidance on generating email and phone numbers in the same record

Customers can use the public ADX listing instead of the private offers
Use AWS Data Exchange screenshot from repo
Update instructions for processing both email and phone numbers
@asloobq asloobq changed the title Update integration-aws-entity-resolution.md Update AWS Entity Resolution integration doc for public ADX listing Dec 1, 2023
@asloobq asloobq marked this pull request as ready for review December 1, 2023 18:01
@@ -98,9 +98,10 @@ Send your UID2 contact the AWS account ID that you'll use for your UID2 integrat

### Subscribe to UID2 on AWS Data Exchange

Currently, you need to send your request via your UID2 contact. Then, you'll receive a custom invitation to the UID2 private service listing on AWS, as shown in the following example, and must accept the invitation to continue.
Visit the UID2 page on the AWS Data Exchange using this [link](https://aws.amazon.com/marketplace/pp/prodview-66zqls7iqsm6o?sr=0-4&ref_=beagle&applicationId=AWSMPContessa#offers) and click 'Continue to Subscribe'.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Visit the Unified ID 2.0 Identity Resolution page on the AWS Data Exchange and click Continue to Subscribe.


![AWS UID2 Private Offer](images/integration-aws-entity-resolution-private-offer.png)

<!-- To participate in UID2 on the Amazon Data Exchange Marketplace, subscribe to the UID2 service. See [Unified ID 2.0 Operator on AWS](https://aws.amazon.com/advertising-marketing/solutions/uid2/). -->
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we delete this also? Looks as though it was a placeholder for this new content?

@@ -138,7 +139,7 @@ When your initial account creation and setup are done, the next step is to creat
The following steps are a summary of actions you'll take in the AWS Entity Resolution user interface. For additional details and instructions, see [Creating a matching workflow with UID 2.0](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow-provider.html#create-mw-uid) in the AWS Entity Resolution documentation.

:::note
UID2 supports either email or phone number for UID2 generation. However, in AWS Entity Resolution, if both values are present in the schema mapping, the workflow uses the email and treats the phone number as a pass-through field. If your data includes a mix of emails and phone numbers, the best approach is to create a separate workflow for each, with separate schema mappings. In this scenario, go through the following steps twice&#8212;create one workflow for emails and a separate one for phone numbers.
UID2 supports both email and phone number for UID2 generation. However, in AWS Entity Resolution, if both values are present in the schema mapping, the workflow will duplicate each record in the output. One record will use the email for UID2 generation and the second record will use phone number. If you don't prefer this duplication of records in the output and if your data includes a mix of emails and phone numbers, the best approach is to create a separate workflow for each, with separate schema mappings. In this scenario, go through the following steps twice&#8212;create one workflow for emails and a separate one for phone numbers.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

UID2 supports both email and phone number for UID2 generation. However, in AWS Entity Resolution, if both values are present in the schema mapping, the workflow duplicates each record in the output. One record uses the email for UID2 generation and the second record uses phone number. If your data includes a mix of emails and phone numbers and you don't want this duplication of records in the output, the best approach is to create a separate workflow for each, with separate schema mappings. In this scenario, go through the following steps twice—create one workflow for emails and a separate one for phone numbers.

(just use present tense instead of future. Also switched the sequence of the two list items)

@@ -153,7 +154,7 @@ To create the matching workflow, first sign in to the AWS Management console, op
|0001|Test 1|test1@uidapi.com|1/1/90|
|0002|Test 2|test2@gmail.com|1/2/78|

NOTE: There can be only **one** email or phone number field per record. If email is present, phone number is treated as pass-through. To process phone numbers, create a separate workflow. See details earlier in this section.
NOTE: If you have both email and phone numbers in the same record, the workflow will duplicate each record in the output. If you don't prefer this, then the best approach is to create separate workflow for each. See details earlier in this section.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NOTE: If you have both email and phone numbers in the same record, the workflow duplicates each record in the output. If you don't want this, the best approach is to create a separate workflow for each. See details earlier in this section.

(again, just using present tense plus fixing "don't prefer" wording)

@asloobq asloobq merged commit 5c7fe5d into main Dec 1, 2023
1 check passed
@asloobq asloobq deleted the aaq-UID2-2162-update-entity-resolution-data-exchange branch December 1, 2023 19:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants