Aracılığıyla paylaş

ApplyProductPartitionActions Hizmet İşlemi - Kampanya Yönetimi

  • Makale

Belirtilen BiddableAdGroupCriterion veya NegativeAdGroupCriterion öğelerinin her birine her biri productpartition içeren bir ekleme, güncelleştirme veya silme eylemi uygular.

İpucu

Microsoft alışveriş kampanyaları hakkında genel bir bakış ve daha fazla bilgi için Ürün Reklamları ve Akıllı Alışveriş Kampanyaları teknik kılavuzlarına bakın.

Lütfen aşağıdaki doğrulama kurallarını not edin.

  • En azından, ürün bölümü grubu ağaç yapısı için en az kök düğümü belirtmeniz gerekir. Ürün bölümü grubunun kök BiddableAdGroupCriterion öğesinin koşulu İşleneni "Tümü" ve Özniteliğinull olarak ayarlanmalıdır. Katalogdaki tüm ürünlere eşit şekilde teklif verirseniz PartitionType değerini Unit olarak ayarlayın. Teklifleri daha belirli ürün koşullarına göre bölümlediyseniz PartitionType değerini Subdivision, ParentCriterionId değerini null, Kimliği ise negatif bir değer olarak ayarlayın. Alt düğümler için ParentCriterionId olarak negatif değeri kullanacaksınız.

  • Kök düğüm düzey 0 olarak kabul edilir ve bir ağaç 7 düzey derine kadar dallara sahip olabilir.

  • Çağrı başına en fazla 5.000 AdGroupCriterionAction nesnesi belirtebilirsiniz. Birden çok çağrı aracılığıyla oluşturulan tüm ağacın en fazla 20.000 düğümü olabilir.

  • AdGroupCriterionAction nesnelerinin her biri aynı AdGroupId'ye sahip olmalıdır, aksi takdirde çağrı başarısız olur.

  • Koşul veya Öznitelik özelliklerini güncelleştirmek için mevcut ürün bölümü ağacı düğümünü silmeniz ve yeni bir tanımlayıcı alacak yeni bir ürün bölümü ağacı düğümü eklemeniz gerekir. Aynı şekilde , BiddableAdGroupCriterion'danNegativeAdGroupCriterion'a (veya tersi) güncelleştirmek için, mevcut ürün bölüm ağacı düğümünü silmeniz ve yeni bir tanımlayıcı alacak yeni bir ürün bölüm ağacı düğümü eklemeniz gerekir.

  • Herhangi bir eylem başarısız olursa, aksi takdirde başarılı olabilecek kalan tüm eylemler de başarısız olur.

  • Bir çağrıdaki tüm eylemler tam bir ağaç yapısına neden olmalıdır. Reklam grubu başına 5.000'den fazla eylem uygulamanız gerekiyorsa birden çok arama yapmanız gerekir. İlk çağrıdan üst reklam grubu ölçüt tanımlayıcılarını alın ve ardından sonraki aramalarda gerektiğinde daha fazla alt öğe ekleyin.

  • Kök düğümden dalın sonuna kadar olan her yol bir yaprak düğüm (ProductPartitionType=Unit) ile sonlandırılmalıdır. Düğüm bir NegativeAdGroupCriterion olmadığı sürece her Birimin bir teklifi olmalıdır.

  • Her alt bölüm, alt bölüm koşullarının geri kalanında teklif veren en az bir yaprak düğüme sahip olmalıdır; örneğin eşdüzey birimleriyle aynı işleneni kullanın ve Özniteliğini null olarak ayarlayın.

  • Alt düğümü yalnızca üst öğesinden sonra belirtebilirsiniz.

  • Üst veya alt öğe olmayan birden çok düzeye sahip bölümler ekliyorsanız, üst öğeyi tanımlamak için başvuru olarak negatif bir int değeri kullanın. Örneğin hem üst öğenin kimliğini hem de alt öğenin ParentCriterionId öğesini aynı negatif değere ayarlayın. Negatif kimlikler yalnızca çağrı süresi boyunca geçerlidir. Başarıyla eklenen her reklam grubu ölçütü için benzersiz sistem tanımlayıcıları yanıt iletisinde döndürülür.

  • Alt Bölüm bölüm düğümleri için BiddableAdGroupCriterion'ınCriterionBid ve DestinationUrl öğeleri yoksayılır. Bu öğeler yalnızca Birim (yaprak) bölüm düğümleri için geçerlidir.

  • AdGroupCriterion'ınStatus öğesi, ürün bölümü ölçütü için her zaman yoksayılır. Ürün bölümü eklemek, güncelleştirmek veya silmek için ilgili AdGroupCriterionActionöğesinin Action öğesini ayarlayın.

  • Herhangi bir ürün bölümünü duraklatmak için UpdateAdGroups'u çağırarak reklam grubunun tamamını duraklatmalısınız. Kampanyanın tamamını duraklatmak için UpdateCampaigns'i çağırabilirsiniz.

  • AdGroupCriterion'ınEditorStatus öğesinin ürün bölümü ölçütü için önemli bir anlamı yoktur. Ürün kataloğu için editoryal doğrulama, Microsoft Merchant Center mağazasında tamamlanır.

  • Delete eylemi için yalnızca AdGroupCriterion içinde Id ve AdGroupId değerini belirtmeniz gerekir.

  • Bir üst ürün bölümünü silerseniz, tüm alt öğeleri ve alt öğeleri de silinir.

  • Dalda yinelenen ürün koşulları belirtemeyebilirsiniz.

