You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: implementation.md
+34-34Lines changed: 34 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1564,13 +1564,13 @@ For an Exchange to properly disclose that an ID substitution has occurred by a p
1564
1564
1565
1565
If a linkage is made by any party (e.g. a SSP to a DSP cookie ID) based on an incoming EID where <code>mm</code> does not equal 1 or 2, then the ID sent to the recipient must inherit the <code>mm</code> value of the incoming Extended Identifier (EID). For example, if a SSP receives an ID based on any kind of matching (<code>mm</code> values 3,4, or 5), then even if the ID they send to the DSP is based on a cookie exchange, it must also indicate that matching occurred (i.e. <code>mm</code> values 3,4, or 5).
1566
1566
1567
-
Example 4 below outlines a workflow where an SSP is able to match to the DSP ID based on a Cookie Based Sync (<code>mm</code>=2) but becasue they recieved a bridged ID from the publisher (<code>mm</code>=3) they retain the match method of 3 to the DSP.
1567
+
Example 4 below outlines a workflow where an SSP is able to match to the DSP ID based on a Cookie Based Sync (<code>mm</code>=2) but because they received a bridged ID from the publisher (<code>mm</code>=3) they retain the match method of 3 to the DSP.
1568
1568
1569
1569
Items in the EID array with <code>mm</code> values of 1 or 2 are generally optional/informational, but some buyers may find it useful for sellers to provide them.
1570
1570
1571
1571
### 7.12.2 - Roles Overview
1572
-
- <code>inserter</code> is the party that’s putting the ID into the bid request - Typically a Publisher or an SSP. In other words, the party that made the decision to put the id in the bidstream. In the case of header bidders, the <code>inserter</code> is the Publisher.<br></br>
1573
-
- <code>source</code>is the party that defined/created an ID. In the case of universal or alt-IDs, it’s the domain of the party who defined/created the ID itself. In the case of cookie IDs, it’s the domain of the party who the cookie belongs to.<br>
1572
+
- <code>inserter</code> is the party that’s putting the ID into the bid request - Typically a Publisher or an SSP. In other words, the party that made the decision to put the ID in the bidstream. In the case of header bidders, the <code>inserter</code> is the Publisher.<br></br>
1573
+
- <code>source</code>is the party that defined/created an ID. In the case of universal or alt-IDs, it’s the domain of the party who defined/created the ID itself. In the case of cookie IDs, it’s the domain of the party who the cookie belongs to Prior to sending a partner’s cookie, you are strongly encouraged to verify their preferred EID <code>source</code> value.<br>
1574
1574
- <code>matcher</code> is the party that created the match included in the ID array, this could be a device graph vendor, or the publisher themselves.
1575
1575
1576
1576
### 7.12.3 - Signaling both Agent Type and Match Method
@@ -1609,7 +1609,7 @@ Different iterations of possible combinations are listed in the following table.
@@ -1624,7 +1624,7 @@ Different iterations of possible combinations are listed in the following table.
1624
1624
```
1625
1625
1626
1626
#### 7.12.4.2 Derived IDs for a Single Property
1627
-
There exist scenarios in which a party may use an alternate approach to infer a DSP cookie user ID or IFA that is believed to apply or be related to the user, but cannot be directly observed. These scenarios should be conveyed using the below mechanism.
1627
+
There exist scenarios in which a party may use an alternate approach to infer a partners (typically a DSP or SSP) cookie user ID or IFA that is believed to apply or be related to the user, but cannot be directly observed. These scenarios should be conveyed using the below mechanism.
1628
1628
1629
1629
##### Example 3: Request from Pub → SSP, user ID matched on hashed email, cookie not observable by SSP in the customary way
1630
1630
@@ -1639,7 +1639,7 @@ There exist scenarios in which a party may use an alternate approach to infer a
1639
1639
"mm": "3",
1640
1640
"uids": [
1641
1641
{
1642
-
"id": "fac13741-0648-436a-88cf-aceafdf45c9a",
1642
+
"id": "ZK5GQGDZ-M-DK5U",
1643
1643
"atype": "3"
1644
1644
}
1645
1645
]
@@ -1650,7 +1650,7 @@ There exist scenarios in which a party may use an alternate approach to infer a
1650
1650
```
1651
1651
Note that there is no <code>buyeruid</code> in the example above. If the SSP does not have an explicit agreement from the DSP that they want to receive matched IDs in the <code>buyeruid</code> field, they would simply forward the above request to the DSP (either removing the eids array if the DSP doesn’t want to receive IDs from graphvendor.com, or retaining the array if the DSP does want to receive IDs from graphvendor.com in eids).
1652
1652
1653
-
##### Example 4: Request from SSP → DSP corresponding to the above request from pub, where the SSP has set the DSP’s buyeruid based on a hosted cookie match table and the bridged ID they received from the pub (based on prior arrangement with the DSP only)
1653
+
##### Example 4: Request from SSP → DSP corresponding to the above request from pub, where the SSP has set the DSP’s buyeruid based on a hosted cookie match table look up using the bridged ID they received from the pub (based on prior arrangement with the DSP only)
1654
1654
1655
1655
If an arrangement exists to put a matched DSP ID in <code>buyeruid</code>, that would be done as follows:
1656
1656
@@ -1659,16 +1659,16 @@ If an arrangement exists to put a matched DSP ID in <code>buyeruid</code>, that
@@ -1679,7 +1679,7 @@ If an arrangement exists to put a matched DSP ID in <code>buyeruid</code>, that
1679
1679
"mm": "3",
1680
1680
"uids": [
1681
1681
{
1682
-
"id": "3d89748d-74bb-44f1-9908-298090dc2944",
1682
+
"id": "FQAGL4yyYwOBNgDZ4PUqAQA8ewN",
1683
1683
"atype": "1"
1684
1684
}
1685
1685
]
@@ -1691,30 +1691,30 @@ If an arrangement exists to put a matched DSP ID in <code>buyeruid</code>, that
1691
1691
note that <code>mm</code> value of 3 is retained in this example, because the match is built on top of an ID that was itself based on cross-domain authentication (e.g. via hashed email)
1692
1692
1693
1693
#### 7.12.4.3 Derived IDs Across Multiple Properties or Devices
1694
-
##### Example 5: SSP matches their own ID to an email-based hash to provide a universal ID to the DSP in the buyeruid field (based on prior arrangement to put it in buyeruid)
1694
+
##### Example 5: SSP matches their ID to an email-based hash to provide a universal ID to the DSP in the buyeruid field (based on prior arrangement to put it in buyeruid)
@@ -1723,65 +1723,65 @@ note that <code>mm</code> value of 3 is retained in this example, because the ma
1723
1723
}
1724
1724
}
1725
1725
```
1726
-
##### Example 6: On a CTV request, the publisher also provides the IFA and an alternative ID of an Apple device within that same household, based on authenticated logins across apps
1726
+
##### Example 6: On a CTV request, the publisher also provides the IFA of the TV and an alternative ID of an Apple device within that same household, based on authenticated logins across apps
1727
1727
1728
1728
```
1729
1729
{
1730
+
"device": {
1731
+
"ifa": "df3a42f4-a388-43e9-a691-b0d308c963b4"
1732
+
},
1730
1733
"user": {
1731
1734
"eids": [
1732
1735
{
1733
-
"matcher": "app-pub.com",
1734
1736
"inserter": "app-pub.com",
1737
+
"matcher": "app-pub.com",
1735
1738
"source": "apple.com",
1736
-
"mm": "3",
1739
+
"mm": 3,
1737
1740
"uids": [
1738
1741
{
1739
1742
"id": "fac13741-0648-436a-88cf-aceafdf45c9a",
1740
-
"atype": "2"
1743
+
"atype": 2
1741
1744
}
1742
1745
]
1743
1746
},
1744
-
{
1745
-
"matcher": "app-pub.com",
1747
+
{
1746
1748
"inserter": "app-pub.com",
1749
+
"matcher": "app-pub.com",
1747
1750
"source": "alt-id.org",
1748
-
"mm": "3",
1751
+
"mm": 3,
1749
1752
"uids": [
1750
1753
{
1751
1754
"id": "e7f8c5f2-6b4e-4565-8b0a-53d8b730143e",
1752
-
"atype": "3"
1755
+
"atype": 3
1753
1756
}
1754
1757
]
1755
1758
}
1756
1759
]
1757
-
},
1758
-
"device": {
1759
-
"ifa": "df3a42f4-a388-43e9-a691-b0d308c963b4"
1760
1760
}
1761
1761
}
1762
1762
```
1763
1763
1764
1764
##### Example 7: On a CTV request, the publisher provides the IFA of the TV, but also adds the IFA of an Apple device within that same household to the extended IDs array, based on the household’s IP and a device graph
1765
1765
```
1766
1766
{
1767
+
"device": {
1768
+
"ifa": "df3a42f4-a388-43e9-a691-b0d308c963b4"
1769
+
},
1767
1770
"user": {
1768
1771
"eids": [
1769
1772
{
1770
-
"matcher": "graphvendor.com",
1771
1773
"inserter": "app-pub.com",
1774
+
"matcher": "graphvendor.com",
1772
1775
"source": "apple.com",
1773
-
"mm": "5",
1776
+
"mm": 5,
1774
1777
"uids": [
1775
1778
{
1776
1779
"id": "fac13741-0648-436a-88cf-aceafdf45c9a",
1777
-
"atype": "2"
1780
+
"atype": 2
1778
1781
}
1779
1782
]
1780
1783
}
1781
1784
]
1782
-
},
1783
-
"device": {
1784
-
"ifa": "df3a42f4-a388-43e9-a691-b0d308c963b4"
1785
1785
}
1786
1786
}
1787
1787
```
@@ -1797,7 +1797,7 @@ note that <code>mm</code> value of 3 is retained in this example, because the ma
0 commit comments