グローバルプレースメント識別子（GPID）をIndexへ送信

事前の準備：Index Exchange (Index)と接続していることを確認してください。Indexと接続が完了していなくて、接続のオプションを知りたい場合は、 Indexとのインテグレーションをご確認ください。

グローバルプレースメント識別子（GPID）は、パブリッシャー広告が表示される、ウェブサイトまたはアプリの所有者。のサイト上で、特定の広告ユニットまたはプレースメントを表すグローバルIDです。パブリッシャーにより定義され、DSP デマンドサイドプラットフォーム（DSP）。リアルタイムで入札の意思決定を自動化し、アドエクスチェンジやSSPを通じてバイヤーとオーディエンスを効率的につなぐソフトウェアプラットフォーム。バイサイド・プラットフォームとも呼ばれます。へのOpenRTB リアルタイム入札オークションにおけるオンライン広告のバイヤーとセラー間の通信のためのオープンな業界標準。IABにより制定されました。入札リクエスト SSPまたはアドエクスチェンジからDSPに送信され、入札可能なインプレッションに対する入札レスポンスをリクエストするOpenRTBリクエスト。入札リクエストには、DSPがそのインプレッションに入札するかどうかを決定するためのインプレッションに関する情報が含まれる。で渡されます。従来の広告ユニット毎の各エクスチェンジから渡される、エクスチェンジに特化したIDとは異なり、GPIDは、すべてのエクスチェンジやデマンドソースを横断し、一貫した広告ユニットを示します。例えば、website.com上のリーダーボードバナー広告ユニットのエクスチェンジに特化したIDを複数受信する代わりに、DSPはIndexを含む、全てのエクスチェンジの広告ユニットに対して同じGPIDを受け取ります。

注意：GPIDを実装する際は、DSPと広告ユニット測定条件を考慮に入れてください。全ての接続で各広告ユニットに、一貫したGPIDを使うことにより、DSPは貴社のインベントリのターゲティング、測定、最適化に対して最も効果的なパスを実現できます。様々なサプライパートナーが、GPIDをフォーマットするのに異なる方法を提案している場合、一貫性を保つために、全てのGPIDを1つの方法のみでフォーマットしてください。

GPIDは、DSPが正確なインプレッション機会を評価するのに役立ち、バイヤーの透明性を向上させます。入札リクエストがGPIDを指定していない場合、DSPはインベントリを購入しないか、他のエクスチェンジかチャネルから購入する可能性があります。

注意：GPIDは、ストリーミングTVアプリに適用できません。

Google Ad ManagerでGPIDを定義する方法

推奨するGPID文字列は、Google広告ユニットパスです。パスだけでページ上の特定の広告ユニットを個別に識別できない場合は、Google広告ユニットパスの最後に「#」をセパレーターとして使用し、div idを追加することをお勧めします。広告ユニットパスに関する詳細は、GoogleドキュメントのGoogleパブリッシャータグを使ってみるをご確認ください。

例

貴社の広告ユニットパスが/1234/homepage/adsで、広告ユニットのdiv idが div id ="header"の場合、GPIDは「/1234/homepage/ads#header」のようになります。

他の広告サーバーでGPIDを定義する方法

英数字ではなく、詳細が理解できるような名前の広告ユニットを提供してください。英数字のGPIDは、特定したり、パフォーマンスの測定をしたりするのが難しくなります。
GPIDにサイズ、デバイスタイプなどの追加情報を含める場合、広告ユニットの情報が簡単に認識できるようにしてください。
区切り文字、可能であればフォワードスラッシュ（/）を使いますが、ハッシュ（#）、ドット（...）、アンダースコア（_）など、どのような区切り文字も使用できます。

例

悪いGPID例	問題	良いGPID例
`/1234/website1`	広告ユニットを特定していない	`/1234/website1/leaderboard_atf` `/1234/website1#div-rightrail1` `/1234/website1_skyscraper` `Website1.homepage.rr1`
`/1234/website1/desktop/728x90/`	サイズやデバイス情報を含むが、広告ユニットを特定していない	`/1234/website1/desktop/728x90/leaderboard_atf` `website1_mobile_skyscraper_160x600` `website1.homepage.300x250.rr1`
`/1234/website1/adslot_1qbzzz13eee`	広告ユニット名の末尾に余分な不規則な文字が含まれるため、識別値が多すぎて測定が困難になる。これは、測定に利用価値がない、固有のDIVサフィックスと異なるルートプレースメントを持つ可能性のある、遅延読み込み広告ユニットにとって特に重要です。	`/1234/website1/adslot_leaderboard`

注意：余分な情報を削除し、広告ユニット名のみ含めることもできます。これは、推奨するフォーマットではありませんが、広告ユニットを個別に特定できるため利用できます：leaderboard_atf, skyscraper, rr1。

GPIDをIndexへ送信する方法

Indexでは、OpenRTB入札リクエストのGPIDをgpidフィールドまたはimp extensionオブジェクトのdfp_ad_unit_codeフィールドで許可しています。Indexとの接続のタイプにより、以下のタスクに従ってください。

接続オプションタスク

Prebid.js パブリッシャーがウェブサイトにヘッダービッディングを実装し、複数のヘッダービッディングパートナーを管理するためのオープンソースライブラリ。

以下のいずれかの方法で、IndexにGPIDを送信できます。

オプション手順

PBJS AdUnitsで、マニュアルでGPIDを送信する。このオプションは以下の場合に推奨します。

