REST Resource: advertisers

แหล่งข้อมูล: ผู้ลงโฆษณา

ผู้ลงโฆษณารายเดียวในเครือข่ายดิสเพลย์และ 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" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่าง: "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 ของเว็บไซต์เพื่อเชื่อมโยงแคมเปญกับผู้ลงโฆษณา

ระบุ 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)

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสบัญชีของการกำหนดค่า CM360 Floodlight ที่ลิงก์กับผู้ลงโฆษณา DV360
cmFloodlightConfigId

string (int64 format)

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสการกําหนดค่า CM360 Floodlight ที่ลิงก์กับผู้ลงโฆษณา 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 จะเพิ่ม IAS "Campaign Monitor" ต่อท้าย ที่มีรหัสนี้ลงในแท็กครีเอทีฟโฆษณา
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)

การตั้งค่าไฟล์ Structured Data (SDF) สําหรับผู้ลงโฆษณา

หากไม่ได้ระบุไว้ ระบบจะใช้การตั้งค่า SDF ของพาร์ทเนอร์หลัก

AdvertiserSdfConfig

การตั้งค่าไฟล์ Structured Data (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

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