複数のクライアントに代わって入札する

入札者は、1 回の入札レスポンスで複数の購入者の広告枠を購入できます。たとえば、デマンドサイド プラットフォーム（DSP）は、入札アプリケーションを使用して、購入者である複数のマーケターや広告代理店のために広告枠を購入する場合があります。このガイドでは、複数の購入者に代わって送信された単一のリクエストを処理するように入札者をコーディングする方法について説明します。

背景

シナリオによっては、広告ネットワークや広告代理店のトレーディング デスクが 1 つ以上の DSP と連携することを選択する場合があります。DSP を通じて作業する購入者には、次の 2 つのオプションがあります。

• DSP は、購入者ではないマーケターまたは代理店のために広告枠を購入します。この場合、DSP は 1 つの入札リクエストを受信し、1 つの入札で応答します。Google から DSP に直接請求されます。
• DSP は、購入者であるマーケターまたは代理店のために広告枠を購入します。DSP は、対象となる購入者に関連付けられた複数の請求先 ID を含む 1 つの入札リクエストを受け取り、入札する購入者ごとに個別の入札を行うことができます。このモデルでは、Google は DSP ではなく購入者に請求します。このガイドの残りの部分では、このシナリオに焦点を当てます。

設定とプレターゲティング

Google は、インプレッションをターゲットにした購入者と事前ターゲティング構成に関連付けられた 1 つ以上の請求 ID を含む入札リクエストを送信します。これらは BidRequest.imp.ext.billing_id フィールドで確認できます。

複数の購入者の請求 ID を含む BidRequest にレスポンスを返す場合は、Google が入札に関連付けるアカウントを認識できるように BidResponse.seatbid.bid.ext.billing_id が必要です。フィールドを設定していないレスポンスはフィルタされます。請求先 ID が 1 つのみ含まれる BidRequest の場合、このフィールドは引き続き省略可能です。

プレターゲティングの例

入札者は、2 人の購入者（請求 ID が 123 の購入者と請求 ID が 124 の購入者）に代わって入札します。入札者は、請求 ID 213 で英語をターゲットとする事前ターゲティング構成と、請求 ID 231 でパソコンをターゲットとする事前ターゲティング構成を 1 つずつ構成します。以下に、さまざまな種類のインプレッションの入札リクエストに表示される課金 ID について説明します。

インプレッションの説明	入札リクエストの請求 ID
パソコンに表示された日本語のコンテンツ。	123、124、231
モバイル デバイスに表示された英語のコンテンツ。	123、124、213
パソコンに表示された英語のコンテンツ。	123、124、213、231

重要: これらがアクティブなプリターゲティング構成のみである場合、パソコン以外から発生し、英語以外のコンテンツを含むインプレッションの入札リクエストは届きません。

BidRequest の例

以下に BidRequest の例を示します。これらのリクエストは複数のアカウントに適用されるため、複数の請求 ID が含まれています。

OpenRTB Protobuf

sample

id: "n9YFp0D9qE02Q5A49bo68a"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    format {
      w: 320
      h: 50
    }
  }
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "11.2.0"
  tagid: "2913643481"
  bidfloor: 0.04
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.0003642654628492892
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.98
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 41048190734
    billing_id: 87998475627
    publisher_settings_list_id: 5889715199959683550
    publisher_settings_list_id: 3379823455061055318
    allowed_vendor_type: 566
    allowed_vendor_type: 113
    ampad: AMP_AD_NOT_ALLOWED
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "6ZVs3vs4"
      versions: "2.0"
      versions: "2.1"
      fidelities: VIEW_THROUGH_ADS
      fidelities: STOREKIT_RENDERED_ADS
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-6227762759521589"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "TX"
    metro: "623"
    city: "Lewisville"
    type: IP
    utcoffset: -300
    accuracy: 6225
  }
  make: "Apple"
  model: "iPhone13,2"
  os: "iOS"
  osv: "17.4.1"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  lmt: true
  hwv: "iPhone13,2"
  w: 390
  h: 844
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "17"
      version: "4"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 2
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
bcat: "IAB18-5"
bcat: "IAB23-4"
bapp: "359917414"
bapp: "1446254576"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v11.2.0"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z17251-40u3eXfXPL5j3MDPa7n6Ree92uf7354o71FP67Rk5i3G30Ez7p39Ze1722D8H"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}