REST Resource: advertisers

منبع: تبلیغ کننده

یک تبلیغ‌کننده‌ی واحد در Display & Video 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 و حداکثر اندازه ۲۴۰ بایت کدگذاری شود.

entityStatus

enum ( EntityStatus )

الزامی. کنترل می‌کند که آیا سفارش‌های درج و اقلام ردیف تبلیغ‌کننده می‌توانند بودجه خود را خرج کنند و برای موجودی کالا پیشنهاد قیمت بدهند یا خیر.

  • مقادیر پذیرفته شده عبارتند از ENTITY_STATUS_ACTIVE ، ENTITY_STATUS_PAUSED و ENTITY_STATUS_SCHEDULED_FOR_DELETION .
  • اگر روی ENTITY_STATUS_SCHEDULED_FOR_DELETION تنظیم شود، تبلیغ‌کننده ۳۰ روز پس از اولین زمان برنامه‌ریزی شده برای حذف، حذف خواهد شد.
updateTime

string ( Timestamp format)

فقط خروجی. مهر زمانی آخرین به‌روزرسانی تبلیغ‌کننده. توسط سیستم تعیین می‌شود.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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) اجازه می‌دهم برنامه‌های بخش بودجه را به گوگل ارسال کند و به گوگل اجازه می‌دهم گزارش‌ها و فاکتورهای مربوطه را از DV360 به 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 و Demand Gen تحت این تبلیغ‌کننده استفاده می‌شود.

defaultLogoAssetId

string ( int64 format)

اختیاری. شناسه‌ی تصویر لوگوی پیش‌فرض برای تبلیغ‌کننده.

این شناسه دارایی است که در صورت عدم ارائه دارایی لوگو، توسط تبلیغات YouTube و Demand تحت این تبلیغ‌کننده استفاده خواهد شد.

برای آپلود این دارایی با استفاده از API، باید از advertisers.adAssets.upload استفاده کنید.

پیکربندی عمومی تبلیغ‌کننده

تنظیمات عمومی یک تبلیغ کننده.

نمایش JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
فیلدها
domainUrl

string

الزامی. آدرس اینترنتی دامنه وب‌سایت اصلی تبلیغ‌کننده. سیستم این اطلاعات را برای ناشرانی که برای مرتبط کردن یک کمپین با یک تبلیغ‌کننده به آدرس اینترنتی وب‌سایت نیاز دارند، ارسال می‌کند.

یک URL بدون مسیر یا رشته پرس‌وجو ارائه دهید که با http: یا https: شروع شود. برای مثال، http://www.example.com

timeZone

string

فقط خروجی. نام استاندارد پایگاه داده TZ مربوط به منطقه زمانی تبلیغ‌کننده. برای مثال، America/New_York .

برای اطلاعات بیشتر به این لینک مراجعه کنید: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

برای تبلیغ‌کنندگان ترکیبی CM360، منطقه زمانی همان منطقه زمانی حساب CM360 مرتبط است؛ برای تبلیغ‌کنندگان صرفاً شخص ثالث، منطقه زمانی همان منطقه زمانی شریک والد است.

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 :

پیکربندی AdServerConfig

تنظیمات مربوط به سرور تبلیغات یک تبلیغ‌کننده.

نمایش 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 از نوع Union است. الزامی است. ad_server_config_scheme فقط می‌تواند یکی از موارد زیر باشد:
thirdPartyOnlyConfig

object ( ThirdPartyOnlyConfig )

پیکربندی برای تبلیغ‌کنندگانی که فقط از سرورهای تبلیغاتی شخص ثالث استفاده می‌کنند.

cmHybridConfig

object ( CmHybridConfig )

پیکربندی برای تبلیغ‌کنندگانی که هم از Campaign Manager 360 (CM360) و هم از سرورهای تبلیغاتی شخص ثالث استفاده می‌کنند.

پیکربندی فقط شخص ثالث

تنظیمات برای تبلیغ‌کنندگانی که فقط از سرورهای تبلیغاتی شخص ثالث استفاده می‌کنند.

نمایش JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
فیلدها
pixelOrderIdReportingEnabled

boolean

