examples.md

Example Payload

{
  "data_set_id": "12345678AA",
  "id": "12ab123456c1234",
  "timestamp": 1746558464,
  "event_type": "purchase",
  "custom_event": null,
  "value": 22.00,
  "currency_code": "USD",
  "source": "website",

  "user_data": {
    "customer_identifier": "123456789123456789",
    "customer_segment": "loyalist",
    "email_addresses": ["d7133d32a78e3ceb672ca127d549dbbaab93d4f7276656099c07ffe1889b3783"],
    "phone_numbers":   ["1fa6b8d986d9b9cd01bf36951815158bbde9f520c0567c835dfe34783d0a4231"],
    "timezone": "EST",
    "opt_out": 0,
    "age_range": 2,
    "gender": "<sha256-hashed-initial>",
    "event_ip_address": "<valid-ipv4-or-ipv6>",
    "event_user_agent": "<browser-user-agent-string>",
    "landing_ip_address": "72f1c97b29994ad08c3636903b235ad7b6b4ca8ee82f642cfdaf45b88a72a2b9",
    "landing_user_agent": "<browser-user-agent-string>",
    "click_id": "<platform-click-id>",
    "impression_id": "<platform-impression-id>",
    "ifa": "<device-advertising-id>",
    "gpp_string": "<gpp-consent-string>",
    "gpp_sid": [6],
    "addresses": [
      {
        "first_name":    "bb472edb86809a761936d90c70aeb4346618aa71da7a00c16e334863499108fd",
        "last_name":     "799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f",
        "street":        "2d64b9a92b81afe0955c5ba76a446daa82bee950d19351f57748dcc99dbc9135",
        "city":          "4df296148e439b91d3d12e4c680489f80c429ad7b745375f5f90011738ad8532",
        "state":         "49a6d05b8e4b516656e464271d9dd38d0a7e0142f7f49546f4dabd2720cafc34",
        "country_code":  "79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621",
        "postal_code":   "5994471abb01112afcc18159f6cc74b4f511b99806da59b3caf5a9c173cacfc5",
        "address_type":  "billing",
        "ext": {}
      }
    ],
    "ext": {}
  },

  "properties": {
    "transaction_id": "AAA123456789A",
    "page_url": "https://www.jondoeAI.com",
    "ad_source": "facebook",
    "ad_platform": "amazon",
    "ad_format": "display_ads",
    "ad_unit_name": "banner_ads",
    "shipping": 11.00,
    "tax": 1.00,
    "payment_type": ["credit_card"],
    "shipping_tier": "premium",
    "promotion_id": "1222371AA892123",
    "promotion_name": "Holiday_campaign",
    "creative_slot": "Holiday_homepage_takeover",
    "search_term": "toys for kids",
    "coupon": [],
    "referrer": null,
    "virtual_currency_name": "USD",
    "virtual_item_name": null,
    "lead_source": null,
    "lead_status": null,
    "lead_reason": null,
    "method": null,
    "group_id": null,
    "level": null,
    "character": null,
    "score": null,
    "achievement_id": null,
    "creative_name": null,
    "items": [
      {
        "id":                 "<upc-or-sku>",
        "name":               "<product-name>",
        "price":              "29.99",
        "discount":           5.00,
        "quantity":           2,
        "brand":              "<brand-name>",
        "affiliation":        "<store-or-supplier>",
        "category":           "<iab-category>",
        "cattax":             "<taxonomy-id>",
        "items_coupon":       "<coupon-code>",
        "items_list_id":      "<list-id>",
        "items_list_name":    "<list-name>",
        "items_item_variant": "<variant-code>",
        "items_location_id":  "<location-id>",
        "ext": {}
      }
    ],
    "ext": {}
  },

  "ext": {}
}

Example user_data JSON

The example below represents an impression with user data normalized and hashed. See the Normalization examples section for the raw and normalized values corresponding to the hashed fields.

{
  "customer_identifier": "e606e38b0d8c19b24cf0ee3808183162ea7cd63ff7912dbb22b5e803286b4446",
  "uids": [
    {
      "id": "ad57366865126e55649ecb23ae1d48887544976efea46a48eb5d85a6eeb4d306",
      "source": "example.com",
      "atype": 1
    }
  ],
  "customer_segments": [
    "gold_member",
    "frequent_shopper"
  ],
  "email_address": [
    "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"
  ],
  "phone_numbers": [
    "7c8d08bf90ca322bcac37f99ba14e980e4b1f5ba919f7e16a030af9070ba125e"
  ],
  "utcoffset": -300,
  "address": [
    {
      "first_name": "81f8f6dde88365f3928796ec7aa53f72820b06db8664f5fe76a7eb13e24546a2",
      "last_name": "6627835f988e2c5e50533d491163072d3f4f41f5c8b04630150debb3722ca2dd",
      "city": "new york",
      "state": "ny",
      "country_code": "us",
      "postal_code": "e443169117a184f91186b401133b20be670c7c0896f9886075e5d9b81e9d076b"
    }
  ],
  "gpp_string": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN",
  "gpp_sid": [
    7
  ],
  "impression_id": "imp_123abc",
  "event_ip_address": "172.16.254.3",
  "event_user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36",
  "ifa": "38400000-8cf0-11bd-b23e-10b96e40000d",
  "age_range": 5,
  "gender": "9f165139a8c2894a47aea23b77d330eca847264224a44d5a17b19db8b9a72c08",
  "ext": {
    "partner_billing": true
  }
}

Normalization examples:

Field	Raw	Normalized	SHA256
customer_identifier	User123	user123	e606e38b0d8c19b24cf0ee3808183162ea7cd63ff7912dbb22b5e803286b4446
email_address	User@example.com	user@example.com	b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514
phone_numbers	+1 212-555-0000	+12125550000	7c8d08bf90ca322bcac37f99ba14e980e4b1f5ba919f7e16a030af9070ba125e
address.first_name	Jane	jane	81f8f6dde88365f3928796ec7aa53f72820b06db8664f5fe76a7eb13e24546a2
address.last_name	Smith	smith	6627835f988e2c5e50533d491163072d3f4f41f5c8b04630150debb3722ca2dd
gender	Female	female	9f165139a8c2894a47aea23b77d330eca847264224a44d5a17b19db8b9a72c08