İstek Öğeleri

ApplyProductPartitionActionsRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar. Öğelerin İstek SOAP'sinde gösterildiği gibi aynı sırada olması gerekir.

Not

Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.

İstek Gövdesi Öğeleri

Öğe Açıklama Veri Türü
CriterionActions Her biri bir Action öğesi ve BiddableAdGroupCriterion veya NegativeAdGroupCriterion içeren en fazla 5.000 AdGroupCriterionAction nesnesinin listesi.

Tüm reklam grubu ölçüt eylemleri aynı reklam grubu için olmalıdır. Doğrulama kuralları da dahil olmak üzere daha fazla bilgi için bkz. Kampanya Yönetimi Hizmeti ile Microsoft Alışveriş kampanyası oluşturma.		 AdGroupCriterionAction dizisi

İstek Üst Bilgisi Öğeleri

Öğe Açıklama Veri Türü
AuthenticationToken Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci.

Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması.		 Dize
CustomerAccountId İstekteki varlıklara sahip olan veya bunlarla ilişkilendirilmiş reklam hesabının tanımlayıcısı. Her ikisi de gerektiğinde bu üst bilgi öğesi AccountId gövde öğesiyle aynı değere sahip olmalıdır. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir.

Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma.		 Dize
Customerıd Kullanıcının eriştiği veya faaliyette olduğu yönetici hesabının (müşteri) tanımlayıcısı. Bir kullanıcı birden çok yönetici hesabına erişebilir. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir.

Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma.		 Dize
DeveloperToken Bing Ads API'sine erişmek için kullanılan geliştirici belirteci.

Daha fazla bilgi için bkz . Geliştirici Belirteci Alma.		 Dize
Password Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir. Dize
Username Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir. Dize

Yanıt Öğeleri

ApplyProductPartitionActionsResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt SOAP'sinde gösterildiği gibi aynı sırada döndürülür.

Yanıt Gövdesi Öğeleri

Öğe Açıklama Veri Türü
AdGroupCriterionIds Eylemin uygulandığı ölçütü tanımlayan tanımlayıcıların listesi. Tanımlayıcı listesi doğrudan istekteki ölçüt listesine karşılık gelir.

Herhangi bir ölçüt eylemi başarısız olursa kalan tüm ölçüt eylemleri başarısız olur ve bu listedeki tüm öğeler null olur.		 uzun dizi
PartialErrors Başarılı olmayan istek öğelerinin ayrıntılarını içeren batcherror nesneleri dizisi.

Hata listesi doğrudan istekteki öğe listesine karşılık gelir. Hata yoksa liste boş olabilir veya istekteki başarısız liste öğelerine karşılık gelen bir veya daha fazla hata nesnesi içerebilir.

