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

Antavo Source documentation #7275

Merged
merged 12 commits into from
Jan 9, 2025
Merged

Antavo Source documentation #7275

merged 12 commits into from
Jan 9, 2025

Conversation

bbantavo
Copy link
Contributor

Proposed changes

Added Antavo Source documentation files.

Merge timing

asap

Related issues (optional)

@bbantavo bbantavo requested a review from a team as a code owner November 29, 2024 10:53
@bbantavo bbantavo requested a review from pwseg November 29, 2024 10:53
@seg-atlantis-prod
Copy link

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

@seg-atlantis-prod
Copy link

Error parsing command: EOF found when expecting closing quote

@seg-atlantis-prod
Copy link

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

@seg-atlantis-prod
Copy link

Error parsing command: EOF found when expecting closing quote

Comment on lines 34 to 38
## Events

Two main event types are synced into Segment: Profile updates and loyalty events.
Both event types require userID, which can be selected in Antavo.
Any customer attribute in Antavo can be selected as "external customer ID".
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
## Events
Two main event types are synced into Segment: Profile updates and loyalty events.
Both event types require userID, which can be selected in Antavo.
Any customer attribute in Antavo can be selected as "external customer ID".
## Events
Antavo syncs two main types of events to Segment: Profile Updates and Loyalty Events. Profile Updates are sent as Segment Identify events, while Loyalty Events are sent as Segment Track events.
Both event types include a `userId`, which can be configured in Antavo. You can designate any customer attribute as the "external customer ID" to use as the Segment `userId`.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

hi @tcgilbert

thanks, this is now applied

Comment on lines 40 to 44
### Profile updates

This event happens when a customer attribute - added to the **Customer field sync** - changes.
- Antavo always includes the `userId`.
- Customer attributes are included in `traits` object.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
### Profile updates
This event happens when a customer attribute - added to the **Customer field sync** - changes.
- Antavo always includes the `userId`.
- Customer attributes are included in `traits` object.
### Profile updates
Profile Updates occur when a customer attribute, added to the Antavo **Customer field sync***, updates. Customer attributes are included in the traits object.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

hi @tcgilbert

thanks for the suggestion, this is now applied

Comment on lines 58 to 62
### Loyalty events

When a built-in or custom loyalty event - added to the **Event sync** - happens, event data are streamlined to the Antavo Source.
- Antavo always includes the `userId`.
- Event properties are included in `properties` object.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
### Loyalty events
When a built-in or custom loyalty event - added to the **Event sync** - happens, event data are streamlined to the Antavo Source.
- Antavo always includes the `userId`.
- Event properties are included in `properties` object.
### Loyalty events
Loyalty Events occur when a built-in or custom event, added to the Antavo Event sync, is triggered. The event data is then sent to the Segment Antavo Source. Event properties are included in the properties object.

Copy link
Contributor

Choose a reason for hiding this comment

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

@bbantavo What are the different event names a customer can expect to be sent into Segment? Is there a standard list of events, or is this all configured in a custom way by the user? If there is a standardized list, we ask that partner provide a table of the expected events:

e.g.,

| Event Name         | Description                           |
| ------------------ | ------------------------------------- |
| Email Sent         | Email was sent successfully           |
| Email Opened       | Prospect opened the email             | 
| Link Clicked       | Prospect clicked the tracking link    | 
| Email Replied      | Prospect replied to email sent        | 
| Email Bounced      | Email servers rejected the email      | 
| Email Unsubscribed | Prospect clicked the unsubscribe link | 

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hi @tcgilbert

Our Source integration requires our clients to configure which events they want to sync to Segment. By default no event is synced.

Our clients have a start set of built-in events which are fully customizable, and they also have the ability the define custom events.

We can provide information about our built-in events, but their meaning could differ from client to client.

Copy link
Contributor

@tcgilbert tcgilbert left a comment

Choose a reason for hiding this comment

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

just one last thing, but lgtm

Comment on lines 1 to 3
```
title: Antavo Source
```
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```
title: Antavo Source
```
---
title: Antavo Source
id: WXNgKpZMsd
---

Copy link
Contributor Author

Choose a reason for hiding this comment

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

hi @tcgilbert

this is now updated, please check

"timestamp": "2024-11-26T15:15:49.000Z",
}
```

Copy link
Contributor

Choose a reason for hiding this comment

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

Integrations Object

Antavo automatically filters data from being sent to Salesforce destinations (Salesforce (Actions), Salesforce Marketing Cloud (Actions)) and the Antavo destination. This is achieved by adding these destinations to the Integrations object in the event payloads. Since Antavo has a dedicated Salesforce integration, this filtering helps prevent infinite loops.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

hi @tcgilbert !

thanks for the suggestion! we'll apply it shortly

quick note: the links seems to be pointing to github.com domain (throwing 404s), but I'm guessing it should be to segment.com instead

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hi @tcgilbert !

Updated this section, please check!

@pwseg pwseg merged commit d03c312 into segmentio:develop Jan 9, 2025
4 checks passed
Copy link
Contributor

github-actions bot commented Jan 9, 2025

Thank you for your contribution! Your pull request is merged, but may take a day or two to appear on the site.

@pwseg pwseg added the new-integration Added a new source or destination label Jan 9, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
new-integration Added a new source or destination
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants