REST Resource: advertisers

المرجع: معلِن

معلِن واحد في "مساحة العرض والفيديو 360"

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean
}
الحقول
name

string

النتائج فقط. اسم مورد المعلن.
advertiserId

string (int64 format)

النتائج فقط. المعرّف الفريد للمعلِن. تم تعيينه من قِبل النظام.
partnerId

string (int64 format)

مطلوبة. غير قابل للتغيير. المعرّف الفريد للشريك الذي ينتمي إليه المعلِن.
displayName

string

مطلوبة. الاسم المعروض للمعلِن.

يجب ترميزها باستخدام UTF-8 بحيث يبلغ الحد الأقصى للحجم 240 بايت.
entityStatus

enum (EntityStatus)

مطلوبة. للتحكم في ما إذا كان يمكن لطلبات الإدراج وتفاصيل المعلن إنفاق ميزانياته وتقديم عروض أسعار للمستودع أم لا.

  • والقيم المقبولة هي ENTITY_STATUS_ACTIVE وENTITY_STATUS_PAUSED وENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • في حال ضبط السياسة على ENTITY_STATUS_SCHEDULED_FOR_DELETION، سيتم حذف المعلِن بعد 30 يومًا من تحديد موعد للحذف للمرة الأولى.
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تعديل للمعلِن تم تعيينه من قِبل النظام.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
generalConfig

object (AdvertiserGeneralConfig)

مطلوبة. الإعدادات العامة للمعلن.
adServerConfig

object (AdvertiserAdServerConfig)

مطلوبة. غير قابل للتغيير. الإعدادات المتعلقة بخادم الإعلانات الخاصة بالمعلِن
creativeConfig

object (AdvertiserCreativeConfig)

مطلوبة. الإعدادات المتعلقة بتصميم الإعلان للمعلِن
dataAccessConfig

object (AdvertiserDataAccessConfig)

الإعدادات التي تتحكّم في كيفية الوصول إلى بيانات المعلن
integrationDetails

object (IntegrationDetails)

تفاصيل دمج المعلِن يسري integrationCode فقط على المعلن في الوقت الحالي. الحقول الأخرى لـ IntegrationDetails غير متاحة، وسيتم تجاهلها إذا تم توفيرها.
servingConfig

object (AdvertiserTargetingConfig)

إعدادات الاستهداف المرتبطة بعرض الإعلانات للمعلِن
prismaEnabled

boolean

يمكنك اختيار ما إذا كان الدمج مع Mediaocean (Prisma) مفعّلاً. من خلال تفعيل هذه الميزة، أنت توافق على ما يلي:

نيابةً عن شركتي، أفوّض Mediaocean (Prisma) بإرسال خطط شرائح الميزانية إلى Google، وأفوّض Google في إرسال التقارير والفواتير المقابلة من "مساحة العرض والفيديو 360" إلى Mediaocean لأغراض تخطيط الميزانية والفوترة والتسوية لهذا المعلن.

AdvertiserGeneralConfig

الإعدادات العامة للمعلن.

تمثيل JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
الحقول
domainUrl

string

مطلوبة. عنوان URL لنطاق الموقع الإلكتروني الأساسي للمعلِن. سيرسل النظام هذه المعلومات إلى الناشرين الذين يطلبون عنوان URL للموقع الإلكتروني لربط حملة بمعلِن.

يُرجى تقديم عنوان URL بدون مسار أو سلسلة طلب بحث، ويبدأ بـ http: أو https:. على سبيل المثال، http://www.example.com
timeZone

string

النتائج فقط. الاسم العادي لقاعدة بيانات TZ للمنطقة الزمنية للمعلِن. مثلاً: America/New_York

يمكنك الاطّلاع على مزيد من المعلومات على: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

بالنسبة إلى المعلِنين المختلطين في "مدير الحملة 360"، تكون المنطقة الزمنية هي نفسها المنطقة الزمنية في حساب "مدير الحملة 360" المرتبط، أما بالنسبة إلى المعلِنين التابعين لجهات خارجية فقط، فإن المنطقة الزمنية هي نفسها المنطقة الزمنية للشريك الرئيسي.
currencyCode

string

