CustomerList Veri Nesnesi - Kampanya Yönetimi

Makale
11/14/2024

CustomerList veri nesnesini tanımlar.

Önemli

Kampanya Yönetimi API'sini kullanarak müşteri listesi verileri oluşturmadan önce bir müşteri listesi hedef kitlesi oluşturmanız ve Microsoft Advertising kullanıcı arabirimindeki hüküm ve koşulları kabul etmeniz gerekir. İlk müşteri listesinin herhangi bir müşteri verisi içermesi gerekmez, ancak Kabul Ediyorum'ı seçmeniz gerekir. "Kabul ediyorum" seçeneğini belirleyerek (1) kişisel veriler olan hedef kitle ayrıntılarını Microsoft'a yasal olarak açıklayabildiğinizi ve (2) Müşteri Eşleştirme Koşullarını, Microsoft Reklam Sözleşmesi'ni ve Microsoft Reklam ilkelerini kabul ettiğinizi kabul edersiniz. Microsoft, yüklediğiniz verileri Müşteri Eşleştirme Koşullarına uygun olarak kullanır.

<xs:complexType name="CustomerList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AudienceNetworkSize": "LongValueHere",
  "CustomerShare": {
    "CustomerAccountShares": [
      {
        "AccountId": "LongValueHere",
        "Associations": [
          {
            "AssociationCount": "LongValueHere",
            "UsageType": "ValueHere"
          }
        ],
        "CustomerId": "LongValueHere"
      }
    ],
    "OwnerCustomerId": "LongValueHere"
  },
  "Description": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "MembershipDuration": IntValueHere,
  "Name": "ValueHere",
  "ParentId": "LongValueHere",
  "Scope": "ValueHere",
  "SearchSize": "LongValueHere",
  "SupportedCampaignTypes": [
    "ValueHere"
  ],
  "Type": "CustomerList"
}

Öğe

CustomerList nesnesinin Devralınan Öğeleri vardır.

Devralınan Öğeler

Hedef Kitleden Devralınan Öğeler

CustomerList nesnesi Audience nesnesinden türetilir ve şu öğeleri devralır: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Aşağıdaki açıklamalar CustomerList'e özeldir ve Audience nesnesinden aynı öğeleri devralan diğer nesneler için geçerli olmayabilir.

Öğ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. Microsoft Advertising'in iyileştirmeler için kullanabilmesi için hedef kitlenin en az 300 kişi olması gerekir. Eklemek: Salt okunur Güncelleştirmek: Salt okunur	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. Paylaşılan UET etiketleri ve hedef kitleleri yalnızca pilot müşteriler tarafından kullanılabilir. Müşteri hiyerarşisinde hedef kitleleri ve UET etiketlerini paylaşmaya genel bakış için bkz. Hedef Kitleleri Paylaşma ve UET Etiketleri teknik kılavuzu. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Mevcut müşteri hesabı paylaşımlarını korumak için bu öğeyi null veya boş olarak ayarlayın. Tüm müşteri hesabı paylaşımlarını kaldırmak için CustomerShare nesnesinin CustomerAccountShares öğesini null veya boş olarak ayarlayın. Müşteri hesap paylaşımlarının bir alt kümesini kaldırmak için, CustomerShare nesnesinin CustomerAccountShares öğesinde tutmak istediğiniz müşteri hesabı paylaşımlarını belirtin.	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. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	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 Audience nesnesi için ileriye dönük uyumluluk değişikliği yoktur.	KeyValuePairOfstringstring dizisi
Kimliği	Hedef kitlenin Microsoft Advertising tanımlayıcısı. Eklemek: Salt okunur Güncelleştirmek: Gerekli ve salt okunur	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 390 gündür. Süre sonu olmaması için süreyi -1 olarak da ayarlayabilirsiniz. Eklemek: Opsiyonel. Belirtilmezse üyelik süresi varsayılan olarak 30 olarak ayarlanır. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	Int
Ad	Hedef kitlenin adı. Ad en fazla 128 karakter içerebilir. Eklemek: Gerekli Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	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. Eklemek: Gerekli Güncelleştirmek: Salt okunur. Üst kimliği değiştiremezsiniz.	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. Eklemek: Gerekli Güncelleştirmek: Opsiyonel. Kapsamı Hesap yerine Müşteri olarak değiştirebilirsiniz, ancak kapsamı Müşteri yerine Hesap olarak değiştiremezsiniz.	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. Microsoft Advertising'in iyileştirmeler için kullanabilmesi için hedef kitlenin en az 300 kişi olması gerekir. Bu özellik, örneğin müşteri listesi üyelik süresini ekler veya güncelleştirirseniz hedef kitle oluşturulurken 48 saate kadar sıfır veya boş olur. Eklemek: Salt okunur Güncelleştirmek: Salt okunur	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. Eklemek: Salt okunur Güncelleştirmek: Salt okunur	dize dizisi
Tür	Hedef kitlenin türü. Bu değer, müşteri listesi hedef kitlesini aldığınızda CustomerList değeridir. hedef kitle türleri hakkında daha fazla bilgi için bkz . Hedef Kitle Verileri Nesnesi Açıklamaları. Eklemek: Salt okunur Güncelleştirmek: Salt okunur	AudienceType

Gereksinimler

Hizmet: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Kullanan

ApplyCustomerListItems

Aracılığıyla paylaş