對象資料物件 - 行銷活動管理
定義物件的基底物件。
請勿嘗試具現化 物件。 您可以建立一或多個衍生自它的下列物件。
- CombinedList
- CustomAudience
- CustomerList
- ImpressionBasedRemarketingList
- InMarketAudience
- ProductAudience
- RemarketingList
- SimilarRemarketingList
注意事項
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 個字元。 |
string |
| ForwardCompatibilityMap | 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。 |
KeyValuePairOfstringstring 陣 列 |
| 標識碼 | 物件的 Microsoft Advertising 識別符。 | 長 |
| MembershipDuration | 當您建立物件時，您可以指定廣告應該尋找符合您物件定義的動作Microsoft時間回溯多久。 最小持續時間為 1 天，允許的持續時間上限為 180 天。 |
int |
| 名稱 | 物件的名稱。 名稱最多可以包含 128 個字元。 | string |
| ParentId | 帳戶或客戶的 Microsoft Advertising 識別碼。 如果 [範圍] 設定為 [ 帳戶]，則這是帳戶標識符，否則為客戶標識符。 |
長 |
| 範圍 | 範圍會定義哪些帳戶可以使用此物件。 如果範圍設定為 Account，則物件只能與一個帳戶中的行銷活動和廣告群組相關聯，也就是透過 ParentId。 如果範圍設定為 [客戶]，則物件可以與所有客戶帳戶中的營銷活動和廣告群組相關聯。 |
EntityScope |
| SearchSize | 在搜尋網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少搜尋用戶設為目標。 如需繼承此元素的物件，請參閱檔中的詳細數據，例如 RemarketingList。 |
長 |
| SupportedCampaignTypes | 支援此物件的營銷活動類型清單。 支援的值為 Audience、DynamicSearchAds、Search 和 Shopping。 未來可能會新增新的行銷活動類型，因此您不應該對一組固定的值採取任何相依性。 |
字串陣列 |
| 類型 | 物件的類型。 如需物件類型的詳細資訊，請參閱。 | AudienceType |
註解
針對 Java 和 .NET 語言，請勿設定 Type 元素，因為值取決於您是具現化自定義對象還是另一種類型的物件。 如果您手動產生 SOAP，請使用 Audience 節點的 type 屬性，如下列範例所示。
<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>
需求
服務： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13