Topics API برای موبایل: نمای کلی

درباره API مربوط به موضوعات (Topics API) در اندروید و مراحل پیاده‌سازی آن اطلاعات کسب کنید. همچنین می‌توانید مستقیماً به پیاده‌سازی موضوعات (topics) بپردازید.

نحوه عملکرد 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 را مشاهده نکرده است. این بدان معنی است که شخص ثالث فقط در مورد موضوع مورد علاقه کاربر در زمینه خاص (برنامه یا وب سایت) که در آن حضور دارد، یاد می گیرد.
نمودار نشان می دهد که Topics API فقط در صورتی موضوعات مشاهده شده را علامت گذاری می کند که تماس گیرندگان در متن حضور داشته باشند.
Topics API موضوعات مشاهده شده را فقط توسط تماس گیرندگانی که در زمینه این موضوعات حضور دارند علامت گذاری می کند. تماس گیرندگان فقط می توانند به موضوعاتی که مشاهده کرده اند دسترسی داشته باشند.

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

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

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

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

دوره ها

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

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

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

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

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

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

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

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

برای همه تکنسین‌های تبلیغات

برای تکنسین‌های تبلیغات سمت فروش

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

برای تکنسین‌های تبلیغات سمت خریدار

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

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

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

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

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

  • وقتی از مدل طبقه‌بندی برای استنتاج محاسبه موضوعات برای یک دوره معین استفاده می‌شود، مجموعه سیگنال‌های مورد استفاده روی دستگاه باقی می‌مانند. این مجموعه سیگنال‌ها ممکن است شامل برنامه‌های نصب شده یا اخیراً استفاده شده باشد و بعداً ممکن است برای شامل شدن سیگنال‌های دیگر گسترش یابد.
  • مدل V5 توسط گوگل بر روی ۵۴۰،۰۰۰ اطلاعات برنامه برچسب‌گذاری شده توسط انسان و ۱۷ میلیون اطلاعات برنامه برچسب‌گذاری شده توسط ماشین که به صورت عمومی از فروشگاه‌های برنامه مانند فروشگاه Google Play در دسترس هستند، آموزش داده شده است. این مدل از نام برنامه‌ها و نام بسته‌ها به عنوان سیگنال‌های ورودی استفاده می‌کند و به صورت رایگان در دسترس توسعه‌دهندگان برنامه قرار دارد تا آن را آزمایش کنند و ببینند برنامه آنها در چه موضوعاتی طبقه‌بندی می‌شود.
  • ممکن است یک برنامه به بیش از یک موضوع نگاشت شود، یا به هیچ موضوعی نگاشت نشود، یا اینکه به تاریخچه موضوعات کاربر اضافه نشود. در صورتی که یک برنامه به بیش از یک موضوع در طبقه‌بندی نگاشت شود، تعداد موضوعات انتخاب شده برای این برنامه به سه مورد برتر محدود خواهد شد.

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

طبقه‌بندی

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

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

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

برنامه طبقه‌بندی موضوعی کیت توسعه نرم‌افزار (SDK) فناوری تبلیغات
الف تی۱، تی۵ ad-sdk1، ad-sdk2
ب تی۲ تبلیغات-sdk2
سی تی۳، تی۶ ad-sdk3، ad-sdk4
دی تی۱، تی۴ ad-sdk1
ای تی۵ ad-sdk4، ad-sdk5
ف تی۶ ad-sdk2، ad-sdk3، ad-sdk4
جی تی۷ تبلیغات-sdk2

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

موضوع برتر تماس‌گیرندگانی که می‌توانند در مورد موضوع اطلاعات کسب کنند
تی۱ ad-sdk1، ad-sdk2
تی۲ تبلیغات-sdk2
تی۳ ad-sdk3، ad-sdk4
تی۴ ad-sdk1
تی۵ ad-sdk1، ad-sdk2، ad-sdk4، ad-sdk5

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

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

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

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

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

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

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

مراحل بعدی

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

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

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