Skip to content

Commit b3c530b

Browse files
committed
alt text for amazon personalize, azure function, braze
1 parent 62191b2 commit b3c530b

File tree

3 files changed

+43
-43
lines changed

3 files changed

+43
-43
lines changed

src/connections/destinations/catalog/amazon-personalize/index.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -579,31 +579,31 @@ To create a personalize dataset group:
579579
580580
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.
581581
582-
![](images/PersonalizeImportJob.png)
582+
![A screenshot of the Import user-item interaction data, with the Data Location field visible](images/PersonalizeImportJob.png)
583583
584584
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.
585585
586586
Be patient as this process can take a long time to complete.
587587
588-
![](images/PersonalizeInteractionDatasetCreating.png)
588+
![A screenshot of the Dataset groups dashboard, with a red box around the status of the dataset upload (Create in progress)](images/PersonalizeInteractionDatasetCreating.png)
589589
590590
### Create Personalize Solution
591591
592592
Once Segment's event CSV is finished importing into a user-item interaction dataset, Segment can create a Personalize Solution. To do this:
593593
594594
1. From the Dashboard page for the dataset group created above, click **Start** in the **Create solutions** column.
595595
596-
![](images/PersonalizeCreateSolution.png)
596+
![A screenshot of the Dataset groups dashboard, with a red box around the Start button in the Create solutions column](images/PersonalizeCreateSolution.png)
597597
598598
2. On the **Create solution** page, enter a **Solution name**.
599599
* 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"}.
600600
601-
![](images/PersonalizeSolutionConfig.png)
601+
![A screenshot of the Create solution page, with a solution name entered in the Solution name field.](images/PersonalizeSolutionConfig.png)
602602
603603
604604
3. Click **Finish** to create your Solution. This process can take several minutes to several hours to complete.
605605
606-
![](images/PersonalizeSolutionInProgress.png)
606+
![A screenshot of the Dataset groups dashboard, with a red box around the status of the solution creation (Create in progress)](images/PersonalizeSolutionInProgress.png)
607607
608608
### Create Personalize Campaign
609609
@@ -613,16 +613,16 @@ To create a Personalize campaign:
613613
614614
1. From the Dataset Group Dashboard, click **Create new campaign**.
615615
616-
![](images/PersonalizeCreateCampaignDash.png)
616+
![A screenshot of the Dataset Group Dashboard, with a red box around the Create new campaign button in the Launch Campaigns column](images/PersonalizeCreateCampaignDash.png)
617617
618618
2. Enter the name for your campaign.
619619
3. Select the solution you created above and click **Create campaign**.
620620
621-
![](images/PersonalizeCreateCampaign.png)
621+
![A screenshot of the Create new campaign page, with a campaign name entered and a solution selected (the solution created above)](images/PersonalizeCreateCampaign.png)
622622
623623
4. Personalize will start creating your new campaign. This process can take several minutes.
624624
625-
![](images/PersonalizeCampaignCreating.png)
625+
![A screenshot of the overview page for the campaign created in the previous step, with a blue banner reading "Campaign creation in progress..."](images/PersonalizeCampaignCreating.png)
626626
627627
628628
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:
675675
4. Search for and click on your new roles from the [IAM home](https://console.aws.amazon.com/iam/home#/home){:target="_blank"}.
676676
5. Select the **Trust Relationships** tab, then click **Edit trust relationship**.
677677

678-
![](images/LambdaTrustRelationship.png)
678+
![A screenshot of the Trust Relationships tab, with the Edit trust relationship button visible](images/LambdaTrustRelationship.png)
679679

680680
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.
681681

@@ -722,7 +722,7 @@ To build a Lambda function to process Segment events:
722722
1. Go to the Lambda service page in your AWS account.
723723
2. Click **Create a function** to create a new function.
724724

725-
![](images/LambdaDashboard.png)
725+
![A screenshot of the Lambda service page in AWS, with a red box around the "Create a function" button](images/LambdaDashboard.png)
726726

727727
3. Select **Author from scratch** since Segment will be providing the source code for the function.
728728

@@ -733,7 +733,7 @@ To build a Lambda function to process Segment events:
733733

734734
7. Click **Create function**.
735735

736-
![](images/LambdaCreateFunction.png)
736+
![A screenshot of the Create a function settings, with a function name, runtime, permissions, and role name entered](images/LambdaCreateFunction.png)
737737

738738

739739
**Lambda Function Source Code**
@@ -745,7 +745,7 @@ To build a Lambda function to process Segment events:
745745

746746
You should now be able to see the code (and associate folders) in the code editor.
747747

748-
![](images/LambdaFunctionCode.png)
748+
![A screenshot of the Lambda code editor](images/LambdaFunctionCode.png)
749749

750750
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.
751751

@@ -803,11 +803,11 @@ You need to modify the IAM Role & Policy originally created with this Lambda to
803803

804804
1. From the **Execution role** section of your Lambda function, click the **View the <your-role-name>** link.
805805

806-
![](images/ExecutionRoleIAM.png)
806+
![A screenshot of the execution role settings section on your Lambda](images/ExecutionRoleIAM.png)
807807

808808
2. Click the arrow next to your policy in this role, then **Edit Policy**.
809809

810-
![](images/EditPolicy.png)
810+
![A screenshot of the permissions policies settings section on your Lambda](images/EditPolicy.png)
811811

812812
3. Add the code below to the existing permissions from within the JSON editor.
813813
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
856856

857857
3. Click **Create event tracker** button.
858858

859-
![](images/PersonalizeCreateTracker.png)
859+
![A screenshot of the Event trackers settings page, with a red box around the Create event tracker button](images/PersonalizeCreateTracker.png)
860860

861861
4. Enter a name for your Event Tracker.
862862

@@ -938,16 +938,16 @@ You need to create a Personalize Event Tracker for the Dataset Group you created
938938
}
939939
```
940940

941-
![](images/PersonalizeEventTrackerConfig.png)
941+
![A screenshot of the Configure tracker setup page](images/PersonalizeEventTrackerConfig.png)
942942

943943

944944
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.
945945

946-
![](images/PersonalizeEventTrackerCreating.png)
946+
![A screenshot of the Install the SDK page, with a red box around the Tracking Id value](images/PersonalizeEventTrackerCreating.png)
947947

948948
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`.
949949

