REST Resource: advertisers

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

معلن واحد في الشبكة الإعلانية الفيديو 360 (مساحة العرض والفيديو 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)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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 لأغراض تخطيط الميزانية والفوترة والتسوية لهذا المعلِن.
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" "أداة مراقبة الحملات" 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

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