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

Linked Audience Runs Log #7232

Merged
merged 35 commits into from
Nov 19, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
b6576a2
Update libraries tiers description
prigiattiperrut Aug 8, 2024
78dcad1
wording update [netlify-build]
pwseg Aug 8, 2024
90be695
Update index.md - remarketing lists, trait activation limits
samkcrespo Aug 16, 2024
f2beb56
Update custom-domain downtime.md
jfoskin Sep 27, 2024
9de9b0a
Update linked-audiences.md
wilwong-segment Nov 5, 2024
9e58616
add transcned api integration docs
tcgilbert Nov 12, 2024
b6506bd
Apply suggestions from code review
tcgilbert Nov 12, 2024
eca9030
clarify setup instructions
tcgilbert Nov 12, 2024
2d859b6
pull from remote
tcgilbert Nov 12, 2024
a944e62
resolve conflicts
tcgilbert Nov 12, 2024
18eed1d
Apply suggestions from code review
tcgilbert Nov 13, 2024
0d99826
Merge pull request #7217 from segmentio/thomas/transcend
forstisabella Nov 14, 2024
f9aa6fa
add React Native link
forstisabella Nov 15, 2024
dcd8d81
update spec method styling
pwseg Nov 17, 2024
0ec778f
more cleanup
pwseg Nov 17, 2024
0e8b745
fix note
pwseg Nov 17, 2024
394b38f
more style guide cleanup
pwseg Nov 17, 2024
28f7fb9
typo fixes
pwseg Nov 17, 2024
d07171a
more cleanup and typo fixes
pwseg Nov 17, 2024
0601a96
Merge pull request #6948 from segmentio/samkcrespo-patch-27
pwseg Nov 17, 2024
f0430bb
Merge pull request #7229 from segmentio/7212-content-integration-for-…
forstisabella Nov 17, 2024
562031c
fix broken link
pwseg Nov 18, 2024
add689e
typo fixes
pwseg Nov 18, 2024
eb7dfb4
change to ACM
pwseg Nov 18, 2024
0c5b866
remove whitespace
pwseg Nov 18, 2024
5eb7c17
move notes around
pwseg Nov 18, 2024
6f555af
Merge branch 'develop' into jfoskin-patch-11
pwseg Nov 18, 2024
5b45369
Merge pull request #7088 from segmentio/jfoskin-patch-11
pwseg Nov 18, 2024
845cdf7
Merge pull request #7197 from segmentio/wilwong-segment-patch-2
pwseg Nov 18, 2024
5473f48
Add library tiers info to Sources overview page
pwseg Nov 18, 2024
1b27cc7
revert support type labels [netlify-build]
pwseg Nov 18, 2024
ec02d82
Merge pull request #6917 from segmentio/prigiattiperrut-patch-6
pwseg Nov 18, 2024
41077fb
draft [netlify-develop]
stayseesong Nov 18, 2024
1f73aa6
[netlify-build]
stayseesong Nov 18, 2024
84b6013
edits
stayseesong Nov 19, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions src/_includes/content/cloud-app-note.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,21 @@
</div>
</div>

{% elsif currentSlug == "transcend" %}
<div class="quick-info">
<div class="qi-content">
<h6>Integration Info</h6>
<ul class="qi">
<li><p markdown=1>The {{ page.title }} is a Segment [Public API](/docs/api/public-api/){:target="_blank"} integration. It facilitates privacy requests using Segment’s API, including erasure and tracking opt-out for Segment users.</p></li>
{% if currentIntegration.status == "PUBLIC_BETA" %}<li>This source is in <span class="release-pill">Beta</span></li>{% endif %}
</ul>
<h6>Partner Owned</h6>
<ul class="qi">
<li>This integration is partner owned. Please reach out to the partner's support for any issues.</li>
</ul>
</div>
</div>

{% else %}
<div class="quick-info">
<div class="qi-content">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,13 @@ engage: true

The Google Ads Remarketing Lists destination is one of Segment's most popular Engage List destinations. It has a variety of use cases related to exclusion, acquisition (using Similar Audience), remarketing, and more.

