หน้านี้ได้รับการแปลโดย Cloud Translation API

Package google.shopping.merchant.conversions.v1beta

ดัชนี

ConversionSourcesService (อินเทอร์เฟซ)
AttributionSettings (ข้อความ)
AttributionSettings.AttributionModel (enum)
AttributionSettings.ConversionType (ข้อความ)
ConversionSource (ข้อความ)
ConversionSource.Controller (enum)
ConversionSource.State (enum)
CreateConversionSourceRequest (ข้อความ)
DeleteConversionSourceRequest (ข้อความ)
GetConversionSourceRequest (ข้อความ)
GoogleAnalyticsLink (ข้อความ)
ListConversionSourcesRequest (ข้อความ)
ListConversionSourcesResponse (ข้อความ)
MerchantCenterDestination (ข้อความ)
UndeleteConversionSourceRequest (ข้อความ)
UpdateConversionSourceRequest (ข้อความ)

ConversionSourcesService

บริการสําหรับจัดการแหล่งที่มาของ Conversion สําหรับบัญชีผู้ขาย

CreateConversionSource

CreateConversionSource
`rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)` สร้างแหล่งที่มาของ Conversion ใหม่ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

สร้างแหล่งที่มาของ Conversion ใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

DeleteConversionSource

DeleteConversionSource
`rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)` เก็บแหล่งที่มาของ Conversion ที่มีอยู่ หากแหล่งที่มาของ Conversion เป็นปลายทาง Merchant Center คุณจะกู้คืนได้ภายใน 30 วัน หากแหล่งที่มาของ Conversion เป็นลิงก์ Google Analytics ระบบจะลบลิงก์นั้นทันทีและจะกู้คืนได้โดยการสร้างลิงก์ใหม่ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

เก็บแหล่งที่มาของ Conversion ที่มีอยู่ หากแหล่งที่มาของ Conversion เป็นปลายทาง Merchant Center คุณจะกู้คืนได้ภายใน 30 วัน หากแหล่งที่มาของ Conversion เป็นลิงก์ Google Analytics ระบบจะลบลิงก์นั้นทันทีและจะกู้คืนได้โดยการสร้างลิงก์ใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

GetConversionSource

GetConversionSource
`rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)` ดึงข้อมูลแหล่งที่มาของ Conversion ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

ดึงข้อมูลแหล่งที่มาของ Conversion

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

ListConversionSources

ListConversionSources
`rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)` ดึงข้อมูลรายการแหล่งที่มาของ Conversion ที่ผู้โทรมีสิทธิ์เข้าถึง ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

ดึงข้อมูลรายการแหล่งที่มาของ Conversion ที่ผู้โทรมีสิทธิ์เข้าถึง

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

UndeleteConversionSource

UndeleteConversionSource
`rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)` เปิดใช้แหล่งที่มาของ Conversion ที่เก็บถาวรอีกครั้ง ใช้ได้กับแหล่งที่มาของ Conversion ปลายทางใน Merchant Center เท่านั้น ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

เปิดใช้แหล่งที่มาของ Conversion ที่เก็บถาวรอีกครั้ง ใช้ได้กับแหล่งที่มาของ Conversion ปลายทางใน Merchant Center เท่านั้น

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

UpdateConversionSource

UpdateConversionSource
`rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)` อัปเดตข้อมูลของแหล่งที่มาของ Conversion ที่มีอยู่ ใช้ได้กับแหล่งที่มาของ Conversion ปลายทางใน Merchant Center เท่านั้น ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ `https://www.googleapis.com/auth/content` ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

อัปเดตข้อมูลของแหล่งที่มาของ Conversion ที่มีอยู่ ใช้ได้กับแหล่งที่มาของ Conversion ปลายทางใน Merchant Center เท่านั้น

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/content

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

AttributionSettings

แสดงการตั้งค่าการระบุแหล่งที่มาสําหรับแหล่งที่มาของ Conversion ที่ได้รับข้อมูลก่อนการระบุแหล่งที่มา

ช่อง

ช่อง
`attribution_lookback_window_days`	`int32` ต้องระบุ กรอบเวลามองย้อนกลับ (เป็นวัน) ที่ใช้สำหรับการระบุแหล่งที่มาในแหล่งข้อมูลนี้ ค่าที่รองรับคือ 7, 30, 40
`attribution_model`	`AttributionModel`
`conversion_type[]`	`ConversionType` เปลี่ยนแปลงไม่ได้ รายการที่ไม่เรียงลําดับ รายการประเภท Conversion ต่างๆ ที่เหตุการณ์ Conversion สามารถจัดประเภทได้ ระบบจะสร้างประเภท "purchase" มาตรฐานโดยอัตโนมัติหากรายการนี้ว่างเปล่า ณ เวลาสร้าง

