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 และ Demand Gen จะใช้ภายใต้ผู้ลงโฆษณารายนี้หากไม่มีชิ้นงานโลโก้

คุณต้องใช้ 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

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