950-
![](images/LambdaEnvVariable.png)
950+
![A screenshot of the key/value pairs under the Environment variables page, with the key personalize_tracking_id visible](images/LambdaEnvVariable.png)
951951

952952
8. Add environment variables for Segment and for the function to tell it the Personalize Campaign to call for retrieving recommendations.
953953

@@ -957,26 +957,26 @@ You need to create a Personalize Event Tracker for the Dataset Group you created
957957

958958
11. Click on the campaign you created earlier and copy the **Campaign ARN** to your clipboard.
959959

960-
![](images/PersonalizeCampaignArn.png)
960+
![A screenshot of the campaign overview page, with a red box around Campaigns in the side navigation](images/PersonalizeCampaignArn.png)
961961

962962

963963
12. Return to your Lambda function and scroll down to the **Environment variables** panel.
964964

965965
13. Add an environment variable with the key `personalize_campaign_arn` and value of the Campaign ARN in your clipboard.
966966
14. Scroll to the top of the page and click **Save** to save your changes.
967967

968-
![](images/LambdaRecCampaignArn.png)
968+
![A screenshot of the environmental variables panel, with a key/value pair of "personalize_campaign_arn" included](images/LambdaRecCampaignArn.png)
969969

970970
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.
971971

972-
![](images/SegmentWriteKey.png)
972+
![A screenshot of a Source's overview panel in Segment, with a green arrow pointing to the Write Key field](images/SegmentWriteKey.png)
973973

974974

975975
16. Go back to your Lambda tab or window, and paste the key under a property called `connections_source_api_key`.
976976

977977
_Make sure to click **Save**_ here or you will need to do this again.
978978

979-
![](images/LambdaRecCampaignArn.png)
979+
![A screenshot of the environmental variables panel, with a key/value pair of "connections_source_api_key" included](images/LambdaRecCampaignArn.png)
980980

981981

982982
Your lambda is now ready to receive events from Segment. Next, you will need to enable your Segment Personalize Destination.

src/connections/destinations/catalog/azure-function/index.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -24,42 +24,42 @@ To process events from Segment, first create a Azure Function that can handle yo
2424

2525

2626
1. Go to https://portal.azure.com, and click **Functions App**.
27-
![](images/azure1.png)
27+
![A screenshot of the Azure services dashboard, with an orange box around the Function Apps buttons](images/azure1.png)
2828

2929
2. Click **+Add** to create your Function App.
30-
![](images/azure2.png)
30+
![A screenshot of the Function Apps dashboard, with an orange box around the "Add" button](images/azure2.png)
3131

3232
3. Enter a name for your app in the **App name** field, and configure any other fields as needed own flavor.
3333
4. Click **Create**. Azure creates your new function app.
34-
![](images/azure3.png)
34+
![A screenshot of the Function App settings page, with blurbs point to the App Name field and the Create button](images/azure3.png)
3535

3636
#### Create a new Azure function
3737

3838

3939
1. Click the new function app's name. (You might need to click the **Refresh** button if the new function doesn't appear.)
40-
![](images/azure4.png)
40+
![A screenshot of the Function App dashboard, with an orange box around the app you created above](images/azure4.png)
4141

