Skip to content

Commit 3762110

Browse files
author
Carlo Javier
committed
Merge branch 'PLAT-234038/add-use-case-in-data-mgmt-guide' of https://git.corp.adobe.com/ens60013/experience-platform.en into PLAT-234038/add-use-case-in-data-mgmt-guide
2 parents 1f3cf3c + b6a9d5c commit 3762110

File tree

9 files changed

+941
-98
lines changed

9 files changed

+941
-98
lines changed

help/destinations/catalog/advertising/google-customer-match-dv360.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,15 @@
11
---
22
title: Google Customer Match + Display & Video 360 connection
33
description: With the Google Customer Match + Display & Video 360 destination connector, you can use your online and offline data from Experience Platform to reach and re-engage with your customers across Google's owned and operated properties, such as Search, Shopping, Gmail, and YouTube.
4+
badge: Limited Availability
45
exl-id: f6da3eae-bf3f-401a-99a1-2cca9a9058d2
56
---
67
# [!DNL Google Customer Match + Display & Video 360] connection
78

9+
>[!NOTE]
10+
>
11+
>**Limited availability of the Google Customer Match + DV360 connector**<br>As we're going through the full lifecycle of maturity on this integration with Google, we're seeing data that points to weaknesses in implementation that need to be corrected before wider adoption can happen. Given these concerns, Adobe has reduced the visibility of this destination to a limited number of customers. We are in active conversations with Google to improve the product experience. We understand this may be disappointing news, but we believe it's the responsible approach to ensure a high-quality, reliable experience for our customers.</br>
12+
813
Use this destination to activate your first-party PII-based [[!DNL Google Customer Match]](https://support.google.com/google-ads/answer/6379332?hl=en) lists directly to [!DNL Google Display & Video 360] properties such as [!DNL Search], [!DNL YouTube], [!DNL Gmail], and the [!DNL Google Display Network].
914

1015
Certain Google-integrated third parties, such as Adobe Real-Time CDP, can use the [!DNL Google Audience Partner API] to create [!DNL Customer Match] audiences directly in customers' [!DNL Display & Video 360] account.

help/destinations/catalog/streaming/http-destination.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ This section describes which types of audiences you can export to this destinati
3939
Refer to the table below for information about the destination export type and frequency.
4040

4141
| Item | Type | Notes |
42-
---------|----------|---------|
42+
| ---------|----------|---------|
4343
| Export type | **[!UICONTROL Profile-based]** | You are exporting all members of a segment, together with the desired schema fields (for example: email address, phone number, last name), as chosen in the mapping screen of the [destination activation workflow](../../ui/activate-segment-streaming-destinations.md#mapping).|
4444
| Export frequency | **[!UICONTROL Streaming]** | Streaming destinations are "always on" API-based connections. As soon as a profile is updated in Experience Platform based on audience evaluation, the connector sends the update downstream to the destination platform. Read more about [streaming destinations](/help/destinations/destination-types.md#streaming-destinations).|
4545

@@ -52,6 +52,7 @@ To use the HTTP API destination to export data out of Experience Platform, you m
5252
* You must have an HTTP endpoint that supports REST API.
5353
* Your HTTP endpoint must support the Experience Platform profile schema. No transformation to a 3rd-party payload schema is supported in the HTTP API destination. Refer to the [exported data](#exported-data) section for an example of the Experience Platform output schema.
5454
* Your HTTP endpoint must support headers.
55+
* Your HTTP endpoint must respond within 2 seconds to ensure proper data processing and avoid timeout errors.
5556

5657
>[!TIP]
5758
>
@@ -357,4 +358,8 @@ Below are further examples of exported data, depending on the UI settings you se
357358

358359
In 95 percent of the time, Experience Platform attempts to offer a throughput latency of less than 10 minutes for successfully sent messages with a rate of less than 10 thousand requests per second for each dataflow to an HTTP destination.
359360

360-
In case of failed requests to your HTTP API destination, Experience Platform stores the failed requests and retries twice to send the requests to your endpoint.
361+
In case of failed requests to your HTTP API destination, Experience Platform stores the failed requests and retries twice to send the requests to your endpoint.
362+
363+
## Troubleshooting {#troubleshooting}
364+
365+
To ensure reliable data delivery and avoid timeout issues make sure that your HTTP endpoint responds within 2 seconds to Experience Platform requests, as specified in the [prerequisites](#prerequisites) section. Responses which take longer will result in timeout errors.

help/destinations/toc.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ role: Admin,User
8585
* [Google Ad Manager connection](./catalog/advertising/google-ad-manager.md)
8686
* [(Beta) Google Ad Manager 360 connection](./catalog/advertising/google-ad-manager-360-connection.md)
8787
* [Google Customer Match connection](./catalog/advertising/google-customer-match.md)
88-
* [Google Customer Match + DV360 connection](./catalog/advertising/google-customer-match-dv360.md)
88+
* [(Limited Availability) Google Customer Match + DV360 connection](./catalog/advertising/google-customer-match-dv360.md)
8989
* [Google Display & Video 360 connection](./catalog/advertising/google-dv360.md)
9090
* [Google gtag extension](./catalog/advertising/gtag-advertising.md)
9191
* [LinkedIn Insight Tag extension](./catalog/advertising/linkedin.md)

help/destinations/ui/activate-batch-profile-destinations.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,18 @@ Select **[!UICONTROL Export full files]** to trigger the export of a file contai
137137
* **[!UICONTROL Weekly]**: select the start date and subsequent exports will occur on that day of the week until the selected end date.
138138
* **[!UICONTROL Monthly]**: select the start date and subsequent exports will occur on that date of the month until the selected end date. For months with fewer than 30 or 31 days, the export occurs on the last day of the month.
139139

140+
>[!NOTE]
141+
>
142+
> Weekly and monthly scheduling options are currently supported only for the following file-based cloud storage destinations, and only when activating [people audiences](../../segmentation/types/overview.md#people-audience) and [prospect audiences](../../segmentation/types/overview.md#prospect-audience).
143+
>
144+
> * [Amazon S3](../catalog/cloud-storage/amazon-s3.md)
145+
> * [Azure Blob Storage](../catalog/cloud-storage/azure-blob.md)
146+
> * [Data Landing Zone](../catalog/cloud-storage/data-landing-zone.md)
147+
> * [Google Cloud Storage](../catalog/cloud-storage/google-cloud-storage.md)
148+
> * [SFTP](../catalog/cloud-storage/sftp.md)
149+
>
150+
> Weekly and monthly scheduling options are not available for other destination types.
151+
140152
2. Use the **[!UICONTROL Time]** toggle to select whether the export should happen immediately after audience evaluation or on a scheduled basis, at a specified time. When selecting the **[!UICONTROL Scheduled]** option, you can use the selector to choose the time of day, in [!DNL UTC] format, when the export should take place.
141153

142154
Use the **[!UICONTROL After segment evaluation]** option to have the activation job run immediately after the daily Experience Platform batch segmentation job completes. This option ensures that when the activation job runs, the most up-to-date profiles are exported to your destination. This might result in an audience being exported multiple times a day, based on your actions.

help/segmentation/TOC.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,10 @@ role: User
1515
- Segmentation API {#api}
1616
- [Overview](api/overview.md)
1717
- [Getting started](api/getting-started.md)
18+
- [Create audience metadata](api/create-audience.md)
1819
- [Audiences](api/audiences.md)
1920
- [Export jobs](api/export-jobs.md)
21+
- [External audiences](api/external-audiences.md)
2022
- [Previews and estimates](api/previews-and-estimates.md)
2123
- [Schedules](api/schedules.md)
2224
- [Segment definitions](api/segment-definitions.md)
Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: Create Audience API Endpoint
3+
description: Learn how to create the metadata for an external audience using the API.
4+
hide: yes
5+
hidefromtoc: yes
6+
exl-id: e841a5f6-f406-4e1d-9e8a-acb861ba6587
7+
---
8+
# Create audience endpoint
9+
10+
The POST `/audiences` endpoint can be used create the metadata for an external audience. You should use this endpoint if the audience ingestion will be managed in a separate service, such as batch ingestion.
11+
12+
## Getting started
13+
14+
>[!IMPORTANT]
15+
>
16+
>The endpoints in this guide are prefixed with `/core/ais`, as opposed to `/core/ups`.
17+
18+
In order to use Experience Platform APIs, you must have completed the [authentication tutorial](https://www.adobe.com/go/platform-api-authentication-en). Completing the authentication tutorial provides the values for each of the required headers in Experience Platform API calls, as shown below:
19+
20+
- Authorization: `Bearer {ACCESS_TOKEN}`
21+
- x-api-key: `{API_KEY}`
22+
- x-gw-ims-org-id: `{ORG_ID}`
23+
24+
All resources in [!DNL Experience Platform] are isolated to specific virtual sandboxes. All requests to [!DNL Experience Platform] APIs require a header that specifies the name of the sandbox in which the operation will take place:
25+
26+
- x-sandbox-name: `{SANDBOX_NAME}`
27+
28+
>[!NOTE]
29+
>
30+
>For more information on working with sandboxes in [!DNL Experience Platform], see the [sandboxes overview documentation](../../sandboxes/home.md).
31+
32+
**API format**
33+
34+
>[!IMPORTANT]
35+
>
36+
>You **must** include the `createAudienceMetaOnly=true` query parameter as part of the request.
37+
38+
```http
39+
POST /audiences?createAudienceMetaOnly=true
40+
```
41+
42+
**Request**
43+
44+
>[!IMPORTANT]
45+
>
46+
>You **must** include the `Accept: application/vnd.adobe.external.audiences+json; version=2` header as part of the API request.
47+
48+
```shell
49+
curl -X POST https://platform.adobe.io/core/ais/audiences?createAudienceMetaOnly=true \
50+
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
51+
-H 'Content-Type: application/json' \
52+
-H 'x-gw-ims-org-id: {ORG_ID}' \
53+
-H 'x-api-key: {API_KEY}' \
54+
-H 'x-sandbox-name: {SANDBOX_NAME}'\
55+
-H 'Accept: application/vnd.adobe.external.audiences+json; version=2'
56+
-d '{
57+
"name": "Sample audience name",
58+
"description" "A sample description for the audience.",
59+
"namespace": "agora",
60+
"originName": "Agora_Collaboration"
61+
}'
62+
```
63+
64+
| Property | Type | Description |
65+
| -------- | ---- | ----------- |
66+
| `name` | String | The name for the audience. |
67+
| `description` | String | An optional description for the audience. |
68+
| `namespace` | String | The namespace for the audience. |
69+
| `originName` | String | The name of the audience's origin. |
70+
71+
**Response**
72+
73+
A successful response returns HTTP status 200 with information about the newly created audience.
74+
75+
```json
76+
{
77+
"name": "Sample audience name",
78+
"audienceId": "4a815904-f2f9-4237-82fb-55605bcc2ad7"
79+
}
80+
```
81+
82+
| Property | Type | Description |
83+
| -------- | ---- | ----------- |
84+
| `name` | String | The name of the audience you created. |
85+
| `audienceId` | String | The ID of the audience you created. |

0 commit comments

Comments
 (0)