הצעת מחיר מטעם חשבונות מרובים

מגיש הצעות מחיר יכול לרכוש מלאי שטחי פרסום לכמה ישויות בהצעת מחיר אחת, אם הישויות האלה הן לקוחות של Authorized Buyers. לדוגמה, פלטפורמה בצד הביקוש (DSP) עשויה להשתמש במגיש הצעות המחיר שלה כדי לרכוש מלאי שטחי פרסום עבור כמה משווקים או סוכנויות שהם עצמם לקוחות של Authorized Buyers. במדריך הזה מוסבר איך לתכנת את מגיש הצעות המחיר כדי לעבד בקשה יחידה שנשלחת מטעם מספר לקוחות של Authorized Buyers.

רקע

Authorized Buyers עובדת עם רשתות מודעות, דסקים למסחר של סוכנויות ופלטפורמות בצד הביקוש (DSP). בתרחישים מסוימים, רשת מודעות או דסק לסחר של סוכנות מסוימת עשויה לעבוד עם מערכת DSP אחת או יותר. יש שתי אפשרויות הטמעה זמינות ללקוחות שעובדים באמצעות DSP:

• מערכת DSP רוכשת מלאי שטחי פרסום עבור משווקים או סוכנויות שאינם לקוחות של Authorized Buyers. במקרה זה, ה-DSP מקבל בקשה אחת להצעת מחיר ומגיב עם הצעת מחיר אחת. Google מחייבת את ה-DSP ישירות.
• מערכת DSP רוכשת מלאי שטחי פרסום עבור משווקים או סוכנויות שהם לקוחות של Authorized Buyers. לקוחות של Authorized Buyers נדרשים להגיש הצעות מחיר באופן עצמאי, גם כשהם משתמשים ב-DSP. המטרה היא לוודא שלבעלי האתרים יש חשיפה של הקונה בפועל, כדי לאפשר הקצאות בלעדיות של מלאי שטחי פרסום וכדי להבטיח שהפניות אוטומטיות לא יעברו מרשת לרשת. במודל הזה, Google מחייבת את הלקוח ב-Authorized Buyers, ולא את ה-DSP. בהמשך המדריך נתמקד בתרחיש הזה.

תוכנית Authorized Buyers מעבירה בקשות להצעות מחיר לחשבונות צאצא של מגיש הצעות מחיר ראשי (DSP) באמצעות מזהה קבוצת מודעות. מזהי קבוצות של מודעות של חשבונות צאצא מסופקים בזמן הגדרת חשבון הצאצא על ידי מנהל חשבון או צוות התמיכה של Authorized Buyers ו-Open Bidding. ה-DSP משתמש במידע זה כדי לעבד את התגובה להצעת המחיר. לפלטפורמת DSP שיש לה לקוחות של Authorized Buyers שמשתמשים בטכנולוגיה שלה כדי לקנות מ-Authorized Buyers, היא מקבלת יתרונות מרכזיים מאוחדים עבור קבוצה של לקוחות ב-RTB.

הגדרה וטירגוט מראש

כל הפלטפורמות בצד הדרישה (DSP) מוגדרות לבקשות מאוחדות. הבחירה של הקריטריונים של הטירגוט מראש מתבצעת ברמת מגיש הצעות המחיר ברמת ההורה, בכל חשבונות הצאצא. ההגדרה הזו נקראת 'טירגוט מראש ברמת מגיש הצעות המחיר' (BLP).

כשמשתמשים ב-BLP, התאמה של מלאי שטחי פרסום מתבצעת רק ברמת מגיש הצעות המחיר ברמה העליונה. התהליך הזה מפשט את תהליך העבודה וניהול קל יותר של מלאי שטחי הפרסום וההגדרות בחשבונות רבים.

היתרונות של טירגוט מראש ברמת מגיש הצעות המחיר לעומת טירגוט מראש רגיל (הוצא משימוש)

טירגוט מראש ברמת מגיש הצעות המחיר	טירגוט רגיל מראש (הוצא משימוש)
מושב ההורה מנהל את הזכאות לכל המושבים	כל עמדה מנהלת בנפרד את הכשירות של מלאי שטחי פרסום
כל המושבים מתאימים לכל סוגי התנועה	הגדרות שונות של טירגוט מראש בחשבונות רבים
הגדרה פשוטה יותר וניהול קל יותר	יש פחות שליטה ברמת מגיש הצעות המחיר ברמה העליונה, אבל שליטה פרטנית בעמדות ספציפיות

לחשבונות צאצא משויך מזהה קבוצת מודעות יחיד, ולכן התאמות של טירגוט מראש נכללות כרשומה אחת בשדה matching_ad_data של BidRequest עבור כל חשבון צאצא תואם.

בתגובה לBidRequest שמכיל התאמות של טירגוט מראש מחשבון שאינו החשבון הראשי (לדוגמה, כל BidRequest שעבורו מוגדר השדה matching_network_data), השדה billing_id בשדה BidResponse נדרש כדי ש-Authorized Buyers יידעו איזה חשבון וקמפיין לשייך להצעת המחיר. כל תגובה שלא מגדירה את השדה תושמט. השדה הזה יישאר אופציונלי לכל BidRequest שכולל רק התאמות של טירגוט מראש מהחשבון של מגיש הצעות המחיר. אם התשובה ל-BidRequest שמכילה התאמות של טירגוט מראש מכמה חשבונות, היא יכולה להחזיר כמה מודעות.

דוגמה לטירגוט מראש ברמת מגיש הצעות המחיר

מושב ילדים (מזהה קבוצת מודעות: 123)	מושב הורה (מזהה קבוצת מודעות: 124)
טירגוט מראש: ארה"ב + האיחוד האירופי	טירגוט מראש: ארה"ב + אסיה-פסיפיק (APAC)

קריטריוני יתרונות מרכזיים	billing_id נשלח
ארה"ב בלבד	123 + 124
באיחוד האירופי בלבד	123
אסיה-פסיפיק (APAC) בלבד	124

בקשות להצעת מחיר לדוגמה

בהמשך מפורטות דוגמאות של 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"

פורמט JSON של OpenRTB

דוגמה

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

OpenRTB Protobuf

דוגמה

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
}