Package google.shopping.merchant.conversions.v1beta

ดัชนี

ConversionSourcesService

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

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

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

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

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

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

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

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

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

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

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

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

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

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

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

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

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

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

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

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

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

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

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

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

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

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

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

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

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

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

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

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 สามารถจัดประเภทได้ ระบบจะสร้างประเภท "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 หรือไม่

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 ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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 ระบบจะกำหนดรหัสใหม่ให้โดยอัตโนมัติเมื่อสร้าง

DeleteConversionSourceRequest

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

ช่อง
name

string

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

GetConversionSourceRequest

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

ช่อง
name

string

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

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

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

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}

UpdateConversionSourceRequest

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

ช่อง
conversion_source

ConversionSource

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

FieldMask

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