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 โดยมีขนาดสูงสุด 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 ส่งการรายงานและใบแจ้งหนี้ที่เกี่ยวข้องจาก 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 ภายใน 1 วัน
defaultBusinessName

string

ไม่บังคับ ชื่อธุรกิจเริ่มต้นของผู้ลงโฆษณา

นี่คือค่าที่โฆษณา YouTube และ Demand Gen ใช้ภายใต้ผู้ลงโฆษณารายนี้ หากไม่มีการระบุชื่อธุรกิจ
defaultLogoAssetId

string (int64 format)

ไม่บังคับ รหัสเนื้อหาของรูปภาพโลโก้เริ่มต้นสำหรับผู้ลงโฆษณา

นี่คือรหัสเนื้อหาที่ YouTube และโฆษณาดีมานด์จะใช้ภายใต้ผู้ลงโฆษณารายนี้ หากไม่มีชิ้นงานโลโก้

คุณต้องใช้ advertisers.adAssets.upload เพื่ออัปโหลดชิ้นงานนี้โดยใช้ API

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

สําหรับผู้ลงโฆษณาแบบไฮบริดของ 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 
{

  // 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.
}
ช่อง
ต้องระบุ ต่อไปนี้คือรายการฟิลด์ที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าฟิลด์อย่างน้อย 1 รายการในการตอบกลับ
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 ต้องระบุอย่างน้อย 1 เว็บไซต์
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)

รหัสสำหรับการกำหนดค่าการตรวจสอบแคมเปญที่ Integral Ad Service (IAS) จัดหาให้ ระบบ DV360 จะต่อท้ายแท็ก "Campaign Monitor" ของ IAS ที่มีรหัสนี้กับแท็กครีเอทีฟโฆษณา
obaComplianceDisabled

boolean

จะปิดใช้ฟีเจอร์ "เกี่ยวกับโฆษณานี้" ของ Google หรือไม่ ซึ่งจะเพิ่มการติดป้ายระบุว่าเป็นโฆษณา (เพื่อระบุว่าเนื้อหาเป็นโฆษณา) และข้อมูลความโปร่งใส (เกี่ยวกับการโต้ตอบกับ "เกี่ยวกับโฆษณานี้") ลงในโฆษณาสำหรับการโฆษณาตามพฤติกรรมบนโลกออนไลน์ (OBA) และข้อกำหนดด้านกฎระเบียบ เกี่ยวกับโฆษณานี้ช่วยให้ผู้ใช้ควบคุมโฆษณาที่เห็นได้มากขึ้น และช่วยให้คุณอธิบายเหตุผลที่ผู้ใช้เห็นโฆษณาของคุณได้ ดูข้อมูลเพิ่มเติม

หากเลือกตั้งค่าฟิลด์นี้เป็น true โปรดทราบว่าโฆษณาที่แสดงผ่าน Display & Video 360 ต้องเป็นไปตามข้อกำหนดต่อไปนี้

  • ปฏิบัติตามข้อกำหนดการโฆษณาตามพฤติกรรมบนโลกออนไลน์ (OBA) ตามสัญญาที่คุณมีกับ Google Marketing Platform
  • ในเขตเศรษฐกิจยุโรป (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

 อัปเดตผู้ลงโฆษณาที่มีอยู่