Aracılığıyla paylaş

EventGoal Veri Nesnesi - Kampanya Yönetimi

  • Makale

Özel bir olay dönüştürme hedefi tanımlar.

Birisi bültene abone olma veya belgeyi dönüştürme olarak indirme gibi belirli bir eylemi her tamamladığınızda saymak için bu tür bir hedefi kullanın.

Varsayılan olarak, UET etiketi, Microsoft Advertising'in UrlGoal, DurationGoal ve PagesViewedPerVisitGoal gibi hedef türlerini desteklemesine olanak tanıyan web sitenizdeki sayfalara kullanıcı ziyaretlerini günlüğe kaydeder. Ancak, bültene abone olma veya belge indirme gibi diğer olay türlerini izlemek isteyebilirsiniz. Microsoft Advertising, EventGoal ile bu senaryoyu etkinleştirir. EventGoal oluşturmaya ek olarak, bir veya daha fazla özel olay parametresinin değerlerini raporlamak için UET etiket izleme kodunuzu özelleştirmeniz gerekir. Daha fazla bilgi edinmek için bkz. UET ile özel olayları raporlama.

İpucu

Uygulamaya genel bakış için Evrensel Olay İzleme teknik kılavuzuna bakın.

Önemli

Microsoft Advertising web uygulaması veya Kampanya Yönetimi API'si aracılığıyla yeni bir DurationGoal, EventGoal, OfflineConversionGoal, PagesViewedPerVisitGoal veya UrlGoal eklediğinizde veya güncelleştirdiğinizde, ilgili AccountProperty'ninMSCLKIDAutoTaggingEnabled değeri otomatik olarak True olarak ayarlanır. Hedefin Kapsamı Müşteri düzeyi olarak ayarlanırsa, Müşteri altındaki tüm hesaplar için AccountProperty ayarlanır.

Sözdizimi

<xs:complexType name="EventGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="ActionExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="CategoryExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="LabelExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" nillable="true" type="tns:ValueOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Öğe

EventGoal nesnesi şu öğelere sahiptir: ActionExpression, ActionOperator, CategoryExpression, CategoryOperator, LabelExpression, LabelOperator, Value, ValueOperator.

Öğe Açıklama Veri Türü
ActionExpression İzlemek istediğiniz kullanıcı etkileşiminin türü. Örneğin ,'oynat' veya 'duraklat'.

Bu öğe bir ekleme veya güncelleştirme işlemi sırasında belirtilirse , ActionOperator öğesi de gereklidir.

Dize en fazla 100 uzunluğunu aşamaz.

Ekle: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Şu olay işleci çiftlerinden birini veya birkaçını eklemeniz gerekir: (ActionOperator ve ActionExpression), (CategoryOperator ve CategoryExpression), (LabelOperator ve LabelExpression), (ValueOperator ve Value).
Güncelleştirme: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Güncelleştirme sırasında ActionOperator ve ActionExpression eklemezseniz, mevcut Tüm ActionOperator ve ActionExpression ayarları silinir.		 Dize
ActionOperator ActionExpression öğesinin değerine uygulanabilen işleç.

Bu öğe bir ekleme veya güncelleştirme işlemi sırasında belirtilirse , ActionExpression öğesi de gereklidir.

Ekle: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Şu olay işleci çiftlerinden birini veya birkaçını eklemeniz gerekir: (ActionOperator ve ActionExpression), (CategoryOperator ve CategoryExpression), (LabelOperator ve LabelExpression), (ValueOperator ve Value).
Güncelleştirme: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Güncelleştirme sırasında ActionOperator ve ActionExpression eklemezseniz, mevcut Tüm ActionOperator ve ActionExpression ayarları silinir.		 ExpressionOperator
CategoryExpression İzlemek istediğiniz olay kategorisi. Örneğin, 'video'.

Bu öğe bir ekleme veya güncelleştirme işlemi sırasında belirtilirse CategoryOperator öğesi de gereklidir.

Dize en fazla 100 uzunluğunu aşamaz.

Ekle: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Şu olay işleci çiftlerinden birini veya birkaçını eklemeniz gerekir: (ActionOperator ve ActionExpression), (CategoryOperator ve CategoryExpression), (LabelOperator ve LabelExpression), (ValueOperator ve Value).
Güncelleştirme: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Güncelleştirme sırasında CategoryOperator ve CategoryExpression eklemezseniz, mevcut CategoryOperator ve CategoryExpression ayarları silinir.		 Dize
CategoryOperator CategoryExpression öğesinin değerine uygulanabilen işleç.

Ekle: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Şu olay işleci çiftlerinden birini veya birkaçını eklemeniz gerekir: (ActionOperator ve ActionExpression), (CategoryOperator ve CategoryExpression), (LabelOperator ve LabelExpression), (ValueOperator ve Value).
Güncelleştirme: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Güncelleştirme sırasında CategoryOperator ve CategoryExpression eklemezseniz, mevcut CategoryOperator ve CategoryExpression ayarları silinir.		 ExpressionOperator
Labelexpression Eyleme neden olan öğenin adı. Örneğin ,'römork' veya 'behindthescenes'.