attribution_lookback_window_days

int32

ต้องระบุ กรอบเวลามองย้อนกลับ (เป็นวัน) ที่ใช้สำหรับการระบุแหล่งที่มาในแหล่งข้อมูลนี้ ค่าที่รองรับคือ 7, 30, 40

attribution_model

AttributionModel

conversion_type[]

ConversionType

เปลี่ยนแปลงไม่ได้ รายการที่ไม่เรียงลําดับ รายการประเภท Conversion ต่างๆ ที่เหตุการณ์ Conversion สามารถจัดประเภทได้ ระบบจะสร้างประเภท "purchase" มาตรฐานโดยอัตโนมัติหากรายการนี้ว่างเปล่า ณ เวลาสร้าง

AttributionModel

รูปแบบการระบุแหล่งที่มาที่ใช้สำหรับแหล่งที่มานี้ เรารองรับชุดรูปแบบเดียวกับที่ Google Analytics 4 เสนอตามที่อธิบายไว้ใน https://support.google.com/analytics/answer/10596866

Enum
`ATTRIBUTION_MODEL_UNSPECIFIED`	ไม่ได้ระบุโมเดล
`CROSS_CHANNEL_LAST_CLICK`	รูปแบบคลิกสุดท้ายข้ามแชแนล
`ADS_PREFERRED_LAST_CLICK`	รูปแบบคลิกสุดท้ายที่ระบุว่ามาจาก Google Ads
`CROSS_CHANNEL_DATA_DRIVEN`	รูปแบบตามข้อมูลข้ามแชแนล
`CROSS_CHANNEL_FIRST_CLICK`	รูปแบบคลิกแรกข้ามแชแนล
`CROSS_CHANNEL_LINEAR`	รูปแบบเชิงเส้นข้ามแชแนล
`CROSS_CHANNEL_POSITION_BASED`	รูปแบบตามตําแหน่งแบบข้ามแชแนล
`CROSS_CHANNEL_TIME_DECAY`	รูปแบบลดลงตามเวลาข้ามแชแนล

ConversionType

ข้อความที่แสดงประเภทเหตุการณ์ Conversion

ช่อง

ช่อง
`name`	`string` เอาต์พุตเท่านั้น ชื่อเหตุการณ์ Conversion ตามที่ไคลเอ็นต์จะรายงาน
`report`	`bool` เอาต์พุตเท่านั้น ตัวเลือกที่ระบุว่าควรรวมประเภทนี้ไว้ในการรายงานของ Merchant Center หรือไม่

name

string

เอาต์พุตเท่านั้น ชื่อเหตุการณ์ Conversion ตามที่ไคลเอ็นต์จะรายงาน

report

bool

เอาต์พุตเท่านั้น ตัวเลือกที่ระบุว่าควรรวมประเภทนี้ไว้ในการรายงานของ Merchant Center หรือไม่

ConversionSource

แสดงแหล่งที่มาของ Conversion ที่บัญชีผู้ขายเป็นเจ้าของ บัญชีผู้ขายจะมีแหล่งที่มาของ Conversion ได้สูงสุด 200 รายการ

ช่อง
`name`	`string` เอาต์พุตเท่านั้น ตัวระบุ สร้างโดย Content API เมื่อสร้าง `ConversionSource` ใหม่ รูปแบบ: [a-z]{4}:.+ อักขระ 4 ตัวก่อนโคลอนแสดงถึงประเภทของแหล่งที่มาของ Conversion เนื้อหาหลังโคลอนแสดงรหัสของแหล่งที่มาของ Conversion ภายในประเภทนั้น รหัสของแหล่งที่มาของ Conversion 2 รายการที่แตกต่างกันอาจเหมือนกันในประเภทต่างๆ ระบบรองรับคำนำหน้าประเภทต่อไปนี้ - galk: สำหรับแหล่งที่มาของ GoogleAnalyticsLink - mcdn: สําหรับแหล่งที่มา MerchantCenterDestination
`state`	`State` เอาต์พุตเท่านั้น สถานะปัจจุบันของแหล่งที่มาของ Conversion นี้ แก้ไขผ่าน API ไม่ได้
`expire_time`	`Timestamp` เอาต์พุตเท่านั้น เวลาที่มีการลบแหล่งที่มาของ Conversion ที่เก็บถาวรออกอย่างถาวรและไม่สามารถยกเลิกการลบได้อีก
`controller`	`Controller` เอาต์พุตเท่านั้น ผู้ควบคุมแหล่งที่มาของ Conversion
ฟิลด์สหภาพ `source_data` ต้องระบุ ข้อมูลแหล่งที่มาของ Conversion ที่เจาะจงสําหรับแหล่งที่มาแต่ละประเภท `source_data` ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
`google_analytics_link`	`GoogleAnalyticsLink` เปลี่ยนแปลงไม่ได้ แหล่งที่มาของ Conversion ประเภท "ลิงก์กับพร็อพเพอร์ตี้ Google Analytics"
`merchant_center_destination`	`MerchantCenterDestination` แหล่งที่มาของ Conversion ประเภท "ปลายทางแท็ก Merchant Center"

