یک راه حل مبتنی بر موضوعات را آزمایش، استقرار و مقیاس بندی کنید

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

پیاده‌سازی بک‌اند مباحث

پیاده‌سازی بک‌اند شما بستگی به این دارد که چگونه می‌خواهید از موضوعات محاسبه‌شده در مرورگر استفاده کنید. ما توصیه می‌کنیم که راهکارهای فناوری تبلیغات از موضوعات به عنوان یک سیگنال IBA اضافی استفاده کنند.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

از تاپیک‌ها به عنوان یک سیگنال اضافی استفاده کنید

داده‌های مربوط به موضوعات را می‌توان در کنار سایر سیگنال‌ها مانند URLها، کلمات کلیدی یا سایر فراداده‌ها، به عنوان یک سیگنال اضافی در مورد مخاطبان خود در نظر گرفت.

همانطور که در بخش «به حداکثر رساندن ارتباط آگهی پس از کوکی‌های شخص ثالث» توضیح داده شد، رویکردهای متعددی برای استفاده از موضوعات (Topics) برای ارائه تبلیغات مرتبط وجود دارد. برخی از این رویکردها شامل استفاده از موضوعات (Topics) برای ایجاد مخاطب است و رویکردهای دیگر، استفاده از موضوعات (Topics) را به عنوان یک سیگنال در میان سیگنال‌های دیگر برای آموزش مدل‌های یادگیری ماشین پیشنهاد می‌دهند که برای استنباط علایق بیشتر مخاطبان یا حتی بهینه‌سازی منطق پیشنهاد قیمت استفاده خواهند شد.

ساخت و استقرار

  1. جمع‌آوری موضوعات با مشاهده کاربران در محیط عملیاتی (زمان تقریبی پیاده‌سازی: تقریباً یک هفته):
    • گزینه‌های خود را درک کنید: نحوه فراخوانی موضوعات با هدرهای HTTP یا iframe و جاوا اسکریپت .
    • دامنه‌ی iframe که API مربوط به موضوعات را فراخوانی می‌کند، تعریف کنید.
    • با استفاده از نسخه نمایشی هدر یا نسخه نمایشی جاوا اسکریپت به عنوان مرجع کد، راه حل خود را بسازید.
    • مباحث را در کدی که ناشران در سایت‌های خود جاسازی می‌کنند (مثلاً iframe تبلیغ شما) ادغام کنید. مطمئن شوید که مباحث را از طریق جاسازی فراخوانی می‌کنید.
    • برای شروع مشاهده موضوعات کاربران، آخرین نسخه اسکریپت خود را در وب‌سایت‌های تولیدی خود جاسازی کنید. توصیه می‌کنیم ابتدا پیاده‌سازی را در وب‌سایت‌های خودتان که تعداد بازدیدهای ماهانه کمی دارند، آزمایش کنید. در این مرحله، توصیه می‌کنیم راه‌حل جدید مبتنی بر موضوعات خود را حداقل در پنج سایت جاسازی کنید.
    • در این مرحله، انتظار می‌رود که API یک آرایه خالی را به عنوان نتیجه برگرداند. دلیل این امر این است که هنوز هیچ موضوعی برای کاربر مشاهده نشده است. شروع دریافت موضوعات کاربر می‌تواند تا سه هفته طول بکشد.
    • تست عملکردی و اعتبارسنجی را انجام دهید. می‌توانید راه‌حل خود را به صورت دستی یا خودکار آزمایش کنید. برای مثال:
      • مرورگر خود را با پرچم‌ها باز کنید و دوره زمانی را روی ۱۵ ثانیه تنظیم کنید تا مرورگر موضوعات را زودتر دوباره محاسبه کند.
      • از سایت‌هایی که اسکریپت شما را جاسازی می‌کنند، بازدید کنید.
      • بررسی کنید که آیا اسکریپت شما در chrome://topics-internals/ موضوعات را مشاهده می‌کند یا خیر.
      • ببینید کدام نتایج را می‌توانید انتظار داشته باشید.
  2. از داده‌های Topics به همراه سایر سیگنال‌های زمینه‌ای (مانند URLها، فراداده‌ها و غیره) استفاده کنید (زمان تخمینی: حدود ۳ روز).
    • پس از سه هفته تولید، اسکریپت شما باید موضوعات برخی از کاربران را مشاهده کرده باشد. در این مرحله، باید بتوانید از داده‌های موضوعات به عنوان یک سیگنال اضافی استفاده کنید.
    • به محض اینکه شروع به دریافت لیست غیر خالی از موضوعات کردید، می‌توانید آن را به همراه سایر سیگنال‌های زمینه‌ای به بخش مدیریت خود ارسال کنید.

استقرار در سایت‌های هدف

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

  • API مربوط به موضوعات فراخوانی می‌شود.
  • مباحث را می‌توان در این محیط کنترل‌شده مشاهده کرد .
  • می‌توان به موضوعات دسترسی پیدا کرد (API موضوعات مشاهده‌شده را برای کاربر برمی‌گرداند).

سایت‌های هدف را انتخاب کنید

قبل از استقرار راهکار خود در سایت‌های ناشران، توصیه می‌کنیم آن را در یک محیط کنترل‌شده، روی وب‌سایت‌هایی که خودتان مالک آنها هستید، آزمایش کنید. توصیه می‌کنیم وب‌سایت‌های هدف را به شرح زیر انتخاب کنید:

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

