REST Resource: advertisers.campaigns

แหล่งข้อมูล: แคมเปญ

แคมเปญเดียว

การแสดง JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของแคมเปญ
advertiserId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่เป็นเจ้าของแคมเปญ
campaignId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของแคมเปญ ระบบกำหนด
displayName

string

ต้องระบุ ชื่อที่แสดงของแคมเปญ

ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 240 ไบต์
entityStatus

enum (EntityStatus)

ต้องระบุ ควบคุมว่าใบสั่งซื้อการใส่โฆษณาภายใต้แคมเปญนี้จะใช้จ่ายงบประมาณและเสนอราคาในพื้นที่โฆษณาได้หรือไม่

  • ค่าที่ยอมรับคือ ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED และ ENTITY_STATUS_PAUSED
  • สำหรับวิธีการ campaigns.create ไม่อนุญาตให้ใช้ ENTITY_STATUS_ARCHIVED
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"
campaignGoal

object (CampaignGoal)

ต้องระบุ เป้าหมายของแคมเปญ
campaignFlight

object (CampaignFlight)

ต้องระบุ การใช้จ่ายและระยะเวลาของแคมเปญที่วางแผนไว้
frequencyCap

object (FrequencyCap)

ต้องระบุ การตั้งค่าความถี่สูงสุดของแคมเปญ
campaignBudgets[]

object (CampaignBudget)

รายการงบประมาณที่ใช้ได้กับแคมเปญนี้

หากไม่ได้ตั้งค่าช่องนี้ แคมเปญจะใช้งบประมาณแบบไม่จำกัด

CampaignGoal

การตั้งค่าที่ควบคุมเป้าหมายของแคมเปญ

การแสดง JSON 
{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}
ช่อง
campaignGoalType

enum (CampaignGoalType)

ต้องระบุ ประเภทเป้าหมายของแคมเปญ
performanceGoal

object (PerformanceGoal)

ต้องระบุ เป้าหมายด้านประสิทธิภาพของแคมเปญ

ค่าที่ยอมรับได้สำหรับ performanceGoalType มีดังนี้

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_OTHER

CampaignGoalType

ประเภทเป้าหมายแคมเปญที่อาจมี

Enum
CAMPAIGN_GOAL_TYPE_UNSPECIFIED ไม่ได้ระบุมูลค่าเป้าหมายหรือไม่รู้จักในเวอร์ชันนี้
CAMPAIGN_GOAL_TYPE_APP_INSTALL กระตุ้นการติดตั้งหรือมีส่วนร่วมกับแอป
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS เพิ่มการรับรู้ถึงแบรนด์หรือผลิตภัณฑ์
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION กระตุ้นยอดขายออฟไลน์หรือในร้านค้า
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION กระตุ้นการเข้าชมหรือการดำเนินการทางออนไลน์

PerformanceGoal

การตั้งค่าที่ควบคุมเป้าหมายด้านประสิทธิภาพของแคมเปญ

การแสดง JSON 
{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}
ช่อง
performanceGoalType

enum (PerformanceGoalType)

ต้องระบุ ประเภทของเป้าหมายด้านประสิทธิภาพ
ฟิลด์ Union performance_goal_value ต้องระบุ ค่าเป้าหมายประสิทธิภาพที่สอดคล้องกับ performance_goal_type ที่ระบุ performance_goal_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
performanceGoalAmountMicros

string (int64 format)

จํานวนเป้าหมายในหน่วยไมโครของสกุลเงินของผู้ลงโฆษณา

ใช้ได้เมื่อ performanceGoalType เป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_VCPM

เช่น 1500000 หมายถึง 1.5 หน่วยมาตรฐานของสกุลเงิน
performanceGoalPercentageMicros

string (int64 format)

การแสดงเปอร์เซ็นต์เป้าหมายในหน่วยไมโครเป็นเลขทศนิยม

