Anket Cevapları

Webhooklar aracılığıyla, anket cevaplarını sunucunuza nasıl alacağınızı öğrenin

Bu webhook hizmeti, satış sitelerinizde anket özelliğini kullandığınızda ankette bulunan soruların yanıtları hakkında size bilgi sağlar. Bu webhook hizmetini etkinleştirdiğinizde, sadece satın alma işlemi tamamlanmış kullanıcıların yanıtları size iletilir. Ancak, satış işlemi tamamlanmamış kullanıcıların cevaplarını da almak isterseniz, webhook alanında bulunan tercih kutucuğunu işaretlemeniz gerekmektedir.

Endpoint URL'inizi Ayarlayın

Webhook bildirimleri sunucunuza HTTP POST aracılığıyla gönderilir. Endpoint URL'sini projenizin altındaki Developer Tools / Webhooks menüsünden yapılandırabilirsiniz.

Varsayılan olarak, webhook bildirimleri yalnızca ödeme yapmış kullanıcıların anket yanıtlarını içerir. Ayrıca, ödeme yapmamış kullanıcılardan gelen anket yanıtlarını da almak üzere yapılandırma yapabilirsiniz.

Webhook Gönderim Kuralları

Anket cevaplarını bildiren webhook bildirimi, ödemeyi tamamlamış kullanıcılar için ilk 5 dakika içinde gönderilir fakat ödeme işlemini tamamlamamış kullanıcılar bu süre 30 dakikadır. . Gönderim işleminin başarılı olarak kabul edilmesi için sisteminizin HTTP 200 durum kodunu dönmesi gerekmektedir. 200 dışındaki herhangi bir durum kodu, gönderim işleminin başarısız olduğu şeklinde değerlendirilir ve şu deneme süreci uygulanır:

• İlk başarısızlık durumunda, bir sonraki deneme 1 saat içinde yapılır.

• Gönderim başarılı olmadığı sürece, bildirim saatte bir olmak üzere en fazla 10 kez gönderilir.

• 10 deneme sonrasında hala başarı sağlanamazsa, bildirim gönderim süreci durdurulur.

Webhook Bildirimlerinin Formatı

Webhook bildirimleri JSON formatında düzenlenir. Sunucunuza gönderilen POST isteğinin içeriği, düzenlenmiş bildirimin bilgilerini içerir.

{
  "client": {
    "subscriberId": "[e-mail]",
    "subscriberName" "name surname",
    "email": "[e-mail]",
    "uuid": "29de05a7-5a6f-4107-b15a-1c8abdefad95",
    "isPayer": 1,
    "platform": "Mac OS",
    "country": "TR",
    "language": "en",
    "utmSource": null,
    "utmMedium": null,
    "utmCampaign": null,
    "utmContent": null,
    "utmTerm": null,
    "paymentModule": "generate",
    "flowId": 600,
    "siteId": 38,
    "ip": 192.168.1.1
  },
  "questions": {
    "5706": {
      "questionId": "question1",
      "questionName": "Question 1",
      "question": "Question Title",
      "settings": "{\"backgroundColor\":\"\",\"forceDesktopBG\":true,\"backgroundImage\":{\"desktop\":\"\",\"tablet\":\"\",\"mobile\":\"\"}}",
      "sequence": 1,
      "displayedSequence": 1,
      "required": 1,
      "isMultiple": 0,
      "typeId": 0,
      "typeName": "SingleSelection",
      "isLogic": false
    },
    "5707": {
      "questionId": "question2",
      "questionName": "Question 2",
      "question": "Question Title",
      "settings": "{\"backgroundColor\":\"\",\"forceDesktopBG\":true,\"backgroundImage\":{\"desktop\":\"\",\"tablet\":\"\",\"mobile\":\"\"}}",
      "sequence": 2,
      "displayedSequence": 2,
      "required": 1,
      "isMultiple": 0,
      "typeId": 2,
      "typeName": "IconBox",
      "isLogic": false
    },
    "5708": {
      "questionId": "question3",
      "questionName": "Question 3",
      "question": "Question Title",
      "settings": "{\"backgroundColor\":\"\",\"forceDesktopBG\":true,\"backgroundImage\":{\"desktop\":\"\",\"tablet\":\"\",\"mobile\":\"\"}}",
      "sequence": 3,
      "displayedSequence": 3,
      "required": 1,
      "isMultiple": 0,
      "typeId": 7,
      "typeName": "SingleLineInput",
      "isLogic": false
    },
    "5710": {
      "questionId": "question5",
      "questionName": "Question 5",
      "question": "Question Title",
      "settings": "{\"backgroundColor\":\"\",\"forceDesktopBG\":true,\"backgroundImage\":{\"desktop\":\"\",\"tablet\":\"\",\"mobile\":\"\"}}",
      "sequence": 5,
      "displayedSequence": 4,
      "required": 1,
      "isMultiple": 0,
      "typeId": 8,
      "typeName": "Location",
      "isLogic": false
    },
    "5711": {
      "questionId": "question6",
      "questionName": "Question 6",
      "question": "Question Title",
      "settings": "{\"backgroundColor\":\"\",\"forceDesktopBG\":true,\"backgroundImage\":{\"desktop\":\"\",\"tablet\":\"\",\"mobile\":\"\"}}",
      "sequence": 6,
      "displayedSequence": 5,
      "required": 1,
      "isMultiple": 0,
      "typeId": 5,
      "typeName": "DateInput",
      "isLogic": false
    },
    "5712": {
      "questionId": "question7",
      "questionName": "Question 7",
      "question": "Question Title",
      "settings": "{\"backgroundColor\":\"\",\"forceDesktopBG\":true,\"backgroundImage\":{\"desktop\":\"\",\"tablet\":\"\",\"mobile\":\"\"}}",
      "sequence": 7,
      "displayedSequence": 6,
      "required": 1,
      "isMultiple": 0,
      "typeId": 6,
      "typeName": "TimeInput",
      "isLogic": false
    },
    "5713": {
      "questionId": "question8",
      "questionName": "Question 8",
      "question": "Question Title",
      "settings": "{\"backgroundColor\":\"\",\"forceDesktopBG\":true,\"backgroundImage\":{\"desktop\":\"\",\"tablet\":\"\",\"mobile\":\"\"}}",
      "sequence": 8,
      "displayedSequence": 7,
      "required": 1,
      "isMultiple": 0,
      "typeId": 10,
      "typeName": "FileUpload",
      "isLogic": false
    }
  },
  "answers": {
    "5706": {
      "answerDate": "2024-01-10 10:47:25",
      "answer": null,
      "answerOptions": [
        {
          "optionId": 8215,
          "name": "Option örnek 1",
          "type": "image",
          "image": ""
        }
      ]
    },
    "5707": {
      "answerDate": "2024-01-10 10:47:25",
      "answer": null,
      "answerOptions": [
        {
          "optionId": 8218,
          "name": "Option örnek 4",
          "type": "image",
          "image": ""
        }
      ]
    },
    "5708": {
      "answerDate": "2024-01-10 10:47:29",
      "answer": "UserTest"
    },
    "5710": {
      "answerDate": "2024-01-10 10:47:34",
      "answer": {
        "value": "Turkey",
        "mainValue": "Türkiye",
        "id": 1,
        "type": "local-country",
        "longitude": "34.9249653",
        "latitude": "38.9597594"
      }
    },
    "5711": {
      "answerDate": "2024-01-10 10:47:36",
      "answer": "03-01-2024"
    },
    "5712": {
      "answerDate": "2024-01-10 10:47:39",
      "answer": "13:47"
    },
    "5713": {
      "answerDate": "2024-01-10 10:47:50",
      "answer": "[\"https://zotlo-3api-assets.mobylonia.com/3p-images/site_media/2024/01/10/66184374-874e-43f0-9713-f97.png\"]"
    }
  }
}