آزمایش عملکردی و اعتبارسنجی

هنگام فراخوانی API موضوعات در این محیط محدود، می‌توانید نتایج زیر را انتظار داشته باشید :

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

  • فهرستی از صفر تا سه موضوع، که نشان‌دهنده‌ی علایق این کاربر است. پس از هفت روز مشاهده، باید موارد زیر را دریافت کنید:

    • یک موضوع، که از بین پنج موضوع برتر برای کاربر انتخاب شده است ، از روی نام میزبان صفحاتی که موضوعات در آن هفته توسط تماس‌گیرنده مشاهده شده‌اند، محاسبه می‌شود.

  • دقیقاً همان پاسخ API که در تمام فراخوانی‌های API تاپیک‌های قبلی وجود داشت. برای همان فراخوانی‌کننده، کاربر و سایت سطح بالا، API تاپیک‌های یکسانی را برای کل یک دوره برمی‌گرداند. این به جلوگیری از افشای بسیاری از علایق کاربر کمک می‌کند. جزئیات بیشتر را در GitHub بیابید.

  • اگر پس از چهار هفته مشاهده، با یکی از سه موضوع قدیمی تماس می‌گیرید، یک موضوع جدید جایگزین آن می‌شود.

  • اگر در سه هفته گذشته یا بیشتر، موضوعات مربوط به کاربر را مشاهده نکرده باشید، API موضوعات دوباره یک آرایه خالی [] برمی‌گرداند.

معیارهای عملکرد را برای ارزیابی تجربه کاربری خود جمع‌آوری کنید:

  • زمان اجرای فراخوانی‌های جاوا اسکریپت به API موضوعات درون یک iframe با مبدا متقابل باید اندازه‌گیری شود تا در تحلیل‌های عملکرد آینده مورد استفاده قرار گیرد.
  • مدت زمان لازم برای ایجاد یک تاپیک iframe و postMessage() ، پس از دریافت تاپیک‌ها.

برای رفع مشکل به بخش پشتیبانی مراجعه کنید.

مقیاس‌پذیری برای تولید

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

در اینجا خلاصه‌ای گام به گام از نحوه‌ی مقیاس‌پذیری تا تولید انبوه ارائه شده است:

  1. راه‌حل مبتنی بر موضوعات خود را روی حجم بیشتری از ترافیک آزمایش کنید.
    • iframe خود را به سایت‌های بیشتری که تعداد بازدید بیشتری دارند اضافه کنید و دستورالعمل‌های زیر را برای انجام تست بارگذاری دنبال کنید.
  2. راهکار خود را در سایت‌های ناشران مستقر کنید.
    • وقتی راه‌حل شما در محیط آزمایشی خودتان به درستی کار کرد، با ناشران همکاری کنید تا iframe شما را در وب‌سایت‌هایشان ادغام کنند. به عنوان مثال، ممکن است لازم باشد کتابخانه‌ای را که iframe شما را در خود جای داده است، به‌روزرسانی کنند.
  3. پردازش و استفاده از داده‌های موضوعات (زمان تخمینی: حدود چهار هفته).
    • داده‌های موضوعی را به عنوان یک سیگنال افزایشی در کنار سایر داده‌ها بگنجانید.
    • شرکای تست پیشنهاد قیمت لحظه‌ای را پیدا کنید.
    • تست کاربردی بودن را با موضوعات به عنوان یک سیگنال افزودنی به سایر داده‌های خود اجرا کنید.

آزمایش بار

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

  1. به تدریج در سایت‌های هدف بیشتری که متعلق به خودتان هستند، به ویژه سایت‌هایی که حجم ترافیک بیشتری دارند، مستقر شوید.
  2. با توجه به ترافیک مورد انتظار، تست بار را برای داده‌های موضوعات خود انجام دهید.
    • شما باید اطلاعات موضوع را از iframe به backend خود ارسال کنید. این به شما امکان می‌دهد نتایج API موضوعات را بیشتر پردازش کنید و از آنها به عنوان یک سیگنال اضافی برای کمک به انتخاب تبلیغاتی که برای کاربر مرتبط‌تر هستند استفاده کنید. هرچه سایت‌های بیشتری از جاسازی شما استفاده کنند، تعداد فراخوانی‌ها به backend شما به طور قابل توجهی افزایش می‌یابد. تأیید کنید که backend شما می‌تواند حجم زیادی از فراخوانی‌ها را از iframe مدیریت کند.
    • جمع‌آوری معیارها و گزارش‌ها را برای تجزیه و تحلیل تنظیم کنید.
  3. بلافاصله پس از استقرار API موضوعات، معیارهای خود را بررسی کنید تا هرگونه مشکل جدی کاربر نهایی را تشخیص دهید. مرتباً معیارهای خود را بررسی کنید.
  4. در صورت بروز اختلال یا رفتار غیرمنتظره، استقرار را به حالت اولیه برگردانید و گزارش‌های خود را تجزیه و تحلیل کنید تا مشکل را بفهمید و برطرف کنید.

همچنین ببینید

برای درک بهتر Topics API در وب، منابع ما را بررسی کنید.