Skip to content

ref-server-side-token-generation.md

Latest commit

 

History

History
68 lines (47 loc) · 3.83 KB

ref-server-side-token-generation.md

File metadata and controls

68 lines (47 loc) · 3.83 KB
title Server-Side Token Generation
description パブリッシャー向けのサーバーサイドでのトークン生成に関する情報。
hide_table_of_contents false
sidebar_position 6
displayed_sidebar docs

import Link from '@docusaurus/Link'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

Server-Side Token Generation

パブリッシャーが Client-Server または Server-Side UID2 インテグレーションを設定する場合、最初のステップはサーバーで UID2 Token を生成することです。その後、トークンを Client-Side または Server-Side でリフレッシュし、RTB ビッドストリームに送信するためにトークンを Client-Side に渡すことができます。

パブリッシャーが Server-Side で直接識別情報 (DII) (メールアドレスまたは電話番号) を提供して UID2 Token を生成するための 2 つのアプローチがあります:

  • SDK のインテグレーション
  • API エンドポイントへのダイレクトインテグレーション

:::warning セキュリティ上の理由により、トークン生成に使用される API キーとシークレットは Server-Side で呼び出す必要があります。これらの値を Web ページ、モバイルアプリ、または Prebid に保存しないでください。詳細は、Security of API Key and Client Secret を参照してください。 :::

オプションは次の表にまとめられています。

Integration Solution Generate Token Refresh Token
SDK for Java ✅  ✅
SDK for Python  ✅ ✅
Direct integration (API endpoints with custom code) ✅ ✅
Identity (UID2 Token と関連する値) を生成するために選択したインテグレーションオプションに関係なく、次のいずれかを実装する必要があります:

  • SDK: UID2 Server-Side SDK を使用して、Publisher Client クラスのいずれかを使用します。これらのクラスは、リクエストを 1 つのメソッド呼び出しに簡素化します。

    手順は、次のいずれかを参照してください:

    SDK オプションを使用している場合、このガイドの残りの部分で必要な Identity レスポンスは、次のいずれかのメソッドの出力です:

    tokenGenerateResponse.getIdentityJsonString()
    token_generate_response.get_identity_json_string()

  • API: POST /token/refresh エンドポイントを呼び出します。

    このガイドの残りの部分で必要な Identity レスポンスは、成功したエンドポイントのレスポンスの body セクション内のコンテンツです。例は、Successful Response を参照してください。

:::important トークンを生成する DII が UID2 からオプトアウトされている場合、エンドポイントと SDK API はオプトアウトステータスを返します。この場合、情報を保存し、同じ DII に対してトークン生成エンドポイントを呼び出さないでください。 :::