Conversion

ทรัพยากร Conversion มีวิธีที่ช่วยให้ผู้ใช้สร้าง แก้ไข และเรียกข้อมูล Conversion ของ Floodlight แบบเป็นกลุ่มได้

ดูรายการวิธีการสำหรับแหล่งข้อมูลนี้ที่ส่วนท้ายของหน้านี้

การนำเสนอทรัพยากร

รายการ Conversion

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	Notes
conversion[]	list	Conversion ที่ขอ
conversion[].adGroupId	long	รหัสกลุ่มโฆษณา DS
conversion[].adId	long	รหัสโฆษณา DS
conversion[].adUserDataConsent	string	แสดงความยินยอมสำหรับค่ากำหนดบริการแพลตฟอร์มหลัก (CPS) ในการตั้งค่า ไม่มีค่าเริ่มต้น ค่าที่ยอมรับได้มีดังนี้ GRANTED: สถานะความยินยอมที่ต้องการคือให้สิทธิ์ อ่านค่ากำหนด CPS จากการตั้งค่า GTE DENIED: สถานะความยินยอมที่ต้องการคือปฏิเสธ รายการ CPS ว่างเปล่า
conversion[].advertiserId	long	รหัสผู้ลงโฆษณา DS
conversion[].agencyId	long	รหัสเอเจนซี DS
conversion[].attributionModel	string	มีไว้สำหรับผู้ลงโฆษณาหลังจากติดต่อทีมสนับสนุนลูกค้าของ DoubleClick Search เท่านั้น
conversion[].campaignId	long	รหัสแคมเปญ DS
conversion[].channel	string	ช่องทางการขายผลิตภัณฑ์ ค่าที่ยอมรับได้มีดังนี้ "local": กิจการที่มีหน้าร้านจริง "online": ร้านค้าออนไลน์
conversion[].clickId	string	รหัสคลิกของ DS สำหรับ Conversion
conversion[].conversionId	string	สำหรับ Conversion ออฟไลน์ ผู้ลงโฆษณาจะระบุรหัสนี้ ผู้ลงโฆษณาสามารถระบุรหัสใดๆ ที่มีความหมายต่อตนได้ Conversion แต่ละรายการในคำขอต้องระบุรหัสที่ไม่ซ้ำกัน และชุดรหัสและการประทับเวลาต้องไม่ซ้ำกันใน Conversion ทั้งหมดของผู้ลงโฆษณา สำหรับ Conversion ออนไลน์ DS จะคัดลอก dsConversionId หรือ floodlightOrderId ลงในพร็อพเพอร์ตี้นี้ตามคำสั่ง Floodlight ของผู้ลงโฆษณา
conversion[].conversionModifiedTimestamp	unsigned long	เวลาที่แก้ไข Conversion ครั้งล่าสุด หน่วยเป็น Epoch มิลลิวินาที UTC
conversion[].conversionTimestamp	unsigned long	เวลาที่เกิด Conversion ในหน่วย Epoch มิลลิวินาที UTC
conversion[].countMillis	long	มีไว้สำหรับผู้ลงโฆษณาหลังจากติดต่อทีมสนับสนุนลูกค้าของ DoubleClick Search เท่านั้น
conversion[].criterionId	long	รหัสเกณฑ์ DS (คีย์เวิร์ด)
conversion[].currencyCode	string	รหัสสกุลเงินสำหรับรายได้ของ Conversion ควรอยู่ในรูปแบบตัวอักษรของ ISO 4217 (อักขระ 3 ตัว)	เขียนได้
conversion[].customDimension[]	list	มิติข้อมูลที่กำหนดเองสำหรับ Conversion ซึ่งสามารถใช้เพื่อกรองข้อมูลในรายงานได้
conversion[].customDimension[].name	string	ชื่อมิติข้อมูลที่กำหนดเอง
conversion[].customDimension[].value	string	ค่ามิติข้อมูลที่กำหนดเอง
conversion[].customMetric[]	list	เมตริกที่กำหนดเองสำหรับ Conversion
conversion[].customMetric[].name	string	ชื่อเมตริกที่กำหนดเอง
conversion[].customMetric[].value	double	ค่าตัวเลขของเมตริกที่กำหนดเอง
conversion[].customerId	string	รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่ ต้องเป็นบัญชีลูกค้า เมื่อตั้งค่าช่องนี้แล้ว ควรตั้งค่าช่องรหัสอื่นๆ ทั้งหมดเป็นรหัส Search Ads 360 เวอร์ชันใหม่
conversion[].deviceType	string	ประเภทอุปกรณ์ที่ Conversion เกิดขึ้น ค่าที่ยอมรับมีดังนี้ "DESKTOP" "HIGH_END_MOBILE" "OTHER_DEVICE" "TABLET"
conversion[].dsConversionId	long	รหัสที่ DoubleClick Search สร้างขึ้นสำหรับ Conversion แต่ละรายการ
conversion[].engineAccountId	long	รหัสบัญชีเครื่องมือค้นหา DS
conversion[].floodlightOrderId	string	รหัสคำสั่งซื้อ Floodlight ที่ผู้ลงโฆษณาระบุไว้สำหรับ Conversion
conversion[].inventoryAccountId	long	รหัสที่ DS สร้างและใช้เพื่อระบุบัญชีพื้นที่โฆษณาที่มีผลิตภัณฑ์โดยไม่ซ้ำกัน
conversion[].productCountry	string	ประเทศที่ลงทะเบียนสำหรับฟีด Merchant Center ที่มีผลิตภัณฑ์ ใช้รหัส ISO 3166 เพื่อระบุประเทศ
conversion[].productGroupId	long	รหัสกลุ่มผลิตภัณฑ์ DS
conversion[].productId	string	รหัสผลิตภัณฑ์ (SKU)
conversion[].productLanguage	string	ภาษาที่ลงทะเบียนไว้สำหรับฟีด Merchant Center ที่มีผลิตภัณฑ์ ใช้รหัส ISO 639 เพื่อระบุภาษา
conversion[].quantityMillis	long	จำนวน Conversion นี้ในหน่วยมิลลิวินาที	เขียนได้
conversion[].revenueMicros	long	จำนวนรายได้ของ Conversion TRANSACTION นี้ในหน่วยไมโคร (ค่าคูณด้วย 1000000 ไม่มีทศนิยม) ตัวอย่างเช่น หากต้องการระบุค่ารายได้เป็น "10" ให้ป้อน "10000000" (10 ล้าน) ในคำขอ	เขียนได้
conversion[].segmentationId	long	ตัวระบุการแบ่งกลุ่มที่เป็นตัวเลข (เช่น รหัสกิจกรรม Floodlight ของ DoubleClick Search)
conversion[].segmentationName	string	ตัวระบุการแบ่งกลุ่มที่เป็นมิตรกับผู้ใช้ (เช่น ชื่อกิจกรรม Floodlight ของ DoubleClick Search)
conversion[].segmentationType	string	ประเภทการแบ่งกลุ่มของ Conversion นี้ (เช่น FLOODLIGHT) ค่าที่ยอมรับได้ ได้แก่ "FLOODLIGHT"
conversion[].state	string	สถานะของ Conversion ซึ่งก็คือ ACTIVE หรือ REMOVED หมายเหตุ: สถานะ "ลบแล้ว" เลิกใช้งานแล้ว ค่าที่ยอมรับมีดังนี้ "ACTIVE" "DELETED":  (เลิกใช้งานแล้ว) "REMOVED"	เขียนได้
conversion[].storeId	string	รหัสของร้านค้าในพื้นที่ที่มีการโฆษณาผลิตภัณฑ์ ใช้ได้เมื่อช่องเป็น "local" เท่านั้น
conversion[].type	string	ประเภทของ Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION เป็นการกระทําของผู้ใช้ที่ไม่มีมูลค่าที่วัดปริมาณได้ ขณะที่ Conversion TRANSACTION เป็นการกระทําที่มีมูลค่าที่เป็นตัวเงินได้ ตัวอย่างเช่น การลงชื่อสมัครใช้รายชื่ออีเมล (ACTION) เทียบกับการซื้อผ่านอีคอมเมิร์ซ (TRANSACTION) ค่าที่ยอมรับได้มีดังนี้ "ACTION" "TRANSACTION"
kind	string	ระบุว่าเป็นทรัพยากร ConversionList ค่า: สตริงคงที่ doubleclicksearch#conversionList

วิธีการ

รับ

เรียกรายการ Conversion จากบัญชี DoubleClick Search Engine

getByCustomerId

เรียกรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search โดยใช้รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่

แทรก

แทรก Conversion ใหม่เป็นกลุ่มใน DoubleClick Search

อัปเดต

อัปเดตกลุ่ม Conversion ใน DoubleClick Search

updateAvailability

อัปเดตความพร้อมใช้งานของกลุ่มกิจกรรม Floodlight ใน DoubleClick Search