หน้านี้ได้รับการแปลโดย 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

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

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

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

GetConversionSource

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

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

ListConversionSources

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

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

UndeleteConversionSource

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

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

UpdateConversionSource

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

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

AttributionSettings

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

ช่อง

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

attribution_lookback_window_days

int32

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

attribution_model

AttributionModel

ต้องระบุ รูปแบบการระบุแหล่งที่มา

conversion_type[]

ConversionType

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

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

ต้องระบุ รายการฟิลด์ที่กําลังอัปเดต