معاملات در مخاطب محافظت شده

اجرای معاملات، همچنین به عنوان بازار خصوصی (PMP)، در حراج مخاطب محافظت شده

نمای کلی

معاملات که به آن بازار خصوصی (PMP) نیز گفته می‌شود، در زیرمجموعه‌ای از موجودی، دسترسی انتخاب‌شده یا قیمت‌گذاری ترجیحی را برای خریداران ارائه می‌دهد. برای تسهیل معاملات برنامه‌ای، از شناسه صندلی و شناسه معامله استفاده می‌شود:

  • شناسه صندلی از خریدار منشأ می گیرد و شناسه ای است که نشان دهنده مشتری خریدار است. شناسه صندلی ممکن است پیامدهای صورتحساب داشته باشد، برای مثال، اگر یک صندلی با فروشنده معینی تخفیف داشته باشد.
  • شناسه معامله از خریدار یا فروشنده سرچشمه می گیرد و شناسه ای است که نشان دهنده توافق بین خریدار و فروشنده است. شناسه معامله ممکن است دارای ویژگی هایی مانند هزینه/قیمت، تعهد حجم، اطلاعات مخاطب، انحصار و غیره باشد.

مخاطب محافظت شده معاملات را با استفاده از شناسه‌های گزارش‌دهی تسهیل می‌کند که به شناسه‌های صندلی و معامله برای پیشنهاد مزایده، امتیازدهی و گزارش‌دهی در دسترس قرار می‌گیرد. شناسه‌های گزارش‌دهی مکانیزمی را برای شرکت‌های فناوری تبلیغات فراهم می‌کنند تا این معامله‌ها را دریافت کنند و شناسه‌های جایگاه را در گزارش‌های مخاطبان محافظت‌شده پس از حراج برای انجام معاملات و سازمان‌دهی تلاش‌های صورت‌حساب ارائه کنند. ما انتظار داریم که خریداران، فروشندگان، آژانس‌ها و تبلیغ‌کنندگان استراتژی‌های سفارشی برای تفسیر و درک معامله و شناسه صندلی‌هایی که دریافت می‌کنند داشته باشند.

راهپیمایی

مراحل تسهیل معاملات در حراج مخاطب محافظت شده به شرح زیر است:

  1. خریدار شناسه معامله و صندلی را در پیکربندی گروه علاقه‌مند قبل از اجرای حراج ثبت می‌کند
    • شناسه معامله و صندلی را می توان در قسمت شناسه های گزارش قابل انتخاب ( selectableBuyerAndSellerReportingIds ) تنظیم کرد.
    • اگر شناسه صندلی برای همه معاملات یکسان باشد، آن شناسه صندلی را می‌توان در buyerAndSellerReportingId ، و شناسه‌های معامله را می‌توان در قسمت شناسه‌های گزارش قابل انتخاب ( selectableBuyerAndSellerReportingIds ) تنظیم کرد.
  2. در طول تولید پیشنهاد، شناسه معامله و صندلی در دسترس قرار می گیرد. خریدار شناسه معامله را از selectableBuyerAndSellerReportingIds انتخاب می کند. خریدار پیشنهادی را ایجاد می‌کند که شامل شناسه معامله مرتبط با آن پیشنهاد با بازگرداندن یک selectedBuyerAndSellerReportingId . پیشنهادی تنها در صورتی برنده حراج می‌شود که شناسه معامله برگشتی در کنار سایر شناسه‌های گزارش‌دهی و دارایی‌های انتخابی گروه ذینفع، k-ناشناس باشد.
  3. در طول امتیازدهی آگهی، شناسه معامله و صندلی انتخاب شده در دسترس فروشنده قرار می گیرد.
  4. شناسه معامله و صندلی در عملکردهای گزارش فروشنده موجود می شود.
  5. شناسه معامله و صندلی در عملکردهای گزارش خریدار در دسترس قرار می گیرد.

1. ثبت نام شناسه معاملات و صندلی

خریدار شناسه معامله و صندلی را در پیکربندی گروه علاقه‌مند قبل از اجرای حراج ثبت می‌کند. شناسه معامله و صندلی در selectableBuyerAndSellerReportingIds به عنوان آرایه ای از رشته ها تنظیم می شوند. اگر شناسه صندلی برای همه معاملات یکسان است و نیازی به تکرار آنها نیست، شناسه صندلی را می‌توان در قسمت buyerAndSellerReportingId اضافه کرد که یک رشته را می‌پذیرد:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: ['deal123', 'deal456', 'deal789'], // Deal IDs
      buyerAndSellerReportingId: 'seat123', // Seat ID

      // Though it is not used to facilitate deals, the buyer
      // reporting ID can be defined with other reporting IDs
      buyerAndReportingId: 'brid123'
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

اگر شناسه صندلی برای معاملات متفاوت است، می توان از تنظیمات زیر استفاده کرد:

const interestGroupConfig = {
  owner: 'https://buyer.example',
  name: 'example-ig',
  ad: [
    {
      renderURL: 'https://buyer.example/ad.html',
      selectableBuyerAndSellerReportingIds: [
        'deal123seat123',
        'deal456seat456',
        'deal789seat456'
      ], // Deal and Seat IDs
    },
  ],
};

navigator.joinAdInterestGroup(interestGroupConfig);

