یک URL با فضای ذخیره‌سازی مشترک انتخاب کنید

یک URL بر اساس داده‌های جمع‌آوری‌شده در فضای ذخیره‌سازی مشترک انتخاب کنید و محتوا را در یک قاب حصاردار ارائه کنید.

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

انتخاب URL می تواند شامل هر نوع محتوا باشد: تبلیغات، مقالات، تصاویر، HTML، فراخوان برای اقدام (مانند دکمه ها) و موارد دیگر.

به عنوان مثال، فرض کنید شما یک سایت مسافرتی راه اندازی می کنید و یک کمپین تبلیغاتی با سه خلاقیت تبلیغاتی مختلف اجرا می کنید. شما می خواهید این خلاقیت ها را بر اساس تعاملات کاربر (مشاهده یا کلیک) ترتیب دهید.

سه آگهی تبلیغاتی که بر اساس تعامل قبلی به کاربران نشان داده می شوند.
اولین خلاقیت برای یک بیننده جدید می گوید: «به ماجراجویی بعدی خودت برو». فقط با یک نمایش و بدون کلیک، کاربر می‌بیند: «گشت‌های آخر هفته را کاوش کنید». پس از مشاهده یا کلیک کردن، سومین خلاقیت کاربران را تشویق می کند که «برای دریافت تخفیف هتل خود کلیک کنید». اگر کاربر روی اولین تبلیغ کلیک کند، تبلیغ بعدی که می بیند، تبلیغ سوم است.

وقتی کاربر برای اولین بار یک فضای تبلیغاتی برنده را مشاهده می کند، می توانید یک شناسه و وضعیت آن خلاقیت را در فضای ذخیره سازی مشترک ذخیره کنید. این بدان معناست که وقتی در یک مزایده تبلیغاتی در سایت‌های دیگری که این کاربر بازدید می‌کند برنده می‌شوید، می‌توانید آگهی متفاوتی را بر اساس آن داده‌ها نمایش دهید.

فضای ذخیره‌سازی مشترک با سه آگهی تبلیغاتی و تعامل با کاربر.

جاوا اسکریپت شما در یک Worklet اجرا می شود تا این اطلاعات را بازیابی کند، اما کد شما نمی تواند با iframe یا فریم حصاردار در صفحه اصلی تعامل داشته باشد یا با آن ارتباط برقرار کند.

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

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

موارد استفاده کنید

انتخاب URL با ذخیره‌سازی مشترک از موارد استفاده مانند موارد زیر پشتیبانی می‌کند:

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

بودجه ها

برای کاهش خطر نشت داده های بین سایتی، Select URL API از یک سیستم بودجه بندی با ترکیبی از بودجه های بلند مدت و کوتاه مدت استفاده می کند:

  • بودجه بلندمدت : 12 بیت برای هر سایت تماس گیرنده بودجه در روز هنگام استفاده از selectURL() . این بودجه تنها زمانی محاسبه می‌شود که فریم میزبان URL انتخابی، پیمایش سطح بالایی را انجام دهد، جایی که هزینه به صورت log2(number of URLs) محاسبه می‌شود. بنابراین، اگر 8 URL برای انتخاب ارائه دهید، هزینه آن 3 بیت است. بودجه باقی مانده برای روز به صورت 12 - (sum of bits deducted in the last 24 hours) و اگر بودجه کافی باقی نماند، URL پیش فرض (اولین URL در لیست) برگردانده می شود و 1 بیت ثبت می شود. URL پیش فرض به پیمایش می شود.

  • بودجه های کوتاه مدت : محدودیت های اضافی بر اساس بارگذاری هر صفحه. یک بودجه بارگیری 6 بیتی برای هر سایت تماس در هر صفحه وجود دارد که با استفاده از selectURL() چقدر یک سایت تماس را محدود می کند. همچنین یک بودجه کلی 12 بیتی برای بارگذاری صفحه وجود دارد که یک محدودیت ترکیبی برای همه سایت‌های تماس در یک صفحه است.

    پرس و جوهای ذخیره شده به شما امکان می دهند از نتیجه selectURL() قبلی در همان صفحه استفاده مجدد کنید و استفاده کوتاه مدت از بودجه را کاهش دهید. هنگامی که selectURL() برای اولین بار با یک نام کوئری ذخیره شده فراخوانی می شود، نمایه به دست آمده برای طول عمر صفحه ذخیره می شود. هنگامی که selectURL() با همان نام query ذخیره شده برای تماس های بعدی فراخوانی می شود، فهرست ذخیره شده برگردانده می شود و عملیات ثبت شده اجرا نمی شود. در این مورد، بودجه فقط در اولین استفاده محاسبه می‌شود، اما نه برای استفاده مجدد در همان بارگذاری صفحه، زیرا هیچ اطلاعات خالص جدیدی فاش نمی‌شود.

    کوئری‌های ذخیره‌شده را می‌توان با افزودن ویژگی savedQuery ، با نام کوئری انتخابی‌تان، به شی گزینه‌ها، همانطور که در مثال زیر نشان داده شده است، پیاده‌سازی کرد.

    const topProductUrls = [
  { url: 'https://ad.example/default-top-product.html' },
  { url: 'https://ad.example/experiment-top-product.html' }];
