ConversionGoal Veri Nesnesi - Kampanya Yönetimi

Makale
12/21/2023

Dönüştürme hedefinin temel nesnesini tanımlar.

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

Sözdizimi

<xs:complexType name="ConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AttributionModelType" nillable="true" type="tns:AttributionModelType">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ConversionWindowInMinutes" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="CountType" nillable="true" type="tns:ConversionGoalCountType" />
    <xs:element minOccurs="0" name="ExcludeFromBidding" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="GoalCategory" nillable="true" type="tns:ConversionGoalCategory">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsEnhancedConversionsEnabled" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Revenue" nillable="true" type="tns:ConversionGoalRevenue" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ConversionGoalStatus" />
    <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:ConversionGoalTrackingStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalType" />
    <xs:element minOccurs="0" name="ViewThroughConversionWindowInMinutes" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Öğe

ConversionGoal nesnesi şu öğelere sahiptir: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes.

Öğe	Açıklama	Veri Türü
AttributionModelType	Dönüştürme hedefiyle hangi ilişkilendirme modelinin ( LastTouch veya LastClick) kullanıldığını belirler. Bu öğe varsayılan olarak döndürülmedi. Bu öğeyi almak için GetConversionGoalsByIds ve GetConversionGoalsByTagIds hizmet işlemlerini çağırdığınızda ReturnAdditionalFields öğesine AttributionModelType değerini ekleyin. Bu öğe AppInstallGoal, InStoreTransactionGoal ve OfflineConversionGoal için geçerli değildir.	AttributionModelType
ConversionWindowInMinutes	Dönüştürme penceresi, bir tıklamadan sonra dönüşümleri izlemek istediğiniz dakika cinsinden süredir. Bu değeri 43200 dakika (30 gün) olarak ayarlarsanız, tıklamanın ardından 30 gün içinde gerçekleşen dönüştürmeler izlenir. Geçmiş dönüştürmeler etkilenmez. Desteklenen en düşük değer 1 dakikadır, ancak daha kısa bir dönüştürme penceresinin hesap kayıtlarınızın dönüşüm sayısını azaltacağını unutmayın. Desteklenen en yüksek değer 129600 dakikadır (90 gün).	Int
CountType	Bu, dönüşümlerinizin seçtiğiniz dönüştürme penceresine nasıl kaydedileceğini belirler. İki seçenek vardır ve bir değer ayarlamazsanız varsayılan değer Tümü'dür: - Tümü: Bir reklam tıklaması sonrasında gerçekleşen tüm dönüşümler sayılır. Bu, satışlar için yaygın bir seçimdir. - Benzersiz: Bir reklam tıklaması sonrasında gerçekleşen yalnızca bir dönüşüm sayılır. Bu, müşteri adayları için yaygın bir seçimdir. Örneğin: İki dönüştürmeyi izlersiniz: müşteri adayları ve satışlar. Müşteri adayları için Benzersiz ve satışlar için Tümü'leri seçersiniz. Bir reklam tıklaması iki müşteri adayına ve iki satışa dönüştüyse üç dönüşüm olarak sayılır: benzersiz müşteri adayı için bir ve tüm satışlar için iki dönüşüm. Bu öğe AppInstallGoal için geçerli değildir.	ConversionGoalCountType
ExcludeFromBidding	Bu dönüştürme hedefiyle ilgili verilerin performans raporu sütunlarının bir alt kümesinden dışlanıp dışlanmayacağını belirler. Bu öğe yalnızca Dönüşümlere Dahil Et özelliği için etkinleştirilen müşteriler tarafından kullanılabilir (GetCustomerPilotFeatures 574 döndürür). Bu öğe true olarak ayarlanırsa, aksi takdirde bu dönüştürme hedefiyle ilgili veriler , `ConversionRate`, , `CostPerConversion`, `ReturnOnAdSpend`, `RevenuePerConversion`ve `Revenue` rapor sütunlarından `Conversions`dışlanır. Ayrıca, otomatik teklif teklifi stratejisi kullanırsanız bu özelliğin true olarak ayarlanması, hedefin dönüşümlerinin artık otomatik teklif hesaplamalarına hesaba katmamasıyla sonuçlanır. Bu özelliğin "true" olarak ayarlanması, Microsoft Advertising web uygulamasında "Dönüştürmelere Ekle" seçeneğinin işaretini kaldırmakla etkili bir şekilde aynıdır. Bu öğe değerinden `AllConversions`bağımsız olarak , `AllConversionRate`, , `AllCostPerConversion`, `AllReturnOnAdSpend`, `AllRevenuePerConversion`ve `AllRevenue` rapor sütunları tüm dönüştürme hedeflerine ait verileri içerir. Varsayılan olarak bu öğe false'tur ve bu dönüştürme hedefiyle ilgili veriler tüm rapor sütunlarına eklenir. Daha fazla bilgi için Rapor Öznitelikleri ve Performans İstatistikleri'ne ve "Dönüştürme hedefleri" ile "Tüm dönüştürmeler" arasındaki yardım makalesine bakın.	Boolean
GoalCategory	Dönüştürme hedefini segmentlere ayırmak için kullanılan kategori. Dönüştürme hedeflerinizi kategorilere ayırın, ancak işletmeniz için mantıklıdır. Hedef kategorileri performansı etkilemez. Bunlar, hedeflerinizi ve performans ölçümlerini segmentlere ayırmanıza yardımcı olmak için buradadır. Desteklenen kategori değerleri dönüştürme hedefi türüne göre değişiklik gösterir, bu nedenle ayrıntılı gereksinimler için lütfen ilgili başvuru sayfasına bakın.	ConversionGoalCategory
Kimlik	Dönüştürme hedefi için benzersiz Microsoft Advertising tanımlayıcısı.	Uzun
IsEnhancedConversionsEnabled	Bir dönüştürme hedefi için gelişmiş dönüştürmelerin etkinleştirilip etkinleştirilmediğini belirler. Not: Gelişmiş dönüştürme hedefi oluşturmak ve ayarlamak `isEnhancedConversionsEnabled=true`için, Microsoft Advertising kullanıcı arabirimi aracılığıyla gelişmiş dönüştürme ayarı seçili ve ilişkili onay kutusu işaretli olarak hesap için bir dönüştürme hedefi oluşturmanız gerekir.	Boolean
Adı	Dönüştürme hedefi adı. Adın uzunluk üst sınırı 100'dür ve aynı müşteriye ait tüm dönüştürme hedefleri arasında ad benzersiz olmalıdır.	Dize
Gelir	Her dönüştürmenin işletmeniz için ne kadar değerinde olduğunu belirler. Herhangi bir gelir izleme tercihi belirtmezseniz bir dönüştürme hedefi eklerken, her ConversionGoalRevenue ilgili varsayılan değerlerine ayarlanır. Dönüştürme hedefini güncelleştirirken Revenue öğesi sıfır veya boşsa iç içe özelliklerin hiçbiri güncelleştirilmez. Ancak, bu öğe sıfır veya boş değilse, mevcut gelir özelliklerini etkili bir şekilde değiştirirsiniz. VariableValue seçeneği AppInstallGoal, DurationGoal veya PagesViewedPerVisitGoal için kullanılamaz.	ConversionGoalRevenue
Kapsam	Hedefin tüm hesaplar için mi yoksa yalnızca gerekli CustomerAccountId üst bilgisi öğesinde belirtilen hesaba mı uygulandığını belirler. Birden çok Microsoft Advertising hesabınız varsa, tüm bu hesaplardaki dönüşümleri izleyebilirsiniz. Bir hedefi tek bir hesapla ilişkilendirirseniz, dönüşümler yalnızca bu hesap için izlenir. Olası değerler Hesap ve Müşteri'dir. Kapsamı ayarladıktan sonra değiştiremezsiniz. Kapsamı değiştirmek istiyorsanız yeni bir dönüştürme hedefi oluşturmanız ve eskisini duraklatmanız gerekir. AppInstallGoal için yalnızca Müşteri kapsamı desteklenir.	EntityScope
Durum	Dönüştürme hedefinin kullanıcı tarafından belirlenen olası durum değerlerini tanımlar. Bunlar, kullanıcının ayarlamaya karar verebileceği durum değerleridir. Örneğin, hedef için dönüştürmeleri artık izlemek istemiyorsanız hedef Duraklatıldı olarak ayarlanabilir. Sistem tarafından ayarlanabilen durum değerleri (örneğin UET etiketinin doğrulanıp doğrulanmadığı) için trackingStatus öğesine bakın.	ConversionGoalStatus
TagId	Microsoft Advertising'in kullanıcıların web sitenizde gerçekleştirecekleri eylemleri toplamasına izin vermek için web sitenize eklediğiniz UET etiketinin benzersiz Microsoft Advertising tanımlayıcısı. Etiket kimliğine bağımlılığınızı almadan önce UET etiketinin başka bir müşteriyle veya başka bir müşteriden paylaşılabildiğini lütfen unutmayın. 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. Bu öğe AppInstallGoal, InStoreTransactionGoal ve OfflineConversionGoal için geçerli değildir.	Uzun
TrackingStatus	Bir dönüştürme hedefinin sistem tarafından belirlenen durum değerlerini tanımlar. Bunlar sistem tarafından ayarlanabilen durum değerleridir. Örneğin, UET etiketi henüz doğrulanmamışsa sistem durumu TagUnverified olarak ayarlar. Kullanıcının ayarlamaya karar verebileceği durum değerleri için, örneğin artık bu hedefe yönelik dönüştürmeleri izlemek istemiyorsanız durumu Duraklatıldı olarak ayarlamak için Status öğesine bakın. AppInstallGoal ve OfflineConversionGoal için yalnızca NoRecentConversions ve RecordingConversions durumları geçerlidir.	ConversionGoalTrackingStatus
Tür	Dönüştürme hedefinin türü. Dönüştürme hedefi türleri hakkında daha fazla bilgi için bkz. Açıklamalar.	ConversionGoalType
ViewThroughConversionWindowInMinutes	Görüntüleme dönüştürme penceresi, bir tıklamadan sonraki dakika cinsinden, görüntüleme dönüştürmelerini izlemek istediğiniz süredir. Bu değeri 43200 dakika (30 gün) olarak ayarlarsanız, tıklamanın ardından 30 gün içinde gerçekleşen görüntüleme dönüştürmeleri izlenir. Geçmiş dönüştürmeler etkilenmez. Desteklenen en düşük değer 1 dakikadır, ancak daha kısa bir dönüştürme penceresinin hesap kayıtlarınızın dönüşüm sayısını azaltacağını unutmayın. Desteklenen en yüksek değer 43200 dakikadır (30 gün). Görüntüleme dönüştürmelerinin izlenmesi için IncludeViewThroughConversions hesap özelliği de true olarak ayarlanmalıdır. Bu öğe varsayılan olarak döndürülmedi. Bu öğeyi almak için GetConversionGoalsByIds ve GetConversionGoalsByTagIds hizmet işlemlerini çağırdığınızda ReturnAdditionalFields öğesine ViewThroughConversionWindowInMinutes değerini ekleyin. Bu öğe AppInstallGoal, InStoreTransactionGoal ve OfflineConversionGoal için geçerli değildir.	Int

