Knowledge Base

Below is the reference documentation for sending (or syncing) a dataset to Google Ads via Narrative’s Connections endpoint. For more information on the Narrative API, visit api.narrative.io.

Endpoint

POST https://app.narrative.io/connections

Request Body

{
    "dataset_id": 1234,
    "profile_id": "09b9a6fc-23c7...",
    "quick_settings": {
        "type": "audience_first_party_new",
        "description": "profile description",
        "historical_data_enabled": true,
        "membership_duration": 10000,
        "name": "my google ads segment name"
    }
}

• dataset_id: The numeric identifier of your dataset in Narrative.
• profile_id: The Google Ads Connector profile ID.
• quick_settings:
  • type: Typically audience_first_party_new for a new Google Ads Customer Match list.
  • description: An optional field to describe the audience.
  • historical_data_enabled: Include matching historical records if true.
  • membership_duration: Number of days to keep a user in the list.
  • name: A user-friendly name for the new Google Ads audience.

Response

Status Code: 201 Created

{
    "id": "56479971-af2d...",
    "dataset_id": 1234,
    "quick_settings": {
        "name": "my google ads segment name",
        "type": "audience_first_party_new",
        "description": "profile description",
        "membership_duration": 10000,
        "historical_data_enabled": true
    },
    "profile_id": "09b9a6fc-23c7...",
    "status": "active"
}