2. شناسه معاملات و صندلی برای خریداران در طول تولید پیشنهاد

در طول تولید پیشنهاد، خریدار تصمیم می گیرد که آیا می خواهد برای شناسه معامله پیشنهاد دهد یا خیر. در generateBid() ، خریدار می‌تواند شناسه معامله را از selectableBuyerAndSellerReportingIds انتخاب کند و مقدار را به صورت selectedBuyerAndSellerReportingId برگرداند. اگر شناسه معامله انتخابی در آرایه selectableBuyerAndSellerReportingIds نباشد، پیشنهاد رد می شود.

function generateBid(interestGroup, ...) {
  const [{
    buyerAndSellerReportingId, // 'seat123'
    selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  }] = interestGroup.ads;

  // ...

  return {
    bid: 1,
    render: 'https://buyer.example/ad.html',
    selectedBuyerAndSellerReportingId: 'deal456', // Buyer selects a deal ID
  };
}

پیشنهادی با مقدار بازگشتی برای selectedbuyerAndSellerReportingId تنها در صورتی برنده حراج خواهد شد که ارزش selectedbuyerAndSellerReportingId به طور مشترک k-ناشناس همراه با buyerAndSellerReportingId (در صورت وجود)، buyerReportingId (در صورت وجود) مالک گروه علاقه مند، URL اسکریپت پیشنهاد، URL رندر، تبلیغ باشد. اندازه (اندازه آگهی حداقل تا سه ماهه اول 2025 از این بررسی مستثنی است).

حتی اگر selectablebuyerAndSellerReportingIds در پیکربندی گروه علاقه تعریف شده باشد، باز هم برای generateBid() معتبر است تا پیشنهادی را که شامل selectedbuyerAndSellerReportingId نباشد، برگرداند. در این حالت، شناسه‌های گزارش‌دهی ارائه شده به عملکردهای گزارش‌دهی در صورت برنده شدن این پیشنهاد، از رفتار شناسه گزارش غیرقابل انتخاب تبعیت می‌کنند.

در مواردی که generateBid() دوباره اجرا می‌شود، زیرا فراخوان اولیه هیچ پیشنهادی با تبلیغاتی که بررسی‌های ناشناس بودن k را پشت سر گذاشته‌اند، ایجاد نمی‌کند، سپس selectableBuyerAndSellerReportingIds که بررسی ناشناس بودن k را رد نمی‌کنند، در گروه علاقه‌مندی وجود نخواهد داشت. اجرای مجدد

3. شناسه معامله و صندلی برای فروشندگان در طول امتیازدهی آگهی

شناسه معامله انتخاب شده، همراه با شناسه صندلی در صورت وجود، برای scoreAd() قابل دسترسی است. فروشنده امتیاز مطلوبیت پیشنهاد برنده را با در نظر گرفتن شناسه معامله و هرگونه شرایط خاص ارائه می دهد. اگر فروشنده فکر نمی‌کند شناسه معامله منتخب خریدار اعمال می‌شود، در این صورت فروشنده با دادن نمره مطلوبیت صفر یا منفی پیشنهاد را رد می‌کند.

function scoreAd(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds, // 'deal456'
  } = browserSignals;

  // ...
}

4. شناسه معامله و صندلی برای گزارش فروشندگان

به یاد داشته باشید که یک پیشنهاد فقط در صورتی ممکن است برنده حراج شود که selectedBuyerAndSellerReportingId , buyerAndSellerReportingId (در صورت وجود) و buyerReportingId (در صورت وجود) K-ناشناس با مالک گروه علاقه مندی، URL اسکریپت پیشنهاد، URL رندر و اندازه آگهی (اندازه آگهی از این موارد مستثنی می شود). این بررسی حداقل تا سه ماهه اول 2025). به این ترتیب، مقادیر شناسه گزارش که شامل یک selectedBuyerAndSellerReportingId است، همیشه در داخل reportResult() موجود خواهد بود. توجه داشته باشید که حتی اگر buyerReportingId برای ناشناس بودن k بررسی شود، این مقدار فقط برای تابع گزارش خریدار در دسترس است و در اینجا تابع گزارش فروشنده نیست.

function reportResult(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingIds // 'deal456'
  } = browserSignals;

  // ...
}

5. شناسه معاملات و صندلی برای گزارش خریدار

همین مفهوم از گزارش‌دهی فروشندگان در مورد گزارش‌دهی خریداران نیز صدق می‌کند. به یاد داشته باشید که یک پیشنهاد فقط در صورتی ممکن است برنده حراج شود که selectedBuyerAndSellerReportingId , buyerAndSellerReportingId (در صورت وجود) و buyerReportingId (در صورت وجود) K-ناشناس با مالک گروه علاقه مندی، URL اسکریپت پیشنهاد، URL رندر و اندازه آگهی (اندازه آگهی از این موارد مستثنی می شود). این بررسی حداقل تا سه ماهه اول 2025). به این ترتیب، مقادیر شناسه گزارش که شامل یک selectedBuyerAndSellerReportingId همیشه در داخل reportWin() موجود خواهد بود.

function reportWin(..., browserSignals, ...) {
  const {
    buyerAndSellerReportingId, // 'seat123'
    selectedBuyerAndSellerReportingId // 'deal456'
    buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
  } = browserSignals;
}

مشارکت کنید و بازخورد را به اشتراک بگذارید