OfflineUserDataJob

งานที่มีข้อมูลผู้ใช้แบบออฟไลน์ของผู้เข้าชมร้านค้า หรือสมาชิกในรายชื่อผู้ใช้ที่จะได้รับการประมวลผลแบบไม่พร้อมกัน ข้อมูลที่อัปโหลดไม่สามารถอ่านได้และสามารถอ่านผลการประมวลผลของงานได้โดยใช้ GoogleAdsService.Search/SearchStream เท่านั้น

การแสดง JSON
{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของงานข้อมูลผู้ใช้แบบออฟไลน์ ชื่อทรัพยากรงานของข้อมูลผู้ใช้แบบออฟไลน์จะมีรูปแบบดังนี้

customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}

type

enum (OfflineUserDataJobType)

เปลี่ยนแปลงไม่ได้ ประเภทของงาน

status

enum (OfflineUserDataJobStatus)

เอาต์พุตเท่านั้น สถานะของงาน

failureReason

enum (OfflineUserDataJobFailureReason)

เอาต์พุตเท่านั้น สาเหตุที่ประมวลผลไม่สำเร็จ หากสถานะเป็น "ไม่สำเร็จ"

operationMetadata

object (OfflineUserDataJobMetadata)

เอาต์พุตเท่านั้น ข้อมูลเมตาของงานข้อมูลผู้ใช้แบบออฟไลน์ที่แสดงช่วงอัตราการจับคู่

id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของงานข้อมูลผู้ใช้แบบออฟไลน์นี้

externalId

string (int64 format)

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

ฟิลด์สหภาพ metadata ข้อมูลเมตาของงาน metadata ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

เปลี่ยนแปลงไม่ได้ ข้อมูลเมตาสำหรับการอัปเดตข้อมูลในรายชื่อผู้ใช้ตาม CRM

storeSalesMetadata

object (StoreSalesMetadata)

เปลี่ยนแปลงไม่ได้ ข้อมูลเมตาสําหรับการอัปเดตข้อมูลยอดขายในร้าน

OfflineUserDataJobType

ประเภทของงานข้อมูลผู้ใช้แบบออฟไลน์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
STORE_SALES_UPLOAD_FIRST_PARTY ข้อมูลการขายในร้านโดยตรงแบบบริการตนเอง
STORE_SALES_UPLOAD_THIRD_PARTY ข้อมูลการขายในร้านโดยตรงสำหรับบุคคลที่สาม
CUSTOMER_MATCH_USER_LIST ข้อมูลรายชื่อผู้ใช้ในการจับคู่ข้อมูลลูกค้า
CUSTOMER_MATCH_WITH_ATTRIBUTES การจับคู่ข้อมูลลูกค้ากับข้อมูลแอตทริบิวต์

OfflineUserDataJobStatus

สถานะของงานข้อมูลผู้ใช้แบบออฟไลน์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
PENDING สร้างงานเรียบร้อยแล้วและกำลังรออัปโหลด
RUNNING การอัปโหลดได้รับการยอมรับแล้ว และกำลังประมวลผลข้อมูล
SUCCESS ประมวลผลข้อมูลที่อัปโหลดเรียบร้อยแล้ว
FAILED ประมวลผลข้อมูลที่อัปโหลดไม่สำเร็จ

OfflineUserDataJobFailureReason

สาเหตุของความล้มเหลวของงานข้อมูลผู้ใช้แบบออฟไลน์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
INSUFFICIENT_MATCHED_TRANSACTIONS ธุรกรรมที่ตรงกันไม่เพียงพอ
INSUFFICIENT_TRANSACTIONS ธุรกรรมที่อัปโหลดไม่เพียงพอ
HIGH_AVERAGE_TRANSACTION_VALUE มูลค่าธุรกรรมโดยเฉลี่ยในบัญชีสูงผิดปกติ หากคุณตั้งใจให้เป็นเช่นนี้ โปรดติดต่อทีมสนับสนุนเพื่อขอยกเว้น ดูข้อมูลเพิ่มเติมที่ https://support.google.com/google-ads/answer/10018944#transaction_value
LOW_AVERAGE_TRANSACTION_VALUE มูลค่าธุรกรรมโดยเฉลี่ยในบัญชีต่ำผิดปกติ หากคุณตั้งใจให้เป็นเช่นนี้ โปรดติดต่อทีมสนับสนุนเพื่อขอยกเว้น ดูข้อมูลเพิ่มเติมที่ https://support.google.com/google-ads/answer/10018944#transaction_value
NEWLY_OBSERVED_CURRENCY_CODE จะมีรหัสสกุลเงินที่คุณไม่เคยใช้มาก่อนในการอัปโหลด หากคุณตั้งใจให้เป็นเช่นนี้ โปรดติดต่อทีมสนับสนุนเพื่อขอยกเว้น ดูข้อมูลเพิ่มเติมที่ https://support.google.com/google-ads/answer/10018944#Unrecognized_currency

OfflineUserDataJobMetadata

ข้อมูลเมตาของงานข้อมูลผู้ใช้แบบออฟไลน์

การแสดง JSON
{
  "matchRateRange": enum (OfflineUserDataJobMatchRateRange)
}
ช่อง
matchRateRange

enum (OfflineUserDataJobMatchRateRange)

เอาต์พุตเท่านั้น อัตราการจับคู่ของการอัปโหลดรายชื่อผู้ใช้ในการจับคู่ข้อมูลลูกค้า อธิบายอัตราการจับคู่โดยประมาณเมื่อสถานะของงานเป็น "กำลังทำงาน" และอัตราการจับคู่ครั้งสุดท้ายเมื่อมีอัตราการจับคู่ครั้งสุดท้ายหลังจากสถานะของงานเป็น "สำเร็จ/ล้มเหลว"

