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: docs/guides/integration-ctv-guide.md
+12-6Lines changed: 12 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ import PrivateOperatorOption from '../snippets/_private-operator-option.mdx';
13
13
14
14
# CTV Integration Guide
15
15
16
-
If you're a CTV publisher, there are several ways that you can integrate with UID2 to generate and refresh identity tokens to be passed into the RTB bidstream in the context of your CTV apps.
16
+
If you're a Connected TV (CTV) publisher, there are several ways that you can integrate with UID2 to generate and refresh identity tokens to be passed into the RTB bidstream in the context of your CTV apps.
17
17
18
18
## Key Integration Steps
19
19
At a high level, to integrate with UID2, you'll implement these three key steps:
@@ -116,14 +116,20 @@ The following table shows supported operating systems, with links to applicable
116
116
117
117
## Best Practices
118
118
119
-
The following points are best practices for Connected TV integrations:
119
+
The following points are best practices for CTV integrations:
120
120
121
-
- Rotate tokens well in advance. Top CTV ad activity is tied to traffic spikes during ad breaks; generating or refreshing UID2 tokens during these times is not ideal. Plan to have tokens generated or refreshed before these busy times.
121
+
-**Rotate tokens well in advance**
122
+
123
+
Top CTV ad activity is tied to traffic spikes during ad breaks; generating or refreshing UID2 tokens during these times is not ideal. Plan to have tokens generated or refreshed before these busy times.
122
124
123
125
If the token was refreshed before its expiration date, both new and old tokens are usable for a while, until the old token expires. The TTL (time to live) timestamp is part of the response body returned by the UID2 Operator when the token is generated or refreshed.
124
126
125
-
- The UID2 token is tied to a user's HEM or phone, not to the viewing session or app session. As long as you have a valid UID2 token for the user, there is no need to generate new UID2 for each new viewing session or app session. For example, if the user leaves your app and then opens the app again, there is no need to generate a new UID2 if the existing one is still fresh.
127
+
-**Rotate tokens only when needed**
128
+
129
+
The UID2 token is tied to a user's HEM or phone, not to the viewing session or app session. As long as you have a valid UID2 token for the user, there is no need to generate new UID2 for each new viewing session or app session. For example, if the user leaves your app and then opens the app again, there is no need to generate a new UID2 if the existing one is still fresh.
130
+
131
+
-**Use the same token for multiple ad slots within a pod**
126
132
127
-
- As long as the UID2 token is valid throughout the pod duration, you can use it for any ad slot within the pod.
133
+
As long as the UID2 token is valid throughout the pod duration, you can use it for any ad slot within the pod.
128
134
129
-
In summary: ideally, if you follow these guidelines, there is no need to generate a new UID2 token during an ad break.
135
+
Ideally, if you follow these guidelines, there is no need to generate a new UID2 token during an ad break.
0 commit comments