Yeni Dönüşüm Ekle

Yüklenen verileri ne kadar kısa sürede kullanabilirim?

Bir Bir dönüşüm için bugünün veya dünün conversionTimestamp kadarı, dönüşümü, yükleme işleminden sonraki bir saat içinde Search Ads 360 kullanıcı arayüzünde görünür. Şu durumda: dünden daha eski bir conversionTimestamp belirtirseniz metrikler şu süre içinde güncellenir: birkaç saat.

Dönüşümlerin tüm zaman damgalarını Dönem zamanı'na (Unix saati olarak da bilinir) dönüştürün.

API'den Floodlight etkinlikleri oluşturabilir miyim?

Reklamveren henüz çevrimdışı dönüşümleri izlemek için bir Floodlight etkinliği oluşturmadıysa şunu yapabilirsiniz: oluşturmak için Campaign Manager API'sini kullanmanız gerekir. API'yi kullanarak bir Floodlight etkinliğinin öncelikli olarak çevrimdışı dönüşümler için kullanıldığını ne zaman teklif stratejilerinin dönüşümden elde edilen verileri kullanacağı ile ilgili alıştırma yapmak.

Daha sonra, API'yi kullanarak bir Floodlight etkinliğinde bir Search Ads 360 kullanıcısı, Search Ads 360'ta oturum açar ve etkinliğin Bu ayar, bir müşterinin birincil kaynağının çevrimdışı etkinlik olduğunu unutmayın.

Dönüşüm eklemeye yönelik en iyi uygulamalar

Dönüşüm eklemek için aşağıdaki en iyi uygulamaları öneririz:

1. Bir Search Ads 360 kullanıcısından Search Ads 360'ta oturum açmasını ve ayarları değiştirmesini isteyin çevrimdışı dönüşümleri raporlamak için kullandığınız her Floodlight etkinliği için otomatik olarak oluşturulur. Ayarlarda Bu, birincil dönüşüm kaynağının çevrimdışı etkinlik olduğunu gösterir. Bkz. Search Ads 360 Yardım Merkezi başlıklı bölüme bakın.

2. Dönüşümleri kullanılabilir olur olmaz yükleyin. Değerli bir kullanıcıysanız dönüşümleri belirli ziyaretlerle ilişkilendirdiyseniz, ilişkilendirme işleminden sonra en az 30 dakika bekleyin. dönüşümü yüklemeden önceki ziyareti. Search Ads 360, aşağıdaki durumlarda ziyaretin tıklama kimliğini tanımayabilir ziyaretten sonraki 30 dakika içinde yüklediğinizden emin olun. Nadir durumlarda, Search Ads 360'ın clickId değerini tanıması 4 saati bulabilir.

   Her yüklemenin en yeni dönüşümleri içerdiğinden emin olun. Tek bir yükleme isteğinde bulunsa da girişlerin kronolojik sıra dışında olması sorun yaratmaz. Ancak teklif stratejisi farklı bir istekte daha sonra yükleyeceğiniz daha eski dönüşümleri dikkate alamaz.

3. Bir Floodlight etkinliğine ilişkin dönüşümleri yüklemeden önce 24 saatten fazla beklerseniz bir müsaitlik durumuna ilişkin zaman damgası hakkında daha fazla bilgi edinin.

   Kullanılabilirlik zaman damgası aşağıdakilerden biri olmalıdır:

   • Son 24 saat içinde dönüşüm kaydettiyseniz ancak yüklemediyseniz zaman damgası, yüklenen son dönüşümün zamanı olmalıdır. meydana geldi. Bu, Search Ads 360'a dönüşümlerin gerçekleşmiş olabileceğini bildirir son 24 saat içinde gösteriliyor ancak henüz veri sağlamamışsınız. Teklif stratejileri ve diğer otomatik sistemler, performans geçmişini yalnızca son dönüşüm elde edersiniz.
   • Son 24 saat içinde hiçbir dönüşüm gerçekleşmediyse zaman damgası geçerli saat ve tarihe bakın. Bu şekilde Search Ads 360, son 24 saat içinde dönüşüm gerçekleşti. Teklif stratejileri ve diğer otomatik sistemleriniz son 24 saati (dönüşüm içermeyen bir tam gün) performans geçmişi kapsamına girer.

Ekleme isteği gönder

Aşağıdakilerden herhangi birini yapmak için bir Conversion.insert() isteği gönderebilirsiniz:

• Dönüşümü belirli bir ziyaretle ilişkilendirme
• Dönüşümü yalnızca bir anahtar kelimeyle ilişkilendirme

