ضبط عروض الأسعار بالنيابة عن حسابات متعددة

يمكن لمقدّم عرض السعر شراء مساحة إعلانية لعدة مشترين في ردّ واحد على عرض السعر. على سبيل المثال، قد تستخدم وسيط عرض الطلب (DSP) تطبيق عروض الأسعار الخاص بها لشراء مساحة إعلانية لعدة جهات تسويق أو وكالات من المشترين. يشرح هذا الدليل كيفية برمجة مقدّم عرض السعر لمعالجة طلب واحد يتم إرساله نيابةً عن عدة مشترين.

خلفية

في بعض السيناريوهات، قد تختار شبكة إعلانية أو مكتب تداول تابع لوكالة العمل مع منصة جانب طلب واحدة أو أكثر. يتوفّر خياران للمشترين الذين يعملون من خلال منصة جانب الطلب:

• تشتري منصة جانب الطلب مساحة إعلانية للمسوّقين أو الوكالات التي هي غير مشترين. في هذه الحالة، تتلقّى منصة جانب الطلب طلب عرض سعر واحدًا وتردّ بعرض سعر واحد. وتفرض Google رسومًا على منصة جانب الطلب مباشرةً.
• تشتري منصة جانب الطلب مساحة إعلانية للمسوّقين أو الوكالات المشترين. تتلقّى منصة جانب الطلب طلب عرض سعر واحدًا يتضمّن عدة معرّفات فوترة مرتبطة بالمشترين المؤهّلين، ويمكنها تقديم عروض أسعار منفصلة لكل مشترٍ تنوي تقديم عرض سعر نيابةً عنه. في هذا النموذج، تفرض Google رسومًا على الـ مشترٍ، وليس على منصة جانب الطلب. يركّز باقي هذا الدليل على هذا السيناريو.

الإعداد والاستهداف المسبَّق

سترسل Google طلب عرض سعر يحتوي على معرّف فوترة واحد أو أكثر مرتبط بالمشترين وإعدادات الاستهداف المسبَّق التي استهدفت ظهور الإعلان. ويمكن العثور على هذه المعرّفات في الحقل BidRequest.imp.ext.billing_id.

عند الردّ على BidRequest يحتوي على معرّفات فوترة من عدة مشترين، يكون الحقل BidResponse.seatbid.bid.ext.billing_id مطلوبًا لكي تعرف Google الحساب الذي يجب ربطه بعرض السعر. ويتم فلترة أي ردّ لا يضبط الحقل. ويظلّ الحقل اختياريًا لأي BidRequest يتضمّن معرّف فوترة واحدًا فقط.

مثال على الاستهداف المسبَّق

يقدّم مقدّم عرض السعر عرضًا نيابةً عن مشترَين، أحدهما لديه معرّف فوترة 123 والآخر لديه معرّف فوترة 124. يضبط مقدّم عرض السعر إعداد استهداف مسبَّق واحدًا باستخدام معرّف الفوترة 213 لاستهداف اللغة الإنجليزية، وإعدادًا آخر باستخدام معرّف الفوترة 231 لاستهداف أجهزة الكمبيوتر الشخصية. في ما يلي وصف لمعرّفات الفوترة التي تظهر في طلبات عروض الأسعار لأنواع مختلفة من مرات الظهور.

وصف ظهور الإعلان	معرّفات الفوترة في طلب عرض السعر
محتوى باللغة اليابانية على جهاز كمبيوتر شخصي	123 و124 و231
محتوى باللغة الإنجليزية على هاتف جوّال	123 و124 و213
محتوى باللغة الإنجليزية على جهاز كمبيوتر شخصي	123 و124 و213 و231

ملاحظة مهمة: إذا كانت هذه هي إعدادات الاستهداف المسبَّق النشطة الوحيدة، لن تتلقّى طلبات عروض أسعار لمرات الظهور التي لم تنشأ من جهاز كمبيوتر شخصي وتتضمّن محتوًى غير إنجليزي.

أمثلة على BidRequest

في ما يلي أمثلة على BidRequest. ستلاحظ وجود عدة معرّفات فوترة في هذه الطلبات لأنّها تنطبق على حسابات متعددة.

OpenRTB Protobuf

عرض المثال

Serialized request

