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

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

موضوعات پیاده سازی باطن

پیاده سازی Backend شما بستگی به نحوه استفاده از موضوعات محاسبه شده در مرورگر دارد. توصیه می‌کنیم راه‌حل‌های فناوری تبلیغات از Topics به عنوان سیگنال 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، کلمات کلیدی یا سایر ابرداده‌ها، به عنوان سیگنالی اضافی درباره مخاطبان در نظر گرفت.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مقیاس به تولید

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

در اینجا یک خلاصه گام به گام از نحوه تولید مقیاس وجود دارد:

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

تست بار

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

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

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

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