const relatedProductUrls = [
  { url: 'https://ad.example/default-related-product.html' },
  { url: 'https://ad.example/experiment-related-product.html' }];

// This is the first call to `selectURL()` with `savedQuery: 'control_or_experiment'`
// on this page, so it will be charged to both per-page budgets.
const topProductsConfig = await sharedStorage.selectURL(
  'productExperiment', topProductUrls, {
    savedQuery: 'control_or_experiment',
    keepAlive: true,
    resolveToConfig: true
});
document.getElementById('topProductsFencedFrame').config = topProductsConfig;

// This next call with this savedQuery won't charge either of the per-page budgets.
const relatedProductConfig = await sharedStorage.selectURL(
  'productExperiment', relatedProductUrls, {
    savedQuery: 'control_or_experiment',
    resolveToConfig: true
});
document.getElementById("relatedProductFencedFrame").config = relatedProductConfig;

انتخاب URL را امتحان کنید

انتخاب نشانی وب با API ذخیره‌سازی مشترک برای آزمایش در Chrome Canary/Dev/Beta M105+ موجود است. برای آزمایش انتخاب URL، همه APIهای حریم خصوصی تبلیغات را در chrome://settings/adPrivacy فعال کنید.

آزمایش با نسخه ی نمایشی

یک نسخه نمایشی در دسترس است و می توانید کد را در GitHub مرور کنید.

این نسخه نمایشی از دیدگاه یک تبلیغ‌کننده، فناوری تبلیغات، توزیع‌کننده محتوا یا سایر خدمات شخص ثالث ساخته شده است که می‌خواهد اطلاعات را در سایت‌های ناشران مختلف ذخیره کند. در نسخه ی نمایشی، کد شخص ثالث مشابه برای هر مورد استفاده در هر دو سایت ناشر A و ناشر B اجرا می شود. از صفحه هر ناشر دیدن کنید تا ببینید چگونه داده ها در یک زمینه بین سایتی به اشتراک گذاشته می شوند.

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

پیشنهاد ذخیره‌سازی مشترک در دست بحث فعال است و ممکن است در آینده تغییر کند. اگر این API را امتحان کردید و بازخورد دارید، مایلیم آن را بشنویم.

،

یک URL بر اساس داده‌های جمع‌آوری‌شده در فضای ذخیره‌سازی مشترک انتخاب کنید و محتوا را در یک قاب حصاردار ارائه کنید.

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

انتخاب URL می تواند شامل هر نوع محتوا باشد: تبلیغات، مقالات، تصاویر، HTML، فراخوان برای اقدام (مانند دکمه ها) و موارد دیگر.

به عنوان مثال، فرض کنید شما یک سایت مسافرتی راه اندازی می کنید و یک کمپین تبلیغاتی با سه خلاقیت تبلیغاتی مختلف اجرا می کنید. شما می خواهید این خلاقیت ها را بر اساس تعاملات کاربر (مشاهده یا کلیک) ترتیب دهید.

سه آگهی تبلیغاتی که بر اساس تعامل قبلی به کاربران نشان داده می شوند.
اولین خلاقیت برای یک بیننده جدید می گوید: «به ماجراجویی بعدی خودت برو». فقط با یک نمایش و بدون کلیک، کاربر می‌بیند: «گشت‌های آخر هفته را کاوش کنید». پس از مشاهده یا کلیک کردن، سومین خلاقیت کاربران را تشویق می کند که «برای دریافت تخفیف هتل خود کلیک کنید». اگر کاربر روی اولین تبلیغ کلیک کند، تبلیغ بعدی که می بیند، تبلیغ سوم است.

وقتی کاربر برای اولین بار یک فضای تبلیغاتی برنده را مشاهده می کند، می توانید یک شناسه و وضعیت آن خلاقیت را در فضای ذخیره سازی مشترک ذخیره کنید. این بدان معناست که وقتی در یک مزایده تبلیغاتی در سایت‌های دیگری که این کاربر بازدید می‌کند برنده می‌شوید، می‌توانید آگهی متفاوتی را بر اساس آن داده‌ها نمایش دهید.

فضای ذخیره‌سازی مشترک با سه آگهی تبلیغاتی و تعامل با کاربر.

جاوا اسکریپت شما در یک Worklet اجرا می شود تا این اطلاعات را بازیابی کند، اما کد شما نمی تواند با iframe یا فریم حصاردار در صفحه اصلی تعامل داشته باشد یا با آن ارتباط برقرار کند.

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

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

موارد استفاده کنید

انتخاب URL با ذخیره‌سازی مشترک از موارد استفاده مانند موارد زیر پشتیبانی می‌کند:

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