ตัวควบคุม

เอนทิตีที่ควบคุมแหล่งที่มาของ Conversion

Enum
`CONTROLLER_UNSPECIFIED`	ค่าเริ่มต้น ค่านี้ไม่ได้ใช้งาน
`MERCHANT`	ควบคุมโดยผู้ขายที่เป็นเจ้าของแหล่งที่มาของ Conversion
`YOUTUBE_AFFILIATES`	ควบคุมโดยโปรแกรมแอฟฟิลิเอต YT

รัฐ

แสดงสถานะของแหล่งที่มาของ Conversion

Enum
`STATE_UNSPECIFIED`	แหล่งที่มาของ Conversion มีสถานะที่ไม่ระบุ
`ACTIVE`	แหล่งที่มาของ Conversion ทํางานได้อย่างสมบูรณ์
`ARCHIVED`	แหล่งที่มาของ Conversion ได้รับการเก็บถาวรในช่วง 30 วันที่ผ่านมาและใช้งานไม่ได้ในขณะนี้ กู้คืนได้โดยใช้วิธีการเลิกลบ
`PENDING`	การสร้างแหล่งที่มาของ Conversion เริ่มขึ้นแล้วแต่ยังไม่เสร็จสมบูรณ์

CreateConversionSourceRequest

ข้อความคําขอสําหรับเมธอด CreateConversionSource

ช่อง

ช่อง
`parent`	`string` ต้องระบุ บัญชีผู้ขายที่จะเป็นเจ้าของแหล่งที่มาของ Conversion ใหม่ รูปแบบ: accounts/{account}
`conversion_source`	`ConversionSource` ต้องระบุ คําอธิบายแหล่งที่มาของ Conversion ระบบจะกำหนดรหัสใหม่ให้โดยอัตโนมัติเมื่อสร้าง

parent

string

ต้องระบุ บัญชีผู้ขายที่จะเป็นเจ้าของแหล่งที่มาของ Conversion ใหม่ รูปแบบ: accounts/{account}

conversion_source

ConversionSource

ต้องระบุ คําอธิบายแหล่งที่มาของ Conversion ระบบจะกำหนดรหัสใหม่ให้โดยอัตโนมัติเมื่อสร้าง

DeleteConversionSourceRequest

ข้อความคําขอสําหรับเมธอด DeleteConversionSource

ช่อง

ช่อง
`name`	`string` ต้องระบุ ชื่อแหล่งที่มาของ Conversion ที่จะลบ รูปแบบ: accounts/{account}/conversionSources/{conversion_source}

name

string

ต้องระบุ ชื่อแหล่งที่มาของ Conversion ที่จะลบ รูปแบบ: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

ข้อความคําขอสําหรับเมธอด GetConversionSource

ช่อง

ช่อง
`name`	`string` ต้องระบุ ชื่อแหล่งที่มาของ Conversion ที่จะดึงข้อมูล รูปแบบ: accounts/{account}/conversionSources/{conversion_source}

name

string

ต้องระบุ ชื่อแหล่งที่มาของ Conversion ที่จะดึงข้อมูล รูปแบบ: accounts/{account}/conversionSources/{conversion_source}

GoogleAnalyticsLink

คุณสามารถใช้แหล่งที่มา "ลิงก์ Google Analytics" เพื่อรับข้อมูล Conversion จากพร็อพเพอร์ตี้ Google Analytics ที่มีอยู่ไปยังบัญชี Merchant Center ที่ลิงก์

ช่อง

ช่อง
`property_id`	`int64` ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสพร็อพเพอร์ตี้ Google Analytics ที่ผู้ขายลิงก์ไว้
`attribution_settings`	`AttributionSettings` เอาต์พุตเท่านั้น การตั้งค่าการระบุแหล่งที่มาสําหรับพร็อพเพอร์ตี้ Google Analytics ที่ลิงก์
`property`	`string` เอาต์พุตเท่านั้น ชื่อพร็อพเพอร์ตี้ Google Analytics ที่ผู้ขายลิงก์ไว้

