- المورد: معلِن
- AdvertiserGeneralConfig
- AdvertiserAdServerConfig
- ThirdPartyOnlyConfig
- CmHybridConfig
- AdvertiserCreativeConfig
- AdvertiserDataAccessConfig
- AdvertiserSdfConfig
- AdvertiserTargetingConfig
- الطُرق
المرجع: معلِن
معلِن واحد في "مساحة العرض والفيديو 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 لأغراض تخطيط الميزانية والفوترة والتسوية لهذا المعلن. |
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, "cmSyncableSiteIds": [ string ], "dv360ToCmDataSharingEnabled": boolean, "dv360ToCmCostReportingEnabled": boolean, "cmFloodlightLinkingAuthorized": boolean } |
الحقول | |
---|---|
cmAccountId |
مطلوبة. غير قابل للتغيير. رقم تعريف الحساب لضبط Floodlight في "مدير الحملة 360" المرتبط بالمعلِن على "مساحة العرض والفيديو 360". |
cmFloodlightConfigId |
مطلوبة. غير قابل للتغيير. رقم تعريف ضبط Floodlight في "مدير الحملة 360" المرتبط بالمعلِن على "مساحة العرض والفيديو 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 |
استخدام الامتثال المتعلّق بسلوك الإعلان على الإنترنت (OBA) في "مساحة العرض والفيديو 360" أو عدم استخدامه تحذير: قد يؤدي تغيير إعدادات OBA إلى إعادة ضبط حالة تدقيق تصميمات الإعلانات بواسطة بعض تبادلات الإعلانات، ما يجعلها غير مؤهَّلة للعرض إلى أن تتم الموافقة عليها مجددًا. |
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 |
ما إذا كانت أجهزة التلفزيون المتّصلة معفاة من استهداف إمكانية العرض لجميع عناصر الفيديو التابعة للمعلِن. |
الطُرق |
|
---|---|
|
تدقيق للمعلِن. |
|
تعديلات مجمّعة لخيارات استهداف معلِن واحد. |
|
يسرد خيارات الاستهداف المعيّنة للمعلِن على مستوى أنواع الاستهداف. |
|
ينشئ معلِنًا جديدًا. |
|
حذف معلن. |
|
الاستعانة بمعلِن |
|
يسرد المعلنين الذين يمكن للمستخدم الحالي الوصول إليه. |
|
لتعديل معلِن حالي |