次の方法で共有

ユーザー ID を同期する

  • [アーティクル]

このページでは、ユーザー ID の同期の概要と、Xandr ユーザー ID と入札者が認識するユーザー ID の間のマッピングの詳細について説明します。

bidder と Xandr の統合は、サーバー側の統合です。 これは、以下のことを意味します。

  • Xandr のインプレッション バスと入札者インスタンスの間で厳密に通信が行われます
  • 入札プロセス中に、ユーザーのブラウザでクッキーに直接アクセスすることはできません

供給パートナーからサーバー側の統合によって印象を受ける場合、ユーザーのブラウザーで Cookie にアクセスすることはできません。 このため、供給パートナーとのユーザー同期を実行します。 これにより、Xandr ユーザー ID と供給パートナー ID の間にマッピングが行われます。 マッピングは、Xandr、サーバー側の Cookie ストア、またはサプライ パートナーによって保存できます。

入札者とデータ プロバイダーも同様のソリューションを利用できます。 同期を実行するには、まずマッピングを格納する場所を特定する必要があります。

警告

この同期を行うには、入札者をアクティブに設定するか、データ プロバイダーを アクティブ に設定する必要があります。

Xandr を使用したマッピングの格納

注:

2019 年 4 月 22 日から、Xandr は userdata_javascript フィールドと setuid_function フィールドをサポートしなくなりました。 Bidders は setuid 呼び出しを直接行うことができます。

Xandr を使用してマッピングを格納するには、

  1. Bidder サービスの bidder の "userdata_javascript" フィールドに次の関数を追加します。

       function setuid(code){ ud.uid = code; }

  2. 次に、 Bidder サービス の [setuid_function] フィールドを次のように設定します。

    setuid

  3. これで、ピクセル呼び出し内で次の URL を使用して、ユーザー ID をユーザーの Cookie と Xandr サーバー側 Cookie ストアにプッシュできます。

    https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[USER_ID]

  4. [BIDDER_ID] を、入札者の ID (Bidder Service から入手できます) と [USER_ID] を、そのユーザー用に保存したユーザー ID に置き換えます。

    "gdpr" と "gdpr_consent" のページで TCF シグナルを使用できる場合は、/setuid url の末尾に GET パラメーターを含める必要があります。

    https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[UID]&gdpr=[GDPR_APPLIES]&gdpr_consent=[GDPR_CONSENT_STRING]

    警告

    2019 年 4 月 22 日の時点で、Xandr は入札要求の [ "userdata_json" ] フィールドをサポートしなくなりました。 "buyeruid" フィールドを使用して、一意のユーザー ID を受け取ることができます。

    次の例のように、入札要求の [ "userdata_json" ] フィールドの一部としてユーザー ID を受け取ります。

{
  "bid_request": {
      ...
      "bid_info": {
          ...,
          "userdata_json": "{\"global_freq\":3,\"last_seen\":1237220391,\"uid\":\"HeVQkH6inotalk0Livh8Vw\"}",
          ...
      },
      ...
  }
}

次の例のように、入札要求の "buyeruid" フィールドの一部としてユーザー ID を受け取ります。

{
    "request": {
        ...
        "user": {
            ...,
            "buyeruid": "HeVQkH6inotalk0Livh8Vw",
            ...
        },
        ...
    }
}

setUID の例

https://ib.adnxs.com/setuid?entity=123&code=HeVQkH6inotalk0Livh8Vw&gdpr=1&gdpr_consent=CPaPwEAPaPwEAACAKAFRBWCgAP_AAH_AAAqIHttf_X__b3_j-_59__t0eY1f9_7_v-0zjhfdt

Bidder/Data Provider の格納済みマッピング

特定のユーザーの Xandr ユーザー ID を抽出するには、ピクセル呼び出しを介してユーザーを getUID サービスに誘導します。 インプレッション バスは、getUID 呼び出しで指定された URL にユーザーをリダイレクトし、ユーザー ID マクロをそのユーザー用に保存した ID に置き換えます。 このプロセスにより、そのユーザーのブラウザーで Cookie にアクセスでき、ID を読み取ることができます。

getUID サービスの形式は次のとおりです。

https://ib.adnxs.com/getuid?[REDIRECT_URL]

リダイレクトには、$UID形式のユーザー ID マクロと、そのユーザーの ID が含まれている必要があります。 次の呼び出しの例では、次のようになります。

  1. ユーザーにhttps://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UIDを指示する
  2. $UID マクロを a9f4072b-ec2d-42cb-8930-e3388a7d47c2 に置き換えます
  3. ユーザーを にリダイレクトする https://ad.adserver.com/pixel?adnxs_uid=a9f4072b-ec2d-42cb-8930-e3388a7d47c2

"gdpr" と "gdpr_consent" のページで TCF シグナルを使用できる場合は、/getuid URL の末尾に GET パラメーターを含める必要があります。

https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&gdpr=[GDPR_APPLIES]&gdpr_consent=[GDPR_CONSENT_STRING]

getUID の例

https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&gdpr=1&gdpr_consent=CPaPwEAPaPwEAACAKAFRBWCgAP_AAH_AAAqIHttf_X__b3_j-_59__t0eY1f9_7_v-0zjhfdt

次の手順: 通知要求を受信する

プライバシーに関する考慮事項

注:

どちらのエンドポイントでも、リダイレクト URL に TCF パラメーターが渡された場合、Xandr はこれらのパラメーターを使用して、Cookie 同期を実行できるかどうかを判断します。 受信したシグナルが十分な法的根拠がないと解釈された場合、Xandr は Cookie 同期要求を処理できず、次のエラー メッセージが返されます。"プライバシーシグナルが原因で要求が失敗しました" というエラー メッセージが返されます。さらに、URL を呼び出すときに TCF シグナルを指定できない場合、パートナーは 同意 パラメーターを URL に追加する必要があります。 consent パラメーターはバイナリ値を受け入れます。ユーザーが同意した場合は 1、同意が拒否された場合は 0 です。 特定の地理的領域でユーザー同期を実行するには、このパラメーターを含める必要があります。

URL で consent パラメーターを使用する方法については、次の例を参照してください。

https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&consent=1


https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&consent=0


https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[UID]&consent=1

ユーザーの同意がない setuid 呼び出しの例

https://ib.adnxs.com/setuid?entity=[BIDDER_ID]&code=[UID]&consent=0