REST Resource: advertisers

{
  "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)
  }
}

string

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

string (int64 format)

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

string (int64 format)

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

string

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

يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت.

enum (EntityStatus)

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

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

string (Timestamp format)

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

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

object (AdvertiserGeneralConfig)

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

object (AdvertiserAdServerConfig)

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

object (AdvertiserCreativeConfig)

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

object (AdvertiserDataAccessConfig)

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

object (IntegrationDetails)

تفاصيل دمج المعلِن ينطبق integrationCode فقط حاليًا على المعلن. لا تتوفّر حقول IntegrationDetails الأخرى وسيتم تجاهلها في حال توفيرها.

object (AdvertiserTargetingConfig)

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

boolean

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

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

object (AdvertiserBillingConfig)

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

{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}

string

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

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

string

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

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

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

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 : راند جنوب أفريقي

{

  // 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.
}

object (ThirdPartyOnlyConfig)

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

object (CmHybridConfig)

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

{
  "pixelOrderIdReportingEnabled": boolean
}

boolean

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

{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}

string (int64 format)

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

string (int64 format)

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

string (int64 format)

النتائج فقط. مجموعة أرقام تعريف المعلِنين في "مدير الحملة 360" التي تتشارك إعدادات Floodlight في "مدير الحملة 360"

string (int64 format)

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

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

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

boolean

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

boolean

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

boolean

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

{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}

string (int64 format)

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

boolean

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

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

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

boolean

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

boolean

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

لا يسري ذلك إلا عندما يكون لدى المعلن إعداد خادم إعلانات "CM360 hybrid".

{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}

object (AdvertiserSdfConfig)

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

في حال عدم تحديد قيمة، يتم استخدام إعدادات SDF الخاصة بالشريك الرئيسي.

{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}

boolean

ما إذا كان هذا المعلن يلغي إعدادات SDF لشريكه الرئيسي أم لا.

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

object (SdfConfig)

إعداد SDF للمعلن.

• مطلوبة عندما تكون قيمة overridePartnerSdfConfig هي true.
• ناتج فقط عندما تكون قيمة overridePartnerSdfConfig هي false.

{
  "exemptTvFromViewabilityTargeting": boolean
}

boolean

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

{
  "billingProfileId": string
}

string (int64 format)

رقم تعريف الملف الشخصي للفوترة الذي تم تعيينه للمعلِن.

سيتم ضبط هذا الحقل تلقائيًا على معرّف الملف الشخصي للفوترة التلقائي للشريك الرئيسي للمعلِن في حال عدم تقديم قيمة.