Kullanıcı hatası nedeniyle başarısız olan ölçüt için eyleme dönüştürülebilir bir hata kodu döndürülür.

Herhangi bir ölçüt eylemi başarısız olursa kalan tüm ölçüt eylemleri başarısız olur ve bu listedeki öğelerin hiçbiri null olmaz. Aksi takdirde başarılı olabilecek ölçütler için, ilgili varlığın başarısız olduğunu açıklayan genel bir hata döndürülür.		 BatchError dizisi

Yanıt Üst Bilgisi Öğeleri

Öğe Açıklama Veri Türü
TrackingId API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı. Dize

SOAP isteme

Bu şablon, SOAP isteği için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <Action mustUnderstand="1">ApplyProductPartitionActions</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <ApplyProductPartitionActionsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <CriterionActions i:nil="false">
        <AdGroupCriterionAction>
          <Action>ValueHere</Action>
          <AdGroupCriterion i:nil="false" i:type="-- derived type specified here with the appropriate prefix --">
            <AdGroupId>ValueHere</AdGroupId>
            <Criterion i:nil="false" i:type="-- derived type specified here with the appropriate prefix --">
              <Type i:nil="false">ValueHere</Type>
              <!--These fields are applicable if the derived type attribute is set to ProductPartition-->
              <Condition i:nil="false">
                <Attribute i:nil="false">ValueHere</Attribute>
                <Operand i:nil="false">ValueHere</Operand>
                <Operator i:nil="false">ValueHere</Operator>
              </Condition>
              <ParentCriterionId i:nil="false">ValueHere</ParentCriterionId>
              <PartitionType>ValueHere</PartitionType>
              <!--These fields are applicable if the derived type attribute is set to HotelGroup-->
              <Listing i:nil="false">
                <Attribute i:nil="false">ValueHere</Attribute>
                <Operand i:nil="false">ValueHere</Operand>
              </Listing>
              <ListingType>ValueHere</ListingType>
              <ParentCriterionId i:nil="false">ValueHere</ParentCriterionId>
              <!--These fields are applicable if the derived type attribute is set to HotelAdvanceBookingWindowCriterion-->
              <MaxDays i:nil="false">ValueHere</MaxDays>
              <MinDays i:nil="false">ValueHere</MinDays>
              <!--These fields are applicable if the derived type attribute is set to HotelCheckInDateCriterion-->
              <EndDate i:nil="false">ValueHere</EndDate>
              <StartDate i:nil="false">ValueHere</StartDate>
              <!--This field is applicable if the derived type attribute is set to HotelCheckInDayCriterion-->
              <CheckInDay i:nil="false">ValueHere</CheckInDay>
              <!--This field is applicable if the derived type attribute is set to HotelDateSelectionTypeCriterion-->
              <HotelDateSelectionType i:nil="false">ValueHere</HotelDateSelectionType>
              <!--These fields are applicable if the derived type attribute is set to HotelLengthOfStayCriterion-->
              <MaxNights i:nil="false">ValueHere</MaxNights>
              <MinNights i:nil="false">ValueHere</MinNights>
              <!--This field is applicable if the derived type attribute is set to ProductScope-->
              <Conditions i:nil="false">
                <ProductCondition>
                  <Attribute i:nil="false">ValueHere</Attribute>
                  <Operand i:nil="false">ValueHere</Operand>
                  <Operator i:nil="false">ValueHere</Operator>
                </ProductCondition>
              </Conditions>
              <!--This field is applicable if the derived type attribute is set to Webpage-->
              <Parameter i:nil="false">
                <Conditions i:nil="false">
                  <WebpageCondition>
                    <Argument i:nil="false">ValueHere</Argument>
                    <Operand>ValueHere</Operand>
                    <Operator i:nil="false">ValueHere</Operator>
                  </WebpageCondition>
                </Conditions>
                <CriterionName i:nil="false">ValueHere</CriterionName>
              </Parameter>
              <!--This field is applicable if the derived type attribute is set to AgeCriterion-->
              <AgeRange i:nil="false">ValueHere</AgeRange>
              <!--These fields are applicable if the derived type attribute is set to DeviceCriterion-->
              <DeviceName i:nil="false">ValueHere</DeviceName>
              <OSName i:nil="false">ValueHere</OSName>
              <!--These fields are applicable if the derived type attribute is set to DayTimeCriterion-->
              <Day i:nil="false">ValueHere</Day>
              <FromHour i:nil="false">ValueHere</FromHour>
              <FromMinute i:nil="false">ValueHere</FromMinute>
              <ToHour i:nil="false">ValueHere</ToHour>
              <ToMinute i:nil="false">ValueHere</ToMinute>
              <!--This field is applicable if the derived type attribute is set to GenderCriterion-->
              <GenderType i:nil="false">ValueHere</GenderType>
              <!--These fields are applicable if the derived type attribute is set to RadiusCriterion-->
              <LatitudeDegrees i:nil="false">ValueHere</LatitudeDegrees>
              <LongitudeDegrees i:nil="false">ValueHere</LongitudeDegrees>
              <Name i:nil="false">ValueHere</Name>
              <Radius i:nil="false">ValueHere</Radius>
              <RadiusUnit i:nil="false">ValueHere</RadiusUnit>
              <!--These fields are applicable if the derived type attribute is set to LocationCriterion-->
              <DisplayName i:nil="false">ValueHere</DisplayName>
              <EnclosedLocationIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <a1:long>ValueHere</a1:long>
              </EnclosedLocationIds>
              <LocationId i:nil="false">ValueHere</LocationId>
              <LocationType i:nil="false">ValueHere</LocationType>
              <!--This field is applicable if the derived type attribute is set to LocationIntentCriterion-->
              <IntentOption i:nil="false">ValueHere</IntentOption>
              <!--These fields are applicable if the derived type attribute is set to AudienceCriterion-->
              <AudienceId i:nil="false">ValueHere</AudienceId>
              <AudienceType i:nil="false">ValueHere</AudienceType>
              <!--These fields are applicable if the derived type attribute is set to ProfileCriterion-->
              <ProfileId>ValueHere</ProfileId>
              <ProfileType>ValueHere</ProfileType>
              <!--This field is applicable if the derived type attribute is set to StoreCriterion-->
              <StoreId i:nil="false">ValueHere</StoreId>
              <!--This field is applicable if the derived type attribute is set to DealCriterion-->
              <DealId>ValueHere</DealId>
              <!--This field is applicable if the derived type attribute is set to GenreCriterion-->
              <GenreId>ValueHere</GenreId>
              <!--These fields are applicable if the derived type attribute is set to PlacementCriterion-->
              <PlacementId>ValueHere</PlacementId>
              <PlacementName i:nil="false">ValueHere</PlacementName>
            </Criterion>
            <Id i:nil="false">ValueHere</Id>
            <Status i:nil="false">ValueHere</Status>
            <Type i:nil="false">ValueHere</Type>
            <!--These fields are applicable if the derived type attribute is set to BiddableAdGroupCriterion-->
            <CriterionBid i:nil="false" i:type="-- derived type specified here with the appropriate prefix --">
              <Type i:nil="false">ValueHere</Type>
              <!--This field is applicable if the derived type attribute is set to RateBid-->
              <RateAmount i:nil="false">
                <Amount i:nil="false">ValueHere</Amount>
              </RateAmount>
              <!--This field is applicable if the derived type attribute is set to FixedBid-->
              <Amount>ValueHere</Amount>
              <!--This field is applicable if the derived type attribute is set to BidMultiplier-->
              <Multiplier>ValueHere</Multiplier>
            </CriterionBid>
            <DestinationUrl i:nil="false">ValueHere</DestinationUrl>
            <EditorialStatus i:nil="false">ValueHere</EditorialStatus>
            <FinalAppUrls i:nil="false">
              <AppUrl>
                <OsType i:nil="false">ValueHere</OsType>
                <Url i:nil="false">ValueHere</Url>
              </AppUrl>
            </FinalAppUrls>
            <FinalMobileUrls i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
              <a1:string>ValueHere</a1:string>
            </FinalMobileUrls>
            <FinalUrlSuffix i:nil="false">ValueHere</FinalUrlSuffix>
            <FinalUrls i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
              <a1:string>ValueHere</a1:string>
            </FinalUrls>
            <TrackingUrlTemplate i:nil="false">ValueHere</TrackingUrlTemplate>
            <UrlCustomParameters i:nil="false">
              <Parameters i:nil="false">
                <CustomParameter>
                  <Key i:nil="false">ValueHere</Key>
                  <Value i:nil="false">ValueHere</Value>
                </CustomParameter>
              </Parameters>
            </UrlCustomParameters>
            <CriterionCashback i:nil="false" i:type="-- derived type specified here with the appropriate prefix --">
              <Type i:nil="false">ValueHere</Type>
              <!--This field is applicable if the derived type attribute is set to CashbackAdjustment-->
              <CashbackPercent i:nil="false">ValueHere</CashbackPercent>
            </CriterionCashback>
            <!--No additional fields are applicable if the derived type attribute is set to NegativeAdGroupCriterion-->
          </AdGroupCriterion>
        </AdGroupCriterionAction>
      </CriterionActions>
    </ApplyProductPartitionActionsRequest>
  </s:Body>
