Tawaran atas Nama Beberapa Akun

Bidder dapat membeli inventaris untuk beberapa entitas dalam satu bid, jika entitas tersebut adalah klien Authorized Buyers. Misalnya, platform sisi permintaan (DSP) mungkin menggunakan bidder-nya untuk membeli inventaris bagi beberapa pemasar atau agensi yang juga merupakan klien Authorized Buyers. Panduan ini menjelaskan cara membuat kode bidder Anda untuk memproses satu permintaan yang dikirim atas nama beberapa klien Authorized Buyers.

Latar belakang

Authorized Buyers bekerja sama dengan jaringan iklan, bagian perdagangan agensi, dan platform sisi permintaan (DSP). Dalam beberapa skenario, jaringan iklan atau bagian perdagangan agensi dapat memilih untuk bekerja sama dengan satu atau beberapa DSP. Ada dua opsi penerapan yang tersedia untuk klien yang bekerja melalui DSP:

• Inventaris pembelian DSP untuk pemasar atau agensi yang bukan klien Authorized Buyers. Dalam hal ini, DSP menerima satu permintaan bid dan merespons dengan satu bid. Google menagih DSP secara langsung.
• Inventaris pembelian DSP untuk pemasar atau agensi yang merupakan klien Authorized Buyers. Klien Authorized Buyers diwajibkan untuk mengajukan bid secara independen, bahkan saat mereka menggunakan DSP. Hal ini untuk memastikan penayang memiliki visibilitas pembeli yang sebenarnya, untuk memungkinkan alokasi eksklusif inventaris, dan memastikan tidak ada pengalihan yang melewati jaringan ke jaringan. Dalam model ini, Google menagih klien Authorized Buyers, bukan DSP. Bagian lainnya dari panduan ini berfokus pada skenario ini.

Authorized Buyers mengarahkan permintaan bid untuk akun turunan dari bidder induk (DSP) melalui ID grup iklan. ID grup iklan akun turunan diberikan saat penyiapan akun turunan oleh pengelola akun atau Authorized Buyers dan Dukungan Bidding Terbuka. DSP menggunakan informasi ini untuk memproses respons bid. Untuk DSP yang memiliki klien Authorized Buyers yang menggunakan teknologinya untuk membeli dari Authorized Buyers, DSP menerima pemanggilan gabungan untuk sekumpulan klien RTB.

Penyiapan dan pra-penargetan

Semua DSP dikonfigurasi untuk permintaan gabungan. Pemilihan kriteria pra-penargetan dilakukan di tingkat bidder induk untuk semua akun turunan. Hal ini disebut Pra-penargetan Tingkat Bidder (BLP).

Dengan BLP, pencocokan inventaris hanya dilakukan pada tingkat bidder induk. Hal ini menyederhanakan alur kerja serta mempermudah pengelolaan inventaris dan setelan di banyak akun.

Manfaat pra-penargetan tingkat bidder dibandingkan pra-penargetan reguler (tidak digunakan lagi)

Pra-penargetan tingkat bidder	Pra-penargetan reguler (tidak digunakan lagi)
Kursi orang tua mengelola kelayakan untuk semua kursi	Setiap slot mengelola kelayakan inventarisnya sendiri
Semua kursi yang memenuhi syarat untuk semua traffic	Memvariasikan penyiapan pra-penargetan di banyak akun
Penyiapan lebih sederhana dan lebih mudah dikelola	Sedikit kontrol di tingkat bidder induk, tetapi memiliki kontrol terperinci untuk slot tertentu

Akun turunan memiliki satu ID grup iklan yang terkait dengan akun tersebut, sehingga pencocokan pra-penargetan disertakan sebagai satu entri di kolom matching_ad_data dari BidRequest untuk setiap akun turunan yang cocok.

Saat merespons BidRequest yang berisi pencocokan pra-penargetan dari akun selain akun induk (misalnya, BidRequest yang kolom matching_network_data ditetapkan), kolom billing_id di BidResponse diperlukan agar Authorized Buyers mengetahui akun dan kampanye mana yang akan dikaitkan dengan bid. Respons apa pun yang tidak menetapkan kolom ini akan dihapus. Kolom ini tetap opsional untuk BidRequest apa pun yang hanya menyertakan pencocokan pra-penargetan dari akun bidder. Respons terhadap BidRequest yang berisi pencocokan pra-penargetan dari beberapa akun dapat menampilkan beberapa iklan.

Contoh pra-penargetan tingkat bidder

Kursi anak (ID grup iklan: 123)	Kursi orang tua (ID grup iklan: 124)
Pra-penargetan: AS + Uni Eropa	Pra-penargetan: AS + Asia Pasifik

Kriteria info	billing_id terkirim
Hanya AS	123 + 124
Khusus Uni Eropa	123
Khusus Asia Pasifik	124

Contoh BidRequest