Açıklamalar

Java ve .NET dilleri için Type öğesini ayarlamayın çünkü değer, örnek oluşturduğunuz dönüştürme hedefi türüne göre belirlenir.

SOAP'yi el ile oluşturursanız, dönüştürme hedefinin <ConversionGoal>türünü belirtmek için aşağıdaki örnekte gösterildiği gibi düğümün tür özniteliğini kullanın.

<ConversionGoals i:nil="false">
  <ConversionGoal i:type="UrlGoal">
    <ConversionWindowInMinutes i:nil="false"></ConversionWindowInMinutes>
    <CountType i:nil="false">Unique</CountType>
    <Id i:nil="true" />
    <Name i:nil="false">My Url Conversion Goal</Name>
    <Revenue i:nil="false">
      <CurrencyCode i:nil="false">USDollar</CurrencyCode>
      <Type i:nil="false">FixedValue</Type>
      <Value i:nil="false">10.00</Value>
    </Revenue>
    <Scope i:nil="false">Customer</Scope>
    <Status i:nil="true" />
    <TagId i:nil="false"></TagId>
    <TrackingStatus i:nil="true" />
    <UrlExpression i:nil="false">contoso</UrlExpression>
    <UrlOperator i:nil="false">Contains</UrlOperator>
  </ConversionGoal>
</ConversionGoals>

Gereksinimler

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

Kullanan

AddConversionGoals
GetConversionGoalsByIds
GetConversionGoalsByTagIds
UpdateConversionGoals

Aracılığıyla paylaş

ConversionGoal Veri Nesnesi - Kampanya Yönetimi

Sözdizimi

Öğe

Açıklamalar

Gereksinimler

Kullanan

Geri Bildirim

Ek kaynaklar