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

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

partnerUploadFraction

number

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

bridgeMapVersionId

string

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

partnerId

string (int64 format)

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