एक से ज़्यादा खातों की तरफ़ से बोली लगाना

अगर कोई व्यक्ति Authorized Buyers क्लाइंट है, तो बिडिंग करने वाला व्यक्ति एक ही बिड में कई इकाइयों के लिए इन्वेंट्री खरीद सकता है. उदाहरण के लिए, एक डिमांड-साइड प्लैटफ़ॉर्म (DSP), अपने बिडिंग करने वाले का इस्तेमाल करके कई मार्केटर या एजेंसियों के लिए इन्वेंट्री खरीद सकता है, जो खुद Authorized Buyers के क्लाइंट हैं. इस गाइड में बताया गया है कि कई Authorized Buyers क्लाइंट की ओर से भेजे गए एक अनुरोध को प्रोसेस करने के लिए, बिड करने वाले को किस तरह कोड करना होगा.

बैकग्राउंड

Authorized Buyers, विज्ञापन नेटवर्क कंपनी, एजेंसी ट्रेडिंग डेस्क, और डिमांड-साइड प्लैटफ़ॉर्म (DSP) के साथ काम करते हैं. कुछ स्थितियों में, कोई विज्ञापन नेटवर्क कंपनी या एजेंसी ट्रेडिंग डेस्क एक या ज़्यादा डीएसपी के साथ काम करने का विकल्प चुन सकती है. डीएसपी के ज़रिए काम करने वाले क्लाइंट के लिए लागू करने के दो विकल्प उपलब्ध हैं:

• DSP, मार्केटर या ऐसी एजेंसियों के लिए इन्वेंट्री खरीदता है जो Authorized Buyers क्लाइंट नहीं हैं. इस मामले में, डीएसपी को बिड के लिए एक अनुरोध मिलता है और वह एक बिड के साथ जवाब देती है. Google सीधे DSP को बिल भेजता है.
• DSP, मार्केटर या Authorized Buyers क्लाइंट वाली एजेंसियों के लिए इन्वेंट्री खरीदता है. Authorized Buyers, क्लाइंट को डीएसपी के साथ काम करने के दौरान भी स्वतंत्र रूप से बिडिंग करनी होती है. इससे यह पक्का किया जाता है कि पब्लिशर को असल खरीदार की जानकारी दिखे. साथ ही, इससे इन्वेंट्री को खास तौर पर असाइन करने की सुविधा चालू हो सके. साथ ही, यह भी पक्का किया जा सके कि कोई भी रीडायरेक्ट, नेटवर्क से नेटवर्क पर न जाए. इस मॉडल में Google, Authorized Buyers क्लाइंट को बिल भेजता है, DSP को नहीं. इस गाइड के बाकी हिस्से में, इसी स्थिति पर फ़ोकस किया गया है.

Authorized Buyers, पैरंट बिडर (DSP) के चाइल्ड खातों के लिए बिड रिक्वेस्ट को विज्ञापन ग्रुप आईडी के ज़रिए रूट करता है. चाइल्ड खाते के विज्ञापन ग्रुप के आईडी, खाता सेट अप करते समय खाता मैनेजर या Authorized Buyers और ओपन बिडिंग सहायता टीम की ओर से दी जाती है. DSP इस जानकारी का इस्तेमाल बिड रिस्पॉन्स को प्रोसेस करने के लिए करती है. किसी DSP के पास ऐसे Authorized Buyers क्लाइंट होते हैं जो Authorized Buyers से खरीदारी करने के लिए, अपनी टेक्नोलॉजी का इस्तेमाल करते हैं. उन्हें RTB क्लाइंट के सेट के लिए, सभी खातों के लिए एक कॉल आउट मिलता है.

सेटअप और प्री-टारगेटिंग

सभी DSP को इकट्ठा किए गए अनुरोधों के लिए कॉन्फ़िगर किया जाता है. पहले से टारगेट करने की शर्तें, सभी चाइल्ड खातों के लिए, पैरंट बिडर के लेवल पर चुनी जाती हैं. इसे बिडर लेवल प्री-टारगेटिंग (बीएलपी) कहा जाता है.

