- المورد: المعلِن
- AdvertiserGeneralConfig
- AdvertiserAdServerConfig
- ThirdPartyOnlyConfig
- CmHybridConfig
- AdvertiserCreativeConfig
- AdvertiserDataAccessConfig
- AdvertiserSdfConfig
- AdvertiserTargetingConfig
- AdvertiserBillingConfig
- الطُرق
المرجع: المعلِن
معلِن واحد في "مساحة العرض والفيديو 360"
تمثيل JSON |
---|
{ "name": string, "advertiserId": string, "partnerId": string, "displayName": string, "entityStatus": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد للمعلن. |
advertiserId |
النتائج فقط. المعرّف الفريد للمعلِن. تم تعيينه من قِبل النظام. |
partnerId |
مطلوبة. غير قابل للتغيير. المعرّف الفريد للشريك الذي ينتمي إليه المعلِن. |
displayName |
مطلوبة. الاسم المعروض للمعلن يجب ترميزها باستخدام UTF-8 بحجم 240 بايت كحد أقصى. |
entityStatus |
مطلوبة. تتحكّم هذه السياسة في ما إذا كان بإمكان طلبات الإدراج وتفاصيل المعلِن إنفاق ميزانياته وتقديم عروض أسعار للمستودع.
|
updateTime |
النتائج فقط. الطابع الزمني لآخر تعديل للمعلِن تم تعيينه من قِبل النظام. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
generalConfig |
مطلوبة. الإعدادات العامة للمعلن |
adServerConfig |
مطلوبة. غير قابل للتغيير. الإعدادات المتعلقة بخادم الإعلانات للمعلن |
creativeConfig |
مطلوبة. الإعدادات المتعلقة بتصميمات الإعلانات للمعلن |
dataAccessConfig |
الإعدادات التي تتحكّم في كيفية الوصول إلى بيانات المعلِن. |
integrationDetails |
تفاصيل دمج المعلِن يسري |
servingConfig |
إعدادات الاستهداف المرتبطة بعرض الإعلانات للمعلِن |
prismaEnabled |
ما إذا كان التكامل مع Mediaocean (Prisma) مفعَّلاً. من خلال تفعيل هذه الميزة، أنت توافق على ما يلي: نيابةً عن شركتي، أفوّض Mediaocean (Prisma) بإرسال خطط تقسيم الميزانية إلى Google، وأفوّض Google بإرسال التقارير والفواتير المقابلة من "مساحة العرض والفيديو 360" إلى Mediaocean لأغراض تخطيط الميزانية والفوترة والتسوية بالنسبة إلى هذا المعلِن. |
billingConfig |
مطلوبة. الإعدادات المتعلقة بالفوترة للمعلِن |
AdvertiserGeneralConfig
الإعدادات العامة للمعلن.
تمثيل JSON |
---|
{ "domainUrl": string, "timeZone": string, "currencyCode": string } |
الحقول | |
---|---|
domainUrl |
مطلوبة. عنوان URL لنطاق الموقع الإلكتروني الأساسي للمعلِن. سيرسل النظام هذه المعلومات إلى الناشرين الذين يطلبون عنوان URL للموقع الإلكتروني من أجل ربط حملة بمعلِن. يُرجى إدخال عنوان URL بدون مسار أو سلسلة طلب بحث يبدأ بـ |
timeZone |
النتائج فقط. الاسم العادي لقاعدة بيانات TZ للمنطقة الزمنية للمعلِن. مثلاً: يمكنك الاطّلاع على المزيد من المعلومات على: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones بالنسبة إلى المعلِنين المختلطين في "مدير الحملة 360"، تكون المنطقة الزمنية هي نفسها للمنطقة الزمنية في حساب "مدير الحملة 360" المرتبط، أما بالنسبة إلى المعلِنين التابعين لجهات خارجية فقط، فيكون المنطقة الزمنية هي نفسها المنطقة الزمنية للشريك الرئيسي. |
currencyCode |
مطلوبة. غير قابل للتغيير. عملة المعلِن بتنسيق ISO 4217. الرموز المقبولة والعملات التي تمثلها هي: رمز العملة : اسم العملة
|
AdvertiserAdServerConfig
الإعدادات المتعلّقة بخادم الإعلانات لأحد المعلِنين
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد ad_server_config_scheme مطلوبة. يمكن أن يكون الحقل "ad_server_config_scheme " واحدًا فقط مما يلي: |
|
thirdPartyOnlyConfig |
هذه الإعدادات للمعلنين الذين يستخدمون خوادم الإعلانات التابعة لجهات خارجية فقط. |
cmHybridConfig |
هذه الإعدادات للمعلِنين الذين يستخدِمون كلاً من "مدير الحملة 360" وخوادم الإعلانات التابعة لجهات خارجية. |
ThirdPartyOnlyConfig
إعدادات للمعلنين الذين يستخدمون خوادم إعلانات تابعة لجهات خارجية فقط
تمثيل JSON |
---|
{ "pixelOrderIdReportingEnabled": boolean } |
الحقول | |
---|---|
pixelOrderIdReportingEnabled |
ما إذا كان إعداد تقارير مُعرّف الطلب لوحدات البكسل مفعَّلاً أم لا. لا يمكن تغيير هذه القيمة بعد ضبطها على |
CmHybridConfig
إعدادات للمعلِنين الذين يستخدِمون كلاً من "مدير الحملة 360" وخوادم الإعلانات التابعة لجهات خارجية
تمثيل JSON |
---|
{ "cmAccountId": string, "cmFloodlightConfigId": string, "cmAdvertiserIds": [ string ], "cmSyncableSiteIds": [ string ], "dv360ToCmDataSharingEnabled": boolean, "dv360ToCmCostReportingEnabled": boolean, "cmFloodlightLinkingAuthorized": boolean } |
الحقول | |
---|---|
cmAccountId |
مطلوبة. غير قابل للتغيير. رقم تعريف الحساب لإعدادات Floodlight في "مدير الحملة 360" المرتبطة بالمعلِن على "مساحة العرض والفيديو 360". |
cmFloodlightConfigId |
مطلوبة. غير قابل للتغيير. رقم تعريف إعدادات Floodlight في "مدير الحملة 360" المرتبطة بالمعلِن على "مساحة العرض والفيديو 360". |
cmAdvertiserIds[] |
النتائج فقط. مجموعة أرقام تعريف المعلنين في "مدير الحملة 360" التي تشارك إعدادات Floodlight في "مدير الحملة 360". |
cmSyncableSiteIds[] |
قائمة بالمواقع الإلكترونية في "مدير الحملة 360" التي ستتم مزامنة مواضعها مع "مساحة العرض والفيديو 360" كتصميمات إعلانات إذا لم تتوفر هذه المعلومات أو كانت فارغة في طريقة قد تؤدي إزالة المواقع الإلكترونية من هذه القائمة إلى حذف تصميمات الإعلانات على "مساحة العرض والفيديو 360" التي تمّت مزامنتها من "مدير الحملة 360". يجب تحديد موقع إلكتروني واحد على الأقل. |
dv360ToCmDataSharingEnabled |
ما إذا كان سيتم تضمين بيانات "مساحة العرض والفيديو 360" في تقارير نقل البيانات في "مدير الحملة 360" أم لا. |
dv360ToCmCostReportingEnabled |
ما إذا كان سيتم الإبلاغ عن تكلفة "مساحة العرض والفيديو 360" في "مدير الحملة 360" أم لا. |
cmFloodlightLinkingAuthorized |
مطلوبة. غير قابل للتغيير. من خلال ضبط هذا الحقل على |
AdvertiserCreativeConfig
الإعدادات ذات الصلة بتصميمات الإعلانات لأحد المعلنين.
تمثيل JSON |
---|
{ "iasClientId": string, "obaComplianceDisabled": boolean, "dynamicCreativeEnabled": boolean, "videoCreativeDataSharingAuthorized": boolean } |
الحقول | |
---|---|
iasClientId |
رقم تعريف لإعداد مراقبة الحملة مُقدَّم من Integral Ad Service (IAS). سيُلحق نظام "مساحة العرض والفيديو 360" علامة "مراقبة الحملة" من IAS التي تحتوي على رقم التعريف هذا بعلامة تصميم الإعلان. |
obaComplianceDisabled |
يمكنك تحديد ما إذا كنت تريد إيقاف ميزة "لمحة عن هذا الإعلان" التي تضيف الشارات (لتحديد المحتوى كإعلان) ومعلومات الشفافية من Google (عند التفاعل مع "لمحة عن هذا الإعلان") إلى إعلاناتك المتعلّقة بالإعلان السلوكي على الإنترنت والمتطلبات التنظيمية. يتيح لك قسم "تفاصيل عن الإعلان" للمستخدمين التحكّم بشكل أكبر في الإعلانات التي يشاهدونها ويساعدك في توضيح سبب مشاهدة إعلانك لهم. مزيد من المعلومات في حال اختيار ضبط هذا الحقل على
|
dynamicCreativeEnabled |
تحدّد هذه السمة ما إذا كان المعلِن مفعّلاً لاستخدام تصميمات الإعلانات الديناميكية أم لا. |
videoCreativeDataSharingAuthorized |
من خلال ضبط هذا الحقل على لا ينطبق هذا الإجراء إلا عند ضبط خادم إعلانات " |
AdvertiserDataAccessConfig
الإعدادات التي تتحكّم في كيفية الوصول إلى البيانات ذات الصلة بالمعلنين.
تمثيل JSON |
---|
{
"sdfConfig": {
object ( |
الحقول | |
---|---|
sdfConfig |
إعدادات ملفات البيانات المنظَّمة (SDF) للمعلن وفي حال عدم تحديد ذلك، يتم استخدام إعدادات SDF للشريك الرئيسي. |
AdvertiserSdfConfig
إعدادات ملفات البيانات المنظَّمة (SDF) لأحد المعلِنين
تمثيل JSON |
---|
{
"overridePartnerSdfConfig": boolean,
"sdfConfig": {
object ( |
الحقول | |
---|---|
overridePartnerSdfConfig |
ما إذا كان هذا المعلِن قد ألغى ضبط SDF لشريكه الرئيسي أم لا بشكلٍ تلقائي، يكتسِب المعلِن إعدادات SDF من الشريك الرئيسي. لإلغاء إعدادات الشريك، يجب ضبط هذا الحقل على |
sdfConfig |
إعدادات SDF للمعلِن
|
AdvertiserTargetingConfig
إعدادات الاستهداف المرتبطة بعرض الإعلانات لدى المعلِن
تمثيل JSON |
---|
{ "exemptTvFromViewabilityTargeting": boolean } |
الحقول | |
---|---|
exemptTvFromViewabilityTargeting |
ما إذا كان يتم استثناء أجهزة التلفزيون المتّصلة من استهداف إمكانية العرض لجميع عناصر الفيديو ضمن المعلِن |
AdvertiserBillingConfig
الإعدادات المتعلّقة بالفوترة لدى المعلِن
تمثيل JSON |
---|
{ "billingProfileId": string } |
الحقول | |
---|---|
billingProfileId |
رقم تعريف الملف الشخصي للفوترة الذي تم تعيينه للمعلِن. |
الطُرق |
|
---|---|
|
يدقّق في حساب المعلِن. |
|
ينشئ معلِنًا جديدًا. |
|
حذف معلِن |
|
تعديلات خيارات الاستهداف تحت إشراف معلِن واحد |
|
الاستعانة بمعلِن |
|
يسرد المعلِنين الذين يمكن للمستخدِم الحالي الوصول إليه. |
|
يسرد خيارات الاستهداف التي تم تعيينها لأحد المعلنين على مستوى أنواع الاستهداف. |
|
تعديل بيانات معلِن حالي |