4242
2. On the left pane, click **Functions**.
43-
![](images/azure5.png)
43+
![A screenshot of the function dashboard, with an orange box around the Functions dropdown](images/azure5.png)
4444

4545
3. In the main frame, click **New function**.
46-
![](images/azure6.png)
46+
![A screenshot of the function panel, with an orange box around the New function button](images/azure6.png)
4747

4848

4949
4. Choose **HTTP trigger**.
50-
![](images/azure7.png)
50+
![A screenshot of the new function setup page, with an orange box around the HTTP trigger box](images/azure7.png)
5151

5252
5. Enter a name for your function, and choose `Function` for the **Authorization level** field.
53-
![](images/azure8.png)
53+
![A screenshot of the HTTP trigger setup panel, with a name entered in the Name field, Function chosen as the Authorization level, and an orange box around the Create button](images/azure8.png)
5454
6. Click `Create`.
5555

5656
11. Set up your function code.
5757
12. In the created function screen, click on `</> Get function URL`.
58-
![](images/azure9.png)
58+
![A screenshot of the function panel, with an orange box around the "</> Get function URL" button](images/azure9.png)
5959

6060
13. In the **Key** field, choose `default (Function key)`.
6161
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-
![](images/azure10.png)
62+
![A screenshot of the Get function URL popup, with an orange box around the "Copy" button](images/azure10.png)
6363

6464
## Configure Azure Function Destination
6565

src/connections/destinations/catalog/braze/index.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -531,27 +531,27 @@ You can send computed traits created in Engage as `identify` calls to create cus
531531
532532
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.
533533
534-
![](images/last_viewed-user.png)
534+
![A screenshot of a user's Engage profile with the Computed Traits button selected](images/last_viewed-user.png)
535535
536536
If the “Last Product Viewed Item” trait is connected to Braze to send `identify` calls, as in this example:
537537
538-
![](images/last_viewed-identify.png)
538+
![A screenshot of the Last Product Viewed Item tab, with the Settings button selected](images/last_viewed-identify.png)
539539
540540
The following custom attribute, “last_product_viewed_item” appears in Braze on the user's profile:
541541
542-
![](images/last_viewed-id-braze.png)
542+
![A screenshot of the "last_product_viewed_item" attribute in Braze](images/last_viewed-id-braze.png)
543543
544544
#### Computed Traits using Track calls
545545
546546
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 `Trait Computed` event to Braze.
547547
548548
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:
549549
550-
![](images/last_viewed-track.png)
550+
![A screenshot of the Braze settings tab in Segment, with the Send Track setting enabled and a Trait Computed value in the Compute Event field](images/last_viewed-track.png)
551551
552552
The following custom event appears in Braze on the user's profile:
553553
554-
![](images/last_viewed-track-braze.png)
554+
![A screenshot of a user's profile in Braze, with a Trait Computed event present](images/last_viewed-track-braze.png)
555555
556556
> info "Tip"
557557
> 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
571571
572572
For example, if a user is in a “Dormant Shoppers” audience:
573573
574-
![](images/dormant-user.png)
574+
![A screenshot of a user's profile in Engage, with the Audiences tab selected and the "Dormant Shoppers" trait present](images/dormant-user.png)
575575
576576
And the “Dormant Shoppers” audience is connected to Braze to send `identify` calls:
577577
578-
![](images/dormant-identify.png)
578+
![A screenshot of the Braze settings tab in Segment, with the Send Identify setting enabled](images/dormant-identify.png)
579579
580580
The “dormant_shoppers” custom attribute appears in Braze on the user's profile:
581581
582-
![](images/dormant-identify-braze.png)
582+
![A screenshot of a user's profile in Braze, with a Trait Computed event present](images/dormant-identify-braze.png)
583583
584584
585585
#### Audiences using Track calls
@@ -588,11 +588,11 @@ You can also send audiences created in Engage as `track` calls to create custom
588588
589589
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.)
590590
591-
![](images/dormant-track.png)
591+
![A screenshot of the Braze settings tab in Segment, with the Send Track setting enabled, Enter Event and Exit Event fields configured](images/dormant-track.png)
592592
593593
The following custom event appears in Braze on the user's profile when they enter the audience:
594594
595-
![](images/dormant-track-braze.png)
595+
![A screenshot of a user's profile in Braze, with an Audience Entered trait present](images/dormant-track-braze.png)
596596
597597
> info "Tip"
598598
> 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
631631
632632
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`.
633633
634-
![](images/braze-anonid.png)
634+
![A screenshot of an anonymous user in Segment, with the Identities tab selected and a braze_id identity present](images/braze-anonid.png)
635635
636636
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"}.
637637

0 commit comments

Comments
 (0)