วัตถุข้อมูล OfflineConversion - การจัดการแคมเปญ

กําหนดการแปลงแบบออฟไลน์ที่คุณส่งไปยัง Microsoft Advertising

เมื่อต้องการตั้งค่าการติดตามการแปลงแบบออฟไลน์ ให้สร้าง OfflineConversionGoal ถ้าคุณตั้งค่า CountType ของ OfflineConversionGoal เป็น ทั้งหมด การแปลงแบบออฟไลน์ทั้งหมดสําหรับ MicrosoftClickId เดียวกันที่มีเวลาการแปลงที่ต่างกันจะถูกเพิ่มแบบสะสม หากคุณตั้งค่า CountType ของ OfflineConversionGoalเป็นไม่ซ้ํา กัน ระบบจะนับเฉพาะ Conversion แรกที่เกิดขึ้นหลังจากคลิกโฆษณาเท่านั้น การแปลงแบบออฟไลน์ซ้ํากับ MicrosoftClickId และ ConversionTime เดียวกันจะถูกละเว้น กล่าวอีกนัยหนึ่งการแปลงแบบออฟไลน์ครั้งแรกสําหรับ MicrosoftClickId และ ConversionTime ที่กําหนดเท่านั้นที่จะถูกนับ

สิ่งสำคัญ

หลังจากตั้งค่า OfflineConversionGoal แล้ว ให้รอสองชั่วโมงแล้วส่งข้อมูล Microsoft Advertising แบบออฟไลน์ Conversion ผ่านการดําเนินการ ApplyOfflineConversions อาจใช้เวลาถึงหกชั่วโมงในการดูข้อมูลการแปลงในการรายงาน Microsoft Advertising

หมายเหตุ

แม้ว่าคุณสามารถอัปโหลดการแปลงแบบออฟไลน์ใน Sandbox สําหรับการทดสอบการทํางาน แต่ข้อมูลการแปลงแบบออฟไลน์จะไม่ถูกนํามาประกอบในข้อมูลการรายงานประสิทธิภาพการทํางานของ Sandbox

ไวยากรณ์

<xs:complexType name="OfflineConversion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ConversionCurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="ConversionValue" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionCredit" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionModel" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="HashedEmailAddress" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="HashedPhoneNumber" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="MicrosoftClickId" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

องค์ ประกอบ