Conversion.insert() isteğinde zorunlu olan alanlar aşağıdakilere göre değişir: etkinliği veya öğeyi seçin. Aşağıdaki bölümlerde, ve isteğe bağlı alanları oluşturun.

Dönüşümü belirli bir ziyaretle ilişkilendirme

Bir müşteri bir veya daha fazla reklamı tıklayıp bir reklamverenin sitesine ulaştığında, Search Ads 360, reklamverenin sitesindeki kullanıcı oturumunu ziyaret olarak kabul eder. Bir dönüşümü bir ziyaretle ilişkilendirmek için Conversion.insert() bölümünde aşağıdakileri belirtin. istek:

Zorunlu alanlar

• clickId: Ziyaretin büyük/küçük harfe duyarlı tıklama kimliği. Şuraya bakın: veya dönüşümleri listeleme ya da kullanmak istiyorsanız başka bir dönüşümdeki tıklama kimliği. Search Ads 360 bu dönüşümü dönüşüm izlemeden sorumlu olan anahtar kelime, reklam ve diğer Search Ads 360 ziyaret oluşturmaktır.
  . Sonrasında en az 30 dakika bekleyin Search Ads 360, dönüşümleri yüklemek için bir tıklama kimliği oluşturur. "Tıklama kimliği bulunamadı" mesajını alırsanız hatasını alıyorsanız, 4 saat bekleyin ve tekrar kullanabilirsiniz. Tüm dönüşümler, tıklama kimliği oluşturulur. Aksi takdirde, Search Ads 360 API ziyareti tanımayabilir.
• conversionId: Reklamverenler, çevrimdışı dönüşümler için bu kimliği sağlar. Reklamverenler şunları yapabilir: onlar için anlamlı olan herhangi bir kimliği belirtin. Bir istekteki her dönüşüm benzersiz bir kimlik belirtmelidir. Kimlik ile zaman damgası kombinasyonu, reklamveren içindeki tüm dönüşümler arasında benzersiz olmalıdır. Search Ads 360, online dönüşümler için dsConversionId veya floodlightOrderId değerini kopyalar ekleyebilirsiniz.
• conversionTimestamp: dönüşüm gerçekleşti. Örneğin, dönüşüm, 05 Ağustos 2016 Cuma günü 11:53:22 Doğu Yaz Saati (GMT -4:00) saatinde gerçekleşecek. zaman damgasını Epoch milisaniye cinsinden belirtin: 1470412402000.
• segmentationType: Yüklediğiniz dönüşüm sisteminin türünü belirtir dönüşüm elde edilir. Şu anda yalnızca Floodlight dönüşümleri desteklenmektedir. Bu nedenle, bu alan her zaman FLOODLIGHT değerini belirtmek gerekir.
• segmentationName: Reklamverenin olduğu Floodlight etkinliğinin adı dönüşüm raporlamak için kullanın.

  Reklamvereniniz aynı ada sahip etkinlikler içeriyorsa (bu durum, etkinlikler ait olması durumunda, önerilen işlem etkinliklerden birini yeniden adlandırın.

  Alternatif olarak, Search Ads 360'ın bir Floodlight etkinliğine atadığı kimliği biliyorsanız adısegmentationId segmentationName alanına girin. (Campaign Manager ayrıca Floodlight etkinliğine bir kimlik atar, ancak Campaign Manager kimliği, Search Ads 360 kimliğinden farklıdır ve conversions.) Bir Floodlight etkinliğinin Search Ads 360 kimliğini görüntülemek için ( Search Ads 360 kullanıcı arayüzü veya raporlama API). sırasında Floodlight etkinliğiyle en az bir dönüşüm ilişkilendirilirse raporun zaman aralığını kapsadığında Search Ads 360 kimliğini raporda görürsünüz.

• type: Dönüşümün türü (ACTION) veya TRANSACTION. ACTION dönüşümünün parasal değeri yoktur, ancak TRANSACTION dönüşümüne dahil oluyor. Örnek olarak, e-posta listesine kaydolma (ACTION) ve e-ticaret satın alma işlemleri (TRANSACTION).

  TRANSACTION belirtirseniz aşağıdaki alanı da belirtmeniz gerekir:

  • revenueMicros: Dönüşümün parasal değeri.

İsteğe bağlı alanlar

• quantityMillis: Bu dönüşümdeki öğe sayısı. Örneğin, E-posta bültenine kaydolan kişi sayısı veya satılan toplam ürün miktarı. ACTION dönüşümleri için bu alanı belirtmezseniz Search Ads 360 otomatik olarak bir 1000 değerine ayarlanır.
• currencyCode: Bir işlemin gelirinin para birimidir. Gelir, varsayılan olarak reklamverenin para biriminde olduğu varsayılır. Farklı bir para birimi belirtirseniz Search Ads 360 belirtilen gelir tutarını reklamverenin para birimine dönüştürür. Daha fazla bilgi
  ISO 4217 alfabetik (3 karakterli) kullanın biçimini kullanın.
  . Yalnızca TRANSACTION dönüşümleri için geçerlidir.
• customMetric ve customDimension: Bir satın alınan öğenin gönderildiği ülke, ürün kimlikleri ve hatta bir telefon aramasının süresidir. Daha fazla bilgi: özel kullanıcı verilerini yükleme Floodlight değişkenleri.
• deviceType: Dönüşümün gerçekleştiği cihazın türünü belirtir. Görüntüleyin bunun için kabul edilen değerlerin listesi girin.

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
    "currencyCode": "USD"
  }]
}
          

  /**
   * Instantiate the Doubleclicksearch service, create conversions, and upload them.
   */
  public static void main(String[] args) throws Exception {

    Doubleclicksearch service = getService(); // See Set Up Your Application.

    // Set up a List to keep track of each conversion you create.
    List<Conversion> conversions = new Vector<Conversion>();

    // Add a conversion to the List.
    addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
        "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);

    // Upload the List and handle the response.
    uploadConversions(conversions, service);
  }


  /**
   * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
   * the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
   */
  private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
      String clickId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion().setClickId(clickId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }


  /**
   * Convert the List of conversions to a DS ConversionList, send an insert request to DS,
   * and output the response to a file.
   */
  private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
      throws IOException {

    FileOutputStream outputStream =
        new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
    final PrintStream printStream = new PrintStream(outputStream);

    try {
      // Convert the List to a ConversionList.
      ConversionList conversionList = new ConversionList().setConversion(conversions);

      // Insert an upload request and download the response to a file.
      service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
      printStream.close();
    } catch (GoogleJsonResponseException e) {
      System.err.println("Get request was rejected.");
      for (ErrorInfo error : e.getDetails().getErrors()) {
        System.err.println(error.getMessage());
      }
      System.exit(e.getStatusCode());
    }
  }
            

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a visit.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
              'conversionId': 'test_20140206_00',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