ใช้ได้เมื่อ performanceGoalType เป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_CLICK_CVR
  • PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
  • PERFORMANCE_GOAL_TYPE_VTR
  • PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
  • PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

เช่น 70000 หมายถึง 7% (ทศนิยม 0.07)
performanceGoalString

string

สตริงตัวชี้วัดประสิทธิภาพ (KPI) ซึ่งอาจว่างเปล่าได้ ต้องเข้ารหัส UTF-8 โดยมีความยาวไม่เกิน 100 อักขระ

ใช้ได้เมื่อตั้งค่า performanceGoalType เป็น PERFORMANCE_GOAL_TYPE_OTHER

PerformanceGoalType

ประเภทเป้าหมายด้านประสิทธิภาพที่เป็นไปได้

Enum
PERFORMANCE_GOAL_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทเป้าหมายด้านประสิทธิภาพหรือไม่รู้จักในเวอร์ชันนี้
PERFORMANCE_GOAL_TYPE_CPM เป้าหมายด้านประสิทธิภาพจะกำหนดใน CPM (ต้นทุนต่อการแสดงผลพันครั้ง)
PERFORMANCE_GOAL_TYPE_CPC เป้าหมายด้านประสิทธิภาพจะกำหนดใน CPC (ต้นทุนต่อคลิก)
PERFORMANCE_GOAL_TYPE_CPA เป้าหมายด้านประสิทธิภาพจะกำหนดใน CPA (ต้นทุนต่อหนึ่งการกระทำ)
PERFORMANCE_GOAL_TYPE_CTR เป้าหมายประสิทธิภาพจะกำหนดเป็นเปอร์เซ็นต์ CTR (อัตราการคลิกผ่าน)
PERFORMANCE_GOAL_TYPE_VIEWABILITY เป้าหมายด้านประสิทธิภาพจะตั้งค่าเป็นเปอร์เซ็นต์ความสามารถในการแสดงโฆษณา
PERFORMANCE_GOAL_TYPE_CPIAVC เป้าหมายด้านประสิทธิภาพตั้งค่าเป็น CPIAVC (ต้นทุนต่อการแสดงผลทั้งภาพและเสียงจนจบ)
PERFORMANCE_GOAL_TYPE_CPE เป้าหมายด้านประสิทธิภาพจะกำหนดใน CPE (ต้นทุนต่อการมีส่วนร่วม)
PERFORMANCE_GOAL_TYPE_CPV เป้าหมายด้านประสิทธิภาพจะกำหนดใน CPV (ต้นทุนต่อการดู)
PERFORMANCE_GOAL_TYPE_CLICK_CVR เป้าหมายประสิทธิภาพจะตั้งค่าเป็นเปอร์เซ็นต์อัตรา Conversion จากการคลิก (Conversion ต่อคลิก)
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR เป้าหมายประสิทธิภาพจะตั้งค่าเป็นเปอร์เซ็นต์อัตรา Conversion จากการแสดงผล (Conversion ต่อการแสดงผล)
PERFORMANCE_GOAL_TYPE_VCPM เป้าหมายด้านประสิทธิภาพจะตั้งค่าใน VCPM (ต้นทุนต่อการแสดงผลที่มองเห็นได้พันครั้ง)
PERFORMANCE_GOAL_TYPE_VTR เป้าหมายด้านประสิทธิภาพจะกำหนดเป็นเปอร์เซ็นต์อัตราการดูบน YouTube (ยอดดูบน YouTube ต่อการแสดงผล)
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE เป้าหมายด้านประสิทธิภาพจะกำหนดในอัตราการเล่นเสียงจนจบ (การฟังเสียงจนจบต่อการแสดงผล) เป็นเปอร์เซ็นต์
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE เป้าหมายด้านประสิทธิภาพจะกำหนดเป็นเปอร์เซ็นต์อัตราการเล่นวิดีโอจนจบ (ยอดดูวิดีโอจนจบต่อการแสดงผล)
PERFORMANCE_GOAL_TYPE_OTHER เป้าหมายด้านประสิทธิภาพตั้งค่าเป็นอื่นๆ

