Microsoft 収益化 - getUID と mapUID を使用したユーザー ID マッピング
Microsoft Advertising Server Side Cookie Store に挿入する必要があるユーザーに関する内部オフライン データを使用して、意思決定に使用できる場合があります。 その場合は、今後の要求でユーザー ID を照合できるようにするために、まず内部ユーザー ID と Microsoft Advertising ユーザー ID をマップする必要があります。 マッピングをシステムまたは Microsoft のどちらに格納するかに応じて、ピクセル呼び出しを通じてこれを行う方法は mapUID と getUID の 2 つです。
getUID サービスは Microsoft Advertising ID を取得するため、独自の社内 ID サーバー側または独自の Cookie 空間で調整できます。 次に、"Microsoft Advertising ユーザー ABC を次のセグメント データで更新する" というオフライン データ フィードを渡すことができます。 mapUID サービスは、Microsoft Advertising Cookie ストア内の Microsoft Advertising 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 ページに配置され、起動すると、Impression Bus はマクロを置き換えて $UID Microsoft Advertising ユーザー ID を URL に挿入します。
ヒント
このしくみの詳細なチュートリアルについては、 ユーザー マッピング ビジュアルとウォークスルーに関するページを参照してください。
getUID サービス
任意の URL は、クエリ文字列パラメーターとして Microsoft Advertising ユーザー ID を使用してクライアント側の呼び出しを受け取ります。 広告呼び出し中に、Microsoft Advertising はユーザーをメンバーの目的の URL にリダイレクトします。 Impression Bus は、マクロを置き換えるか $UID 、URL の末尾に追加することで、Microsoft Advertising ユーザー 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 を持たないユーザーまたはオプトアウトしたユーザーは、ユーザー ID 0 でリダイレクトされます。 0 のユーザー ID を受け取りたくない場合は、次の形式を使用します。
https://ib.adnxs.com/getuidnb?URL
URL を URI でエンコードしたままにする必要がある場合は、次の形式を使用します。
https://ib.adnxs.com/getuidu?URL
JSON のサポート
CORS がサポートされている JSON 応答で Microsoft Advertising ユーザー ID を返すには、次の形式を使用します。
https://ib.adnxs.com/getuidj
次のような JSON 形式の応答を受け取ります。
{"uid":1680598911678123849}
CORS サポートを使用して JSONP 応答を返すには:
https://ib.adnxs.com/getuidp?callback=ABC
(ここで callback 、クエリ文字列で定義されているコールバック関数です)。次のような JSONP 形式の応答を受け取ります。
ABC({"uid":1680598911678123849})
getUID の例
ほとんどの場合、URL のクエリ文字列内の指定されたパラメーターにユーザー ID を渡す必要があります。 これを行うには、マクロを $UID 使用できます。
https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?adnxs_uid=$UID&geo=35&referrer=https://www.website.com
このマクロは $UID 、インプレッション バスによって Microsoft Advertising ユーザー ID に置き換えられ、ユーザーは次の URL に転送されます。
https://ad.adserver.com/pixel?adnxs_uid=19241908471992&geo=35&referrer=https://www.website.com
ユース ケース: ピクセル呼び出しでのピギーバック
このマッピングを簡単に作成する方法は、既存のピクセル呼び出しの 1 つから getUID サービスをピギーバックすることです。 ピクセル呼び出しが行われると、Microsoft Advertising getUID サービスへの即時リダイレクトが行われるようにピクセルを調整できます。これにより、Microsoft Advertising 収益化によって示される URL 内のユーザー ID が返されます。
たとえば、今日、パブリッシャー サイトに次のピクセルが存在するとします。
<img src="media/pixel?id=234123" width=1 height=1/>
代わりに、Microsoft Advertising getuid ピクセルを起動し、adserver.com ピクセルの URL を指定します。
https://ib.adnxs.com/getuid?https://ad.adserver.com/pixel?id=234123&adnxs_uid=$UID
getUID サービスは、マクロの代わりに Microsoft Advertising ユーザー ID を使用して、指定された URL に $UID リダイレクトします。
https://ad.adserver.com/pixel?id=234123&adnxs_uid=19241908471992
この呼び出しを受信すると adserver.com 、Microsoft Advertising ユーザー ID をサーバー側のユーザー データ ストアに adserver.com挿入できます。このユーザー ID のマッピングは、Microsoft Advertising Impression Bus を介した将来のインプレッションとピクセル呼び出しで使用できます。
mapUID サービス
ヒント
mapUID サービスには料金が関連付けられています。 このオプションの使用に関心がある場合は、Microsoft Advertising の担当者にお問い合わせください。
mapUID Service は、Microsoft Advertising Server Side Cookie Store に社内 ID を挿入します。
お客様の ID をシステム内の Microsoft にマップするクライアント側ピクセルの形式は、
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 呼び出しのセグメント呼び出しをピギーバックする
Microsoft Advertising Cookie ストア内の 1 つ以上のセグメントにユーザー ID を追加すると同時に、ユーザー ID を Microsoft の 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 の Batch Segment Service に関するページを参照してください。