REST Resource: advertisers

المورد: المعلِن

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

تمثيل 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),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
الحقول
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)

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

enum (EuPoliticalAdvertisingStatus)

اختيارية: ما إذا كان هذا المعلِن يتضمّن بنودًا إعلانية تعرض إعلانات سياسية عن الاتحاد الأوروبي

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

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

string

اختيارية: اسم المؤسسة التلقائي للمعلِن

هذه هي القيمة التي تستخدمها إعلانات YouTube و"إعلانات زيادة الطلب" ضمن هذا المعلِن في حال عدم تقديم اسم مؤسسة.
defaultLogoAssetId

string (int64 format)

اختيارية: رقم تعريف مادة العرض لصورة الشعار التلقائية للمعلن

هذا هو رقم تعريف مادة العرض الذي سيتم استخدامه في الإعلانات على YouTube و"إعلانات زيادة الطلب" ضمن حساب المعلِن هذا في حال عدم توفير مادة عرض شعار.

يجب استخدام advertisers.adAssets.upload لتحميل مادة العرض هذه باستخدام واجهة برمجة التطبيقات.

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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
الحقول
الحقل مطلوب. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
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)

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

AdvertiserTargetingConfig

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

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

boolean

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

AdvertiserBillingConfig

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

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

string (int64 format)

الحقل مطلوب. رقم تعريف الملف التعريفي للفوترة المخصّص للمعلِن

الطُرق

audit

 تدقيق معلِن

create

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

delete

 لحذف معلِن

editAssignedTargetingOptions

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

get

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

list

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

listAssignedTargetingOptions

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

patch

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