CampaignFlight

การตั้งค่าที่ติดตามการใช้จ่ายและระยะเวลาที่วางแผนไว้ของแคมเปญ

การแสดง JSON 
{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}
ช่อง
plannedSpendAmountMicros

string (int64 format)

จํานวนเงินที่คาดว่าแคมเปญจะใช้สําหรับ plannedDates ที่ระบุ การดำเนินการนี้จะไม่จำกัดการแสดงโฆษณา แต่จะใช้เพื่อติดตามค่าใช้จ่ายใน UI ของ DV360

จำนวนเงินมีหน่วยเป็นไมโคร ต้องมากกว่าหรือเท่ากับ 0 เช่น 500000000 หมายถึง 500 หน่วยมาตรฐานของสกุลเงิน
plannedDates

object (DateRange)

ต้องระบุ วันที่ที่คาดว่าจะแสดงแคมเปญ โดยจะได้รับการแก้ไขตามเขตเวลาของผู้ลงโฆษณาหลัก

  • วันที่ที่ระบุที่นี่จะไม่ส่งผลต่อการแสดงโฆษณา โดยใช้เพื่อสร้างการแจ้งเตือนและคำเตือน ตัวอย่างเช่น หากวันที่แสดงโฆษณาของคำสั่งซื้อที่แทรกใดๆ อยู่นอกช่วงวันที่เหล่านี้ อินเทอร์เฟซผู้ใช้จะแสดงคำเตือน
  • startDate ต้องระบุและต้องเป็นวันที่ปัจจุบันหรือหลังจากนี้
  • คุณจะระบุ endDate หรือไม่ก็ได้ หากระบุ ต้องเป็น startDate หรือหลังจากนั้น
  • วันที่ที่ระบุต้องอยู่ก่อนปี 2037

CampaignBudget

การตั้งค่าที่ควบคุมวิธีจัดสรรงบประมาณแคมเปญ

การแสดง JSON 
{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}
ช่อง
budgetId

string (int64 format)

รหัสที่ไม่ซ้ำกันของงบประมาณแคมเปญ ระบบกำหนด อย่าตั้งค่าสำหรับงบประมาณใหม่

ต้องระบุเมื่ออัปเดตหรือเพิ่มงบประมาณใน campaignBudgets มิฉะนั้น ระบบจะสร้างและกำหนดรหัสใหม่
displayName

string

ต้องระบุ ชื่อที่แสดงของงบประมาณ

ต้องเข้ารหัส UTF-8 โดยมีขนาดสูงสุด 240 ไบต์
budgetUnit

enum (BudgetUnit)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุว่าวัดงบประมาณเป็นสกุลเงินหรือการแสดงผล
budgetAmountMicros

string (int64 format)

ต้องระบุ จำนวนเงินทั้งหมดที่กลุ่มใบสั่งซื้อการใส่โฆษณาที่ลิงก์สามารถตั้งงบประมาณได้

จำนวนเงินมีหน่วยเป็นไมโคร ต้องมากกว่า 0 เช่น 500000000 หมายถึง 500 หน่วยมาตรฐานของสกุลเงิน
dateRange

object (DateRange)

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

ทั้ง startDate และ endDate ต้องอยู่ก่อนปี 2037
externalBudgetSource

enum (ExternalBudgetSource)

ต้องระบุ แหล่งที่มาภายนอกของงบประมาณ
externalBudgetId

string

เปลี่ยนแปลงไม่ได้ รหัสที่ระบุงบประมาณนี้ไปยังแหล่งที่มาภายนอก

