You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/amazon-personalize/index.md
+22-22Lines changed: 22 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -579,31 +579,31 @@ To create a personalize dataset group:
579
579
580
580
14. Find the location of the CSV file you generated in the earlier steps. This needs to be configured in the **Data Location** field on this screen.
581
581
582
-

582
+

583
583
584
584
15. After clicking the **Finish** button at the bottom of the page, you'll return to the Personalize Dashboard where you can monitor the progress of your interaction dataset as it is being created.
585
585
586
586
Be patient as this process can take a long time to complete.

589
589
590
590
### Create Personalize Solution
591
591
592
592
Once Segment's event CSV is finished importing into a user-item interaction dataset, Segment can create a Personalize Solution. To do this:
593
593
594
594
1. From the Dashboard page for the dataset group created above, click **Start** in the **Create solutions** column.
595
595
596
-

596
+

597
597
598
598
2. On the **Create solution** page, enter a **Solution name**.
599
599
* For a discussion on the different recipes you can use with Personalize, see [here](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html){:target="_blank"}.
600
600
601
-

601
+

602
602
603
603
604
604
3. Click **Finish** to create your Solution. This process can take several minutes to several hours to complete.
605
605
606
-

606
+

607
607
608
608
### Create Personalize Campaign
609
609
@@ -613,16 +613,16 @@ To create a Personalize campaign:
613
613
614
614
1. From the Dataset Group Dashboard, click **Create new campaign**.
615
615
616
-

616
+

617
617
618
618
2. Enter the name for your campaign.
619
619
3. Select the solution you created above and click **Create campaign**.
620
620
621
-

621
+

622
622
623
623
4. Personalize will start creating your new campaign. This process can take several minutes.
624
624
625
-

625
+

