החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
סוגי קהל
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מתוארים סוגי הקהלים הזמינים ומוסבר איך אפשר לאחזר אותם באמצעות Display & Video 360 API.
קהלים ב-Google
קהלים של Google הם רשימות של משתמשים עם תחום עניין משותף, אירוע משמעותי בחיים או כוונת רכישה שהתרחשה לאחרונה. Google יוצרת ומנהלת את הקהלים. אפשר לאחזר את המשאבים הזמינים של GoogleAudience באמצעות השיטה googleAudiences.list.
קהלים מאינטראקציה ישירה (First-Party) וקהלים של שותפים
קהלים שנוצרו באמצעות נתונים מאינטראקציה ישירה או נתונים של שותפים מיוצגים ב-Display & Video 360 API כמשאבים מסוג FirstPartyAndPartnerAudience. המשאב הזה כולל מספר סוגים של קהלים נפרדים, כולל קהלים של התאמה אישית לפי נתוני לקוחות, קהלים מבוססי תגים, קהלים מבוססי פעילות וקהלים ברישיון, בשדה audienceType של המשאב.
אפשר לאחזר קהלים מאינטראקציה ישירה (first-party) ומצד שלישי באמצעות השיטה firstPartyAndPartnerAudiences.list. יכול להיות שיוחזרו רשימות שונות של קהלים, בהתאם לכך אם בבקשה נעשה שימוש במזהה של המפרסם או של שותף ההורה שלו בפרמטר האיחוד הנדרש accessor.
אפשר ליצור ולעדכן קהלים בהתאמה ללקוחות שנוצרו באמצעות פרטים ליצירת קשר של לקוחות או מזהי מכשירים ניידים דרך Display & Video 360 API. מידע נוסף זמין בדף העלאת קהל בהתאמה ללקוחות בהמשך המדריך. אפשר גם ליצור קהלים בהתאמה ללקוחות, יחד עם סוגים אחרים של קהלים מאינטראקציה ישירה, דרך ממשק המשתמש של Display & Video 360.
רשימות מותאמות אישית
רשימות בהתאמה אישית מאפשרות ללקוחות Display & Video 360 לטרגט משתמשים שציינו תחומי עניין ספציפיים או מחפשים פריטים ספציפיים. אפשר ליצור רשימות בהתאמה אישית דרך ממשק המשתמש של Display & Video 360. אפשר לאחזר את המשאבים הזמינים של CustomList דרך Display & Video 360 API באמצעות השיטה customLists.list.
קהלים משולבים
קהלים משולבים הם קהלים שמוגדרים על ידי המשתמשים, שנוצרים על ידי איחוד ותצוגת הצטלבות של קהלים קיימים של Google, קהלים מאינטראקציה ישירה (First-Party) וקהלים של צד שלישי. אפשר ליצור אותם דרך ממשק המשתמש של Display & Video 360. אפשר לאחזר את המשאבים הזמינים של CombinedAudience באמצעות השיטה combinedAudiences.list.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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."]]