หากตั้งค่าช่องนี้และตั้งค่ารายละเอียดใบแจ้งหนี้ของโปรไฟล์การเรียกเก็บเงินที่เกี่ยวข้องเป็น "PO ระดับงบประมาณ" การแสดงผลทั้งหมดที่แสดงเทียบกับงบประมาณนี้จะมีรหัสนี้ในใบแจ้งหนี้

ต้องไม่ซ้ำกันในแคมเปญ
invoiceGroupingId

string

เปลี่ยนแปลงไม่ได้ รหัสที่ใช้จัดกลุ่มงบประมาณที่จะรวมไว้ในใบแจ้งหนี้เดียวกัน

หากตั้งค่าฟิลด์นี้และตั้งค่าระดับใบแจ้งหนี้ของโปรไฟล์การเรียกเก็บเงินที่เกี่ยวข้องเป็น "รหัสการจัดกลุ่มใบแจ้งหนี้ตามงบประมาณ" ระบบจะจัดกลุ่ม externalBudgetId ทั้งหมดที่แชร์ invoiceGroupingId เดียวกันไว้ในใบแจ้งหนี้เดียวกัน
prismaConfig

object (PrismaConfig)

ข้อมูลเมตาเพิ่มเติมสำหรับใช้โดยเครื่องมือ Mediaocean Prisma

จำเป็นสำหรับงบประมาณ Mediaocean

ใช้ได้กับprismaEnabledผู้ลงโฆษณาเท่านั้น

ExternalBudgetSource

แหล่งที่มาภายนอกสำหรับกลุ่มงบประมาณแคมเปญ

Enum
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED ไม่ได้ระบุมูลค่าแหล่งงบประมาณภายนอกหรือไม่รู้จักในเวอร์ชันนี้
EXTERNAL_BUDGET_SOURCE_NONE งบประมาณไม่มีแหล่งที่มาภายนอก
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN แหล่งงบประมาณคือ Mediaocean

PrismaConfig

การตั้งค่าเฉพาะเครื่องมือ Mediaocean Prisma

การแสดง JSON 
{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}
ช่อง
prismaType

enum (PrismaType)

ต้องระบุ ประเภทของ Prisma
prismaCpeCode

object (PrismaCpeCode)

ต้องระบุ รหัสลูกค้า ผลิตภัณฑ์ และการประมาณที่เกี่ยวข้องจากเครื่องมือ Prisma ของ Mediaocean
supplier

string

ต้องระบุ เอนทิตีที่จัดสรรงบประมาณนี้ (DSP, เว็บไซต์ ฯลฯ)

PrismaType

ประเภทที่เป็นไปได้สำหรับงบประมาณ Prisma

Enum
PRISMA_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทหรือประเภทที่ไม่รู้จักในเวอร์ชันนี้
PRISMA_TYPE_DISPLAY ประเภทจอแสดงผล
PRISMA_TYPE_VIDEO ประเภทวิดีโอ
PRISMA_TYPE_AUDIO ประเภทเสียง
PRISMA_TYPE_SOCIAL ประเภทโซเชียล
PRISMA_TYPE_FEE ประเภทค่าธรรมเนียม

PrismaCpeCode

ศูนย์การชำระเงินของ Google รองรับการค้นหาและการกรองในช่องคอมโพเนนต์ของรหัสนี้

การแสดง JSON 
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
ช่อง
prismaClientCode

string

โค้ดไคลเอ็นต์ Prisma
prismaProductCode

string

รหัสผลิตภัณฑ์ Prisma
prismaEstimateCode

string

โค้ดการคาดการณ์ Prisma

เมธอด

create

 สร้างแคมเปญใหม่

delete

 ลบแคมเปญอย่างถาวร

get

 รับแคมเปญ

list

 แสดงรายการแคมเปญในผู้ลงโฆษณา

listAssignedTargetingOptions

 แสดงตัวเลือกการกำหนดเป้าหมายที่กำหนดของแคมเปญในประเภทการกำหนดเป้าหมายต่างๆ

patch

 อัปเดตแคมเปญที่มีอยู่