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)
  }
}
فیلدها
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 "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "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 اجازه می‌دهم گزارش‌ها و صورت‌حساب‌های مربوطه را از DV360 به Mediaocean به منظور برنامه‌ریزی بودجه، صورت‌حساب، و تطبیق برای این تبلیغ‌کننده ارسال کند.

billingConfig

object ( AdvertiserBillingConfig )

مورد نیاز. تنظیمات مربوط به صورت‌حساب آگهی‌دهنده.

AdvertiserGeneralConfig

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

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

string

مورد نیاز. آدرس دامنه وب سایت اصلی تبلیغ کننده. سیستم این اطلاعات را برای ناشرانی که برای مرتبط کردن یک کمپین با تبلیغ‌کننده نیاز به 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

برای تبلیغ‌کنندگان ترکیبی 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 : راند آفریقای جنوبی

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 )

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

ThirdPartyOnlyConfig

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

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

boolean

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

CmHybridConfig

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

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

string ( int64 format)

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

cmFloodlightConfigId

string ( int64 format)

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

cmAdvertiserIds[]

string ( int64 format)

فقط خروجی مجموعه شناسه‌های تبلیغ‌کننده CM360 که پیکربندی Floodlight 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 اجازه می دهید.

AdvertiserCreativeConfig

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

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

string ( int64 format)

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

obaComplianceDisabled

boolean

اینکه آیا ویژگی Google's About this Ad را غیرفعال کنید یا خیر که نشان (برای شناسایی محتوا به عنوان آگهی) و اطلاعات شفافیت (در تعامل با درباره این آگهی) را به تبلیغات شما برای تبلیغات رفتاری آنلاین (OBA) و الزامات قانونی اضافه می کند. درباره این آگهی به کاربران کنترل بیشتری بر تبلیغاتی که می‌بینند می‌دهد و به شما کمک می‌کند توضیح دهید چرا تبلیغ شما را می‌بینند. بیشتر بدانید .

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

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

boolean

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

videoCreativeDataSharingAuthorized

boolean

با تنظیم این فیلد روی true ، شما به نمایندگی از شرکت خود، به Google اجازه می‌دهید از خلاقیت‌های ویدیویی مرتبط با این تبلیغ‌کننده Display & Video 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

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