Topics API for Mobile نمای کلی

درباره Topics API در اندروید و مراحل اجرای آن بیاموزید. همچنین می توانید مستقیماً به اجرای موضوعات بپرید.

نحوه عملکرد Topics API

Topics API را می توان برای مشاهده و دسترسی به موضوعاتی که به نظر می رسد مورد علاقه کاربر است، بر اساس فعالیت آنها استفاده کرد. سپس Topics API می تواند به تماس گیرندگان API (مانند پلتفرم های فناوری تبلیغات) به موضوعات مورد علاقه کاربر دسترسی داشته باشد، اما بدون افشای اطلاعات اضافی در مورد فعالیت کاربر.

مفاهیم کلیدی

  • موضوع یک موضوع قابل خواندن برای کاربر مورد علاقه کاربر فعلی است و بخشی از طبقه بندی موضوعات است.
  • تماس گیرنده موجودی است، مانند یک برنامه، یک SDK شخص ثالث، یک وب‌سایت یا سرویس که برای مشاهده یا دسترسی به علایق کاربر از Topics API درخواست می‌کند.
  • یک موضوع توسط تماس‌گیرنده مشاهده می‌شود، اگر تماس‌گیرنده یک درخواست Topics API از یک صفحه وب یا برنامه مرتبط با این موضوع در طول سه دوره گذشته داشته باشد.
  • دوره یک دوره محاسبه موضوع است که به طور پیش فرض یک هفته است.
  • طبقه‌بندی فهرستی سلسله مراتبی از دسته‌ها است که برای مثال شامل دسته‌هایی مانند /Arts & Entertainment/Music & Audio/Soul & R&B و /Business & Industrial/Business Services/Corporate Events .
  • موضوعات با استفاده از یک مدل طبقه بندی کننده مشتق می شوند که فعالیت کاربر را به عنوان صفر یا بیشتر نشان می دهد.

مراحل اصلی جریان موضوعات API

چرخه عمر Topics API سه مرحله اصلی دارد:

  • فعالیت کاربر را مشاهده کنید ، مانند زمانی که آنها از صفحه وب https://cats.example/tabby/index.html بازدید می کنند یا برنامه cats را دانلود می کنند.
  • موضوعات را از فعالیت کاربر استخراج کنید ، به عنوان مثال /Pets & Animals/Pets/Cats .
  • به موضوعاتی که قبلاً برای کاربر مشاهده شده است دسترسی داشته باشید ، به عنوان مثال به عنوان سیگنالی برای انتخاب تبلیغات مرتبط (مانند تبلیغ غذای گربه).

موضوعات را رعایت کنید

تماس گیرندگان فقط می توانند به موضوعات مورد علاقه ای که مشاهده کرده اند دسترسی داشته باشند. زمانی که تماس گیرنده از یک زمینه مرتبط با این موضوع درخواست Topics API می دهد، موضوعی را مشاهده می کند. برای نشان دادن این مفهوم، به مثال ساده زیر توجه کنید.

  • فرض کنید دو تماس گیرنده Topics API وجود دارد: A و B.
  • دو زمینه وجود دارد:
    • Greenhouse ، برای مثال برنامه ای به نام Greenhouse یا وب سایت greenhouse.example که با موضوع Home & Garden مرتبط است.
    • تمرینات تنیس ، به عنوان مثال یک برنامه با نام Tennis Exercises یا یک وب سایت tennis.example، مرتبط با موضوع Sports/Tennis .
  • هر دو تماس گیرنده A و B در زمینه گلخانه حضور دارند.
  • فقط تماس گیرنده B در زمینه تمرینات تنیس حضور دارد.
  • فرض کنید که هیچ موضوعی برای کاربر قبل از دوره 1 مشاهده نشده است، به خاطر ساده سازی.
  • کاربر از برنامه Greenhouse بازدید می کند و تماس گیرندگان A و B برای ضبط بازدید کاربر از صفحه یا برنامه یک تماس API Topics برقرار می کنند (برای اطلاع از نحوه فراخوانی Topics API به راهنمای پیاده سازی پیشنهاد شده در مراحل بعدی مراجعه کنید). این رکورد (نام میزبان یا داده های برنامه) بعداً برای استخراج موضوعات مورد علاقه استفاده می شود. Topics API بعداً موضوع Home & Garden را همانطور که توسط تماس گیرندگان A و B مشاهده شده است علامت گذاری می کند.
  • کاربر از برنامه تمرینات تنیس بازدید می کند. فقط تماس گیرنده B یک درخواست Topics API ارسال می کند. Topics API بعداً موضوع Sports/Tennis را همانطور که توسط تماس گیرنده B مشاهده می شود علامت گذاری می کند.
  • در پایان دوره ، Topics API موضوعات اصلی کاربر را تازه می کند و تماس گیرندگانی را که این موضوعات را مشاهده کرده اند بر اساس فعالیت کاربر تعیین می کند.
  • بعداً، هنگامی که تماس‌گیرنده B تماس دیگری با Topics API برقرار می‌کند، می‌تواند برای این کاربر در آرایه پاسخ، موضوع Home & Garden یا Sports/Tennis (یا با احتمال 5 درصد، موضوع تصادفی) را دریافت کند.
  • تماس گیرنده A فقط می تواند به موضوع Home & Garden دسترسی داشته باشد، زیرا هرگز موضوع Sports/Tennis را مشاهده نکرده است. این بدان معنی است که شخص ثالث فقط در مورد موضوع مورد علاقه کاربر در زمینه خاص (برنامه یا وب سایت) که در آن حضور دارد، یاد می گیرد.