OfflineUserDataJobMatchRateRange

ช่วงอัตราการจับคู่ของงานข้อมูลผู้ใช้แบบออฟไลน์

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่าเริ่มต้นสำหรับช่วงอัตราการจับคู่
MATCH_RANGE_LESS_THAN_20 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์อยู่ระหว่าง 0% ถึง 19%
MATCH_RANGE_20_TO_30 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์อยู่ระหว่าง 20% ถึง 30%
MATCH_RANGE_31_TO_40 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์อยู่ระหว่าง 31% ถึง 40%
MATCH_RANGE_41_TO_50 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์อยู่ระหว่าง 41% ถึง 50%
MATCH_RANGE_51_TO_60 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์อยู่ระหว่าง 51% ถึง 60%
MATCH_RANGE_61_TO_70 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์อยู่ระหว่าง 61% ถึง 70%
MATCH_RANGE_71_TO_80 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์อยู่ระหว่าง 71% ถึง 80%
MATCH_RANGE_81_TO_90 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์อยู่ระหว่าง 81% ถึง 90%
MATCH_RANGE_91_TO_100 ช่วงอัตราการจับคู่สำหรับเอนทิตีการอัปโหลดข้อมูลออฟไลน์มากกว่าหรือเท่ากับ 91%

StoreSalesMetadata

ข้อมูลเมตาสำหรับการขายในร้านโดยตรง

การแสดง JSON
{
  "thirdPartyMetadata": {
    object (StoreSalesThirdPartyMetadata)
  },
  "loyaltyFraction": number,
  "transactionUploadFraction": number,
  "customKey": string
}
ช่อง
thirdPartyMetadata

object (StoreSalesThirdPartyMetadata)

ข้อมูลเมตาสำหรับการอัปโหลดยอดขายในร้านของบุคคลที่สาม

loyaltyFraction

number

นี่คือเศษส่วนของธุรกรรมทั้งหมดที่ระบุตัวตนได้ (เช่น เชื่อมโยงกับข้อมูลลูกค้าในรูปแบบใดก็ได้) ต้องระบุ โดยเศษส่วนจะต้องอยู่ระหว่าง 0-1 (ไม่รวม 0)

transactionUploadFraction

number

นี่คืออัตราส่วนของการขายที่อัปโหลดเทียบกับยอดขายโดยรวมที่เชื่อมโยงกับลูกค้าได้ ต้องระบุ โดยเศษส่วนจะต้องอยู่ระหว่าง 0-1 (ไม่รวม 0) เช่น หากคุณอัปโหลดการขายครึ่งหนึ่งที่เชื่อมโยงกับลูกค้าได้ จำนวนนี้จะเป็น 0.5

customKey

string

ชื่อของคีย์ตัวแปรที่กําหนดเองของยอดขายในร้านค้า คีย์ที่กำหนดไว้ล่วงหน้าที่สามารถใช้กับธุรกรรมได้ และใช้สำหรับการแบ่งกลุ่มที่กำหนดเองในการรายงานในภายหลัง เฉพาะลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะเข้าถึงได้

StoreSalesThirdPartyMetadata

ข้อมูลเมตาสําหรับยอดขายในร้านของบุคคลที่สาม ผลิตภัณฑ์นี้มีไว้สำหรับลูกค้าในรายการที่อนุญาตเท่านั้น ติดต่อตัวแทนการพัฒนาธุรกิจของ Google เพื่อขอรายละเอียดเกี่ยวกับการกำหนดค่าการอัปโหลด

การแสดง JSON
{
  "advertiserUploadDateTime": string,
  "validTransactionFraction": number,
  "partnerMatchFraction": number,
  "partnerUploadFraction": number,
  "bridgeMapVersionId": string,
  "partnerId": string
}
ช่อง
advertiserUploadDateTime

string

เวลาที่ผู้ลงโฆษณาอัปโหลดข้อมูลไปยังพาร์ทเนอร์ ต้องระบุ รูปแบบคือ "YYYY-MM-DD HH:MM:SS" เช่น "2018-03-05 09:15:00" หรือ "2018-02-01 14:34:30"

validTransactionFraction

number

เศษส่วนของธุรกรรมที่ถูกต้อง ธุรกรรมที่ไม่ถูกต้องอาจมีรูปแบบหรือค่าที่ไม่ถูกต้อง ต้องระบุ โดยเศษส่วนจะต้องอยู่ระหว่าง 0-1 (ไม่รวม 0)

partnerMatchFraction

number

เศษส่วนของธุรกรรมที่ถูกต้องซึ่งจับคู่กับ User-ID ที่กำหนดให้กับบุคคลที่สามในฝั่งพาร์ทเนอร์ ต้องระบุ โดยเศษส่วนจะต้องอยู่ระหว่าง 0-1 (ไม่รวม 0)

partnerUploadFraction

number

เศษส่วนของธุรกรรมที่ถูกต้องซึ่งพาร์ทเนอร์อัปโหลดไปยัง Google ต้องระบุ โดยเศษส่วนจะต้องอยู่ระหว่าง 0-1 (ไม่รวม 0)

bridgeMapVersionId

string

เวอร์ชันของรหัสพาร์ทเนอร์ที่จะใช้สำหรับการอัปโหลด ต้องระบุ

partnerId

string (int64 format)

รหัสของพาร์ทเนอร์บุคคลที่สามที่อัปเดตฟีดธุรกรรม