626
626
627
627
628
628
In the next section, Segment will build a real-time clickstream ingestion pipeline that accepts events from Segment and can query the solution you just deployed.
@@ -675,7 +675,7 @@ To create an IAM role:
675
675
4. Search for and click on your new roles from the [IAM home](https://console.aws.amazon.com/iam/home#/home){:target="_blank"}.
676
676
5. Select the **Trust Relationships** tab, then click **Edit trust relationship**.
677
677
678
-

678
+

679
679
680
680
6. Copy and paste the following into your trust relationship. You should replace `<your-source-id>` with either the Source ID of the attached Segment source (the default) or the custom external ID you set in your Amazon Lambda destination settings.
681
681
@@ -722,7 +722,7 @@ To build a Lambda function to process Segment events:
722
722
1. Go to the Lambda service page in your AWS account.
723
723
2. Click **Create a function** to create a new function.
724
724
725
-

725
+

726
726
727
727
3. Select **Author from scratch** since Segment will be providing the source code for the function.
728
728
@@ -733,7 +733,7 @@ To build a Lambda function to process Segment events:
733
733
734
734
7. Click **Create function**.
735
735
736
-

736
+

737
737
738
738
739
739
**Lambda Function Source Code**
@@ -745,7 +745,7 @@ To build a Lambda function to process Segment events:
745
745
746
746
You should now be able to see the code (and associate folders) in the code editor.
747
747
748
-

748
+

749
749
750
750
Segment will call your lambda once per event. The provided code maps Segment event fields from the Segment event it gets, and sends them to your Personalize Tracker. It then calls Personalize to get a recommendation for the userId in the event, and pushes that recommendation back as a user trait into Segment, using the `identify` call.
751
751
@@ -803,11 +803,11 @@ You need to modify the IAM Role & Policy originally created with this Lambda to
803
803
804
804
1. From the **Execution role** section of your Lambda function, click the **View the <your-role-name>** link.
805
805
806
-

806
+

807
807
808
808
2. Click the arrow next to your policy in this role, then **Edit Policy**.
809
809
810
-

810
+

811
811
812
812
3. Add the code below to the existing permissions from within the JSON editor.
813
813
4. Click **Review Policy** and **Save Changes**.
@@ -856,7 +856,7 @@ You need to create a Personalize Event Tracker for the Dataset Group you created
856
856
857
857
3. Click **Create event tracker** button.
858
858
859
-

859
+

860
860
861
861
4. Enter a name for your Event Tracker.
862
862
@@ -938,16 +938,16 @@ You need to create a Personalize Event Tracker for the Dataset Group you created
938
938
}
939
939
```
940
940
941
-

941
+

942
942
943
943
944
944
6. The Event Tracker's tracking ID is displayed on the following page and is also available on the Event Tracker's detail page. Copy this value to your clipboard.
945
945
946
-

946
+

947
947
948
948
7. Returning to the Lambda function, paste the Event Tracker's tracking ID into an Environment variable for the function with the key `personalize_tracking_id`.
949
949
950
-

950
+

951
951
952
952
8. Add environment variables for Segment and for the function to tell it the Personalize Campaign to call for retrieving recommendations.
953
953
@@ -957,26 +957,26 @@ You need to create a Personalize Event Tracker for the Dataset Group you created
957
957
958
958
11. Click on the campaign you created earlier and copy the **Campaign ARN** to your clipboard.
959
959
960
-

960
+

961
961
962
962
963
963
12. Return to your Lambda function and scroll down to the **Environment variables** panel.
964
964
965
965
13. Add an environment variable with the key `personalize_campaign_arn` and value of the Campaign ARN in your clipboard.
966
966
14. Scroll to the top of the page and click **Save** to save your changes.
967
967
968
-

968
+

969
969
970
970
15. You need a key for the Segment source that will get Segment's update events. Go back to your Segment workspace tab or window, and click on the source which will receive events from your Lambda, and copy the write key from the **Overview** tab.
971
971
972
-

972
+

973
973
974
974
975
975
16. Go back to your Lambda tab or window, and paste the key under a property called `connections_source_api_key`.
976
976
977
977
_Make sure to click **Save**_ here or you will need to do this again.
978
978
979
-

979
+

980
980
981
981
982
982
Your lambda is now ready to receive events from Segment. Next, you will need to enable your Segment Personalize Destination.
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/azure-function/index.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,42 +24,42 @@ To process events from Segment, first create a Azure Function that can handle yo
24
24
25
25
26
26
1. Go to https://portal.azure.com, and click **Functions App**.
27
-

27
+

28
28
29
29
2. Click **+Add** to create your Function App.
30
-

30
+

31
31
32
32
3. Enter a name for your app in the **App name** field, and configure any other fields as needed own flavor.
33
33
4. Click **Create**. Azure creates your new function app.
34
-

34
+

35
35
36
36
#### Create a new Azure function
37
37
38
38
39
39
1. Click the new function app's name. (You might need to click the **Refresh** button if the new function doesn't appear.)
40
-

40
+

41
41
42
42
2. On the left pane, click **Functions**.
43
-

43
+

44
44
45
45
3. In the main frame, click **New function**.
46
-

46
+

47
47
48
48
49
49
4. Choose **HTTP trigger**.
50
-

50
+

51
51
52
52
5. Enter a name for your function, and choose `Function` for the **Authorization level** field.
53
-

53
+

54
54
6. Click `Create`.
55
55
56
56
11. Set up your function code.
57
57
12. In the created function screen, click on `</> Get function URL`.
58
-

58
+

59
59
60
60
13. In the **Key** field, choose `default (Function key)`.
61
61
14. Click **Copy** to the right of the URL. You'll use this URL to tell Segment where to connect to use this Azure Function.
62
-

62
+

Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/braze/index.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -531,27 +531,27 @@ You can send computed traits created in Engage as `identify` calls to create cus
531
531
532
532
For example, if you have a computed trait for “Last Product Viewed Item,” that would be named `last_product_viewed_item` in the user's Engage profile.
533
533
534
-

534
+

535
535
536
536
If the “Last Product Viewed Item” trait is connected to Braze to send `identify` calls, as in this example:
537
537
538
-

538
+

539
539
540
540
The following custom attribute, “last_product_viewed_item” appears in Braze on the user's profile:
541
541
542
-

542
+

543
543
544
544
#### Computed Traits using Track calls
545
545
546
546
You can also send computed traits created in Engage as `track` calls to create custom events in Braze. When Engage calculates a computed trait for a user, it sends a `TraitComputed` event to Braze.
547
547
548
548
Using the same example as above, if a user has a computed trait for “Last Product Viewed Item” and the trait is connected to Braze and configured to send `track` calls:
549
549
550
-

550
+

551
551
552
552
The following custom event appears in Braze on the user's profile:
553
553
554
-

554
+

555
555
556
556
> info "Tip"
557
557
> You can change the name of the “computed trait” event that Braze receives in the Destination Settings accessed through Engage.
@@ -571,15 +571,15 @@ You can send audiences created in Engage as `identify` calls to create custom at
571
571
572
572
For example, if a user is in a “Dormant Shoppers” audience:
573
573
574
-

574
+

575
575
576
576
And the “Dormant Shoppers” audience is connected to Braze to send `identify` calls:
577
577
578
-

578
+

579
579
580
580
The “dormant_shoppers” custom attribute appears in Braze on the user's profile:
581
581
582
-

582
+

583
583
584
584
585
585
#### Audiences using Track calls
@@ -588,11 +588,11 @@ You can also send audiences created in Engage as `track` calls to create custom
588
588
589
589
Using the same example as above, if a user is in a “Dormant Shoppers” audience and the audience is connected to Braze to send `track` calls, Engage sends the following “Audience Entered” and “Audience Exited” events. (You can edit the names of these events from this screen.)
590
590
591
-

591
+

592
592
593
593
The following custom event appears in Braze on the user's profile when they enter the audience:
594
594
595
-

595
+

596
596
597
597
> info "Tip"
598
598
> You can change the name of the “Audience Entered” event that Braze receives in the Destination Settings accessed through Engage.
@@ -631,7 +631,7 @@ If you use the Braze destination in either [cloud or device mode](/docs/connecti
631
631
632
632
By default, Engage data is sent to Braze by matching the `userId`. The Segment `userId` maps to Braze's External ID. If the user is anonymous and does not have a `userId`, you can also choose to send data using the `braze_id` auto-generated by Braze. To use `braze_id`, you must pass the `braze_id` to Segment as a [Segment externalId](/docs/unify/identity-resolution/externalids/) in the `context.integrations.Braze.braze_id` object. If `braze_id` is sent as an `externalId` **and** `userId` is missing, Engage matches on `braze_id` when sending to Braze. You can check the **Identities** tab on a user's Engage profile to confirm that `braze_id` was successfully picked up as an `externalId`.
633
633
634
-

634
+

635
635
636
636
You can find the `braze_id` in the Braze UI or by using Braze's [Users by Identifier API Endpoint](https://www.braze.com/docs/api/endpoints/export/user_data/post_users_identifier/){:target="_blank"}.
0 commit comments