Aracılığıyla paylaş

OfflineConversion Veri Nesnesi - Kampanya Yönetimi

  • Makale

Microsoft Advertising'e gönderdiğiniz çevrimdışı dönüştürmeyi tanımlar.

Çevrimdışı dönüştürme izlemeyi ayarlamak için bir OfflineConversionGoal oluşturun. OfflineConversionGoal'ınCountType değerini Tümü olarak ayarlarsanız, aynı MicrosoftClickId için farklı dönüştürme sürelerine sahip tüm çevrimdışı dönüştürmeler toplu olarak eklenir. OfflineConversionGoal'ınCountType değerini Benzersiz olarak ayarlarsanız, yalnızca reklam tıklaması sonrasında gerçekleşen ilk dönüştürme sayılır. Aynı MicrosoftClickId ve ConversionTime ile yinelenen çevrimdışı dönüştürmeler yoksayılır. Başka bir deyişle, belirli bir MicrosoftClickId ve ConversionTime için yalnızca ilk çevrimdışı dönüştürme sayılır.

Önemli

OfflineConversionGoal ayarlandıktan sonra iki saat bekleyin ve ardından ApplyOfflineConversions işlemi aracılığıyla Microsoft Advertising the OfflineConversion verilerini gönderin. Microsoft Advertising raporlamasında dönüştürme verilerinin görüntülenmesi altı saate kadar sürebilir.

Not

İşlevsel test için çevrimdışı dönüştürmeleri korumalı alana yükleyebilmenize rağmen, çevrimdışı dönüştürme verileri korumalı alan performans raporlama verilerinde ilişkilendirilmeyecektir.

Sözdizimi

<xs:complexType name="OfflineConversion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ConversionCurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="ConversionValue" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionCredit" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionModel" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="HashedEmailAddress" nillable="true" type="xs:string">
      <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="HashedPhoneNumber" nillable="true" type="xs:string">
      <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="MicrosoftClickId" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Öğe

OfflineConversion nesnesi şu öğelere sahiptir: ConversionCurrencyCode, ConversionName, ConversionTime, ConversionValue, ExternalAttributionCredit, ExternalAttributionModel, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

Öğe Açıklama Veri Türü
ConversionCurrencyCode Çevrimdışı dönüştürme için para birimi kodu.

Daha fazla bilgi için bkz. Para Birimleri.

Uygulamak: Isteğe bağlı. Çevrimdışı dönüştürme para birimi kodu belirtmezseniz hedefin ConversionGoalRevenue öğesinin CurrencyCode öğesi kullanılır.		 Dize
ConversionName Dönüştürme hedefi adı.

Bu ad mevcut bir dönüştürme hedefi adıyla eşleşmelidir, aksi takdirde çevrimdışı dönüştürme hedefi verileri uygulanmaz.

Uygulamak: Gerekli		 Dize
ConversionTime Çevrimdışı dönüştürmenin gerçekleştiği tarih ve saat.

Tarih ve saat son 90 gün içinde olmalıdır, aksi takdirde Microsoft Advertising'e çevrimdışı dönüştürme verilerini göndermeye çalıştığınızda işlem başarısız olur.

Karşıya yükleme başarılı olduktan sonra Microsoft Advertising tarafından çevrimdışı dönüştürme olarak sayılabilmesi için aşağıdaki ek gereksinimlerin karşılanması gerekir:
- Dönüştürme tarihi ve saati, kaydedilen tıklamanın tarih ve saatinden sonra ayarlanmalıdır.
- Tarih ve saat dönüştürme penceresinde olmalıdır. OfflineConversionGoal'ınConversionWindowInMinutes özelliği, bir tıklamadan sonra dönüştürmelerin izlenecek en uzun süresini dakika cinsinden belirler.

Örneğin, 30 Nisan'da üç tıklama kaydedildiyse, OfflineConversionGoal'ınConversionWindowInMinutes değeri 30 güne (43200 dakika) eşitse ve Microsoft Advertising'e aşağıdaki çevrimdışı dönüştürmeleri 31 Temmuz'da gönderirseniz, Microsoft Advertising yalnızca MicrosoftClickId=2 olan öğeyi çevrimdışı dönüştürme olarak sayar.
- MicrosoftClickId=1; ConversionTime=2020-04-30T17:02:35.6853793Z
- MicrosoftClickId=2; ConversionTime=2020-05-15T17:02:35.6853793Z
- MicrosoftClickId=3; ConversionTime=2020-06-15T17:02:35.6853793Z

MicrosoftClickId=1 ile çevrimdışı dönüştürme verileri, dönüştürme tarihi ve saati 90 günden uzun olduğundan karşıya yüklenmez ve MicrosoftClickId=3 ile çevrimdışı dönüştürme verileri, dönüştürme penceresine girmediğinden (30 Nisan ile 29 Mayıs arasında) sayılmaz.

Önemli: Değer Eşgüdümlü Evrensel Saat (UTC) içinde olmalıdır. Bu, Microsoft Advertising web uygulamasında çevrimdışı dönüşümleri karşıya yüklediğinizde saat dilimi seçeneklerinden farklıdır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.

Uygulamak: Gerekli		 Datetime
ConversionValue Çevrimdışı dönüştürme değeri.

Uygulamak: Isteğe bağlı. Çevrimdışı dönüştürme değeri belirtmezseniz hedefin ConversionGoalRevenuedeğerinin Value öğesi kullanılır.		 Çift
ExternalAttributionCredit Bu alan yalnızca dış ilişkilendirme kullanan dönüştürme eylemleri için ayarlanabilir. Her tıklamayla ilişkilendirilen dönüştürmenin kesirini temsil eder. Değeri 0'dan büyük ve 1'den küçük veya 1'e eşit olmalıdır.

Bu alan harici olarak özniteliklendirilmemiş bir dönüştürme eylemiyle kullanılıyorsa Bir GoalNotEligibleForExternalAttribution hatası döndürülür.

Uygulamak: Isteğe bağlı		 Çift
ExternalAttributionModel Bu alan yalnızca dış ilişkilendirme kullanan dönüştürme eylemleri için ayarlanabilir. İlişkilendirme modeli adını belirtir.

Bu alan harici olarak özniteliklendirilmemiş bir dönüştürme eylemiyle kullanılıyorsa Bir GoalNotEligibleForExternalAttribution hatası döndürülür.

Uygulamak: Isteğe bağlı		 Dize
HashedEmailAddress Gelişmiş dönüştürmelerle kullanılmak üzere SHA-256 algoritmasını kullanan karma e-posta adresi. Dize
HashedPhoneNumber Gelişmiş dönüştürmelerle kullanılmak üzere E.164 standardına göre karma telefon numarası. Dize
MicrosoftClickId Çevrimdışı dönüştürme için MSCLKID.

Microsoft tıklama kimliği izleme için otomatik etiketlemenin etkinleştirildiğinden emin olmak için GetAccountProperties ve SetAccountProperties işlemlerini kullanın.

Uygulamak: Isteğe bağlı

Not: Gelişmiş dönüştürmeler için karma bir e-posta adresi veya telefon numarası sağladığınızda MSCLKID isteğe bağlıdır.		 Dize

Gereksinimler

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

Kullanan

ApplyOfflineConversions