BLP की मदद से, सिर्फ़ पैरंट बिडर के लेवल पर इन्वेंट्री मैचिंग की जाती है. इससे वर्कफ़्लो आसान हो जाता है. साथ ही, कई खातों में इन्वेंट्री और सेटिंग को मैनेज करना आसान हो जाता है.

बिडर लेवल प्री-टारगेटिंग बनाम सामान्य प्री-टारगेटिंग के फ़ायदे (अब काम नहीं करते)

बिडर-लेवल प्री-टारगेटिंग	नियमित प्री-टारगेटिंग (अब सेवा में नहीं है)
पैरंट सीट से, सभी सीटों पर ज़रूरी शर्तें लागू होती हैं	हर सीट अपनी इन्वेंट्री की ज़रूरी शर्तें खुद मैनेज करती है
सभी सीटें, ट्रैफ़िक से जुड़ी ज़रूरी शर्तें पूरी करती हैं	कई खातों में अलग-अलग प्री-टारगेटिंग सेटअप
सेटअप और मैनेज करने में आसान	पैरंट बिडर के लेवल पर, इस पर कम कंट्रोल है. हालांकि, खास सीटों के लिए ज़्यादा कंट्रोल

चाइल्ड खातों से सिर्फ़ एक विज्ञापन ग्रुप आईडी जुड़ा होता है. इसलिए, मैच होने वाले हर चाइल्ड खाते के लिए, BidRequest के matching_ad_data फ़ील्ड में, प्री-टारगेटिंग मैच को एक एंट्री के तौर पर शामिल किया जाता है.

जब ऐसे BidRequest का जवाब दिया जाता है जिसमें पैरंट खाते के अलावा, किसी दूसरे खाते के प्री-टारगेटिंग मैच हैं (उदाहरण के लिए, कोई भी BidRequest जिसके लिए matching_network_data फ़ील्ड सेट है), तो BidResponse में मौजूद billing_id फ़ील्ड की ज़रूरत होती है. इससे Authorized Buyers को पता चलता है कि बिड के साथ किस खाते और कैंपेन को जोड़ना है. फ़ील्ड को सेट नहीं करने वाला कोई भी जवाब छोड़ दिया जाता है. यह फ़ील्ड, ऐसे किसी भी BidRequest के लिए ज़रूरी नहीं रहता है जिसमें सिर्फ़ बिड करने वाले के खाते से मिलने वाले प्री-टारगेटिंग मैच शामिल होते हैं. अगर BidRequest में कई खातों से प्री-टारगेटिंग मैच होते हैं, तो जवाब में कई विज्ञापन दिख सकते हैं.

बिडर लेवल प्री-टारगेटिंग का उदाहरण

चाइल्ड सीट (विज्ञापन ग्रुप आईडी: 123)	पैरंट सीट (विज्ञापन ग्रुप आईडी: 124)
पहले से टारगेट करना: अमेरिका + ईयू	पहले से टारगेट करना: अमेरिका + एशिया पैसिफ़िक (APAC)

कॉलआउट की शर्तें	Billing_id भेजा गया
केवल अमेरिका	123 + 124
सिर्फ़ ईयू (यूरोपीय संघ)	123
सिर्फ़ एशिया पैसिफ़िक (APAC)	124

BidRequests के उदाहरण

BidRequest के उदाहरण नीचे दिए गए हैं. आपको इस बात का ध्यान रखना होगा कि इन अनुरोधों में एक से ज़्यादा बिलिंग आईडी मौजूद हैं, क्योंकि ये अनुरोध कई खातों पर लागू होते हैं.

Google

सैंपल

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"

OpenRTB JSON

सैंपल

{
  "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
    }
  }
}

ओपनआरटीबी प्रोटोबफ़

सैंपल

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
}