مطلوبة. غير قابل للتغيير. عملة المعلِن بتنسيق ISO 4217.

الرموز المقبولة والعملات التي تمثلها هي:

رمز العملة : اسم العملة

  • ARS : بيزو أرجنتيني
  • AUD : دولار أسترالي
  • BRL : ريال برازيلي
  • CAD : دولار كندي
  • CHF : فرنك سويسري
  • CLP : بيزو تشيلي
  • CNY : يوان صيني
  • COP : بيزو كولومبي
  • CZK : كرونة تشيكية
  • DKK : كرونة دنماركية
  • EGP : جنيه مصري
  • EUR : يورو
  • GBP : جنيه إسترليني
  • HKD : دولار هونغ كونغ
  • HUF : فورينت مجري
  • IDR : روبية إندونيسية
  • ILS : شيكل إسرائيلي
  • INR : روبية هندي
  • JPY : ين ياباني
  • KRW : وون كوري جنوبي
  • MXN : بيزو مكسيكي
  • MYR : رينغيت ماليزي
  • NGN : نايرا نيجيري
  • NOK : كرونة نرويجية
  • NZD : دولار نيوزيلندي
  • PEN : سول بيروفي جديد
  • PLN : زلوتي بولندي
  • RON : ليو روماني جديد
  • RUB : روبل روسي
  • SEK : كرونة سويدية
  • TRY : ليرة تركية
  • TWD : دولار تايواني جديد
  • USD : دولار أمريكي
  • ZAR : راند جنوب أفريقيا

AdvertiserAdServerConfig

الإعدادات المتعلقة بخادم الإعلانات للمعلِن

تمثيل JSON 
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
الحقول
حقل الاتحاد ad_server_config_scheme مطلوبة. يمكن أن تكون السمة "ad_server_config_scheme" واحدة فقط مما يلي:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

إعداد المعلنين الذين يستخدمون خوادم إعلانات الجهات الخارجية فقط.
cmHybridConfig

object (CmHybridConfig)

إعدادات المعلِنين الذين يستخدِمون كلاً من "مدير الحملة 360" وخوادم الإعلانات التابعة لجهات خارجية.

ThirdPartyOnlyConfig

إعدادات للمعلنين الذين يستخدمون خوادم إعلانات تابعة لجهات خارجية فقط.

تمثيل JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
الحقول
pixelOrderIdReportingEnabled

boolean

ما إذا كان إعداد تقارير مُعرّف الطلب لوحدات البكسل مفعَّلاً أم لا. لا يمكن تغيير هذه القيمة بعد ضبطها على true.

CmHybridConfig

إعدادات للمعلِنين الذين يستخدِمون كلاً من "مدير الحملة 360" وخوادم الإعلانات التابعة لجهات خارجية.

تمثيل JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
الحقول
cmAccountId

string (int64 format)

مطلوبة. غير قابل للتغيير. رقم تعريف الحساب لضبط Floodlight في "مدير الحملة 360" المرتبط بالمعلِن على "مساحة العرض والفيديو 360".
cmFloodlightConfigId

string (int64 format)

مطلوبة. غير قابل للتغيير. رقم تعريف ضبط Floodlight في "مدير الحملة 360" المرتبط بالمعلِن على "مساحة العرض والفيديو 360".
cmSyncableSiteIds[]

string (int64 format)

قائمة بالمواقع الإلكترونية في "مدير الحملة 360" التي ستتم مزامنة مواضعها مع "مساحة العرض والفيديو 360" كتصميمات إعلانات.

في حال عدم توفّر هذا العنصر أو تركه فارغًا في طريقة advertisers.create، سينشئ النظام موقعًا إلكترونيًا في "مدير الحملة 360" تلقائيًا.

قد تؤدي إزالة المواقع الإلكترونية من هذه القائمة إلى حذف تصميمات الإعلانات على "مساحة العرض والفيديو 360" التي تمت مزامنتها من "مدير الحملة 360". يجب تحديد موقع إلكتروني واحد على الأقل.
dv360ToCmDataSharingEnabled

boolean

ما إذا كان سيتم تضمين بيانات "مساحة العرض والفيديو 360" في تقارير نقل البيانات في "مدير الحملة 360" أم لا.
dv360ToCmCostReportingEnabled