Bu öğe bir ekleme veya güncelleştirme işlemi sırasında belirtilirse LabelOperator öğesi de gereklidir.

Dize en fazla 100 uzunluğunu aşamaz.

Ekle: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Şu olay işleci çiftlerinden birini veya birkaçını eklemeniz gerekir: (ActionOperator ve ActionExpression), (CategoryOperator ve CategoryExpression), (LabelOperator ve LabelExpression), (ValueOperator ve Value).
Güncelleştirme: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Güncelleştirme sırasında LabelOperator ve LabelExpression eklemezseniz, mevcut LabelOperator ve LabelExpression ayarları silinir.		 Dize
LabelOperator LabelExpression öğesinin değerine uygulanabilen işleç.

Ekle: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Şu olay işleci çiftlerinden birini veya birkaçını eklemeniz gerekir: (ActionOperator ve ActionExpression), (CategoryOperator ve CategoryExpression), (LabelOperator ve LabelExpression), (ValueOperator ve Value).
Güncelleştirme: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Güncelleştirme sırasında LabelOperator ve LabelExpression eklemezseniz, mevcut LabelOperator ve LabelExpression ayarları silinir.		 ExpressionOperator
Değer Bu olayla ilişkili sayısal bir değer. Örneğin, değer videonun oynatılma süresi olabilir.

Bu öğe bir ekleme veya güncelleştirme işlemi sırasında belirtilirse ValueOperator öğesi de gereklidir.

Ekle: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Şu olay işleci çiftlerinden birini veya birkaçını eklemeniz gerekir: (ActionOperator ve ActionExpression), (CategoryOperator ve CategoryExpression), (LabelOperator ve LabelExpression), (ValueOperator ve Value).
Güncelleştirme: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Güncelleştirme sırasında ValueOperator ve Value eklemezseniz, mevcut ValueOperator ve Value ayarları silinir		 On -da -lık
ValueOperator Value öğesinin değerine uygulanabilen işleç.

Ekle: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Şu olay işleci çiftlerinden birini veya birkaçını eklemeniz gerekir: (ActionOperator ve ActionExpression), (CategoryOperator ve CategoryExpression), (LabelOperator ve LabelExpression), (ValueOperator ve Value).
Güncelleştirme: Diğer olaylardan birini veya daha fazlasını eklerseniz isteğe bağlı; Güncelleştirme sırasında ValueOperator ve Value eklemezseniz, mevcut ValueOperator ve Value ayarları silinir.		 ValueOperator

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

Devralınan Öğeler

ConversionGoal'dan Devralınan Öğeler

EventGoal nesnesi ConversionGoal nesnesinden türetilir ve şu öğeleri devralır: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes. Aşağıdaki açıklamalar EventGoal'a özeldir ve Aynı öğeleri ConversionGoal nesnesinden devralan diğer nesneler için geçerli olmayabilir.

Öğe Açıklama Veri Türü
AttributionModelType Dönüştürme hedefiyle hangi ilişkilendirme modelinin ( LastTouch veya LastClick) kullanıldığını belirler. 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).

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 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, RevenuePerConversionve Revenue rapor sütunlarından Conversionsdış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 AllConversionsbağımsız olarak , AllConversionRate, , AllCostPerConversion, AllReturnOnAdSpend, AllRevenuePerConversionve 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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 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 farklılık gösterir. Olay hedefleri AddToCart, BeginCheckout, BookAppointment, Contact, GetDirections, Other, OutboundClick, PageView, Purchase, RequestQuote, Signup, SubmitLeadForm ve Subscribe kategorilerini destekler.

Ekle: Haziran 2021 itibariyle gereklidir. Daha önce bu öğeyi sıfır veya boş bıraktıysanız varsayılan kategori Yok olarak ayarlanmıştı.
Güncelleştirme: Dönüştürme hedefi zaten Hiçbiri dışında bir kategori kümesine sahipse isteğe bağlıdır. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.		 ConversionGoalCategory
Kimlik Dönüştürme hedefi için benzersiz Microsoft Advertising tanımlayıcısı.

Ekle: Salt okunur
Güncelleştirme: Gerekli ve Read-Only		 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=trueiç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.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı		 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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 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. Belirtilmezse kapsam varsayılan olarak Müşteri olarak ayarlanır.

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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 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.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı		 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.

Ekle: Salt okunur
Güncelleştirme: Salt okunur		 ConversionGoalTrackingStatus
Tür Dönüştürme hedefinin türü. Bir olay hedefi aldığınızda bu değer Olay'dır . Dönüştürme hedefi türleri hakkında daha fazla bilgi için bkz . ConversionGoal Veri Nesnesi Açıklamaları.

Ekle: Salt okunur
Güncelleştirme: Salt okunur		 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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 Int

Gereksinimler

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