This destination can send audiences created in [Engage](/docs/engage/) to Google Ads as a [Customer List](https://support.google.com/google-ads/answer/6276125){:target="_blank"}. Once you set this destination up, Segment sends an initial user list of users to the [Google Ads API](https://developers.google.com/google-ads/api/docs/remarketing/overview){:target="_blank"}. As users move in and out of the audience, Segment automatically updates the list in Google. This allows you to run advertising campaigns without having manually update the list of users to target in your Google Ads campaigns.
This destination can send audiences created in [Engage](/docs/engage/) to Google Ads as a [Customer List](https://support.google.com/google-ads/answer/6276125){:target="_blank"}. Once you set this destination up, Segment sends an initial user list of users to the [Google Ads API](https://developers.google.com/google-ads/api/docs/remarketing/overview){:target="_blank"}. As users move in and out of the audience, Segment automatically updates the list in Google. This allows you to run advertising campaigns without having to manually update the list of users to target in your Google Ads campaigns.

You can send either an email address or mobile device ID (IDFA) from Engage to Google as custom matchers. You can set an email address on the user profile by including `email` as a trait on an [`identify` call](/docs/connections/spec/identify/), as a property on a [`track` call](/docs/connections/spec/track/), or as an [external id](/docs/unify/identity-resolution/externalids/) for the user. If you use Segment’s mobile SDKs to collect events from a mobile app, the user’s IDFA is automatically captured. If you don't use Segment’s mobile SDKs, you can set the user’s IDFA by setting it within `context.device.advertisingId`. You are also required to collect `context.device.type` and `context.device.adTrackingEnabled` on the event payload. Additionally, ensure `android.idfa` and `ios.idfa` are enabled as identifiers in your [Identity Resolution settings](/docs/unify/identity-resolution/identity-resolution-settings/) in Engage.
You can send either an email address or mobile device ID (IDFA) from Engage to Google as custom matchers. You can set an email address on the user profile by including `email` as a trait on an [Identify calls](/docs/connections/spec/identify/), as a property on a [Track calls](/docs/connections/spec/track/), or as an [external id](/docs/unify/identity-resolution/externalids/) for the user. If you use Segment’s mobile SDKs to collect events from a mobile app, the user’s IDFA is automatically captured. If you don't use Segment’s mobile SDKs, you can set the user’s IDFA by setting it within `context.device.advertisingId`. You must also collect `context.device.type` and `context.device.adTrackingEnabled` on the event payload. Additionally, ensure `android.idfa` and `ios.idfa` are enabled as identifiers in your [Identity Resolution settings](/docs/unify/identity-resolution/identity-resolution-settings/) in Engage.

When you send an audience to Google Ads Remarketing Lists, you can choose which custom matcher (email or mobile device ID/IDFA) to match with. If a user has multiple emails or IDFAs on their account as `external_ids`, Engage sends the ID that was most recently added to the user profile to Google Ads.

These audience lists can be used to serve content on Google Search, YouTube, and Gmail. You can only target users with email addresses that are associated with a Google account, and you can target users in Gmail only if they have an `@gmail.com` address.
You can use these audience lists to serve content on Google Search, YouTube, and Gmail. You can only target users with email addresses associated with a Google account, and you can target users in Gmail only if they have an `@gmail.com` address.

> info ""
> You must have access to Engage as part of your Segment plan to use this destination. [Contact Segment's sales team](https://segment.com/demo/){:target="_blank”} to try this out.
Expand All @@ -35,7 +35,7 @@ These audience lists can be used to serve content on Google Search, YouTube, and
- **Lookback window allowed**: Yes
- **Identifiers required** : Email or Mobile Device ID (IDFA)
- **Identifiers accepted** : Email and Mobile Device ID (IDFA)
- **Client or Server-Side Connection**: Server-side
- **Client or server-side Connection**: Server-side
- **Minimum audience size required**: 100

## Use cases: known users
Expand All @@ -53,12 +53,12 @@ Create an audience of users that signed up, purchased a product, or otherwise pe
You can use Engage to create a detailed profile of your most loyal customers (sometimes called a “seed audience”) and then send this list of customers to Google. In Google, you can then use Google's [Similar Audience](https://support.google.com/google-ads/answer/7151628?hl=en-AU){:target="_blank”} features to find similar users to target. For example, you might want to create a group of high-value users who have spent a certain amount of money on your product, and then use Similar Audiences to find users who might also spend that much.

> note ""
> **Note:** A “seed audience” must have at least 100 members for Google's Similar Audience feature to function.
> A “seed audience” must have at least 100 members for Google's Similar Audience feature to function.


### Remarketing audiences

You can use Engage to target users who completed some initial action, but didn't follow through on a purchase or other conversion event. You can create audiences to re-target these individuals and remind them to complete the purchase or other process. For example, you might send an email to someone who didn't complete a sign-up form or who didn't complete a shopping cart checkout.
You can use Engage to target users who completed some initial action, but didn't follow through on a purchase or other conversion event. You can create audiences to re-target these individuals and remind them to complete the purchase or other process. For example, you might send an email to someone who didn't complete a signup form or who didn't complete a shopping cart checkout.

## How it works

Expand All @@ -68,7 +68,7 @@ When you create an audience in Engage and connect it to Google Ads Remarketing L
2. Adds any users that fit the audience definition based on email or mobile ID (IDFA). Google uses these identifiers to match users in your list to users in the Google system who can be served ads.
3. Either adds or removes users from this audience based on the same identifiers.

## Set up
## Setup

Before you start, make sure you have administrative access to the Google Ads account so you can set up and link this destination.

Expand All @@ -78,14 +78,14 @@ Before you start, make sure you have administrative access to the Google Ads acc

2. Search for "Google Ads Remarketing Lists” and click **Configure**.

3. Click **Connect to Google Ads Remarketing Lists** and sign in to your Google Ads account. Make sure you sign in to the account that has administrator access!
3. Click **Connect to Google Ads Remarketing Lists** and sign in to your Google Ads account. Make sure you sign in to the account that has administrator access.

4. When prompted, click **Allow**. This is required for Segment to update your Google Ads Remarketing Lists.
4. When prompted, click **Allow**. Segment needs this to update your Google Ads Remarketing Lists.

5. Select the Google Ads account or sub-account to connect with Engage.

> info ""
> **What are sub-accounts?** Because the Google My Client Center (MCC) account allows a user to access multiple Google Ads accounts through a single user account, Segment has updated the selector to include these additional "sub-accounts." By default, Segment syncs the "primary" Google Ads account connected to your Google account, but when using Google MCC, you can select any of the Google Ads accounts managed by your primary Google Ads account. If you're not using MCC, your primary Google Ads account is connected. MCC is typically used by advertisers or agencies that manage multiple client accounts.
> info "What are sub-accounts"
> Because the Google My Client Center (MCC) account allows a user to access multiple Google Ads accounts through a single user account, Segment has updated the selector to include these additional "sub-accounts." By default, Segment syncs the "primary" Google Ads account connected to your Google account, but when using Google MCC, you can select any of the Google Ads accounts managed by your primary Google Ads account. If you're not using MCC, your primary Google Ads account is connected. MCC is typically used by advertisers or agencies that manage multiple client accounts.

### 2. Create an audience in Segment and connect it to Google Ads Remarketing Lists

Expand All @@ -107,7 +107,7 @@ In Google Ads, go to **Tools & Settings** > **Shared Library** > **Audience mana
![A screenshot of the Google Ads Audience lists page, with one list currently populating.](images/garl-audience_mgr.png)

> info ""
> **Note**: Google Ads can take 24+ hours to fully process initial audience uploads before they can be used for a campaign. If the audience is still processing, the list status appears as “Populating”.
> Google Ads can take 24+ hours to fully process initial audience uploads before they can be used for a campaign. If the audience is still processing, the list status appears as “Populating”.

## Consent mode
[Consent mode](https://support.google.com/analytics/answer/9976101?hl=en){:target="_blank"} is a feature provided by Google in the context of its products, particularly the Gtag library and Google Analytics. As of March 6, 2024, Google announced that consent mode must function for European Economic Area (EEA) users, otherwise data from EEA users won't process.
Expand Down Expand Up @@ -145,9 +145,7 @@ If you have any questions setting up consent mode, reach out to [friends@segment

Engage matches users in your audience using email and mobile device ID (IDFA) values. Make sure you are tracking these with Segment to have as high a match rate as possible.

You can set an email address on the user profile by including `email` as a trait on an [`identify` call](/docs/connections/spec/identify/), as a property on a [`track` call](/docs/connections/spec/track/), or as an [external id](/docs/unify/identity-resolution/externalids/) for the user. If you use Segment’s mobile SDKs to collect events from a mobile app, the user’s IDFA is automatically captured. If you don't use Segment’s mobile SDKs, you can set the user’s IDFA by setting it within `context.device.advertisingId`.

You can set an email on the user profile by including `email` as a trait, as a property on an event, or as an external id for the user. If you use Segment's mobile SDKs to collect events from a mobile app, IDFA is automatically captured for the user. You can also set a user's IDFA on a mobile app by setting it within `context.device.advertisingId`.
You can set an email address on the user profile by including `email` as a trait on an [Identify call](/docs/connections/spec/identify/), as a property on a [Track call](/docs/connections/spec/track/), or as an [external id](/docs/unify/identity-resolution/externalids/) for the user. If you use Segment’s mobile SDKs to collect events from a mobile app, the user’s IDFA is automatically captured. If you don't use Segment’s mobile SDKs, you can set the user’s IDFA by setting it within `context.device.advertisingId`.

If a user has more than one email address or IDFA on their account as `external_ids`, Engage sends the most recent id on the user profile to Adwords for matching. The match rate will be low if Google can't identify users based on the data that you provide.

Expand All @@ -156,11 +154,11 @@ If a user has more than one email address or IDFA on their account as `external_

### Invalid Settings error in Event Delivery

Make sure that this destination was created in [Engage](/docs/engage/) as it requires additional event data not available in standard destinations.
Make sure that this destination was created in [Engage](/docs/engage/), as it requires additional event data not available in standard destinations.

### Invalid user list ID error in Event Delivery

When you first connect a destination to an audience, Segment triggers a call to the destination to create the audience downstream. Once Segment creates the audience, the destination API returns an audience ID. For subsequent updates to the audience in the destination (adding or removing users), Segment uses this ID to send requests to the destination. The invalid user list ID error usually means that the audience ID no longer exists in the destination. To resolve this, you'll need to either recreate the audience or create a *new instance* of the destination and link it to the audience. Removing and re-adding the same instance of the destination will not work.
When you first connect a destination to an audience, Segment triggers a call to the destination to create the audience downstream. Once Segment creates the audience, the destination API returns an audience ID. For subsequent updates to the audience in the destination (adding or removing users), Segment uses this ID to send requests to the destination. The invalid user list ID error usually means that the audience ID no longer exists in the destination. To resolve this, you'll need to either recreate the audience or create a new instance of the destination and link it to the audience. Removing and re-adding the same instance of the destination won't work.

## FAQs

Expand All @@ -170,7 +168,7 @@ Engage audiences can only send to Google Ads Remarketing Lists for Google Search

#### How many users must be in an audience to use Google Ads Campaigns?

100
100.

#### What custom matchers does Engage send to Google Ads?

Expand All @@ -188,4 +186,8 @@ When you create Engage audiences, add conditions to specify which App ID to send

#### Why is there a schemaType validation error when I test an event?

Typically this is a validation error and the permissions need to be re-authorized. Ensure the user who is authorizing has adminstration permissions.
Typically, this is a validation error and the permissions need to be reauthorized. Ensure the user who is authorizing has administration permissions.

#### Limitations on identifiers and traits for Google Ads Remarketing Lists with Trait Activation

When configuring [ID Sync](/docs/engage/trait-activation/id-sync/) and [Trait Enrichment](/docs/engage/trait-activation/trait-enrichment/) for Google Ads Remarketing Lists, you can include one additional identifier in the payload. In the Customized Setup, only one Trait can be mapped, and it must be assigned to the `phone` field.
7 changes: 4 additions & 3 deletions src/connections/destinations/catalog/braze/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,12 @@ id: 54efbf12db31d978f14aa8b5
The Braze Destination is open-sourced on GitHub. Source code for the following integrations is available:

- [iOS](https://github.com/Appboy/appboy-segment-ios){:target="_blank"} (maintained by Braze)
- [Android](https://github.com/Appboy/appboy-segment-android){:target="_blank"}(maintained by Braze)
- [Swift](https://github.com/braze-inc/analytics-swift-braze){:target="_blank"}(maintained by Braze)
- [Kotlin](https://github.com/braze-inc/braze-segment-kotlin){:target="_blank"}(maintained by Braze)
- [Android](https://github.com/Appboy/appboy-segment-android){:target="_blank"} (maintained by Braze)
- [Swift](https://github.com/braze-inc/analytics-swift-braze){:target="_blank"} (maintained by Braze)
- [Kotlin](https://github.com/braze-inc/braze-segment-kotlin){:target="_blank"} (maintained by Braze)
- [Web](https://github.com/segment-integrations/analytics.js-integration-appboy){:target="_blank"} (maintained by Segment)
- [Server](https://github.com/segmentio/integration-appboy){:target="_blank"} (maintained by Segment)
- [React Native](https://github.com/segmentio/analytics-react-native/tree/master/packages/plugins/plugin-braze){:target="_blank"} (maintained by Segment)

For issues with mobile platforms (iOS, Android, Swift, or Kotlin), contact Braze support. For issues with Web or Server platforms, contact [Segment support](https://segment.com/help/contact){:target="_blank"}.

Expand Down
Loading