Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

adds opja extension #138

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 49 additions & 0 deletions extensions/2.x_official_extensions/opja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
### Open Private Join & Activation (OPJA)

**Goal**:

The goal is to support a protocol for sending [OPJA](https://iabtechlab.com/blog/wp-content/uploads/2023/06/Open-Private-Join-Activation_Version_1.011.pdf) encrypted matching labels using OpenRTB 2.x.

**Requested Changes**:

Addition to **User Extension** Object

### Details

Open Private Join & Activation (OPJA) is a protocol for enabling two parties to privately generate activation matches.
OPJA uses advanced cryptographic techniques to keep private data securely encrypted throughout all steps of the process.
therevoltingx marked this conversation as resolved.
Show resolved Hide resolved
Note, it is assumed that parties will collaborate with the appropriate regulatory agencies and vendor(s) to ensure compliance.

A new field under `BidRequest->user->ext` is specified which is named `ojpa`.
It is an array of objects describing match jobs, each could be generated by one or more matching vendors.

Below we describe each field within each match job object:

| Key | Type | Description |
| ------------------- | ---------------- | ------------------------------------------- |
| name | String | The human readable name of the matching job |
therevoltingx marked this conversation as resolved.
Show resolved Hide resolved
| matches | Array of Objects | An array of objects containing encrypted matching labels |
| matches[].id | String | The match transaction ID which is unique to each match job row |
| matches[].el | String | The encrypted label which can be used to determine a match |
therevoltingx marked this conversation as resolved.
Show resolved Hide resolved

Example Request

```
{
"user": {
"ext": {
"opja": [
{
"name": "matching-system-operator.com",
"matches": [
{
"id": "0x1234",
"el": "0x45668"
therevoltingx marked this conversation as resolved.
Show resolved Hide resolved
}
]
}
]
}
}
}
```