ユーザーに関する内部オフライン データを、意思決定に使用できるように Microsoft Advertising サーバー側の Cookie ストア に挿入する必要がある場合があります。 その場合は、今後の要求でユーザー ID を照合できるように、まず内部ユーザー ID と Microsoft 広告ユーザー ID をマッピングする必要があります。 マッピングを自社のシステムに保存するか、Microsoft のシステムに保存するかに応じて、ピクセル呼び出しを使用してこれを行うには、mapUID と getUID の 2 つの方法があります。
getUID サービスは Microsoft 広告識別子を取得して、社内 ID サーバー側または Cookie 空間で調整できるようにします。 次に、「Microsoft 広告ユーザー ABC を次のセグメント データで更新してください」というオフライン データ フィードを渡すことができます。 mapUID サービスは、Microsoft 広告 Cookie ストア内の Microsoft 広告 ID にマッピングするために、内部 ID を Microsoft に渡します。
注:
以下で説明する Microsoft Advertising ユーザー ID マクロは $UIDであることに注意してください。 他の多くのマクロとは異なり、このマクロには中かっこがありません。
基本的なマッピングの例
| Prostarr ユーザー ID | PS123 |
| Microsoft Advertising ユーザー ID | 2894234234 |
| 靴の購入者セグメント ID | 0005 |
広告主の Prostarr がユーザー PS123 がセグメント 0005 にあると通知した場合、これは私たちにとって何の意味もありません。 代わりに、ユーザー 2894234234 がセグメント 0005 にあることを伝える必要があります。
これを行うために、Prostarr は GetUID サービスを使用してすべての Microsoft Advertising および Prostarr Sportswear ユーザー ID の以前のマッピングを行い、そのマッピングを内部データベースに保存しました。 GetUID 呼び出しは次のようになります
https://ib.adnxs.com/getuid?URL
ここで、URL はマッピングの転送先の URL です。 このピクセルは Prostarr の Web ページ上に配置され、起動時に、インプレッション バスが $UID マクロを置き換えて Microsoft 広告ユーザー ID を URL に挿入します。
ヒント
この機能の詳細なチュートリアルについては、「 ユーザー マッピングのビジュアルとチュートリアル」を参照してください。
getUID サービス
選択した URL は、クエリ文字列パラメーターとして Microsoft 広告ユーザー ID を使用したクライアント側の呼び出しを受け取ります。 広告呼び出し中に、Microsoft Advertising によってメンバーの目的の URL にユーザーがリダイレクトされます。 インプレッション バスは、 $UID マクロを置き換えるか、URL の末尾に追加することによって、Microsoft 広告ユーザー ID を URL に挿入します。 ユーザーが Microsoft Advertising Cookie を持っていない場合、"0" が返され、Microsoft Advertising は Cookie を作成しようとします。 ただし、ユーザーが getuid 呼び出しに初めて遭遇した場合は、"0" は返されません。
コード
getUID サービスの形式は非常に単純です。
https://ib.adnxs.com/getuid?URL
セキュリティで保護されたバージョンでは、次の形式を使用します。
https://secure.adnxs.com/getuid?URL
Cookie を使用していないユーザーやオプトアウトしたユーザーは、0 のユーザー ID でリダイレクトされます。 0 のユーザー ID を受け取りたくない場合は、次の形式を使用します。
https://ib.adnxs.com/getuidnb?URL
URL を URI エンコードされたままにする必要がある場合は、次の形式を使用します。
https://ib.adnxs.com/getuidu?URL
JSON のサポート
CORS をサポートする JSON 応答で Microsoft 広告ユーザー ID を返すには、次の形式を使用します:
https://ib.adnxs.com/getuidj
次のような JSON 形式の応答を受信します。
{"uid":1680598911678123849}
CORS サポートを使用して JSONP 応答を返すには:
https://ib.adnxs.com/getuidp?callback=ABC
( callback は、クエリ文字列で定義されているコールバック関数です。)次のような JSON 形式の応答を受信します。
ABC({"uid":1680598911678123849})
getUID の例
ほとんどの場合、URL のクエリ文字列内の指定されたパラメーターにユーザー ID を渡す必要があります。 これを行うには、 $UID マクロを使用できます。
注:
ページ "gdpr" と "gdpr_consent" で TCF シグナルを使用できる場合は、/getuid URL の末尾に GET パラメーターを含める必要があります。
https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&geo=35&referrer=https://www.website.com&gdpr_consent=CPaPwEAPaPwEAACAKAFRBWCgAP_AAH_AAAqIHttf_X__b3_j-_59__t0eY1f9_7_v-0zjhfdt
$UID マクロはインプレッション バスによって Microsoft Advertising ユーザー ID に置き換えられ、ユーザーは次の URL にリダイレクトされます。
https://ad.adserver.com/pixel?adnxs_uid=19241908471992&gdpr=1&geo=35&referrer=https://www.website.com&gdpr_consent=CPaPwEAPaPwEAACAKAFRBWCgAP_AAH_AAAqIHttf_X__b3_j-_59__t0eY1f9_7_v-0zjhfdt
注:
どちらのエンドポイントでも、リダイレクト URL で TCF パラメーターが渡された場合、Xandr はこれらのパラメーターを使用して Cookie 同期を実行できるかどうかを判断します。 受信したシグナルに法的根拠がないと解釈される場合、Xandr は Cookie 同期要求を処理できず、"プライバシー シグナルのため要求に失敗しました" というエラー メッセージが返されます。さらに、URL を呼び出すときに TCF シグナルを指定できない場合、パートナーは URL に 同意 パラメーターを追加する必要があります。 同意パラメーターは、バイナリ値を受け入れます。ユーザーが同意した場合は 1、同意が拒否された場合は 0 です。 特定の地理的領域でユーザー同期を実行するには、このパラメーターを含める必要があります。
ユース ケース: ピクセル呼び出しにピギーバックする
このマッピングを作成する簡単な方法は、既存のピクセル呼び出しの 1 つから getUID サービスにピッグバックすることです。 ピクセル呼び出しが行われると、Microsoft Advertising の getUID サービスに即時にリダイレクトされ、Microsoft Advertising Monetize によって指定された URL 内のユーザー ID が返されるようにピクセルを調整できます。
たとえば、現在パブリッシャーのサイトに次のピクセルが存在するとします。
<img src="media/pixel?id=234123" width=1 height=1/>
代わりに、adserver.com ピクセルの URL を指定して、Microsoft Advertising getuid ピクセルを起動します。
https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?id=234123&adnxs_uid=$UID
getUID サービスは、 $UID マクロの代わりに Microsoft Advertising ユーザー ID を使用して、指定された URL にリダイレクトします。
https://ad.adserver.com/pixel?id=234123&adnxs_uid=19241908471992
adserver.comがこの呼び出しを受信すると、Microsoft 広告ユーザー ID を adserver.com のサーバー側ユーザー データ ストアに挿入できます。そこで、このユーザー ID のマッピングを、Microsoft 広告インプレッション バスを介して将来のインプレッション呼び出しおよびピクセル呼び出しで使用できます。
mapUID サービス
ヒント
mapUID サービスには料金がかかります。 このオプションの使用に関心がある場合は、Microsoft 広告の担当者にお問い合わせください。
mapUID サービスは、社内 ID を Microsoft 広告サーバー側の Cookie ストアに挿入します。
お客様の ID をシステム内のユーザーの ID にマップするクライアント側ピクセルの形式は次のとおりです
https://ib.adnxs.com/mapuid?member=MEMBER_ID&user=USER_UD
メンバー ID は Microsoft Advertising によって会社に割り当てられた ID で、 USER_ID は会社のユーザー ID です。 会員IDがわからない場合は、会員サービスにGETリクエストすることで確認できます。
複数のユーザー ID がある場合は、セミコロンで区切ることができます。次に例を示します。
https://ib.adnxs.com/mapuid?member=123&user=ABC;DEF;GHI
マッピングの有効期限
mapUID マッピングの平均存続期間 (TTL) は約 2.5 週間です。 したがって、マッピングを有効状態を維持するには、できるだけ頻繁に、できるだけ多くのページで mapUID ピクセルを起動することが非常に重要です。
mapUID 呼び出しからセグメント呼び出しに便乗する
ユーザー ID を Microsoft Cookie ストア内の 1 つ以上のセグメントに追加すると同時に、ユーザー ID を弊社の ID にマップできます。
構文は次のとおりです。
https://ib.adnxs.com/mapuid?member=[MEMBER_ID]&user=[USER_ID]&seg=[SEG_ID],[SEG_ID],[SEG_ID]
https://ib.adnxs.com/mapuid?member=123&user=12abc34565&seg=1,2,3
各セグメントの値を渡すには、コロンを使用します。 (この例では、ID の代わりにセグメント コードを使用しました。)
https://ib.adnxs.com/mapuid?member=123&user=[USER_ID]&seg_code=[code1]:[code1value],[code2]:[code2value],[code3]:[code3value]
セグメント データをオフラインで送信する
セグメント データをオフラインで送信する方法の詳細については、API の バッチ セグメント サービスを参照してください。