Skip to content

Create Segment

There are two types of segments that users can upload to Blockgraph Platform:

1. Blockgraph ID (BG ID) Segment

The Blockgraph platform enables participants to create segments by uploading a formatted data file containing supported identity signals. There are two types of segments that users can create and upload to the Blockgraph platform.

a. Using your own identity

  • Upload a file of supported signals, which will be resolved against your node's identity layer to produce BG IDs.

Supported Signals in the data file

  • Household ID (Record ID)
  • Blockgraph ID
  • Postal Address
  • IP Address
  • Email address
  • IDFA
  • AAID
  • STB IDs
  • Zipcode
API Sequence to Create a Segment
  1. Load Segment File:
    • For files up to 150MB: Use POST file API
    • For files larger than 150MB: Upload directly to the provided S3 bucket (contact support for bucket details and credentials)
  2. Validate that this file was loaded via GET file API
  3. Create segment via POST Segment API
  4. Monitor job status to verify that it's completed via GET Jobs API

b. Using a partner's identity

  • Upload a file of supported signals, which will be resolved against a partner's identity layer to produce BG IDs.

Supported Signals in the data file

  • Postal Address
  • IP Address
  • Email address
  • IDFA
  • AAID
  • STB IDs
  • Zipcode
API Sequence to Create a Lookup Segment
  1. Load Segment File:
    • For files up to 150MB: Use POST file API
    • For files larger than 150MB: Upload directly to the provided S3 bucket (contact support for bucket details and credentials)
  2. Validate that this file was loaded via GET file API
  3. Get Partner ID GET Partners API
  4. Create segment via POST Segment API
  5. Monitor job status to verify that it's completed via GET Jobs API

2. Segment of Hashed Signals

Resultant segment of Hashed Signals can be uploaded to nodes that do not have identity.

Supported Signals

  • Postal Address
  • IP Address
  • Email address
  • IDFA
  • AAID
  • STB ID
API Sequence to create a segment of hashed signals
  1. Load Segment File:
    • For files up to 150MB: Use POST file API
    • For files larger than 150MB: Upload directly to the provided S3 bucket (contact support for bucket details and credentials)
  2. Validate that this file was loaded via GET file API
  3. Create segment via POST Segment API
  4. Monitor job status to verify that it's completed via GET Jobs API