نموداری که tat را نشان می دهد Topics API تنها در صورتی موضوعات مشاهده شده را علامت گذاری می کند که تماس گیرندگان در زمینه حضور داشته باشند.
Topics API موضوعات مشاهده شده را فقط توسط تماس گیرندگانی که در زمینه این موضوعات حضور دارند علامت گذاری می کند. تماس گیرندگان فقط می توانند به موضوعاتی که مشاهده کرده اند دسترسی داشته باشند.

موضوعات را استخراج کنید

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

تماس گیرنده به موضوعات مورد علاقه کاربر دسترسی دارد

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

دوره ها

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

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

،

نحوه عملکرد Topics API

Topics API را می توان برای مشاهده و دسترسی به موضوعاتی که به نظر می رسد مورد علاقه کاربر است، بر اساس فعالیت آنها استفاده کرد. سپس Topics API می تواند به تماس گیرندگان API (مانند پلتفرم های فناوری تبلیغات) به موضوعات مورد علاقه کاربر دسترسی داشته باشد، اما بدون افشای اطلاعات اضافی در مورد فعالیت کاربر.

مفاهیم کلیدی

  • موضوع یک موضوع قابل خواندن برای کاربر مورد علاقه کاربر فعلی است و بخشی از طبقه بندی موضوعات است.
  • تماس گیرنده موجودی است، مانند یک برنامه، یک SDK شخص ثالث، یک وب‌سایت یا سرویس که برای مشاهده یا دسترسی به علایق کاربر از Topics API درخواست می‌کند.
  • یک موضوع توسط تماس‌گیرنده مشاهده می‌شود، اگر تماس‌گیرنده یک درخواست Topics API از یک صفحه وب یا برنامه مرتبط با این موضوع در طول سه دوره گذشته داشته باشد.
  • دوره یک دوره محاسبه موضوع است که به طور پیش فرض یک هفته است.
  • طبقه‌بندی فهرستی سلسله مراتبی از دسته‌ها است که برای مثال شامل دسته‌هایی مانند /Arts & Entertainment/Music & Audio/Soul & R&B و /Business & Industrial/Business Services/Corporate Events .
  • موضوعات با استفاده از یک مدل طبقه بندی کننده مشتق می شوند که فعالیت کاربر را به عنوان صفر یا بیشتر نشان می دهد.

مراحل اصلی جریان موضوعات API

چرخه عمر Topics API سه مرحله اصلی دارد:

  • فعالیت کاربر را مشاهده کنید ، مانند زمانی که آنها از صفحه وب https://cats.example/tabby/index.html بازدید می کنند یا برنامه cats را دانلود می کنند.
  • موضوعات را از فعالیت کاربر استخراج کنید ، به عنوان مثال /Pets & Animals/Pets/Cats .
  • به موضوعاتی که قبلاً برای کاربر مشاهده شده است دسترسی داشته باشید ، به عنوان مثال به عنوان سیگنالی برای انتخاب تبلیغات مرتبط (مانند تبلیغ غذای گربه).

