แชร์ผ่าน

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

  • บทความ

กําหนดวัตถุพื้นฐานของผู้ชม

อย่าพยายามสร้างอินสแตนซ์ของผู้ชม คุณสามารถสร้างอย่างน้อยหนึ่งวัตถุต่อไปนี้ที่สืบทอดมาจากวัตถุนั้น

หมายเหตุ

Microsoft Advertising จะสร้างผู้ชมที่คล้ายกันโดยอัตโนมัติสําหรับรายการรีมาร์เก็ตติ้งสําหรับผู้เข้าร่วมนําร่อง เช่น GetCustomerPilotFeatures ส่งกลับตัวระบุฟีเจอร์ 317

ไวยากรณ์

<xs:complexType name="Audience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AudienceNetworkSize" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CustomerShare" nillable="true" type="tns:CustomerShare" />
    <xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
    <xs:element xmlns:q123="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q123:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MembershipDuration" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ParentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="SearchSize" nillable="true" type="xs:long" />
    <xs:element xmlns:q124="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="SupportedCampaignTypes" nillable="true" type="q124:ArrayOfstring" />
    <xs:element minOccurs="0" name="Type" type="tns:AudienceType" />
  </xs:sequence>
</xs:complexType>

องค์ ประกอบ

วัตถุ Audience มีองค์ประกอบต่อไปนี้: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
AudienceNetworkSize จํานวนรวมของบุคคลที่เป็นสมาชิกที่ใช้งานอยู่ของผู้ชมนี้ในเครือข่ายผู้ชม ซึ่งจะช่วยให้คุณทราบจํานวนผู้ใช้เครือข่ายผู้ชมที่คุณกําหนดเป้าหมายได้

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

องค์ประกอบนี้ได้รับการสนับสนุนด้วย RemarketingList เท่านั้น ไม่สามารถใช้ผู้ชมชนิดอื่นในลําดับชั้นลูกค้าร่วมกันได้		 CustomerShare
คำ อธิบาย คําอธิบายของผู้ชม ใช้คําอธิบายเพื่อช่วยให้คุณจําผู้ชมที่คุณกําลังกําหนดเป้าหมายได้

คําอธิบายสามารถมีอักขระได้สูงสุด 1,024 อักขระ		 สาย อักขระ
ForwardCompatibilityMap รายการของคีย์และสตริงค่าสําหรับความเข้ากันได้แบบไปข้างหน้าเพื่อหลีกเลี่ยงการเปลี่ยนแปลงที่เสียหายเป็นอย่างอื่นเมื่อมีการเพิ่มองค์ประกอบใหม่ในเวอร์ชัน API ปัจจุบัน

การเปลี่ยนแปลงความเข้ากันได้ในอนาคตจะถูกบันทึกไว้ที่นี่ในรุ่นต่อ ๆ ไป ไม่มีการเปลี่ยนแปลงความเข้ากันได้ไปข้างหน้าในขณะนี้สําหรับวัตถุนี้		 อาร์เรย์ KeyValuePairOfstringstring
Id ตัวระบุ Microsoft Advertising ของผู้ชม ยาว
การเป็นสมาชิก เมื่อคุณสร้างผู้ชม คุณสามารถระบุระยะเวลาที่ Microsoft Advertising ควรค้นหาการดําเนินการที่ตรงกับข้อกําหนดของผู้ชมของคุณ

ระยะเวลาต่ําสุดคือ 1 วันและระยะเวลาสูงสุดที่อนุญาตคือ 180 วัน		 Int
ชื่อ ชื่อของผู้ชม ชื่อสามารถมีอักขระได้สูงสุด 128 อักขระ สาย อักขระ
ParentId ตัวระบุ Microsoft Advertising ของบัญชีหรือลูกค้า

ถ้า ขอบเขต ถูกตั้งค่าเป็น บัญชี นี่คือ ID บัญชี และมิฉะนั้นจะเป็น ID ลูกค้า		 ยาว
ขอบ เขต ขอบเขตจะกําหนดบัญชีผู้ใช้ที่สามารถใช้ผู้ชมรายนี้

หากตั้งค่าขอบเขตเป็นบัญชี ผู้ชมจะสามารถเชื่อมโยงกับแคมเปญและกลุ่มโฆษณาในบัญชีเดียวเท่านั้น เช่น ผ่าน ParentId หากกําหนดขอบเขตเป็น ลูกค้า ผู้ชมจะสามารถเชื่อมโยงกับแคมเปญและกลุ่มโฆษณาในบัญชีของลูกค้าทั้งหมดได้		 ขอบเขตเอนทิตี
ขนาดการค้นหา จํานวนรวมของบุคคลที่เป็นสมาชิกที่ใช้งานอยู่ของผู้ชมนี้ในเครือข่ายการค้นหา ซึ่งช่วยให้คุณทราบจํานวนผู้ใช้การค้นหาที่คุณสามารถกําหนดเป้าหมายได้

โปรดดูรายละเอียดเพิ่มเติมในเอกสารสําหรับวัตถุที่สืบทอดองค์ประกอบนี้ เช่น RemarketingList		 ยาว
SupportedCampaignTypes รายการของชนิดการส่งเสริมการขายที่สนับสนุนผู้ชมนี้

ค่าที่สนับสนุนคือ Audience, DynamicSearchAds, Search และ Shopping อาจมีการเพิ่มแคมเปญชนิดใหม่ในอนาคต คุณจึงไม่ควรพึ่งพาชุดค่าแบบคงที่		 อาร์เรย์สตริง
ชนิด ชนิดของผู้ชม สําหรับข้อมูลเพิ่มเติมเกี่ยวกับชนิดผู้ชม ให้ดู หมายเหตุ AudienceType

หมาย เหตุ

สําหรับภาษา Java และ .NET อย่าตั้งค่าองค์ประกอบ ชนิด เนื่องจากค่าถูกกําหนดโดยว่าคุณสร้างอินสแตนซ์ของผู้ชมแบบกําหนดเองหรือผู้ชมชนิดอื่น ถ้าคุณสร้าง SOAP ด้วยตนเอง ให้ใช้แอตทริบิวต์ type ของโหนด Audience ดังที่แสดงในตัวอย่างต่อไปนี้

<Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Audience i:type="CustomAudience">
    <Description i:nil="false">Custom Audience Description</Description>
    <ForwardCompatibilityMap xmlns:e43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
      <e43:KeyValuePairOfstringstring>
        <e43:key i:nil="false"></e43:key>
        <e43:value i:nil="false"></e43:value>
      </e43:KeyValuePairOfstringstring>
    </ForwardCompatibilityMap>
    <Id i:nil="true" />
    <MembershipDuration i:nil="false">30</MembershipDuration>
    <Name i:nil="false">Custom Audience Name</Name>
    <ParentId i:nil="false">ParentIdHere</ParentId>
    <Scope>Customer</Scope>
  </Audience>
</Audiences>

ข้อกําหนด

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

ใช้โดย

เพิ่มการตรวจสอบ
GetAudiencesByIds
UpdateAudiences