از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به
صفحه لغو اعتبار ما مراجعه کنید.
انواع مخاطب
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این صفحه انواع مخاطبان موجود را شرح می دهد و نحوه بازیابی آنها را با استفاده از Display & Video 360 API مشخص می کند.
مخاطبان گوگل
Google Audiences فهرستی از کاربرانی هستند که تمایلات، رویدادهای زندگی یا قصد خرید اخیرشان مشخص شده است. مخاطبان توسط Google ایجاد و نگهداری می شوند. می توانید منابع GoogleAudience موجود را با استفاده از روش googleAudiences.list بازیابی کنید.
مخاطبان شخص اول و شریک
مخاطبین ایجاد شده با استفاده از داده های شخص اول یا شریک در Display & Video 360 API به عنوان منابع FirstPartyAndPartnerAudience نشان داده می شوند. این منبع شامل تعدادی از انواع مخاطبان منفرد، از جمله مخاطبین مطابق با مشتری، مخاطبان مبتنی بر برچسب، فعالیت‌محور و مخاطبان دارای مجوز، در قسمت audienceType نوع منبع است.
با استفاده از روش firstPartyAndPartnerAudiences.list می توانید مخاطبان اول و شخص ثالث را بازیابی کنید. بسته به اینکه درخواست از شناسه تبلیغ‌کننده یا شریک اصلی آن در پارامتر اتحادیه accessor مورد نیاز استفاده می‌کند، ممکن است فهرست‌های متفاوتی از مخاطبان برگردانده شود.
می‌توانید مخاطبان «تطابق مشتری» را که با استفاده از اطلاعات تماس مشتری یا شناسه‌های دستگاه تلفن همراه ایجاد شده‌اند، از طریق Display & Video 360 API ایجاد کرده و به‌روزرسانی کنید. برای اطلاعات بیشتر به صفحه آپلود مخاطب مطابقت مشتری بعداً در این راهنما مراجعه کنید. همچنین می‌توانید از طریق رابط کاربری Display & Video 360، مخاطبان مطابقت مشتری، همراه با انواع دیگر مخاطبان شخص اول ایجاد کنید.
لیست های سفارشی
لیست های سفارشی به مشتریان Display & Video 360 اجازه می دهد تا کاربرانی را که علایق خاصی را نشان داده اند یا به دنبال موارد خاصی هستند، هدف قرار دهند. می‌توانید فهرست‌های سفارشی را از طریق رابط کاربری Display & Video 360 ایجاد کنید. می توانید منابع CustomList موجود را از طریق Display & Video 360 API با استفاده از روش customLists.list بازیابی کنید.
مخاطبان ترکیبی
مخاطبان ترکیبی ، مخاطبان پیکربندی شده توسط کاربر هستند که توسط اتحاد و تقاطع مخاطبان موجود Google، شخص اول و شخص ثالث ایجاد شده‌اند. می توانید آنها را از طریق رابط کاربری Display & Video 360 ایجاد کنید. می توانید منابع CombinedAudience موجود را با استفاده از روش combinedAudiences.list بازیابی کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis page explains how to retrieve different audience types, including Google Audiences, first- and third-party audiences, custom lists, and combined audiences, using the Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eGoogle provides Google Audiences, while first- and third-party audiences are based on your own or third-party data and encompass various types like Customer Match, tag-based, activity-based, and licensed audiences.\u003c/p\u003e\n"],["\u003cp\u003eCustom lists target users with specific interests, are created in the Display & Video 360 UI, and can be retrieved via the API.\u003c/p\u003e\n"],["\u003cp\u003eCombined audiences are user-defined combinations of other audience types, created in the Display & Video 360 UI, and retrievable using the API.\u003c/p\u003e\n"]]],[],null,["# Audience Types\n\nThis page describes the available audience types and specifies how they can be\nretrieved using the Display \\& Video 360 API.\n\nGoogle Audiences\n----------------\n\nGoogle Audiences are lists of users with an identified affinity, life event, or\nrecent purchase intent. Audiences are created and maintained by Google. You can\nretrieve available [`GoogleAudience`](/display-video/api/reference/rest/current/googleAudiences#GoogleAudience) resources using the\n[`googleAudiences.list`](/display-video/api/reference/rest/current/googleAudiences/list) method.\n| **Key Point:** [Extended Demographic Google Audiences](/display-video/api/reference/rest/current/googleAudiences#GoogleAudienceType.ENUM_VALUES.GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC) are not retrievable or targetable using the Display \\& Video 360 API.\n\nFirst-party and partner audiences\n---------------------------------\n\nAudiences created using first-party or partner data are represented in the\nDisplay \\& Video 360 API as [`FirstPartyAndPartnerAudience`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience) resources. This\nresource encompasses a number of individual audience types, including Customer\nMatch, tag-based, activity-based, and licensed audiences, in the resource's\n[`audienceType`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience.FIELDS.audience_type) field.\n\nYou can retrieve first and third-party audiences using the\n[`firstPartyAndPartnerAudiences.list`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/list) method. Different lists of\naudiences may be returned depending on whether the request uses the ID of an\nadvertiser or its parent partner in the required\n[`accessor`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/list#body.QUERY_PARAMETERS.oneof_accessor) union parameter.\n| **Note:** [Estimated audience size fields](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience.FIELDS.display_audience_size) are available in the resource object, but are only included in the resource when individually retrieved using the [`firstPartyAndPartnerAudiences.get`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/get) method.\n\nYou can create and update Customer Match audiences generated using customer\ncontact information or mobile device IDs through the Display \\& Video 360 API. See the\n[Upload Customer Match Audience](/display-video/api/guides/audiences/upload-customer-match) page later in this guide for\nmore information. You can also create Customer Match audiences, along with other\ntypes first-party audiences, through the Display \\& Video 360 UI.\n\nCustom lists\n------------\n\n[Custom lists](//support.google.com/displayvideo/answer/7583366) allow Display \\& Video 360 customers to target users who have\nindicated specific interests or are looking for specific items. You can create\ncustom lists through the Display \\& Video 360 UI. You can retrieve available\n[`CustomList`](/display-video/api/reference/rest/current/customLists#CustomList) resources through the Display \\& Video 360 API using the\n[`customLists.list`](/display-video/api/reference/rest/current/customLists/list) method.\n\nCombined audiences\n------------------\n\n[Combined audiences](//support.google.com/displayvideo/answer/9001225) are user-configured audiences created by the union\nand intersection of existing Google, first-party, and third-party audiences. You\ncan create them through the Display \\& Video 360 UI. You can retrieve available\n[`CombinedAudience`](/display-video/api/reference/rest/current/combinedAudiences#CombinedAudience) resources using the\n[`combinedAudiences.list`](/display-video/api/reference/rest/current/combinedAudiences/list) method."]]