فعال بودن یا نبودن گزارش شناسه سفارش برای پیکسل‌ها. این مقدار پس از تنظیم روی true ، قابل تغییر نیست.

پیکربندی CmHybrid

تنظیمات برای تبلیغ‌کنندگانی که هم از Campaign Manager 360 (CM360) و هم از سرورهای تبلیغاتی شخص ثالث استفاده می‌کنند.

نمایش JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
فیلدها
cmAccountId

string ( int64 format)

الزامی. تغییرناپذیر. شناسه حساب پیکربندی CM360 Floodlight که به تبلیغ‌کننده DV360 مرتبط است.

cmFloodlightConfigId

string ( int64 format)

الزامی. تغییرناپذیر. شناسه پیکربندی نورافکن CM360 که به تبلیغ‌کننده DV360 مرتبط است.

cmAdvertiserIds[]

string ( int64 format)

فقط خروجی. مجموعه‌ای از شناسه‌های تبلیغ‌کننده CM360 که پیکربندی نورافکن CM360 را به اشتراک می‌گذارند.

cmSyncableSiteIds[]

string ( int64 format)

فهرستی از سایت‌های CM360 که جایگاه‌های آنها به عنوان آگهی‌های تبلیغاتی با DV360 همگام‌سازی خواهد شد.

اگر متد advertisers.create وجود نداشته باشد یا خالی باشد، سیستم به طور خودکار یک سایت CM360 ایجاد می‌کند.

حذف سایت‌ها از این لیست ممکن است باعث شود که آگهی‌های تبلیغاتی DV360 که از CM360 همگام‌سازی شده‌اند، حذف شوند. حداقل یک سایت باید مشخص شود.

dv360ToCmDataSharingEnabled

boolean

آیا داده‌های DV360 در گزارش‌های انتقال داده CM360 لحاظ شوند یا خیر.

dv360ToCmCostReportingEnabled

boolean

آیا هزینه DV360 را به CM360 گزارش دهیم یا خیر.

cmFloodlightLinkingAuthorized

boolean

الزامی. تغییرناپذیر. با تنظیم این فیلد روی true ، شما، از طرف شرکت خود، اشتراک‌گذاری اطلاعات از پیکربندی Floodlight داده شده را با این تبلیغ‌کننده Display & Video 360 مجاز می‌کنید.

تبلیغ‌کنندهCreativeConfig

تنظیمات مرتبط با خلاقیت‌های یک تبلیغ‌کننده.

نمایش JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
فیلدها
iasClientId

string ( int64 format)

یک شناسه برای پیکربندی نظارت بر کمپین که توسط سرویس تبلیغات یکپارچه (IAS) ارائه می‌شود. سیستم DV360 یک برچسب «نظارت بر کمپین» IAS حاوی این شناسه را به برچسب خلاقیت اضافه می‌کند.

obaComplianceDisabled

boolean

اینکه آیا ویژگی «درباره این تبلیغ» گوگل که نشان (برای شناسایی محتوا به عنوان تبلیغ) و اطلاعات شفاف (در مورد تعامل با «درباره این تبلیغ») را به تبلیغات شما برای تبلیغات رفتاری آنلاین (OBA) و الزامات نظارتی اضافه می‌کند، غیرفعال شود یا خیر. «درباره این تبلیغ» به کاربران کنترل بیشتری بر تبلیغاتی که می‌بینند می‌دهد و به شما کمک می‌کند توضیح دهید که چرا تبلیغ شما را می‌بینند. اطلاعات بیشتر .

اگر تصمیم دارید این فیلد را روی true تنظیم کنید، توجه داشته باشید که تبلیغاتی که از طریق Display & Video 360 ارائه می‌شوند باید موارد زیر را رعایت کنند:

  • طبق قرارداد خود با پلتفرم بازاریابی گوگل، با تبلیغات رفتاری آنلاین (OBA) سازگار باشید.
  • در منطقه اقتصادی اروپا (EEA)، اطلاعات شفاف‌سازی و مکانیزمی را برای کاربران جهت گزارش محتوای غیرقانونی در تبلیغات لحاظ کنید. اگر از راهکار جایگزین برای نشان‌گذاری، شفافیت و گزارش‌دهی تبلیغات استفاده می‌کنید، باید مطمئن شوید که شامل اطلاعات شفاف‌سازی مورد نیاز و مکانیزم پرچم‌گذاری محتوای غیرقانونی است و با استفاده از فرم مناسب، گوگل را از هرگونه گزارش محتوای غیرقانونی مطلع می‌کنید.
