Topics API: راهنمای ادغام، موضوعات API: راهنمای ادغام، موضوعات API: راهنمای ادغام

Topics API برای Android برای پشتیبانی از تبلیغات مبتنی بر علاقه بدون تکیه بر شناسه‌های متقابل برنامه طراحی شده است.

تبلیغ‌کنندگان تلاش می‌کنند تا تبلیغات مرتبطی را ارائه دهند که به علاقه کاربر مربوط می‌شود. به عنوان مثال، اگر کاربر به اطلاعات مربوط به آشپزی علاقه مند باشد، ممکن است تبلیغات مرتبط با آشپزی را نسبت به تبلیغاتی که به علایق او مرتبط نیست مرتبط تر بداند.

تبلیغات مبتنی بر علاقه (IBA) نوعی تبلیغات شخصی سازی شده است که در آن تبلیغات بر اساس علایق کاربر انتخاب می شوند. با Privacy Sandbox در Android، این علایق از برنامه‌هایی که کاربر با آن‌ها درگیر شده است، نشأت می‌گیرد. این با تبلیغات متنی متفاوت است، که صرفاً بر اساس علایق ناشی از محتوای فعلی مشاهده شده است. IBA برنامه‌ها را قادر می‌سازد تا تبلیغات مرتبط و جذاب‌تری نسبت به تبلیغات متنی نشان دهند.

IBA معمولاً شامل ارتباط بین برنامه‌ها، فروشندگان و خریداران است. این راهنما برای همه این طرف‌ها، از جمله شبکه‌ها و فناوری‌های تبلیغاتی که هم به عنوان خریدار و هم فروشنده عمل می‌کنند، در نظر گرفته شده است.

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

هنگام اجرای تبلیغات مبتنی بر علاقه با Topics API ملاحظات سطح بالایی وجود دارد:

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

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

واژه شناسی

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

اهداف

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

در حال حاضر، اهداف برنامه‌ریزی یکپارچه‌سازی برای Privacy Sandbox در پیش‌نمایش برنامه‌نویس Android شامل توانایی انجام موارد زیر است:

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

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

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

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

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

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

پیش نیازها و راه اندازی

توسعه دهندگان برنامه، فروشندگان و خریداران باید این مراحل را دنبال کنند تا برای استفاده از Topics API راه اندازی شوند.

با API آشنا شوید

  1. با خواندن طرح پیشنهادی شروع کنید تا با Topics API و قابلیت های آن آشنا شوید.
  2. راهنمای توسعه‌دهنده را بخوانید تا یاد بگیرید که چگونه کد و فراخوان‌های API را که برای موارد استفاده خود نیاز دارید به کار ببرید.
  3. طبقه بندی را مرور کنید و در مورد موضوعاتی که در لیست گنجانده شده است بازخورد ارائه دهید.
  4. برای طرح پیشنهادی یا مستندات بازخورد ارسال کنید .
  5. برای دریافت به‌روزرسانی‌ها در Topics API ثبت‌نام کنید . این به شما کمک می‌کند تا در مورد ویژگی‌های جدیدی که در نسخه‌های آینده معرفی می‌شوند، در جریان باشید.

برنامه نمونه را راه اندازی و تست کنید

  1. دستورالعمل‌های این صفحه را برای راه‌اندازی Privacy Sandbox در Android SDK در Android Studio دنبال کنید .
  2. برای آشنایی با نحوه بازیابی موضوعات در دستگاه، کد را در نسخه جاوا یا کاتلین برنامه نمونه فورک کرده و اجرا کنید.
  3. در حین آزمایش ، اطلاعات برنامه را برای نام و توضیحات آزمایش کنید تا موضوعاتی را که از طبقه‌بندی‌کننده روی دستگاه برمی‌گردند، تغییر دهید.
  4. پس از اینکه متوجه شدید که API مشتری و طبقه‌بندی‌های روی دستگاه چگونه کار می‌کنند، از برنامه نمونه به عنوان مثال برای هدایت یکپارچه‌سازی خود استفاده کنید.

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