パブリッシャーが、GPIDがどのように定義されたか管理したい場合。
パブリッシャーが、Google Ad Manager以外の広告サーバー管理、保管、広告をパブリッシャーのサイトに提供するプラットフォーム。を利用している場合。

Prebid.jsのバージョンを6.5.0またそれ以降にアップデートしてください。
広告ユニットのortb2Imp.ext.gpidフィールドでGPIDを指定してください。このフィールドの詳細は、PrebidのThe Prebid Ad Slot and the GPIDをご確認ください。

例：
```
var adUnits = [
```
```
{
      code: '/19968336/home/mpu',
      ortb2Imp: {
         ext: {
           gpid: '/19968336/home/mpu/atf'
          }  
       },
       [...]
     }
    ]
```
Indexは、入札リクエストimp extensionオブジェクトgpidフィールドにあるIDをDSPに送信します。

GPT Googleパブリッシャータグ（GPT）Google Ad Manager (GAM)用の広告タグ付けライブラリで、広告リクエストを動的に作成するために使用されます。パブリッシャーから広告ユニットコード、広告サイズ、カスタムターゲティングなどの主要な情報を受け取り、リクエストを作成し、ウェブページに広告を配信します。プレオークションモジュールを使いGPIDを送信。このオプションは、Google Ad Managerを広告サーバーとして使い、既存のGPT広告ユニットコードをGPIDの定義に使用するパブリッシャーに推奨します。

GPTプレオークションモジュールが有効なPrebid.jsを4.42.0以降にアップデートしてください。このモジュールに関する詳細は、Prebidの GPT Pre-Auction Moduleをご確認ください。
注意：GPTプレオークションモジュールは、バナー広告ユニットのみを検知します。動画広告ユニットを送信するには、PBJS AdUnitsで動画ユニットの広告ユニットパスをマニュアルで設定してください。
googletag.defineSlot()コード文は、pbjs.requestBids()コード文がPrebid.jsで設定される前に定義してください。これにより、PrebidがGoogle Ad Manager設定で定義された広告ユニットパスを見つけることができます。

広告ユニットパスが、上記の「GPID定義方法」で説明したように、十分に識別できるものでない場合は、GPTプレオークションモジュール内でcustomPbAdSlot関数を作成し、広告ユニットパスにGPIDに適した固有の値を送信します。Indexが、このカスタム関数でGPIDを定義するには、Prebid.jsバージョン6.5.0またはそれ以降である必要があります。この関数の作成方法は、PrebidのExample custom PbAdSlot functionをご確認ください。

IndexがGPT Pre-Auction ModuleからGPIDを受け取る際、DSPへの入札リクエストのimp.ext.gpidフィールドに送信します。

Google Open Bidding

Googleが、Indexパスを入札リクエストimp extension オブジェクトdfp_ad_unit_codeフィールドに送信します。広告スロット広告が表示される、パブリッシャーのウェブサイト上の場所。インベントリとも呼ばれる。を個別に特定するGoogle Ad Manager広告ユニットコードです。広告ユニットの詳細は、Googleの広告ユニットの階層をご確認ください。
Indexは、入札リクエストimp extensionオブジェクトgpidフィールドにあるIDをDSPに送信します。
imp.tagidフィールドで共通IDを既に送信している場合、Indexが、DSPに対する入札リクエストのimp.tagidフィールドにこのIDを含めて送信します。

Prebidサーバー、OpenRTB、その他サーバー間接続

IDは、Indexへの入札リクエストのimp extensionオブジェクトgpidフィールドに含めて送信します。このフィールドを指定しない場合、Indexは、dfp_ad_unit_code フィールドからIDを取得します（可能な場合）。これらのフィールドの詳細は、セラー向けOpenRTB入札リクエストフィールドの対応一覧をご確認ください。

注意：impオブジェクトtagidフィールドで共通のIDを既に送信している場合は、gpidフィールドを送信することもお勧めします。一部のDSPは、gpidフィールドを入札リクエストに常に含めることを条件としているので、推奨します。
Indexは、入札リクエストimp extensionオブジェクトgpidフィールドに含まれるIDをDSPに送信します。
imp.tagidフィールドで共通IDを既に送信している場合、Indexが、DSPに対する入札リクエストのimp.tagidフィールドにこのIDを含めて送信します。当社では、gpidフィールドを送信することも推奨します。一部のDSPは、gpidフィールドを常に入札リクエストに含めることを条件としているので、推奨しています。

その他サードパーティ接続

注意：接続するサードパーティベンダーは、GPIDに対応し、接続のために有効化されていることを確認してください。

IDは、Indexへの入札リクエストのimp extensionオブジェクトgpidフィールドに含めて送信します。このフィールドを指定しない場合、Indexは、dfp_ad_unit_code フィールドからIDを取得します（可能な場合）。これらのフィールドの詳細は、セラー向けOpenRTB入札リクエストフィールドの対応一覧をご確認ください。
Indexは、入札リクエストimp extensionオブジェクトgpidフィールドに含まれるIDをDSPに送信します。

Amazon

Transparent Ad Marketplace（TAM）

利用可能な場合、Amazon TAMが自動的にGPIDをIndexに送信します。いかにAmazon TAMがGPIDを送信するかにより、Indexは、以下のようにDSPへの入札リクエストにIDを送信します。

当社が入札リクエストimp.ext.gpidフィールドまたは、imp.ext. dfp_ad_unit_code でＩＤを受け取った場合、このIDをDSPへの入札リクエストimp.ext.gpid フィールドに送信します。
当社が入札リクエストimp.tagidフィールドでＩＤを受け取った場合、このIDをDSPへの入札リクエストimp.tagidフィールドに送信します。