Aracılığıyla paylaş

Hedef Kitle Veri Nesnesi - Kampanya Yönetimi

  • Makale

Hedef kitlenin temel nesnesini tanımlar.

Hedef Kitle örneği oluşturmaya çalışmayın. Bu nesneden türetilen aşağıdaki nesnelerden birini veya daha fazlasını oluşturabilirsiniz.

Not

Microsoft Advertising, pilot katılımcılar için yeniden pazarlama listeleri için otomatik olarak benzer hedef kitleler oluşturur; örneğin GetCustomerPilotFeatures özellik tanımlayıcısı 317'yi döndürür.

Sözdizimi

<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:q124="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q124: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:q125="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="SupportedCampaignTypes" nillable="true" type="q125:ArrayOfstring" />
    <xs:element minOccurs="0" name="Type" type="tns:AudienceType" />
  </xs:sequence>
</xs:complexType>

Öğe

Audience nesnesi şu öğelere sahiptir: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type.

Öğe Açıklama Veri Türü
AudienceNetworkSize Hedef Kitle ağındaki bu hedef kitlenin etkin üyesi olan toplam kişi sayısı. Bu, hedefleyebileceğiniz hedef kitle ağı kullanıcısı sayısı hakkında size bir fikir verir.

Bu öğeyi devralan nesneler için belgelerdeki diğer ayrıntılara bakın; örneğin, RemarketingList.		 uzun
CustomerShare Hedef kitleyi paylaşan müşterilerin ve hesapların listesini belirler. Ayrıntılar, hedef kitle ilişkilendirme sayılarını içerir.

Bu öğe yalnızca RemarketingList ile desteklenir. Diğer türlerdeki hedef kitleler müşteri hiyerarşisinde paylaşılamaz.		 CustomerShare
Açıklama İzleyicinin açıklaması. Hedeflediğiniz hedef kitleyi hatırlamanıza yardımcı olması için bir açıklama kullanın.

Açıklama en fazla 1.024 karakter içerebilir.		 dize
İletme Uyumluluğu Haritası Geçerli API sürümüne yeni öğeler eklendiğinde başka değişikliklerden kaçınmak için ileriye dönük uyumluluk için anahtar ve değer dizelerinin listesi.

İleriye dönük uyumluluk değişiklikleri gelecek sürümlerde burada not alınacaktır. Şu anda bu nesne için ileriye dönük uyumluluk değişikliği yok.		 KeyValuePairOfstringstring dizisi
Kimliği Hedef kitlenin Microsoft Advertising tanımlayıcısı. uzun
MembershipDuration Hedef kitle oluşturduğunuzda Microsoft Advertising'in hedef kitle tanımınızla eşleşen eylemleri ne kadar geriye araması gerektiğini belirtebilirsiniz.

En düşük süre 1 gündür ve izin verilen en uzun süre 180 gündür.		 Int
Ad Hedef kitlenin adı. Ad en fazla 128 karakter içerebilir. dize
ParentId Hesabın veya müşterinin Microsoft Advertising tanımlayıcısı.

KapsamHesap olarak ayarlandıysa, bu hesap kimliğidir ve aksi takdirde müşteri kimliğidir.		 uzun
Kapsam Kapsam, bu hedef kitleyi hangi hesapların kullanabileceğini tanımlar.

Kapsam Hesap olarak ayarlandıysa, hedef kitle yalnızca bir hesaptaki kampanyalarla ve reklam gruplarıyla ilişkilendirilebilir; örneğin ParentId aracılığıyla. Kapsam Müşteri olarak ayarlanırsa, hedef kitle müşterinin tüm hesaplarındaki kampanyalar ve reklam gruplarıyla ilişkilendirilebilir.		 EntityScope
AramaAyrılaştır Arama ağındaki bu hedef kitlenin etkin üyesi olan toplam kişi sayısı. Bu size kaç arama kullanıcısının hedefleyebileceğiniz hakkında bir fikir verir.

Bu öğeyi devralan nesneler için belgelerdeki diğer ayrıntılara bakın; örneğin, RemarketingList.		 uzun
SupportedCampaignTypes Bu hedef kitleyi destekleyen kampanya türlerinin listesi.

Desteklenen değerler: Audience, DynamicSearchAds, Search ve Shopping. Gelecekte yeni kampanya türleri eklenebilir, bu nedenle sabit bir değer kümesine bağımlılık almamalısınız.		 dize dizisi
Tür Hedef kitlenin türü. İzleyici türleri hakkında daha fazla bilgi için bkz. Açıklamalar. AudienceType

Açıklamalar

Java ve .NET dilleri için Type öğesini ayarlamayın çünkü değer, özel bir hedef kitle veya başka bir hedef kitle türü örneği oluşturup oluşturmadığınıza göre belirlenir. SOAP'yi el ile oluşturursanız, aşağıdaki örnekte gösterildiği gibi İzleyici düğümünün tür özniteliğini kullanın.

<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>

Gereksinimler

Hizmet: CampaignManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/CampaignManagement/v13

Kullanan

AddAudiences
GetAudiencesByIds
UpdateAudiences