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,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
الحقول
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)

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

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
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 لأغراض تخطيط الميزانية والفوترة والتسوية لهذا المعلِن.
billingConfig

object (AdvertiserBillingConfig)

مطلوب. إعدادات الفوترة الخاصة بالمعلِن
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

اختياريّ. تُستخدَم لتحديد ما إذا كان هذا المعلِن يحتوي على عناصر حملات تعرض إعلانات سياسية عن الاتحاد الأوروبي.

إذا تم ضبط هذا الحقل على DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING، سيحدث ما يلي:

  • سيتم تعيين DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING لأي عناصر جديدة يتم إنشاؤها ضمن هذا المعلِن، ما لم يتم تحديد خلاف ذلك.
  • سيتم تعديل أي عناصر حالية ضمن هذا المعلِن لا تتضمّن قيمة محدّدة إلى DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING في غضون يوم واحد.

AdvertiserGeneralConfig

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

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

string

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

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

string

النتائج فقط. اسم قاعدة بيانات المنطقة الزمنية العادي للمعلِن مثلاً: 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,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
الحقول
cmAccountId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

النتائج فقط. مجموعة أرقام تعريف المعلِنين في "مدير الحملة 360" الذين يتشاركون إعدادات Floodlight في "مدير الحملة 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

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

إذا اخترت ضبط هذا الحقل على true، يُرجى العِلم أنّ الإعلانات التي يتم عرضها من خلال "مساحة العرض والفيديو 360" يجب أن تستوفي ما يلي:

  • الالتزام بالإعلان استنادًا إلى سلوك المستخدم على الإنترنت (OBA)، وفقًا لعقدك مع "منصّة Google للتسويق"
  • في المنطقة الاقتصادية الأوروبية، يجب تضمين معلومات الشفافية وآلية تتيح للمستخدمين الإبلاغ عن المحتوى غير القانوني في الإعلانات. في حال استخدام حلّ بديل لعرض شارة الإعلان وتوفير الشفافية والإبلاغ، عليك التأكّد من أنّه يتضمّن معلومات الشفافية وآلية الإبلاغ عن المحتوى غير القانوني المطلوبة، وعليك إعلام Google بأي بلاغات تصِلك بشأن محتوى غير قانوني باستخدام النموذج المناسب.
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

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

AdvertiserBillingConfig

إعدادات الفوترة الخاصة بأحد المعلِنين

تمثيل JSON 
{
  "billingProfileId": string
}
الحقول
billingProfileId

string (int64 format)

مطلوب. معرّف ملف فوترة تم تعيينه للمعلِن.

الطُرق

audit

 تدقيق حساب أحد المعلِنين

create

 تنشئ هذه الطريقة معلِنًا جديدًا.

delete

 تحذف هذه الطريقة معلِنًا.

editAssignedTargetingOptions

 تعديل خيارات الاستهداف ضمن معلِن واحد

get

 تعرض هذه الطريقة معلومات عن أحد المعلِنين.

list

 تعرض هذه السمة قائمة بالمعلِنين الذين يمكن للمستخدم الحالي الوصول إليهم.

listAssignedTargetingOptions

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

patch

 تعدّل هذه الطريقة معلنًا حاليًا.