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

Media Owners
Last Updated: 4月 23, 2026

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

グローバルプレースメント識別子(GPID)は、パブリッシャーのサイト上で、特定の広告ユニットまたはプレースメントを表すグローバルIDです。It is defined by the Media Owner and is passed in OpenRTB bid requests to DSPs. 従来の広告ユニット毎の各エクスチェンジから渡される、エクスチェンジに特化したIDとは異なり、GPIDは、すべてのエクスチェンジやデマンドソースを横断し、一貫した広告ユニットを示します。例えば、website.com上のリーダーボードバナー広告ユニットのエクスチェンジに特化したIDを複数受信する代わりに、DSPはGPIDを含む、全てのエクスチェンジの広告ユニットに対して同じIndexを受け取ります。

Note: When implementing GPID, it is important to consider the DSP's ad unit measure requirements. 全ての接続で各広告ユニットに、一貫したGPIDを使うことにより、DSPは貴社のインベントリのターゲティング、測定、最適化に対して最も効果的なパスを実現できます。様々なサプライパートナーが、GPIDをフォーマットするのに異なる方法を提案している場合、一貫性を保つために、全てのGPIDを1つの方法のみでフォーマットしてください。

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

Note: GPID is not applicable to STV apps.

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

Note: You can also choose to remove any extra information and include the ad unit name only. これは、推奨するフォーマットではありませんが、広告ユニットを個別に特定できるため利用できます: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以外の広告サーバーを利用している場合。

  1. Prebid.jsのバージョンを6.5.0またそれ以降にアップデートしてください。

  2. 広告ユニットの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'
              }  
           },
           [...]
         }
        ]
  3. Indexは、入札リクエストimp extensionオブジェクトgpidフィールドにあるIDをDSPに送信します。

GPTプレオークションモジュールを使いGPIDを送信。This option is recommended for Media Owners using Google Ad Manager as their ad server and who want to use their existing GPT ad unit codes to define GPID.

  1. GPTプレオークションモジュールが有効なPrebid.jsを4.42.0以降にアップデートしてください。このモジュールに関する詳細は、Prebidの GPT Pre-Auction Moduleをご確認ください。
    注意:GPTプレオークションモジュールは、バナー広告ユニットのみを検知します。動画広告ユニットを送信するには、PBJS AdUnitsで動画ユニットの広告ユニットパスをマニュアルで設定してください。
  2. 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をご確認ください。

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

Google Open Bidding

  1. Googleが、Indexパスを入札リクエストimp extension オブジェクトdfp_ad_unit_codeフィールドに送信します。広告スロットを個別に特定するGoogle Ad Manager広告ユニットコードです。広告ユニットの詳細は、Googleの広告ユニットの階層をご確認ください。

  2. Indexは、入札リクエストimp extensionオブジェクトgpidフィールドにあるIDをDSPに送信します。

  3. imp.tagidフィールドで共通IDを既に送信している場合、Indexが、DSPに対する入札リクエストのimp.tagidフィールドにこのIDを含めて送信します。

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

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

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

  2. Indexは、入札リクエストimp extensionオブジェクトgpidフィールドに含まれるIDをDSPに送信します。

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

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

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

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

  2. 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を受け取った場合、このIDをDSPへの入札リクエストimp.ext.gpid フィールドに送信します。

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