วัตถุ OfflineConversion มีองค์ประกอบต่อไปนี้: ConversionCurrencyCode, ConversionName, ConversionTime, ConversionValue, ExternalAttributionCredit, ExternalAttributionModel, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
ConversionCurrencyCode	รหัสสกุลเงินสําหรับการแปลงแบบออฟไลน์ สําหรับข้อมูลเพิ่มเติม ให้ดูที่ สกุลเงิน ใช้: เสริม หากคุณไม่ได้ระบุรหัสสกุลเงินของการแปลงแบบออฟไลน์ ระบบจะใช้องค์ประกอบ CurrencyCode ของ ConversionGoalRevenue ของเป้าหมาย	สาย อักขระ
ConversionName	ชื่อเป้าหมายการแปลง ชื่อนี้ต้องตรงกับชื่อเป้าหมายการแปลงที่มีอยู่ มิฉะนั้นข้อมูลเป้าหมายการแปลงแบบออฟไลน์จะไม่ถูกนําไปใช้ ใช้: ต้องระบุ	สาย อักขระ
เวลาการแปลง	วันที่และเวลาที่เกิดการแปลงแบบออฟไลน์ วันที่และเวลาต้องอยู่ภายใน 90 วันที่ผ่านมา มิฉะนั้นการดําเนินการจะล้มเหลวเมื่อคุณพยายามส่งข้อมูลการแปลงแบบออฟไลน์ของ Microsoft Advertising เพื่อให้ Microsoft Advertising นับเป็นการแปลงแบบออฟไลน์หลังจากอัปโหลดสําเร็จ จะต้องปฏิบัติตามข้อกําหนดเพิ่มเติมต่อไปนี้: - วันที่และเวลาของการแปลงต้องตั้งค่าหลังจากวันที่และเวลาของการคลิกที่บันทึกไว้ - วันที่และเวลาต้องอยู่ภายในหน้าต่างการแปลง คุณสมบัติ ConversionWindowInMinutes ของ OfflineConversionGoal จะกําหนดความยาวสูงสุดของเวลาเป็นนาทีหลังจากคลิกจะมีการติดตามการแปลง ตัวอย่างเช่น ถ้ามีการบันทึกการคลิกสามครั้งในวันที่ 30 เมษายน ถ้า ConversionWindowInMinutes ของ OfflineConversionGoal เท่ากับ 30 วัน (43200 นาที) และถ้าคุณส่งการแปลงแบบออฟไลน์ต่อไปนี้ของ Microsoft การโฆษณาในวันที่ 31 กรกฎาคม Microsoft Advertising จะนับเฉพาะรายการที่มี MicrosoftClickId=2 เป็นการแปลงแบบออฟไลน์เท่านั้น - MicrosoftClickId=1; ConversionTime=2020-04-30T17:02:35.6853793Z - MicrosoftClickId=2; ConversionTime=2020-05-15T17:02:35.6853793Z - MicrosoftClickId=3; ระยะเวลาการแปลง=2020-06-15T17:02:35.6853793Z ข้อมูลการแปลงแบบออฟไลน์ที่มี MicrosoftClickId=1 จะไม่ถูกอัปโหลดเนื่องจากวันที่และเวลาของการแปลงมากกว่า 90 วันที่ผ่านมา และข้อมูลการแปลงแบบออฟไลน์ด้วย MicrosoftClickId=3 จะไม่ถูกนับเนื่องจากไม่ได้อยู่ภายในหน้าต่างการแปลง (30 เมษายนถึงวันที่ 29 พฤษภาคม) สำคัญ: ค่าต้องอยู่ในเวลามาตรฐานสากล (UTC) ซึ่งจะแตกต่างจากตัวเลือกโซนเวลาเมื่อคุณอัปโหลดการแปลงแบบออฟไลน์ในแอปพลิเคชันบนเว็บ Microsoft Advertising สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML ใช้: ต้องระบุ	Datetime
ConversionValue	ค่าการแปลงแบบออฟไลน์ ใช้: เสริม หากคุณไม่ได้ระบุค่าการแปลงแบบออฟไลน์ ระบบจะใช้องค์ประกอบ ค่า ของ ConversionGoalRevenue ของเป้าหมาย	คู่
ExternalAttributionCredit	สามารถตั้งค่าฟิลด์นี้สําหรับการดําเนินการแปลงที่ใช้การระบุแหล่งที่มาภายนอกเท่านั้น ซึ่งแสดงเศษส่วนของการแปลงที่มีแอตทริบิวต์ในการคลิกแต่ละครั้ง ค่าต้องมากกว่า 0 และน้อยกว่าหรือเท่ากับ 1 ข้อผิดพลาด GoalNotEligibleForExternalAttribution จะถูกส่งกลับถ้าเขตข้อมูลนี้ใช้กับการกระทําการแปลงที่ไม่ใช่ภายนอก ใช้: เสริม	คู่
ExternalAttributionModel	สามารถตั้งค่าฟิลด์นี้สําหรับการดําเนินการแปลงที่ใช้การระบุแหล่งที่มาภายนอกเท่านั้น ซึ่งจะระบุชื่อแบบจําลองที่มา ข้อผิดพลาด GoalNotEligibleForExternalAttribution จะถูกส่งกลับถ้าเขตข้อมูลนี้ใช้กับการกระทําการแปลงที่ไม่ใช่ภายนอก ใช้: เสริม	สาย อักขระ
HashedEmailAddress	ที่อยู่อีเมลที่มีการแฮชที่ใช้อัลกอริทึม SHA-256 สําหรับใช้กับการแปลงที่ปรับปรุงประสิทธิภาพแล้ว	สาย อักขระ
HashedPhoneNumber	หมายเลขโทรศัพท์ที่มีการแฮชตามมาตรฐาน E.164 สําหรับใช้กับการแปลงที่ได้รับการปรับปรุง	สาย อักขระ
MicrosoftClickId	MSCLKID สําหรับการแปลงแบบออฟไลน์ เพื่อให้แน่ใจว่าได้เปิดใช้งานการแท็กอัตโนมัติสําหรับการติดตาม Microsoft คลิก ID ให้ใช้การดําเนินการ GetAccountProperties และ SetAccountProperties ใช้: เสริม หมายเหตุ: MSCLKID เป็นทางเลือกเมื่อคุณใส่ที่อยู่อีเมลที่แฮชหรือหมายเลขโทรศัพท์สําหรับการแปลงเพิ่มเติม	สาย อักขระ

ข้อกําหนด

บริการ: การส่งเสริมการขายการจัดการบริการ.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

ใช้โดย

ApplyOfflineConversions