،

Topics API برای Android برای پشتیبانی از تبلیغات مبتنی بر علاقه بدون تکیه بر شناسه‌های متقابل برنامه طراحی شده است.

تبلیغ‌کنندگان تلاش می‌کنند تا تبلیغات مرتبطی را ارائه دهند که به علاقه کاربر مربوط می‌شود. به عنوان مثال، اگر کاربر به اطلاعات مربوط به آشپزی علاقه مند باشد، ممکن است تبلیغات مرتبط با آشپزی را نسبت به تبلیغاتی که به علایق او مرتبط نیست مرتبط تر بداند.

تبلیغات مبتنی بر علاقه (IBA) نوعی تبلیغات شخصی سازی شده است که در آن تبلیغات بر اساس علایق کاربر انتخاب می شوند. با Privacy Sandbox در Android، این علایق از برنامه‌هایی که کاربر با آن‌ها درگیر شده است، نشأت می‌گیرد. این با تبلیغات متنی متفاوت است، که صرفاً بر اساس علایق ناشی از محتوای فعلی مشاهده شده است. IBA برنامه‌ها را قادر می‌سازد تا تبلیغات مرتبط و جذاب‌تری نسبت به تبلیغات متنی نشان دهند.

IBA معمولاً شامل ارتباط بین برنامه‌ها، فروشندگان و خریداران است. این راهنما برای همه این طرف‌ها، از جمله شبکه‌ها و فناوری‌های تبلیغاتی که هم به عنوان خریدار و هم فروشنده عمل می‌کنند، در نظر گرفته شده است.

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

هنگام اجرای تبلیغات مبتنی بر علاقه با Topics API ملاحظات سطح بالایی وجود دارد:

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

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

واژه شناسی

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

اهداف

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

در حال حاضر، اهداف برنامه‌ریزی یکپارچه‌سازی برای Privacy Sandbox در پیش‌نمایش برنامه‌نویس Android شامل توانایی انجام موارد زیر است:

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

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

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

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

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

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

پیش نیازها و راه اندازی

توسعه دهندگان برنامه، فروشندگان و خریداران باید این مراحل را دنبال کنند تا برای استفاده از Topics API راه اندازی شوند.

با API آشنا شوید

  1. با خواندن طرح پیشنهادی شروع کنید تا با Topics API و قابلیت های آن آشنا شوید.
  2. راهنمای توسعه‌دهنده را بخوانید تا یاد بگیرید که چگونه کد و فراخوان‌های API را که برای موارد استفاده خود نیاز دارید به کار ببرید.
  3. طبقه بندی را مرور کنید و در مورد موضوعاتی که در لیست گنجانده شده است بازخورد ارائه دهید.
  4. برای طرح پیشنهادی یا مستندات بازخورد ارسال کنید .
  5. برای دریافت به‌روزرسانی‌ها در Topics API ثبت‌نام کنید . این به شما کمک می‌کند تا در مورد ویژگی‌های جدیدی که در نسخه‌های آینده معرفی می‌شوند، در جریان باشید.

برنامه نمونه را راه اندازی و تست کنید

  1. دستورالعمل‌های این صفحه را برای راه‌اندازی Privacy Sandbox در Android SDK در Android Studio دنبال کنید .
  2. برای آشنایی با نحوه بازیابی موضوعات در دستگاه، کد را در نسخه جاوا یا کاتلین برنامه نمونه فورک کرده و اجرا کنید.
  3. در حین آزمایش ، اطلاعات برنامه را برای نام و توضیحات آزمایش کنید تا موضوعاتی را که از طبقه‌بندی‌کننده روی دستگاه برمی‌گردند، تغییر دهید.
  4. پس از اینکه متوجه شدید که API مشتری و طبقه‌بندی‌های روی دستگاه چگونه کار می‌کنند، از برنامه نمونه به عنوان مثال برای هدایت یکپارچه‌سازی خود استفاده کنید.

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