property_id

int64

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสพร็อพเพอร์ตี้ Google Analytics ที่ผู้ขายลิงก์ไว้

attribution_settings

AttributionSettings

เอาต์พุตเท่านั้น การตั้งค่าการระบุแหล่งที่มาสําหรับพร็อพเพอร์ตี้ Google Analytics ที่ลิงก์

property

string

เอาต์พุตเท่านั้น ชื่อพร็อพเพอร์ตี้ Google Analytics ที่ผู้ขายลิงก์ไว้

ListConversionSourcesRequest

ข้อความคําขอสําหรับเมธอด ListConversionSources

ช่อง
`parent`	`string` ต้องระบุ บัญชีผู้ขายที่เป็นเจ้าของคอลเล็กชันแหล่งที่มาของ Conversion รูปแบบ: accounts/{account}
`page_size`	`int32` ไม่บังคับ จํานวนแหล่งที่มาของ Conversion สูงสุดที่จะแสดงในหน้าเว็บ หากไม่ได้ระบุ `page_size` ระบบจะใช้ `100` เป็นค่าเริ่มต้น ค่าสูงสุดคือ `200` ระบบจะเปลี่ยนค่าที่สูงกว่า `200` เป็น `200` ระบบจะแสดงแหล่งที่มาของ Conversion ทั้งหมดไม่เกิน `200` รายการ ไม่ว่าจะมีการแบ่งหน้าหรือไม่ก็ตาม
`page_token`	`string` ไม่บังคับ โทเค็นหน้า
`show_deleted`	`bool` ไม่บังคับ แสดงตัวเลือกที่ลบ (เก็บถาวร)

ListConversionSourcesResponse

ข้อความตอบกลับสําหรับเมธอด ListConversionSources

ช่อง

ช่อง
`conversion_sources[]`	`ConversionSource` รายการแหล่งที่มาของ Conversion
`next_page_token`	`string` โทเค็นที่จะใช้เรียกข้อมูลหน้าผลลัพธ์ถัดไป

conversion_sources[]

ConversionSource

รายการแหล่งที่มาของ Conversion

next_page_token

string

โทเค็นที่จะใช้เรียกข้อมูลหน้าผลลัพธ์ถัดไป

MerchantCenterDestination

คุณสามารถใช้แหล่งที่มา "ปลายทาง Merchant Center" เพื่อส่งเหตุการณ์ Conversion จากร้านค้าออนไลน์โดยใช้แท็ก Google ไปยังบัญชี Merchant Center ที่สร้างขึ้นโดยตรง

ช่อง
`destination`	`string` เอาต์พุตเท่านั้น รหัสปลายทาง Merchant Center
`attribution_settings`	`AttributionSettings` ต้องระบุ การตั้งค่าการระบุแหล่งที่มาที่ใช้สําหรับปลายทาง Merchant Center
`display_name`	`string` ต้องระบุ ชื่อที่แสดงซึ่งผู้ขายระบุสำหรับปลายทาง ชื่อนี้จะระบุแหล่งที่มาของ Conversion ภายใน UI ของ Merchant Center จำกัดอักขระไม่เกิน 64 ตัว
`currency_code`	`string` ต้องระบุ รหัสสกุลเงิน 3 ตัวอักษร (ISO 4217) รหัสสกุลเงินจะกําหนดสกุลเงินที่ระบบจะรายงาน Conversion ที่ส่งไปยังปลายทางนี้ใน Merchant Center

UndeleteConversionSourceRequest

ข้อความคําขอสําหรับเมธอด UndeleteConversionSource

ช่อง

ช่อง
`name`	`string` ต้องระบุ ชื่อแหล่งที่มาของ Conversion ที่จะยกเลิกการลบ รูปแบบ: accounts/{account}/conversionSources/{conversion_source}

name

string

ต้องระบุ ชื่อแหล่งที่มาของ Conversion ที่จะยกเลิกการลบ รูปแบบ: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

ข้อความคําขอสําหรับเมธอด UpdateConversionSource

ช่อง

ช่อง
`conversion_source`	`ConversionSource` ต้องระบุ ข้อมูลแหล่งที่มาของ Conversion เวอร์ชันใหม่ รูปแบบ: accounts/{account}/conversionSources/{conversion_source}
`update_mask`	`FieldMask` ไม่บังคับ รายการช่องที่อัปเดต

conversion_source

ConversionSource

ต้องระบุ ข้อมูลแหล่งที่มาของ Conversion เวอร์ชันใหม่ รูปแบบ: accounts/{account}/conversionSources/{conversion_source}

update_mask

FieldMask

ไม่บังคับ รายการช่องที่อัปเดต