Skip to content

Commit 0ac40a7

Browse files
authored
Errata in ID Bridging Imp Guidance
Changing IDs to be distinct to their specific examples and typos
1 parent 696fcb2 commit 0ac40a7

File tree

1 file changed

+34
-34
lines changed

1 file changed

+34
-34
lines changed

implementation.md

Lines changed: 34 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1564,13 +1564,13 @@ For an Exchange to properly disclose that an ID substitution has occurred by a p
15641564

15651565
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).
15661566

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.
15681568

15691569
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.
15701570

15711571
### 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>
15741574
- <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.
15751575

15761576
### 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.
16091609
```
16101610
{
16111611
"user": {
1612-
"buyeruid": "fac13741-0648-436a-88cf-aceafdf45c9a"
1612+
"buyeruid": "FQAGL4yyYwOBNgDZ4PUqAQA8ewN"
16131613
}
16141614
}
16151615
```
@@ -1624,7 +1624,7 @@ Different iterations of possible combinations are listed in the following table.
16241624
```
16251625

16261626
#### 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.
16281628

16291629
##### Example 3: Request from Pub → SSP, user ID matched on hashed email, cookie not observable by SSP in the customary way
16301630

@@ -1639,7 +1639,7 @@ There exist scenarios in which a party may use an alternate approach to infer a
16391639
"mm": "3",
16401640
"uids": [
16411641
{
1642-
"id": "fac13741-0648-436a-88cf-aceafdf45c9a",
1642+
"id": "ZK5GQGDZ-M-DK5U",
16431643
"atype": "3"
16441644
}
16451645
]
@@ -1650,7 +1650,7 @@ There exist scenarios in which a party may use an alternate approach to infer a
16501650
```
16511651
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).
16521652

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)
16541654

16551655
If an arrangement exists to put a matched DSP ID in <code>buyeruid</code>, that would be done as follows:
16561656

@@ -1659,16 +1659,16 @@ If an arrangement exists to put a matched DSP ID in <code>buyeruid</code>, that
16591659
```
16601660
{
16611661
"user": {
1662-
"buyeruid": "3d89748d-74bb-44f1-9908-298090dc2944",
1662+
"buyeruid": "FQAGL4yyYwOBNgDZ4PUqAQA8ewN",
16631663
"eids": [
16641664
{
1665-
"matcher": "graphvendor.com",
16661665
"inserter": "pub.com",
1666+
"matcher": "graphvendor.com",
16671667
"source": "sspdomain.com",
16681668
"mm": "3",
16691669
"uids": [
16701670
{
1671-
"id": "fac13741-0648-436a-88cf-aceafdf45c9a",
1671+
"id": "ZK5GQGDZ-M-DK5U",
16721672
"atype": "3"
16731673
}
16741674
]
@@ -1679,7 +1679,7 @@ If an arrangement exists to put a matched DSP ID in <code>buyeruid</code>, that
16791679
"mm": "3",
16801680
"uids": [
16811681
{
1682-
"id": "3d89748d-74bb-44f1-9908-298090dc2944",
1682+
"id": "FQAGL4yyYwOBNgDZ4PUqAQA8ewN",
16831683
"atype": "1"
16841684
}
16851685
]
@@ -1691,30 +1691,30 @@ If an arrangement exists to put a matched DSP ID in <code>buyeruid</code>, that
16911691
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)
16921692

16931693
#### 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)
16951695
```
16961696
{
16971697
"user": {
1698-
"buyeruid": "fac13741-0648-436a-88cf-aceafdf45c9a",
1698+
"buyeruid": "JE6!-1XvQEfD3cLpz7k1zAgY85k0PRJgkXdno7R2NXvKVhKsoSY8qpSb",
16991699
"eids": [
17001700
{
17011701
"source": "sspdomain.com",
17021702
"mm": "1",
17031703
"uids": [
17041704
{
1705-
"id": "3d89748d-74bb-44f1-9908-298090dc2944",
1705+
"id": "ZK5GQGDZ-M-DK5U",
17061706
"atype": "1"
17071707
}
17081708
]
17091709
},
17101710
{
1711-
"matcher": "idvendor.com",
17121711
"inserter": "sspdomain.com",
1712+
"matcher": "idvendor.com",
17131713
"source": "universalid.com",
17141714
"mm": "5",
17151715
"uids": [
17161716
{
1717-
"id": "fac13741-0648-436a-88cf-aceafdf45c9a",
1717+
"id": "JE6!-1XvQEfD3cLpz7k1zAgY85k0PRJgkXdno7R2NXvKVhKsoSY8qpSb",
17181718
"atype": "3"
17191719
}
17201720
]
@@ -1723,65 +1723,65 @@ note that <code>mm</code> value of 3 is retained in this example, because the ma
17231723
}
17241724
}
17251725
```
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
17271727

17281728
```
17291729
{
1730+
"device": {
1731+
"ifa": "df3a42f4-a388-43e9-a691-b0d308c963b4"
1732+
},
17301733
"user": {
17311734
"eids": [
17321735
{
1733-
"matcher": "app-pub.com",
17341736
"inserter": "app-pub.com",
1737+
"matcher": "app-pub.com",
17351738
"source": "apple.com",
1736-
"mm": "3",
1739+
"mm": 3,
17371740
"uids": [
17381741
{
17391742
"id": "fac13741-0648-436a-88cf-aceafdf45c9a",
1740-
"atype": "2"
1743+
"atype": 2
17411744
}
17421745
]
17431746
},
1744-
{
1745-
"matcher": "app-pub.com",
1747+
{
17461748
"inserter": "app-pub.com",
1749+
"matcher": "app-pub.com",
17471750
"source": "alt-id.org",
1748-
"mm": "3",
1751+
"mm": 3,
17491752
"uids": [
17501753
{
17511754
"id": "e7f8c5f2-6b4e-4565-8b0a-53d8b730143e",
1752-
"atype": "3"
1755+
"atype": 3
17531756
}
17541757
]
17551758
}
17561759
]
1757-
},
1758-
"device": {
1759-
"ifa": "df3a42f4-a388-43e9-a691-b0d308c963b4"
17601760
}
17611761
}
17621762
```
17631763

17641764
##### 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
17651765
```
17661766
{
1767+
"device": {
1768+
"ifa": "df3a42f4-a388-43e9-a691-b0d308c963b4"
1769+
},
17671770
"user": {
17681771
"eids": [
17691772
{
1770-
"matcher": "graphvendor.com",
17711773
"inserter": "app-pub.com",
1774+
"matcher": "graphvendor.com",
17721775
"source": "apple.com",
1773-
"mm": "5",
1776+
"mm": 5,
17741777
"uids": [
17751778
{
17761779
"id": "fac13741-0648-436a-88cf-aceafdf45c9a",
1777-
"atype": "2"
1780+
"atype": 2
17781781
}
17791782
]
17801783
}
17811784
]
1782-
},
1783-
"device": {
1784-
"ifa": "df3a42f4-a388-43e9-a691-b0d308c963b4"
17851785
}
17861786
}
17871787
```
@@ -1797,7 +1797,7 @@ note that <code>mm</code> value of 3 is retained in this example, because the ma
17971797
"mm": "4",
17981798
"uids": [
17991799
{
1800-
"id": "fac13741-0648-436a-88cf-aceafdf45c9a"
1800+
"id": "ca0b9ab6-322a-4928-a849-798df75d2042"
18011801
}
18021802
]
18031803
}

0 commit comments

Comments
 (0)