،

Topics API برای Android برای پشتیبانی از تبلیغات مبتنی بر علاقه بدون تکیه بر شناسه‌های متقابل برنامه طراحی شده است.

تبلیغ‌کنندگان تلاش می‌کنند تا تبلیغات مرتبطی را ارائه دهند که به علاقه کاربر مربوط می‌شود. به عنوان مثال، اگر کاربر به اطلاعات مربوط به آشپزی علاقه مند باشد، ممکن است تبلیغات مرتبط با آشپزی را نسبت به تبلیغاتی که به علایق او مرتبط نیست مرتبط تر بداند.

تبلیغات مبتنی بر علاقه (IBA) نوعی تبلیغات شخصی سازی شده است که در آن تبلیغات بر اساس علایق کاربر انتخاب می شوند. با Privacy Sandbox در Android، این علایق از برنامه‌هایی که کاربر با آن‌ها درگیر شده است، نشأت می‌گیرد. این با تبلیغات متنی متفاوت است، که صرفاً بر اساس علایق ناشی از محتوای فعلی مشاهده شده است. IBA برنامه‌ها را قادر می‌سازد تا تبلیغات مرتبط و جذاب‌تری نسبت به تبلیغات متنی نشان دهند.

IBA معمولاً شامل ارتباط بین برنامه‌ها، فروشندگان و خریداران است. این راهنما برای همه این طرف‌ها، از جمله شبکه‌ها و فناوری‌های تبلیغاتی که هم به عنوان خریدار و هم فروشنده عمل می‌کنند، در نظر گرفته شده است.

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

هنگام اجرای تبلیغات مبتنی بر علاقه با Topics API ملاحظات سطح بالایی وجود دارد:

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

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

واژه شناسی

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

اهداف

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

در حال حاضر، اهداف برنامه‌ریزی یکپارچه‌سازی برای Privacy Sandbox در پیش‌نمایش برنامه‌نویس Android شامل توانایی انجام موارد زیر است:

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

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

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

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

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

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

پیش نیازها و راه اندازی

توسعه دهندگان برنامه، فروشندگان و خریداران باید این مراحل را دنبال کنند تا برای استفاده از Topics API راه اندازی شوند.

با API آشنا شوید

  1. با خواندن طرح پیشنهادی شروع کنید تا با Topics API و قابلیت های آن آشنا شوید.
  2. راهنمای توسعه‌دهنده را بخوانید تا یاد بگیرید که چگونه کد و فراخوان‌های API را که برای موارد استفاده خود نیاز دارید به کار ببرید.
  3. طبقه بندی را مرور کنید و در مورد موضوعاتی که در لیست گنجانده شده است بازخورد ارائه دهید.
  4. برای طرح پیشنهادی یا مستندات بازخورد ارسال کنید .
  5. برای دریافت به‌روزرسانی‌ها در Topics API ثبت‌نام کنید . این به شما کمک می‌کند تا در مورد ویژگی‌های جدیدی که در نسخه‌های آینده معرفی می‌شوند، در جریان باشید.

برنامه نمونه را راه اندازی و تست کنید

  1. دستورالعمل‌های این صفحه را برای راه‌اندازی Privacy Sandbox در Android SDK در Android Studio دنبال کنید .
  2. برای آشنایی با نحوه بازیابی موضوعات در دستگاه، کد را در نسخه جاوا یا کاتلین برنامه نمونه فورک کرده و اجرا کنید.
  3. در حین آزمایش ، اطلاعات برنامه را برای نام و توضیحات آزمایش کنید تا موضوعاتی را که از طبقه‌بندی‌کننده روی دستگاه برمی‌گردند، تغییر دهید.
  4. پس از اینکه متوجه شدید که API مشتری و طبقه‌بندی‌های روی دستگاه چگونه کار می‌کنند، از برنامه نمونه به عنوان مثال برای هدایت یکپارچه‌سازی خود استفاده کنید.

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