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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 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 ที่แชร์การกำหนดค่า CM360 Floodlight
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)

รหัสสำหรับกำหนดค่าการตรวจสอบแคมเปญที่ให้บริการโดย 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

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