موضوعات را رعایت کنید

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

  • فرض کنید دو تماس گیرنده Topics API وجود دارد: A و B.
  • دو زمینه وجود دارد:
    • Greenhouse ، برای مثال برنامه ای به نام Greenhouse یا وب سایت greenhouse.example که با موضوع Home & Garden مرتبط است.
    • تمرینات تنیس ، به عنوان مثال یک برنامه با نام Tennis Exercises یا یک وب سایت tennis.example، مرتبط با موضوع Sports/Tennis .
  • هر دو تماس گیرنده A و B در زمینه گلخانه حضور دارند.
  • فقط تماس گیرنده B در زمینه تمرینات تنیس حضور دارد.
  • فرض کنید که هیچ موضوعی برای کاربر قبل از دوره 1 مشاهده نشده است، به خاطر ساده سازی.
  • کاربر از برنامه Greenhouse بازدید می کند و تماس گیرندگان A و B برای ضبط بازدید کاربر از صفحه یا برنامه یک تماس API Topics برقرار می کنند (برای اطلاع از نحوه فراخوانی Topics API به راهنمای پیاده سازی پیشنهاد شده در مراحل بعدی مراجعه کنید). این رکورد (نام میزبان یا داده های برنامه) بعداً برای استخراج موضوعات مورد علاقه استفاده می شود. Topics API بعداً موضوع Home & Garden را همانطور که توسط تماس گیرندگان A و B مشاهده شده است علامت گذاری می کند.
  • کاربر از برنامه تمرینات تنیس بازدید می کند. فقط تماس گیرنده B یک درخواست Topics API ارسال می کند. Topics API بعداً موضوع Sports/Tennis را همانطور که توسط تماس گیرنده B مشاهده می شود علامت گذاری می کند.
  • در پایان دوره ، Topics API موضوعات اصلی کاربر را تازه می کند و تماس گیرندگانی را که این موضوعات را مشاهده کرده اند بر اساس فعالیت کاربر تعیین می کند.
  • بعداً، هنگامی که تماس‌گیرنده B تماس دیگری با Topics API برقرار می‌کند، می‌تواند برای این کاربر در آرایه پاسخ، موضوع Home & Garden یا Sports/Tennis (یا با احتمال 5 درصد، موضوع تصادفی) را دریافت کند.
  • تماس گیرنده A فقط می تواند به موضوع Home & Garden دسترسی داشته باشد، زیرا هرگز موضوع Sports/Tennis را مشاهده نکرده است. این بدان معنی است که شخص ثالث فقط در مورد موضوع مورد علاقه کاربر در زمینه خاص (برنامه یا وب سایت) که در آن حضور دارد، یاد می گیرد.
نموداری که tat را نشان می دهد Topics API تنها در صورتی موضوعات مشاهده شده را علامت گذاری می کند که تماس گیرندگان در زمینه حضور داشته باشند.
Topics API موضوعات مشاهده شده را فقط توسط تماس گیرندگانی که در زمینه این موضوعات حضور دارند علامت گذاری می کند. تماس گیرندگان فقط می توانند به موضوعاتی که مشاهده کرده اند دسترسی داشته باشند.

موضوعات را استخراج کنید

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

تماس گیرنده به موضوعات مورد علاقه کاربر دسترسی دارد

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

دوره ها

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

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

مباحث اندروید در عمل

Topics API در Android برای پشتیبانی از SDK های تبلیغاتی شخص ثالث طراحی شده است که معمولاً در چندین برنامه کار می کنند. Topics بدون تکیه بر شناسه های متقابل برنامه، موضوعات تبلیغاتی درشت را بر اساس استفاده کاربر از برنامه ارائه می دهد. این موضوعات را می توان برای تکمیل هر گونه اطلاعات متنی مرتبط با برنامه ای که می خواهد تبلیغی را نمایش دهد، استفاده کرد و می تواند برای کمک به انتخاب یک تبلیغ مناسب برای کاربر، ترکیب شوند.

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

برای نمونه‌های کدی که نحوه تنظیم توانایی واکشی موضوعات برای تبلیغات مبتنی بر علاقه را نشان می‌دهد، به راهنمای اجرای Topics API مراجعه کنید.

ادغام موضوعات بر اساس نوع کسب و کار

برای IBA (تبلیغات مبتنی بر علاقه) با Topics API فعال کنید. برای ادغام Topics API و آماده شدن برای راه‌اندازی، مراحل را بر اساس نوع کسب‌وکار فناوری تبلیغات خود دنبال کنید.

برای همه فناوری های تبلیغاتی

برای فناوری های تبلیغاتی طرف فروش

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

