- المرجع: FirstAndPartyaudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- الموافقة
- ConsentStatus
- MobileDeviceIdList
- الطُرق
المرجع: FirstAndPartyaudience
يصف قائمة مستخدمين من الطرف الأول أو الثالث يتم استخدامها في الاستهداف. يتم إنشاء شرائح جمهور الطرف الأول عن طريق استخدام بيانات العميل. يوفِّر مزوّدو البيانات التابعون لجهات خارجية شرائح الجمهور التابعة لجهات خارجية، ولا يمكن ترخيصها إلا للعملاء.
تمثيل JSON |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد للجمهور الأول والجهة الخارجية. |
firstAndThirdPartyAudienceId |
النتائج فقط. المعرّف الفريد لشريحة جمهور الطرف الأول والطرف الثالث تم تعيينه من قِبل النظام. |
displayName |
الاسم المعروض لجمهور الطرف الأول والطرف الثالث |
description |
الوصف المقدَّم من المستخدِم للجمهور. لا ينطبق إلا على شرائح جمهور الطرف الأول. |
firstAndThirdPartyAudienceType |
ما إذا كان الجمهور عبارة عن جمهور للطرف الأول أو الطرف الثالث |
audienceType |
نوع الجمهور. |
audienceSource |
النتائج فقط. مصدر الجمهور. |
membershipDurationDays |
المدة بالأيام التي يظل فيها الإدخال ضمن الجمهور بعد الحدث المؤهَّل. إذا لم يكن لشريحة الجمهور تاريخ انتهاء صلاحية، اضبط قيمة هذا الحقل على 10, 000. بخلاف ذلك، يجب أن تكون القيمة المحددة أكبر من 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 |
النتائج فقط. الحجم المقدّر لجمهور الويب على الأجهزة الجوّالة في الشبكة الإعلانية. إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين. لا ينطبق إلا على شرائح جمهور الطرف الأول. عاد فقط في طلب GET. |
displayDesktopAudienceSize |
النتائج فقط. حجم الجمهور المقدّر لأجهزة الكمبيوتر المكتبي في الشبكة الإعلانية. إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين. لا ينطبق إلا على شرائح جمهور الطرف الأول. عاد فقط في طلب GET. |
appId |
يتطابق appId مع نوع mobileDeviceId تم تحميلها. ينطبق فقط على |
حقل الاتحاد members الأعضاء الأوليون لجمهور "مطابقة العملاء". يمكن أن تكون السمة "members " واحدة فقط مما يلي: |
|
contactInfoList |
الإدخال فقط. قائمة بمعلومات الاتصال لتحديد أعضاء الجمهور الأولي. ينطبق فقط على |
mobileDeviceIdList |
الإدخال فقط. قائمة بأرقام تعريف الأجهزة الجوّالة لتحديد أعضاء الجمهور المبدئيين. ينطبق فقط على |
FirstAndThirdPartyAudienceType
الأنواع المحتملة من مورد الجمهور الأول والتابع لجهة خارجية.
عمليات التعداد | |
---|---|
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED |
القيمة التلقائية عندما يكون النوع غير محدد أو غير معروف. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY |
شريحة الجمهور التي يتم إنشاؤها عن طريق استخدام بيانات العميل |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY |
شريحة الجمهور التي يوفّرها مزوّدو البيانات التابعون لجهات خارجية |
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. |
LICENSED |
نوع فرعي من نوع جمهور الجهات الخارجية. |
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[] |
قائمة بأرقام تعريف الأجهزة الجوّالة التي تُحدِّد أعضاء جمهور "مطابقة العملاء". يجب ألا يتجاوز حجم mobileDeviceId 500,000. |
consent |
الإدخال فقط. إعداد الموافقة للمستخدمين في يشير ترك هذا الحقل بدون ضبط إلى عدم تحديد الموافقة. في حال ضبط الحقل |
الطُرق |
|
---|---|
|
يؤدي هذا الخيار إلى إنشاء شريحة جمهور في الأولى. |
|
تُعدِّل قائمة الأعضاء لشريحة جمهور "مطابقة العملاء". |
|
الحصول على شريحة جمهور للطرف الأول وطرف ثالث |
|
يسرد شرائح الجمهور الأولى وشرائح الجمهور التابعة لجهة خارجية. |
|
لتعديل جمهور حالي في FirstAndPartyUsers |