id: "2Ic9Szo73ub9164McIS5z4"
imp {
  id: "1"
  banner {
    w: 300
    h: 250
    pos: ABOVE_THE_FOLD
    format {
      w: 300
      h: 250
    }
    format {
      w: 320
      h: 100
    }
  }
  tagid: "3354852099"
  bidfloor: 1.0
  bidfloorcur: "JPY"
  secure: true
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0004362155741546303
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.07
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 14872229026
    billing_id: 65822939644
    publisher_settings_list_id: 5996751740207644979
    publisher_settings_list_id: 7279221809215794243
    allowed_vendor_type: 0
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    allowed_restricted_category: 32
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    gpid: "/7780786/example.com/homepage/image_top"
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "GB"
    }
  }
  content {
    language: "en"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    uact {
      wasact: true
      isact: false
    }
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "GBR"
    region: "GB-ENG"
    zip: "S11"
    type: IP
    utcoffset: 60
    accuracy: 2754
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9046364
    }
  }
  ipv6: "2a02:c7c:c202::"
  language: "en"
  os: "X11"
  devicetype: PERSONAL_COMPUTER
  w: 1536
  h: 864
  pxratio: 1.25
  sua {
    browsers {
      brand: "Google Chrome"
      version: "147"
      version: "0"
    }
    browsers {
      brand: "Not.A/Brand"
      version: "8"
      version: "0"
    }
    platform {
      brand: "Chrome OS"
      version: "16610"
      version: "57"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  data {
    id: "0"
    segment {
      id: "OMITTED"
    }
    segment {
      id: "OMITTED"
    }
    [com.google.doubleclick.data] {
      segtax: 4
    }
  }
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 2577
      consented_providers: 2309
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED_SOURCE"
      uids {
        id: "OMITTED_ID"
      }
    }
    eids {
      source: "OMITTED_SOURCE"
      uids {
        id: "OMITTED_ID"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 500
cur: "BRL"
cur: "GBP"
bcat: "3"
bcat: "4"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zcBbZN-AVQv37tjp208071nti0SFDv2FtD6776DgTHiouw72l227G6q3tZ1777nj5N4A"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

OpenRTB JSON

عرض المثال

{
  "id": "2Ic9Szo73ub9164McIS5z4",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 250,
        "pos": 1,
        "format": [
          {
            "w": 300,
            "h": 250
          },
          {
            "w": 320,
            "h": 100
          }
        ]
      },
      "tagid": "3354852099",
      "bidfloor": 1.0,
      "bidfloorcur": "JPY",
      "secure": 1,
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0004362155741546303,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.07,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "14872229026",
          "65822939644"
        ],
        "publisher_settings_list_id": [
          "5996751740207644979",
          "7279221809215794243"
        ],
        "allowed_vendor_type": [
          0
        ],
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          },
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "allowed_restricted_category": [
          32
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "gpid": "/7780786/example.com/homepage/image_top"
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "GB"
      }
    },
    "content": {
      "language": "en"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "uact": {
        "wasact": 1,
        "isact": 0
      },
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "GBR",
      "region": "GB-ENG",
      "zip": "S11",
      "type": 2,
      "utcoffset": 60,
      "accuracy": 2754,
      "ext": {
        "geo_criteria_id": 9046364
      }
    },
    "ipv6": "2a02:c7c:c202::",
    "language": "en",
    "os": "X11",
    "devicetype": 2,
    "w": 1536,
    "h": 864,
    "pxratio": 1.25,
    "sua": {
      "browsers": [
        {
          "brand": "Google Chrome",
          "version": [
            "147",
            "0"
          ]
        },
        {
          "brand": "Not.A/Brand",
          "version": [
            "8",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Chrome OS",
        "version": [
          "16610",
          "57"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "data": [
      {
        "id": "0",
        "segment": [
          {
            "id": "OMITTED"
          },
          {
            "id": "OMITTED"
          }
        ],
        "ext": {
          "segtax": 4
        }
      }
    ],
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "2577",
          "2309"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED_SOURCE",
          "uids": [
            {
              "id": "OMITTED_ID"
            }
          ]
        },
        {
          "source": "OMITTED_SOURCE",
          "uids": [
            {
              "id": "OMITTED_ID"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 500,
  "cur": [
    "BRL",
    "GBP"
  ],
  "bcat": [
    "3",
    "4"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zcBbZN-AVQv37tjp208071nti0SFDv2FtD6776DgTHiouw72l227G6q3tZ1777nj5N4A",
    "fcap_scope": 1,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}