برای فناوری های تبلیغات سمت خرید

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

چگونه API موضوعات را برای یک برنامه استنباط می کند

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

طبقه بندی موضوع

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

  • هنگامی که از مدل طبقه‌بندی کننده برای استنتاج برای محاسبه موضوعات برای یک دوره معین استفاده می‌شود، مجموعه سیگنال‌های مورد استفاده روی دستگاه باقی می‌ماند. این مجموعه سیگنال‌ها ممکن است شامل برنامه‌هایی باشد که نصب شده یا اخیراً استفاده شده‌اند، و ممکن است بعداً برای شامل سایر سیگنال‌ها گسترش یابد.
  • مدل V5 توسط گوگل بر روی 540000 اطلاعات برنامه با برچسب انسانی و 17 میلیون ML در دسترس عموم از فروشگاه های برنامه مانند فروشگاه Google Play آموزش داده شد. این مدل از نام برنامه‌ها و نام بسته‌ها به‌عنوان سیگنال ورودی استفاده می‌کند و به‌طور رایگان برای توسعه‌دهندگان برنامه‌ها در دسترس است تا آن‌ها را آزمایش کنند و ببینند برنامه آن‌ها در چه موضوعاتی طبقه‌بندی می‌شود.
  • این امکان وجود دارد که یک برنامه به بیش از یک موضوع، یا به هیچ موضوعی نگاشت شود، یا به تاریخچه موضوعی کاربر اضافه نشود. در صورتی که یک برنامه به بیش از یک موضوع در طبقه بندی نگاشت شود، تعداد موضوعات انتخاب شده برای این برنامه به سه موضوع برتر محدود می شود.

برای درک بهتر نحوه عملکرد مدل طبقه‌بندی‌کننده، می‌توانید با استفاده از Android Topics Classifier Colab آزمایش کنید که چگونه داده‌های برنامه‌های مختلف بر طبقه‌بندی تأثیر می‌گذارند.

طبقه بندی

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

مباحث اندروید در عمل

فرض کنید یک کاربر هفت برنامه روی دستگاه نصب کرده است: A، B، C، D، E، F و G. فرض کنید که طبقه بندی موضوع برای برنامه و SDK های فناوری تبلیغات در این برنامه ها به شرح زیر است:

برنامه طبقه بندی موضوع SDK فناوری تبلیغات
الف T1، T5 ad-sdk1، ad-sdk2
ب T2 ad-sdk2
سی T3، T6 ad-sdk3، ad-sdk4
D T1، T4 ad-sdk1
E T5 ad-sdk4، ad-sdk5
اف T6 ad-sdk2، ad-sdk3، ad-sdk4
جی T7 ad-sdk2

پایان هفته اول: Topics API 5 موضوع برتر کاربر را برای این دوره تولید می کند.

موضوع برتر تماس گیرندگانی که می توانند در مورد موضوع یاد بگیرند
T1 ad-sdk1، ad-sdk2
T2 ad-sdk2
T3 ad-sdk3، ad-sdk4
T4 ad-sdk1
T5 ad-sdk1، ad-sdk2، ad-sdk4، ad-sdk5

در هفته دوم، اگر تماس‌گیرنده‌ای در هر برنامه‌ای با API تماس بگیرد، لیست موضوعات برگشتی فقط شامل موضوعاتی می‌شود که تماس‌گیرنده در ستون «تماس‌گیرندگانی که می‌توانند درباره موضوع یاد بگیرند» برای آن موضوع برای آن برنامه برای آن دوره است.

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

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

رمزگذاری موضوعات برگشتی

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

Privacy Sandbox این کلیدها را از نقطه پایانی ارائه شده توسط فناوری تبلیغات دریافت می کند. به عنوان بهترین روش توصیه می کنیم که کلیدها به طور مرتب به روز شوند، اما نه حداقل هر شش ماه یکبار.

Privacy Sandbox از تکنسین‌های تبلیغات می‌خواهد تا در دسترس بودن نقطه پایانی را که در طول فرآیند ثبت‌نام ارائه می‌کنند تأیید کنند. برای جزئیات بیشتر در مورد اقدامات مورد نیاز توسط فناوری های تبلیغاتی فعلی و تازه ثبت نام شده، به راهنمای ثبت نام مراجعه کنید

Next steps

Check out implementation details and code samples for callers to observe and access topics.
Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.

See also

Check out our resources to better understand the Topics API on Android.