Berikut adalah contoh BidRequest. Anda akan mencatat bahwa ada beberapa ID penagihan dalam permintaan ini karena permintaan tersebut berlaku untuk beberapa akun.

Google

contoh

id: "S\212\364\302\036\030\211TJ\365\212\340l6\245=u;\317x\333\252 "
ip: "\300\250"
user_agent: "Mozilla/5.0 (Linux; Android 13; SM-S906U Build/TP1A.220624.014; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/108.0.5359.128 Mobile Safari/537.36 (Mobile; afma-sdk-a-v225014044.225014044.0)"
url: "https://www.google.com"
detected_language: "en"
adslot {
  id: 1
  width: 320
  width: 300
  height: 50
  height: 50
  excluded_attribute: 14
  excluded_attribute: 30
  allowed_vendor_type: 3
  allowed_vendor_type: 42
  matching_ad_data {
    billing_id: 14066780015
    billing_id: 25678885930
    minimum_cpm_micros: 4900000
  }
  slot_visibility: ABOVE_THE_FOLD
  ad_block_key: 3514974457
  publisher_settings_list_id: 3949401098794797722
  publisher_settings_list_id: 4224560246640894720
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  viewability: 98
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  allowed_ad_types: ALLOWED_AD_TYPE_BANNER
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  session_depth: 2
  api: OMID_1
  api: MRAID_1
  flexible_adslot_settings {
    max_width: 412
    max_height: 64
    min_width: 300
    min_height: 50
  }
  omidpn: "Google"
  omidpv: "afma-sdk-a-v224400999.221310000.1"
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
}
is_test: false
cookie_version: 1
google_user_id: "2vy4H5TgSY2XD4I22zb394gB6Vu"
mobile {
  app_id: "com.google.testapp"
  is_app: true
  encrypted_advertising_id: "\322H\300\221\312\024ylU\211\022\024\020x*\2340\021\255O\360\0036b\205R\371\275 fWa\223K\221)"
  app_name: "Test App"
  app_rating: 4.7201877
  advertising_id: "\346\324\370053\310g\347\224;S\204\'%\370"
}
cookie_age_seconds: 25920000
postal_code: "10011"
geo_criteria_id: 9010919
encrypted_hyperlocal_set: "pJ\275\207\352\024nHX\236VvP\313v\206x\006\252\234\256^\254\323-\213\274Gf\264\013\032{\376\233\243\000\320\307\321\330\254\351\007o\244\323\236U\220F\254b@\265 Qm5\206\374\212\237\242{8Yf\317\367j-\221\310\305\350\311/\355U\004\327\361\331Y3\311fV\273\355"
seller_network_id: 7664
publisher_type: PUBLISHER_OWNED_AND_OPERATED
hyperlocal_set {
  hyperlocal {
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
  }
  center_point {
    latitude: 0.0
    longitude: 0.0
  }
}
device {
  device_type: HIGHEND_PHONE
  platform: "android"
  brand: "samsung"
  model: "sm-s906u"
  os_version {
    major: 13
  }
  carrier_id: 0
  screen_width: 412
  screen_height: 816
  screen_pixel_ratio_millis: 2625
  screen_orientation: PORTRAIT
  limit_ad_tracking: false
}
publisher_country: "TR"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 1000
google_query_id: "ANy-zk0vw2-E3557O1HQ6Lyj920O22231f54B9leUCUR3oP61TN5cq16sj62j3TJ7W3y1862"
auction_type: FIRST_PRICE
geo {
  lat: 33.63
  lon: -84.26
  country: "USA"
  region: "GA"
  metro: "524"
  city: "Ellenwood"
  zip: "30294"
  accuracy: 6306
}
user_agent_data {
  platform {
    brand: "Android"
    version: "13"
  }
  mobile: true
  model: "SM-S906U"
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "AppleWebKit"
    version: "537"
    version: "36"
  }
  bitness: "64"
}
supply_chain {
  complete: false
  nodes {
    advertising_system_identifier: "google.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

JSON OpenRTB

contoh

{
  "id": "7O93Fz6ValZ0J1OU917TBd",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 250,
        "pos": 1,
        "battr": [
          5,
          6
        ],
        "api": [
          3,
          5
        ],
        "wmax": 300,
        "hmax": 250,
        "wmin": 201,
        "hmin": 167,
        "format": [
          {
            "w": 300,
            "h": 250
          }
        ]
      },
      "displaymanager": "GOOGLE",
      "tagid": "1763160040",
      "bidfloor": 1.13,
      "bidfloorcur": "USD",
      "pmp": {
        "deals": [
          {
            "id": "74575310",
            "bidfloor": 4.97,
            "bidfloorcur": "USD",
            "at": 3,
            "ext": {
              "deal_type": 3,
              "must_bid": 0,
              "publisher_blocks_overridden": 1,
              "creative_source": 1
            }
          }
        ]
      },
      "secure": 1,
      "metric": [
        {
          "type": "viewability",
          "value": 0.85,
          "vendor": "EXCHANGE"
        },
        {
          "type": "session_depth",
          "value": 111,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          95125716848,
          68063619966
        ],
        "publisher_settings_list_id": [
          7531260801312350752,
          8928022352247371517
        ],
        "ampad": 2,
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1,
          "is_default": 1
        },
        "auction_environment": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-2640954686638618",
      "ext": {
        "country": "US"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.5",
      "livestream": 0,
      "language": "pt"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 11; M2004J19C Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/102.0.5005.78 Mobile Safari/537.36 (Mobile; afma-sdk-a-v221820037.221820037.0)",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "BRA",
      "region": "BR-RJ",
      "city": "Mangaratiba",
      "zip": "23860-000"
    },
    "make": "xiaomi",
    "model": "m2004j19c",
    "os": "android",
    "osv": "11",
    "devicetype": 4,
    "lmt": 0,
    "w": 393,
    "h": 808,
    "pxratio": 2.75,
    "ext": {
      "user_agent_data": {
        "browser": {
          "brand": "Chrome",
          "version": [
            "102",
            "0"
          ]
        },
        "platform": {
          "brand": "Android",
          "version": [
            "11"
          ]
        },
        "mobile": 1,
        "model": "M2004J19C",
        "browsers": [
          {
            "brand": "Mozilla",
            "version": [
              "5",
              "0"
            ]
          },
          {
            "brand": "AppleWebKit",
            "version": [
              "537",
              "36"
            ]
          }
        ]
      }
    }
  },
  "user": {
    "id": "a876d0gb190X6N49C6144T039Rv",
    "buyeruid": "79pVs5m3XhYE538N5nf6j6Z6qf023z0B",
    "customdata": "JQ171Jwzh0T12N0Gjl73z40Z07527w2280666212Jjk7S5lN",
    "ext": {}
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB7-39"
  ],
  "regs": {
    "ext": {
      "lgpd": 1
    }
  },
  "source": {
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v221310999.214106000.1",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "google.com",
            "sid": "pub-7203890273681265",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zi592K-32715HsNgUv4F7y10GR773cb8V5dp99TSILtoKC1Zz83y0G42c9qm0uVspi99",
    "fcap_scope": 3,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Protobuf OpenRTB

contoh

id: "378836oi92t144hpA8Nv3X"
imp {
  id: "1"
  banner {
    w: 360
    h: 640
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    format {
      w: 360
      h: 640
    }
    format {
      w: 360
      h: 604
    }
  }
  instl: true
  tagid: "7237784749"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  metric {
    type: "click_through_rate"
    value: 0.017687013372778893
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.96
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 88839033718
    billing_id: 42465810344
    publisher_settings_list_id: 6385730468696724206
    publisher_settings_list_id: 7602756188937910294
    allowed_vendor_type: 4374
    allowed_vendor_type: 780
    ampad: AMP_AD_NOT_ALLOWED
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
      is_default: true
    }
    auction_environment: SERVER_SIDE_AUCTION
  }
}
app {
  bundle: "com.google.testapp"
  publisher {
    id: "pub-8927593002710190"
    [com.google.doubleclick.publisher] {
      country: "CN"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "id"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
  }
}
device {
  ua: "Mozilla/5.0 (Linux; Android 6.0; Redmi Note 4 Build/MRA58K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/100.0.4896.127 Mobile Safari/537.36 (Mobile; afma-sdk-a-v221613021.221613021.0)"
  geo {
    lat: 0.0
    lon: 0.0
    country: "IDN"
    region: "ID-JB"
    zip: "46184"
  }
  ipv6: "2001:448a:3066::"
  make: "xiaomi"
  model: "redmi note 4"
  os: "android"
  osv: "6.0"
  devicetype: HIGHEND_PHONE
  ifa: "b\'\\x08\\xc9\\xfa\\x8d\\xe0\\x16OZ\\x97\\xffH9%\\xd8\\xebi\'"
  lmt: false
  w: 360
  h: 640
  pxratio: 3.0
  sua {
    browsers {
      brand: "Chrome"
      version: "100"
      version: "0"
    }
    platform {
      brand: "Android"
      version: "6"
      version: "0"
    }
    mobile: true
    model: "redmi note 4"
  }
}
user {
  id: "H4X9h8D5bFg8tWnh3S065N96C6y"
  [com.google.doubleclick.user] {
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
bcat: "IAB18-5"
bcat: "IAB7-39"
source {
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v221310999.211512000.1"
    schain {
      complete: 1
      nodes {
        asi: "google.com"
        sid: "pub-4062377952200160"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zp09u8-d20rQ521040dqz39K771Lr9102b031Z15C45Q9q7AB414SnDWG5Rj96Z77W66"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
}