Dönüşümü yalnızca bir anahtar kelimeyle ilişkilendirme

Asıl endişeniz dönüşümleri anahtar kelimelerle ilişkilendirmekse ve yalnızca bir tıklama ile ilişkilendirilirse, özellikle de Search Ads 360'ın tanımlayıcılarını içermelidir ve yalnızca anahtar kelime tanımlayıcısını, başka birkaç alanla birlikte belirtmeniz gerekir:

Zorunlu alanlar

• criterionId: Bu, anahtar kelime tanımlayıcısıdır. TrackerId ekleyerek criterionId alabilirsiniz makrosu ekleyin. Anahtar kelime kimliklerini alma hakkında bilgi için Search Ads 360 kimlikleri ve Dönüşümler.
• conversionId: Reklamverenler, çevrimdışı dönüşümler için bu kimliği sağlar. Reklamverenler şunları yapabilir: onlar için anlamlı olan herhangi bir kimliği belirtin. Bir istekteki her dönüşüm benzersiz bir kimlik belirtmelidir. Kimlik ile zaman damgası kombinasyonu, reklamveren içindeki tüm dönüşümler arasında benzersiz olmalıdır. Search Ads 360, online dönüşümler için dsConversionId veya floodlightOrderId değerini kopyalar ekleyebilirsiniz.
• conversionTimestamp: dönüşüm gerçekleşti. Örneğin, dönüşüm, 05 Ağustos 2016 Cuma günü 11:53:22 Doğu Yaz Saati (GMT -4:00) saatinde gerçekleşecek. zaman damgasını Epoch milisaniye cinsinden belirtin: 1470412402000.
• segmentationType: Yüklediğiniz dönüşüm sisteminin türünü belirtir dönüşüm elde edilir. Şu anda yalnızca Floodlight dönüşümleri desteklenmektedir. Bu nedenle, bu alan her zaman FLOODLIGHT değerini belirtmek gerekir.
• segmentationName: Reklamverenin olduğu Floodlight etkinliğinin adı dönüşüm raporlamak için kullanın.

  Reklamvereniniz aynı ada sahip etkinlikler içeriyorsa (bu durum, etkinlikler ait olması durumunda, önerilen işlem etkinliklerden birini yeniden adlandırın.

  Alternatif olarak, Search Ads 360'ın bir Floodlight etkinliğine atadığı kimliği biliyorsanız adısegmentationId segmentationName alanına girin. (Campaign Manager ayrıca Floodlight etkinliğine bir kimlik atar, ancak Campaign Manager kimliği, Search Ads 360 kimliğinden farklıdır ve conversions.) Bir Floodlight etkinliğinin Search Ads 360 kimliğini görüntülemek için ( Search Ads 360 kullanıcı arayüzü veya raporlama API). sırasında Floodlight etkinliğiyle en az bir dönüşüm ilişkilendirilirse raporun zaman aralığını kapsadığında Search Ads 360 kimliğini raporda görürsünüz.

• type: Dönüşümün türü (ACTION) veya TRANSACTION. ACTION dönüşümünün parasal değeri yoktur, ancak TRANSACTION dönüşümüne dahil oluyor. Örnek olarak, e-posta listesine kaydolma (ACTION) ve e-ticaret satın alma işlemleri (TRANSACTION).

  TRANSACTION belirtirseniz aşağıdaki alanı da belirtmeniz gerekir:

  • revenueMicros: Dönüşümün parasal değeri.

İsteğe bağlı alanlar

• quantityMillis: Bu dönüşümdeki öğe sayısı. Örneğin, E-posta bültenine kaydolan kişi sayısı veya satılan toplam ürün miktarı. ACTION dönüşümleri için bu alanı belirtmezseniz Search Ads 360 otomatik olarak bir 1000 değerine ayarlanır.
• currencyCode: Bir işlemin gelirinin para birimidir. Gelir, varsayılan olarak reklamverenin para biriminde olduğu varsayılır. Farklı bir para birimi belirtirseniz Search Ads 360 belirtilen gelir tutarını reklamverenin para birimine dönüştürür. Daha fazla bilgi
  ISO 4217 alfabetik (3 karakterli) kullanın biçimini kullanın.
  . Yalnızca TRANSACTION dönüşümleri için geçerlidir.
• customMetric ve customDimension: Bir satın alınan öğenin gönderildiği ülke, ürün kimlikleri ve hatta bir telefon aramasının süresidir. Daha fazla bilgi: özel kullanıcı verilerini yükleme Floodlight değişkenleri.
• deviceType: Dönüşümün gerçekleştiği cihazın türünü belirtir. Görüntüleyin bunun için kabul edilen değerlerin listesi girin.

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "criterionId": "43700003491981017", // Replace with your ID
    "conversionId": "customerTransaction73126",
    "conversionTimestamp": "1351196386000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "Offline Purchase",
    "type": "TRANSACTION",
    "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
    "currencyCode": "USD"
  }]
}

  /**
   * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>.
   * The example in the preceding section contains the uploadConversions method,
   * which can submit the list as an insert() request.
   */
  private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions,
      Long criterionId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setCriterionId(criterionId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }        

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a keyword only.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'criterionId': '43700004289911004', // Replace with your ID
              'conversionId': 'test_1378710000000',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

Örnek

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "attributionModel": "External Attribution Model",
    "countMillis": "330",
    "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
    "currencyCode": "USD"
  }]
}
          

requestValidation hataları

requestValidation hataları, dönüşüm yüklemesindeki veri sorunlarını gösterir isteği (ör. dönüşüm zaten yüklenmiş veya clickId bulunamadı). Burada türünde, ayrıntılar mesajı iki öğe içerir:

• Hatanın türünü tanımlayan bir onaltılık kod. Kodu kendi başınıza kullanabilirsiniz komut dosyalarını kullanır.
• Doğrulama hatasının açıklaması.

Daha fazla bilgi için kod listesi ve açıklamaları döndürür.

Diğer hata türleri

Diğer tüm hata türleri (internalError, transactionFailed, veya lateStageRequestError) ifade ederek sistemde dahili bir sorun Search Ads 360

Bir hataya yanıt verme

İstek başarısız olursa istek çağrısının tamamını daha sonra yeniden göndermeyi deneyin. Search Ads 360 olan tüm dönüşümler için requestValidation hatalarını raporla ancak kalan dönüşümleri yüklemeye çalışır.

Yeniden gönderdikten sonra hata görmeye devam ederseniz sorun giderme bölümüne bakın.