بودجه ها

برای کاهش خطر نشت داده های بین سایتی، Select URL API از یک سیستم بودجه بندی با ترکیبی از بودجه های بلند مدت و کوتاه مدت استفاده می کند:

  • بودجه بلندمدت : 12 بیت برای هر سایت تماس گیرنده بودجه در روز هنگام استفاده از selectURL() . این بودجه تنها زمانی محاسبه می‌شود که فریم میزبان URL انتخابی، پیمایش سطح بالایی را انجام دهد، جایی که هزینه به صورت log2(number of URLs) محاسبه می‌شود. بنابراین، اگر 8 URL برای انتخاب ارائه دهید، هزینه آن 3 بیت است. بودجه باقی مانده برای روز به صورت 12 - (sum of bits deducted in the last 24 hours) و اگر بودجه کافی باقی نماند، URL پیش فرض (اولین URL در لیست) برگردانده می شود و 1 بیت ثبت می شود. URL پیش فرض به پیمایش می شود.

  • بودجه های کوتاه مدت : محدودیت های اضافی بر اساس بارگذاری هر صفحه. یک بودجه بارگیری 6 بیتی برای هر سایت تماس در هر صفحه وجود دارد که با استفاده از selectURL() چقدر یک سایت تماس را محدود می کند. همچنین یک بودجه کلی 12 بیتی برای بارگذاری صفحه وجود دارد که یک محدودیت ترکیبی برای همه سایت‌های تماس در یک صفحه است.

    پرس و جوهای ذخیره شده به شما امکان می دهند از نتیجه selectURL() قبلی در همان صفحه استفاده مجدد کنید و استفاده کوتاه مدت از بودجه را کاهش دهید. هنگامی که selectURL() برای اولین بار با یک نام کوئری ذخیره شده فراخوانی می شود، نمایه به دست آمده برای طول عمر صفحه ذخیره می شود. هنگامی که selectURL() با همان نام query ذخیره شده برای تماس های بعدی فراخوانی می شود، فهرست ذخیره شده برگردانده می شود و عملیات ثبت شده اجرا نمی شود. در این مورد، بودجه فقط در اولین استفاده محاسبه می‌شود، اما نه برای استفاده مجدد در همان بارگذاری صفحه، زیرا هیچ اطلاعات خالص جدیدی فاش نمی‌شود.

    کوئری‌های ذخیره‌شده را می‌توان با افزودن ویژگی savedQuery ، با نام کوئری انتخابی‌تان، به شی گزینه‌ها، همانطور که در مثال زیر نشان داده شده است، پیاده‌سازی کرد.

    const topProductUrls = [
  { url: 'https://ad.example/default-top-product.html' },
  { url: 'https://ad.example/experiment-top-product.html' }];
const relatedProductUrls = [
  { url: 'https://ad.example/default-related-product.html' },
  { url: 'https://ad.example/experiment-related-product.html' }];

// This is the first call to `selectURL()` with `savedQuery: 'control_or_experiment'`
// on this page, so it will be charged to both per-page budgets.
const topProductsConfig = await sharedStorage.selectURL(
  'productExperiment', topProductUrls, {
    savedQuery: 'control_or_experiment',
    keepAlive: true,
    resolveToConfig: true
});
document.getElementById('topProductsFencedFrame').config = topProductsConfig;

// This next call with this savedQuery won't charge either of the per-page budgets.
const relatedProductConfig = await sharedStorage.selectURL(
  'productExperiment', relatedProductUrls, {
    savedQuery: 'control_or_experiment',
    resolveToConfig: true
});
document.getElementById("relatedProductFencedFrame").config = relatedProductConfig;

انتخاب URL را امتحان کنید

انتخاب نشانی وب با API ذخیره‌سازی مشترک برای آزمایش در Chrome Canary/Dev/Beta M105+ موجود است. برای آزمایش انتخاب URL، همه APIهای حریم خصوصی تبلیغات را در chrome://settings/adPrivacy فعال کنید.

آزمایش با نسخه ی نمایشی

یک نسخه نمایشی در دسترس است و می توانید کد را در GitHub مرور کنید.

این نسخه نمایشی از دیدگاه یک تبلیغ‌کننده، فناوری تبلیغات، توزیع‌کننده محتوا یا سایر خدمات شخص ثالث ساخته شده است که می‌خواهد اطلاعات را در سایت‌های ناشران مختلف ذخیره کند. در نسخه ی نمایشی، کد شخص ثالث مشابه برای هر مورد استفاده در هر دو سایت ناشر A و ناشر B اجرا می شود. از صفحه هر ناشر دیدن کنید تا ببینید چگونه داده ها در یک زمینه بین سایتی به اشتراک گذاشته می شوند.

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

پیشنهاد ذخیره‌سازی مشترک در دست بحث فعال است و ممکن است در آینده تغییر کند. اگر این API را امتحان کردید و بازخورد دارید، مایلیم آن را بشنویم.