boolean

ما إذا كان سيتم الإبلاغ عن تكلفة "مساحة العرض والفيديو 360" في "مدير الحملة 360" أم لا.
cmFloodlightLinkingAuthorized

boolean

مطلوبة. غير قابل للتغيير. من خلال ضبط هذا الحقل على true، فإنّك تسمح بالنيابة عن شركتك بمشاركة المعلومات من إعدادات Floodlight المحدّدة مع هذا المعلِن على "مساحة العرض والفيديو 360".

AdvertiserCreativeConfig

الإعدادات المتعلقة بتصميمات الإعلانات للمعلِن

تمثيل JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
الحقول
iasClientId

string (int64 format)

رقم تعريف لضبط إعدادات مراقبة الحملة مقدَّمة من Integral Ad Service (IAS). سيُلحق نظام "مساحة العرض والفيديو 360" علامة "أداة مراقبة الحملة" من IAS التي تحتوي على رقم التعريف هذا بعلامة تصميم الإعلان.
obaComplianceDisabled

boolean

استخدام الامتثال المتعلّق بسلوك الإعلان على الإنترنت (OBA) في "مساحة العرض والفيديو 360" أو عدم استخدامه

تحذير: قد يؤدي تغيير إعدادات OBA إلى إعادة ضبط حالة تدقيق تصميمات الإعلانات بواسطة بعض تبادلات الإعلانات، ما يجعلها غير مؤهَّلة للعرض إلى أن تتم الموافقة عليها مجددًا.
dynamicCreativeEnabled

boolean

ما إذا كان المعلِن مفعَّلاً للتصاميم الديناميكية أو لا
videoCreativeDataSharingAuthorized

boolean

يشير ضبط هذا الحقل على true، نيابةً عن شركتك، إلى منح Google الإذن باستخدام تصميمات إعلانات الفيديو المرتبطة بهذا المعلِن على "مساحة العرض والفيديو 360" لتقديم التقارير والميزات ذات الصلة بالحملات التلفزيونية للمعلِن.

لا يسري هذا العرض إلا عندما يضبط المُعلِن خادم إعلانات CM360 hybrid.

AdvertiserDataAccessConfig

الإعدادات التي تتحكّم في كيفية الوصول إلى البيانات المتعلقة بالمعلنين.

تمثيل JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
الحقول
sdfConfig

object (AdvertiserSdfConfig)

إعدادات ملفات البيانات المنظَّمة (SDF) للمعلِن

وفي حال عدم تحديد ذلك، سيتم استخدام إعدادات SDF للشريك الرئيسي.

AdvertiserSdfConfig

إعدادات ملفات البيانات المنظَّمة (SDF) للمعلِن

تمثيل JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
الحقول
overridePartnerSdfConfig

boolean

ما إذا كان هذا المعلِن يلغي ضبط SDF لشريكه الرئيسي

بشكلٍ تلقائي، يكتسب المعلِن إعدادات SDF من الشريك الرئيسي. لإلغاء إعدادات الشريك، اضبط هذا الحقل على true وقدِّم الإعدادات الجديدة في sdfConfig.
sdfConfig

object (SdfConfig)

إعدادات SDF للمعلِن

AdvertiserTargetingConfig

إعدادات الاستهداف المرتبطة بعرض الإعلانات لأحد المعلِنين

تمثيل JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
الحقول
exemptTvFromViewabilityTargeting

boolean

ما إذا كانت أجهزة التلفزيون المتّصلة معفاة من استهداف إمكانية العرض لجميع عناصر الفيديو التابعة للمعلِن.

الطُرق

audit

 تدقيق للمعلِن.

bulkEditAdvertiserAssignedTargetingOptions

 تعديلات مجمّعة لخيارات استهداف معلِن واحد.

bulkListAdvertiserAssignedTargetingOptions

 يسرد خيارات الاستهداف المعيّنة للمعلِن على مستوى أنواع الاستهداف.

create

 ينشئ معلِنًا جديدًا.

delete

 حذف معلن.

get

 الاستعانة بمعلِن

list

 يسرد المعلنين الذين يمكن للمستخدم الحالي الوصول إليه.

patch

 لتعديل معلِن حالي