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)
  }
}
الحقول
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 ويستخدم 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)

مطلوب. الإعدادات المتعلّقة بالفوترة للمعلِن

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,
  "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" علامة "Campaign Monitor" من 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

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