اعتبارًا من
8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على
صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
أنواع الجمهور
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح هذه الصفحة أنواع شرائح الجمهور المتاحة وتحدّد كيفية retrieving retrieving
استردادها باستخدام واجهة برمجة التطبيقات Display & Video 360 API.
جماهير Google
شرائح جمهور Google هي قوائم بالمستخدمين الذين لديهم اهتمامات مشتركة أو حدث في الحياة أو
نية شراء حديثة تم تحديدها. تنشئ Google شرائح الجمهور وتحافظ عليها. يمكنك retrieving
موارد GoogleAudience المتاحة باستخدام الأسلوب
googleAudiences.list.
شرائح جمهور الطرف الأول والشركاء
يتم تمثيل شرائح الجمهور التي تم إنشاؤها باستخدام بيانات الطرف الأول أو بيانات الشركاء في واجهة برمجة التطبيقات
Display & Video 360 API كموارد FirstPartyAndPartnerAudience. يتضمّن
هذا المرجع عددًا من أنواع شرائح الجمهور الفردية، بما في ذلك شرائح الجمهور المستندة إلى
"مطابقة العملاء" وشرائح الجمهور المستندة إلى العلامات وشرائح الجمهور المستندة إلى النشاط وشرائح الجمهور المرخّصة، في حقل
audienceType في المرجع.
يمكنك استرداد شرائح الجمهور التابعة للطرف الأول والتابعة لجهات خارجية باستخدام الطريقة
firstPartyAndPartnerAudiences.list. قد يتم عرض قوائم مختلفة من
شرائح الجمهور استنادًا إلى ما إذا كان الطلب يستخدم معرّف أحد
المعلِنين أو شريكه الرئيسي في مَعلمة دمج
accessor المطلوبة.
يمكنك إنشاء شرائح جمهور "مطابقة العملاء" وتعديلها التي تم إنشاؤها باستخدام
معلومات الاتصال بالعملاء أو أرقام تعريف الأجهزة الجوّالة من خلال واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360". اطّلِع على صفحة
تحميل شريحة جمهور "مطابقة العملاء" لاحقًا في هذا الدليل للحصول على
مزيد من المعلومات. يمكنك أيضًا إنشاء شرائح جمهور "مطابقة العملاء"، بالإضافة إلى غيرها من
أنواع شرائح جمهور الطرف الأول، من خلال واجهة مستخدم "مساحة العرض والفيديو 360".
قوائم العملاء
تسمح القوائم المخصّصة لعملاء "مساحة العرض والفيديو 360" باستهداف المستخدِمين الذين أشاروا
إلى اهتمامات معيّنة أو يبحثون عن سلع معيّنة. يمكنك إنشاء
قوائم مخصّصة من خلال واجهة مستخدم "مساحة العرض والفيديو 360". يمكنك استرداد موارد
CustomList المتاحة من خلال Display & Video 360 API باستخدام الأسلوب
customLists.list.
الجماهير المُجمَّعة
شرائح الجمهور المجمّعة هي شرائح جمهور يضبطها المستخدمون ويتم إنشاؤها من خلال دمج
وتداخل شرائح جمهور Google الحالية وشرائح جمهور الطرف الأول وشرائح جمهور الجهات الخارجية. يمكنك
إنشاؤها من خلال واجهة مستخدم "مساحة العرض والفيديو 360". يمكنك استرداد موارد
CombinedAudience المتاحة باستخدام طريقة
combinedAudiences.list.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