</s:Envelope>

Yanıt SOAP

Bu şablon, SOAP yanıtı için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <ApplyProductPartitionActionsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <AdGroupCriterionIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <a1:long>ValueHere</a1:long>
      </AdGroupCriterionIds>
      <PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <BatchError d4p1:type="-- derived type specified here with the appropriate prefix --">
          <Code>ValueHere</Code>
          <Details d4p1:nil="false">ValueHere</Details>
          <ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
          <FieldPath d4p1:nil="false">ValueHere</FieldPath>
          <ForwardCompatibilityMap xmlns:e70="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e70:KeyValuePairOfstringstring>
              <e70:key d4p1:nil="false">ValueHere</e70:key>
              <e70:value d4p1:nil="false">ValueHere</e70:value>
            </e70:KeyValuePairOfstringstring>
          </ForwardCompatibilityMap>
          <Index>ValueHere</Index>
          <Message d4p1:nil="false">ValueHere</Message>
          <Type d4p1:nil="false">ValueHere</Type>
          <!--These fields are applicable if the derived type attribute is set to EditorialError-->
          <Appealable d4p1:nil="false">ValueHere</Appealable>
          <DisapprovedText d4p1:nil="false">ValueHere</DisapprovedText>
          <Location d4p1:nil="false">ValueHere</Location>
          <PublisherCountry d4p1:nil="false">ValueHere</PublisherCountry>
          <ReasonCode>ValueHere</ReasonCode>
        </BatchError>
      </PartialErrors>
    </ApplyProductPartitionActionsResponse>
  </s:Body>
</s:Envelope>

Kod Söz Dizimi

Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .

public async Task<ApplyProductPartitionActionsResponse> ApplyProductPartitionActionsAsync(
	IList<AdGroupCriterionAction> criterionActions)
{
	var request = new ApplyProductPartitionActionsRequest
	{
		CriterionActions = criterionActions
	};

	return (await CampaignManagementService.CallAsync((s, r) => s.ApplyProductPartitionActionsAsync(r), request));
}

static ApplyProductPartitionActionsResponse applyProductPartitionActions(
	ArrayOfAdGroupCriterionAction criterionActions) throws RemoteException, Exception
{
	ApplyProductPartitionActionsRequest request = new ApplyProductPartitionActionsRequest();

	request.setCriterionActions(criterionActions);

	return CampaignManagementService.getService().applyProductPartitionActions(request);
}

static function ApplyProductPartitionActions(
	$criterionActions)
{

	$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];

	$request = new ApplyProductPartitionActionsRequest();

	$request->CriterionActions = $criterionActions;

	return $GLOBALS['CampaignManagementProxy']->GetService()->ApplyProductPartitionActions($request);
}

response=campaignmanagement_service.ApplyProductPartitionActions(
	CriterionActions=CriterionActions)

Gereksinimler

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