Parametreler

client.subscriberId	Satın alma işlemi yapan kullanıcı bilgisidir. E-posta ya da telefon numarası olabilir.
client.subscriberName	Kayıt işlemi yapan kullanıcının isim ve soyisim bilgisidir.
client.email	Satın alma işlemi yapan kullanıcının mail bilgisidir.
client.uuid	Kullanıcıya ait benzersiz bir bilgidir.
client.isPayer	Kullanıcının satın alma işlemini tamamlayıp tamamlanmadığını gösterir. Bu alan 1 ve 0 değerlerini alabilir. Eğer 1 ise satın alma işlemi tamamlanmış, eğer 0 ise satın alma işlemi tamamlanmamış kullanıcıyı ifade eder.
client.platform	Kullanıcının hangi işletim sisteminden işlem yaptığını belirtir.
client.country	Kullanıcının işlem yaptığı ülke bilgisidir.
client.language	Kullanıcının işlem yaptığı dil bilgisidir.
client.utmSource	Eğer varsa UTM parametrelerini gösterir.
client.utmCampaign	Eğer varsa UTM parametrelerini gösterir.
client.utmContent	Eğer varsa UTM parametrelerini gösterir.
client.utmTerm	Eğer varsa UTM parametrelerini gösterir.
client.paymentModule	İşlemin hangi module ait olduğunu belirtir. Zotlo Self Service tarafı için generate değerini, Store tarafı için ise store değerini alır.
client.flowId	Satış yapılan siteye bağlı akış'ın Zotlo'daki id bilgisidir.
client.siteId	Satış yapılan sitenin Zotlo'daki id bilgisidir.
client.ip	Kullanıcının ip bilgisidir.
questions	Ankette yer alan sorulara ait bilgilerdir.
questions.questionId	Sorunun id bilgisidir.
questions.questionName	Sorunun isim bilgisidir.
questions.question	Soru başlığıdır.
questions.sequence	Soru sırasıdır.
questions.displayedSequence	Sorunun hangi sırada görüntülendiği bilgisidir.
questions.required	Soru cevabının zorunlu olup olmadığını belirtir.
questions.isMultiple	Soru cevabının çoklu olabileceği anlamına gelir.
questions.typeId	Soru tipinin id bilgisidir. Aşağıdaki değerleri alabilir. 0 : Multiple choice 2 : Image chooser 4 : Info page 5 : Date 6 : Time 7 : Single row text 8 : Location 9 : Ending page 10 : file upload
questions.typeName	Soru tipinin isim bilgisidir.
questions.isLogic	Soruya ait bir logic eklenip eklenmediğini belirtir. False ve true değerlerini alabilir.
answers	Ankette yanıtlanan cevaplara ait bilgilerdir. Eğer çoklu dil desteği var ise, cevaplar kullanıcının yanıtladığı dilde gönderilir.
answers.answerDate	Cevaplanma tarihidir.
answers.answer	Soruya verilen cevaplardır.
answers.answerOptions.optionId	Cevabın id bilgisidir.Çoktan seçmeli sorularda bulunur.
answers.answerOptions.name	Cevap metnidir. Çoktan seçmeli sorularda bulunur.
answers.answerOptions.optionId	Soruya verilen cevaplardır.
answers.answerOptions.type	Sorunun cevap tipidir. ımage ya da text değerlerini alabilir.
answers.answerOptions.image	Cevaba ait görsel bilgisidir.