dynamicCreativeEnabled

boolean

اینکه آیا تبلیغ‌کننده برای تبلیغات پویا فعال است یا خیر.

videoCreativeDataSharingAuthorized

boolean

با تنظیم این فیلد روی true ، شما، از طرف شرکت خود، به گوگل اجازه می‌دهید تا از ویدیوهای خلاقانه مرتبط با این تبلیغ‌کننده‌ی Display & Video 360 برای ارائه گزارش و ویژگی‌های مرتبط با کمپین‌های تلویزیونی تبلیغ‌کننده استفاده کند.

فقط زمانی قابل اجرا است که تبلیغ‌کننده پیکربندی سرور تبلیغاتی CM360 hybrid را داشته باشد.

پیکربندی دسترسی به داده‌های تبلیغ‌کننده

تنظیماتی که نحوه دسترسی به داده‌های مربوط به تبلیغ‌کنندگان را کنترل می‌کنند.

نمایش JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
فیلدها
sdfConfig

object ( AdvertiserSdfConfig )

تنظیمات فایل‌های داده ساختاریافته (SDF) برای تبلیغ‌کننده.

اگر مشخص نشده باشد، از تنظیمات SDF شریک والد استفاده می‌شود.

پیکربندی تبلیغ‌کنندهSdf

تنظیمات فایل‌های داده ساختاریافته (SDF) یک تبلیغ‌کننده.

نمایش JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
فیلدها
overridePartnerSdfConfig

boolean

اینکه آیا این تبلیغ‌کننده پیکربندی SDF شریک والد خود را لغو می‌کند یا خیر.

به طور پیش‌فرض، یک تبلیغ‌کننده پیکربندی SDF را از شریک والد به ارث می‌برد. برای لغو پیکربندی شریک، این فیلد را روی true تنظیم کنید و پیکربندی جدید را در sdfConfig ارائه دهید.

sdfConfig

object ( SdfConfig )

پیکربندی SDF برای تبلیغ‌کننده.

پیکربندی هدف‌گیری تبلیغ‌کننده

تنظیمات هدف‌گیری مربوط به نمایش تبلیغات یک تبلیغ‌کننده.

نمایش JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
فیلدها
exemptTvFromViewabilityTargeting

boolean

اینکه آیا دستگاه‌های تلویزیون متصل از هدف‌گذاری قابلیت مشاهده برای همه موارد خط ویدیویی تحت تبلیغ‌کننده معاف هستند یا خیر.

پیکربندی صورتحساب تبلیغ‌کننده

تنظیمات مربوط به صورتحساب یک تبلیغ‌کننده.

نمایش JSON 
{
  "billingProfileId": string
}
فیلدها
billingProfileId

string ( int64 format)

الزامی. شناسه‌ی نمایه‌ی صورتحساب اختصاص داده شده به تبلیغ‌کننده.

روش‌ها

audit

 یک تبلیغ‌کننده را حسابرسی می‌کند.

create

 یک تبلیغ‌کننده جدید ایجاد می‌کند.

delete

 یک تبلیغ‌کننده را حذف می‌کند.

editAssignedTargetingOptions

 گزینه‌های هدف‌گیری را تحت یک تبلیغ‌کننده واحد ویرایش می‌کند.

get

 یک تبلیغ کننده می گیرد.

list

 تبلیغ‌کنندگانی را که برای کاربر فعلی قابل دسترسی هستند، فهرست می‌کند.

listAssignedTargetingOptions

 گزینه‌های هدف‌گیری اختصاص داده شده به یک تبلیغ‌کننده را در انواع هدف‌گیری فهرست می‌کند.

patch

 یک تبلیغ‌کننده‌ی موجود را به‌روزرسانی می‌کند.