- المرجع: FirstPartyAndPartnerAudience
- FirstPartyAndPartnerAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- الموافقة
- ConsentStatus
- MobileDeviceIdList
- الطُرق
المورد: FirstPartyAndPartnerAudience
يصف قائمة جمهور من الطرف الأول أو من الشركاء المستخدَمة للاستهداف. يتم إنشاء شرائح جمهور الطرف الأول من خلال استخدام بيانات العميل. تقدّم الجهات الخارجية التي تقدّم البيانات شرائح جمهور الشركاء، ولا يمكن ترخيصها إلا للعملاء.
تمثيل JSON |
---|
{ "name": string, "firstPartyAndPartnerAudienceId": string, "displayName": string, "description": string, "firstPartyAndPartnerAudienceType": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد لشريحة جمهور الطرف الأول والشريك |
firstPartyAndPartnerAudienceId |
المعرّف المعرّف الفريد لشريحة جمهور الطرف الأول والشريك تمّ تعيينه من قِبل النظام. |
displayName |
النتائج فقط. الاسم المعروض لشريحة جمهور الطرف الأول والشريك. |
description |
النتائج فقط. الوصف الذي يوفّره المستخدِم للجمهور. لا ينطبق ذلك إلا على شرائح جمهور الطرف الأول. |
firstPartyAndPartnerAudienceType |
النتائج فقط. ما إذا كان الجمهور تابعًا للطرف الأول أو شريكًا |
audienceType |
النتائج فقط. نوع الجمهور |
audienceSource |
النتائج فقط. مصدر الجمهور. |
membershipDurationDays |
النتائج فقط. المدة التي يظل فيها الإدخال ضمن شريحة الجمهور بعد الحدث المؤهّل، وذلك باليوم إذا لم يكن للجمهور تاريخ انتهاء صلاحية، اضبط قيمة هذا الحقل على 10000. بخلاف ذلك، يجب أن تكون القيمة المحدّدة أكبر من 0 وأصغر من أو تساوي 540. لا ينطبق ذلك إلا على شرائح جمهور الطرف الأول. هذا الحقل مطلوب في حال استخدام أحد القيم التالية لسمة
|
displayAudienceSize |
النتائج فقط. حجم الجمهور المقدّر للشبكة الإعلانية إذا كان العدد أقل من 1000، سيتم إخفاءه وسيتم عرض القيمة 0 لأسباب تتعلّق بالخصوصية. بخلاف ذلك، سيتم تقريب الرقم إلى رقمين معنوين. لا يتم عرضها إلا في طلب GET. |
activeDisplayAudienceSize |
النتائج فقط. حجم الجمهور المقدّر على "الشبكة الإعلانية" في الشهر الماضي. إذا كان العدد أقل من 1000، سيتم إخفاءه وسيتم عرض القيمة 0 لأسباب تتعلّق بالخصوصية. بخلاف ذلك، سيتم تقريب الرقم إلى رقمين معنوين. لا يتم عرضها إلا في طلب GET. |
youtubeAudienceSize |
النتائج فقط. حجم الجمهور المقدّر لشبكة YouTube إذا كان العدد أقل من 1000، سيتم إخفاءه وسيتم عرض القيمة 0 لأسباب تتعلّق بالخصوصية. بخلاف ذلك، سيتم تقريب الرقم إلى رقمين معنوين. لا ينطبق ذلك إلا على شرائح جمهور الطرف الأول. لا يتم عرضها إلا في طلب GET. |
gmailAudienceSize |
النتائج فقط. حجم الجمهور المقدّر لشبكة Gmail إذا كان العدد أقل من 1000، سيتم إخفاءه وسيتم عرض القيمة 0 لأسباب تتعلّق بالخصوصية. بخلاف ذلك، سيتم تقريب الرقم إلى رقمين معنوين. لا ينطبق ذلك إلا على شرائح جمهور الطرف الأول. لا يتم عرضها إلا في طلب GET. |
displayMobileAppAudienceSize |
النتائج فقط. حجم الجمهور المقدّر للتطبيقات المتوافقة مع الأجهزة الجوّالة في "الشبكة الإعلانية" إذا كان العدد أقل من 1000، سيتم إخفاءه وسيتم عرض القيمة 0 لأسباب تتعلّق بالخصوصية. بخلاف ذلك، سيتم تقريب الرقم إلى رقمين معنوين. لا ينطبق ذلك إلا على شرائح جمهور الطرف الأول. لا يتم عرضها إلا في طلب GET. |
displayMobileWebAudienceSize |
النتائج فقط. حجم جمهور الويب على الأجهزة الجوّالة المقدّر في "شبكة Google الإعلانية" إذا كان العدد أقل من 1000، سيتم إخفاءه وسيتم عرض القيمة 0 لأسباب تتعلّق بالخصوصية. بخلاف ذلك، سيتم تقريب الرقم إلى رقمين معنوين. لا ينطبق ذلك إلا على شرائح جمهور الطرف الأول. لا يتم عرضها إلا في طلب GET. |
displayDesktopAudienceSize |
النتائج فقط. حجم الجمهور المقدَّر على أجهزة الكمبيوتر المكتبي في "شبكة Google الإعلانية" إذا كان العدد أقل من 1000، سيتم إخفاءه وسيتم عرض القيمة 0 لأسباب تتعلّق بالخصوصية. بخلاف ذلك، سيتم تقريب الرقم إلى رقمين معنوين. لا ينطبق ذلك إلا على شرائح جمهور الطرف الأول. لا يتم عرضها إلا في طلب GET. |
appId |
اختياريّ. يتطابق appId مع نوع أرقام تعريف mobileDeviceId التي يتم تحميلها. لا ينطبق إلا على |
حقل الربط members الأعضاء الأوليّون في شريحة جمهور "مطابقة العملاء" يمكن أن يكون members واحدًا فقط مما يلي: |
|
contactInfoList |
الإدخال فقط قائمة بمعلومات الاتصال لتحديد أعضاء الجمهور الأوليين لا ينطبق إلا على |
mobileDeviceIdList |
الإدخال فقط قائمة بأرقام تعريف الأجهزة الجوّالة لتحديد أعضاء شريحة الجمهور الأولية لا ينطبق إلا على |
FirstPartyAndPartnerAudienceType
الأنواع المحتملة لمصدر جمهور الطرف الأول والشريك
عمليات التعداد | |
---|---|
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED |
القيمة التلقائية عندما لا يكون النوع محدّدًا أو غير معروف |
TYPE_FIRST_PARTY |
شريحة الجمهور التي يتم إنشاؤها من خلال استخدام بيانات العميل. |
TYPE_PARTNER |
شرائح الجمهور التي يوفّرها مزوّدو البيانات التابعون لجهات خارجية |
AudienceType
أنواع شرائح الجمهور المحتملة
عمليات التعداد | |
---|---|
AUDIENCE_TYPE_UNSPECIFIED |
القيمة التلقائية عندما لا يكون النوع محدّدًا أو غير معروف |
CUSTOMER_MATCH_CONTACT_INFO |
تمّ إنشاء شريحة الجمهور من خلال مطابقة العملاء بمعلومات اتصال معروفة. |
CUSTOMER_MATCH_DEVICE_ID |
تمّ إنشاء شريحة الجمهور من خلال مطابقة العملاء مع أرقام تعريف الأجهزة الجوّالة المعروفة. |
CUSTOMER_MATCH_USER_ID |
تمّ إنشاء شريحة الجمهور من خلال مطابقة العملاء مع أرقام تعريف مستخدمين معروفة. |
ACTIVITY_BASED |
تمّ إنشاء شريحة الجمهور استنادًا إلى نشاط الحملة. |
FREQUENCY_CAP |
تمّ إنشاء شريحة الجمهور استنادًا إلى استبعاد عدد مرّات الظهور التي تمّ عرضها. |
TAG_BASED |
تمّ إنشاء شريحة الجمهور استنادًا إلى المتغيّرات المخصّصة المرتبطة بالبكسل. |
YOUTUBE_USERS |
تم إنشاء شريحة الجمهور استنادًا إلى التفاعلات السابقة مع الفيديوهات أو إعلانات YouTube أو قناة YouTube. |
THIRD_PARTY |
تم ترخيص شريحة الجمهور لاستخدامها من جهة خارجية. |
COMMERCE |
شريحة الجمهور التي يوفّرها شركاء التجارة مقابل رسوم |
LINEAR |
شريحة جمهور محتوى البث التلفزيوني المباشر |
AudienceSource
مصادر الجمهور المحتمَلة
عمليات التعداد | |
---|---|
AUDIENCE_SOURCE_UNSPECIFIED |
القيمة التلقائية عندما لا يتم تحديد مصدر شريحة الجمهور أو يكون غير معروف |
DISPLAY_VIDEO_360 |
مصدرها "مساحة العرض والفيديو 360". |
CAMPAIGN_MANAGER |
مصدرها "مدير الحملة 360". |
AD_MANAGER |
مصدرها "مدير إعلانات Google" |
SEARCH_ADS_360 |
مصدرها "إعلانات شبكة البحث 360". |
YOUTUBE |
تم إنشاؤها على YouTube. |
ADS_DATA_HUB |
مصدرها Ads Data Hub |
ContactInfoList
رسالة ملفّ تعريف لعرض قائمة بمعلومات الاتصال التي تحدّد أعضاء شريحة الجمهور المستندة إلى "مطابقة العملاء"
تمثيل JSON |
---|
{ "contactInfos": [ { object ( |
الحقول | |
---|---|
contactInfos[] |
قائمة بعناصر ContactInfo التي تحدّد أعضاء جمهور "مطابقة العملاء" يجب ألا يزيد حجم الأعضاء بعد تقسيم contactInfos عن 500,000. |
consent |
الإدخال فقط إعدادات الموافقة للمستخدمين في يشير ترك هذا الحقل بدون ضبط إلى عدم تحديد الموافقة. إذا تم ضبط حقلَي |
ContactInfo
معلومات الاتصال التي تحدّد أحد أعضاء شريحة الجمهور المستندة إلى "مطابقة العملاء"
تمثيل JSON |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
الحقول | |
---|---|
hashedEmails[] |
قائمة بعناوين البريد الإلكتروني المجزّأة باستخدام خوارزمية SHA256 للمشترك قبل التجزئة، أزِل كل المسافات البيضاء وتأكَّد من أنّ السلسلة تتألف من أحرف إنجليزية صغيرة فقط. |
hashedPhoneNumbers[] |
قائمة بأرقام هواتف المشترِك المجزّأة باستخدام خوارزمية SHA256 قبل التجزئة، يجب تنسيق جميع أرقام الهواتف باستخدام تنسيق E.164 وتضمين رمز الاتصال بالبلد. |
zipCodes[] |
قائمة بالرموز البريدية للعضو يجب أيضًا ضبطها باستخدام الحقول التالية: |
hashedFirstName |
الاسم الأوّل للمشترك بعد تجزئته باستخدام خوارزمية SHA256 قبل التجزئة، أزِل كل المسافات البيضاء وتأكَّد من أنّ السلسلة تتألف من أحرف إنجليزية صغيرة فقط. يجب أيضًا ضبطها باستخدام الحقول التالية: |
hashedLastName |
تجزئة SHA256 لاسم العائلة الخاص بالعضو قبل التجزئة، أزِل كل المسافات البيضاء وتأكَّد من أنّ السلسلة تتألف من أحرف إنجليزية صغيرة فقط. يجب أيضًا ضبطها باستخدام الحقول التالية: |
countryCode |
رمز بلد المشترك يجب أيضًا ضبطها باستخدام الحقول التالية: |
الموافقة
حالة موافقة المستخدم
تمثيل JSON |
---|
{ "adUserData": enum ( |
الحقول | |
---|---|
adUserData |
يمثّل الموافقة على بيانات مستخدِمي الإعلانات. |
adPersonalization |
يمثّل الموافقة على تخصيص الإعلانات. |
ConsentStatus
حالة الموافقة
عمليات التعداد | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
لم يتم تحديد قيمة النوع أو هي غير معروفة في هذا الإصدار. |
CONSENT_STATUS_GRANTED |
تم منح الموافقة. |
CONSENT_STATUS_DENIED |
تم رفض الموافقة. |
MobileDeviceIdList
رسالة ملفّ تعريف لائحة أرقام تعريف الأجهزة الجوّالة التي تحدّد أعضاء جمهور "مطابقة العملاء"
تمثيل JSON |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
الحقول | |
---|---|
mobileDeviceIds[] |
قائمة بأرقام تعريف الأجهزة الجوّالة التي تحدّد أعضاء جمهور "مطابقة العملاء" يجب ألا يزيد حجم mobileDeviceIds عن 500,000. |
consent |
الإدخال فقط إعدادات الموافقة للمستخدمين في يشير ترك هذا الحقل بدون ضبط إلى عدم تحديد الموافقة. إذا تم ضبط حقلَي |
الطُرق |
|
---|---|
|
تُنشئ شريحة جمهور FirstPartyAndPartnerAudience. |
|
تعديل قائمة أعضاء شريحة جمهور "مطابقة العملاء" |
|
الحصول على شريحة جمهور من الطرف الأول أو شريحة جمهور شريك |
|
يسرد شرائح جمهور الطرف الأول والشركاء. |
|
تعديل شريحة جمهور حالية من النوع FirstPartyAndPartnerAudience |