AddCampaignCriterions Hizmet İşlemi - Kampanya Yönetimi
Her kampanyadaki reklamların sunulup sunulmadığını belirlemeye yardımcı olan bir veya daha fazla kampanya ölçütü ekler.
İstek Öğeleri
AddCampaignCriterionsRequest 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ü |
|---|---|---|
| CampaignCriterions | Her kampanyadaki reklamların sunulup sunulmayacağını belirlemeye yardımcı olan ölçütlerin listesi. İstek başına en fazla 100 kampanya ölçütü ekleyebilirsiniz. |
CampaignCriterion dizisi |
| CriterionType | Eklenecek ölçüt türü, örneğin Web sayfası. Çağrı başına yalnızca bir ölçüt türü değeri belirtebilirsiniz. Yaş, gün ve saat, cihaz, cinsiyet, konum, konum amacı ve yarıçap ölçütleri gibi hedef ölçütleri eklemek, silmek veya güncelleştirmek için CriterionType değerini Hedefler olarak belirtmeniz gerekir. Aynı işlemde birden çok hedef ölçüt türü ekleyebilir, silebilir ve güncelleştirebilirsiniz. GetCampaignCriterionsByIds aracılığıyla bu hedef ölçütleri almak için belirli türü tek tek istemeniz gerekir; örneğin, Age, DayTime, Device, Gender, Location, LocationIntent ve Radius. Özel hedef kitleler, pazar içi hedef kitleler ve yeniden pazarlama listeleri gibi hedef kitle ölçütlerini eklemek, silmek veya güncelleştirmek için CriterionType değerini Hedef Kitle olarak belirtmeniz gerekir. Aynı işlemde birden çok hedef ölçüt türü ekleyebilir, silebilir ve güncelleştirebilirsiniz. GetCampaignCriterionsByIds aracılığıyla bu hedef kitle ölçütlerini almak için özel türü tek tek istemeniz gerekir. Örneğin, CustomAudience, InMarketAudience, ProductAudience ve RemarketingList. |
CampaignCriterionType |
İ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
AddCampaignCriterionsResponse 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ü |
|---|---|---|
| CampaignCriterionIds | Eklenen ölçüte karşılık gelen benzersiz sistem tanımlayıcılarının listesi. Tanımlayıcı listesi doğrudan istekteki ölçüt listesine karşılık gelir. Listedeki öğeler null olarak döndürülebilir. Ölçüt eklenmediği her liste dizini için ilgili öğe null olur. |
uzun dizi |
| NestedPartialErrors | Başarıyla eklenmedi tüm ölçütlerin ayrıntılarını içeren batcherrorCollection nesneleri dizisi. Her BatchErrorCollection nesnesi içindeki en üst düzey hata, olası ölçüt hatalarına karşılık gelir.
BatchError nesnelerinin iç içe yerleştirilmiş listesi, bir ölçütün içerebileceği öğe listesine özgü hataları içerebilir. 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. |
BatchErrorCollection 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">AddCampaignCriterions</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>
<AddCampaignCriterionsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<CampaignCriterions i:nil="false">
<CampaignCriterion i:type="-- derived type specified here with the appropriate prefix --">
<CampaignId>ValueHere</CampaignId>
<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 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>
</Criterion>
<ForwardCompatibilityMap xmlns:e38="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e38:KeyValuePairOfstringstring>
<e38:key i:nil="false">ValueHere</e38:key>
<e38:value i:nil="false">ValueHere</e38:value>
</e38:KeyValuePairOfstringstring>
</ForwardCompatibilityMap>
<Id i:nil="false">ValueHere</Id>
<Status i:nil="false">ValueHere</Status>
<Type i:nil="false">ValueHere</Type>
<!--No additional fields are applicable if the derived type attribute is set to NegativeCampaignCriterion-->
<!--These fields are applicable if the derived type attribute is set to BiddableCampaignCriterion-->
<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>
<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>
</CampaignCriterion>
</CampaignCriterions>
<CriterionType>ValueHere</CriterionType>
</AddCampaignCriterionsRequest>
</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>
<AddCampaignCriterionsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<CampaignCriterionIds 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>
</CampaignCriterionIds>
<NestedPartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<BatchErrorCollection d4p1:type="-- derived type specified here with the appropriate prefix --">
<BatchErrors d4p1:nil="false">
<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:e39="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e39:KeyValuePairOfstringstring>
<e39:key d4p1:nil="false">ValueHere</e39:key>
<e39:value d4p1:nil="false">ValueHere</e39:value>
</e39: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>
</BatchErrors>
<Code d4p1:nil="false">ValueHere</Code>
<Details d4p1:nil="false">ValueHere</Details>
<ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
<FieldPath d4p1:nil="false">ValueHere</FieldPath>
<ForwardCompatibilityMap xmlns:e40="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e40:KeyValuePairOfstringstring>
<e40:key d4p1:nil="false">ValueHere</e40:key>
<e40:value d4p1:nil="false">ValueHere</e40:value>
</e40: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 EditorialErrorCollection-->
<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>
</BatchErrorCollection>
</NestedPartialErrors>
</AddCampaignCriterionsResponse>
</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<AddCampaignCriterionsResponse> AddCampaignCriterionsAsync(
IList<CampaignCriterion> campaignCriterions,
CampaignCriterionType criterionType)
{
var request = new AddCampaignCriterionsRequest
{
CampaignCriterions = campaignCriterions,
CriterionType = criterionType
};
return (await CampaignManagementService.CallAsync((s, r) => s.AddCampaignCriterionsAsync(r), request));
}
static AddCampaignCriterionsResponse addCampaignCriterions(
ArrayOfCampaignCriterion campaignCriterions,
ArrayList<CampaignCriterionType> criterionType) throws RemoteException, Exception
{
AddCampaignCriterionsRequest request = new AddCampaignCriterionsRequest();
request.setCampaignCriterions(campaignCriterions);
request.setCriterionType(criterionType);
return CampaignManagementService.getService().addCampaignCriterions(request);
}
static function AddCampaignCriterions(
$campaignCriterions,
$criterionType)
{
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
$request = new AddCampaignCriterionsRequest();
$request->CampaignCriterions = $campaignCriterions;
$request->CriterionType = $criterionType;
return $GLOBALS['CampaignManagementProxy']->GetService()->AddCampaignCriterions($request);
}
response=campaignmanagement_service.AddCampaignCriterions(
CampaignCriterions=CampaignCriterions,
CriterionType=CriterionType)
Gereksinimler
Hizmet: CampaignManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/CampaignManagement/v13