Member Web Service

POST

Service URL	member.asmx

Member web servisini kullanarak, üye listesine yeni üye ekleme, varolan üyeleri güncelleme, üyeleri sorgulama, üyenin dahil olduğu listeleri çekme gibi işlemler uygulayabilirsiniz.

Member web servisine ait aşağıda ki metodlar bulunmaktadır.

Metod	Açıklama
AddToAllLists	Add the member defined by Key and Value pairs to all Interest Lists.
AddToSendLists	Add the member defined by Key and Value pairs to Interest Lists.
InsertMemberDemography	Insert/Update the member’s demographic information. The member is defined by Key and Value pair.
QueryCampaignsBetweenDates	Fetches the campaigns and results for the specified member between specific dates.
QueryMemberDemography	Query the member’s demographic information. The member is defined by Key and Value pair.
QueryMemberID	Query 32-char ID of a member based on Key and Value pair.
QuerySendLists	Query the member’s send lists. The member is defined by Key and Value pair.
RemoveFromSendLists	Removes the member from Interest Lists. The member is defined by Key and Value pair.
SendOngoingEMail	Insert/Update the member’s demographic information and Sends and Ongoing E-Mail template to the Client. The member is defined by Key and Value pair.
SendOngoingSms	Insert/Update the member’s demographic information and Sends and Ongoing Sms template to the Client. The member is defined by Key and Value pair.
UpdateMemberDemography	Insert/Update the member’s demographic information. The member is defined by Key and Value pair.

Geliştiricinin her hangi bir web servis ile etkileşime geçebilmesi için, öncelikle Login metodunu kullanarak bir SERVICE TICKET alması gerekir. Diğer web servis ve metodlarına yaratmış olduğu bu değer ile istekte bulunabilir.

AddToAllLists

`<AddToAllLists>`
Belli bir kullanıcıyı tüm listelere ekler.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	ZORUNLU
Key	EMAIL, MEMBER_ID veya Related Marketing Cloud yönetim panelinde tanımlanmış, dilediğiniz her hangi bir alan adı.	ZORUNLU
Value	`Key` alanında belirtilen alan adının değeri.	ZORUNLU

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <AddToAllLists xmlns="http://ws.euromsg.com/member">
            <ServiceTicket>string</ServiceTicket>
            <Key>string</Key>
            <Value>string</Value>
        </AddToAllLists>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <AddToAllListsResponse xmlns="http://ws.euromsg.com/member">
            <AddToAllListsResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
            </AddToAllListsResult>
        </AddToAllListsResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner.

Hata Parametreleri

Code	Message	DetailedMessage	Açıklama
9998	No session. Please try re-logon.		`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	No such member!		Kullanıcı sistemde bulunmuyor.

AddToSendLists

<AddToSendLists>
Belli bir kullanıcıyı belirtilen listelere ekler.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	ZORUNLU
Key	EMAIL, MEMBER_ID veya Related Marketing Cloud yönetim panelinde tanımlanmış, dilediğiniz her hangi bir alan adı.	ZORUNLU
Value	`Key` alanında belirtilen alan adının değeri.	ZORUNLU
SendLists	`EmSendList` dizisi ile birden fazla liste belirtilebilir.	ZORUNLU
Move	`true` gönderilmesi durumunda, `SendLists` dizisinde yer almayan listelerden çıkarır.	ZORUNLU

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <AddToSendLists xmlns="http://ws.euromsg.com/member">
            <ServiceTicket>string</ServiceTicket>
            <Key>string</Key>
            <Value>string</Value>
            <SendLists>
                <EmSendList>
                    <ListName>string</ListName>
                    <GroupName>string</GroupName>
                </EmSendList>
                <EmSendList>
                    <ListName>string</ListName>
                    <GroupName>string</GroupName>
                </EmSendList>
            </SendLists>
            <Move>boolean</Move>
        </AddToSendLists>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <AddToSendListsResponse xmlns="http://ws.euromsg.com/member">
            <AddToSendListsResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
            </AddToSendListsResult>
        </AddToSendListsResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner.

Hata Parametreleri

Code	Message	DetailedMessage	Açıklama
9998	No session. Please try re-logon.		`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	The list or lists you provided are not valid!		Belirtilen liste bulunamadı.

InsertMemberDemography

`<InsertMemberDemography>`
Yeni üyeyi, demografik bilgileri ile ekler.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	ZORUNLU
Key	EMAIL, MEMBER_ID veya Related Marketing Cloud yönetim panelinde tanımlanmış, dilediğiniz her hangi bir alan adı.	ZORUNLU
Value	`Key` alanında belirtilen alan adının değeri.	ZORUNLU
DemograficData	`EmKeyValue` dizisi ile üyeye ait alanlar belirlenir.	ZORUNLU
ForceUpdate	Üye sistemde var ise, `true` değeri gönderilmesi durumunda, varolan üye güncellenir.	ZORUNLU

Ad, Soyad gibi alanlar Related Marketing Cloud platformu üzerinden ayarlanır.

Statik Alanlar

Alan Adı	Açıklama
EMAIL	Email adresi
STATUS	Üye durumu. A : Aktif, P : Pasif
EMAIL_PERMIT	Email izin durumu. Y : Evet, N : Hayır
GSM_PERMIT	SMS izin durumu. Y : Evet, N : Hayır
FAX_PERMIT	FAX izin durumu. Y : Evet, N : Hayır
CALL_PERMIT	Call Center izin durumu. Y : Evet, N : Hayır
PRINT_PERMIT	Print izin durumu. Y : Evet, N : Hayır
REFERRAL	Referans adresi
REFERRAL_DOMAIN	Referans domain

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <InsertMemberDemography xmlns="http://ws.euromsg.com/member">
            <ServiceTicket>string</ServiceTicket>
            <Key>string</Key>
            <Value>string</Value>
            <DemograficData>
                <EmKeyValue>
                    <Key>string</Key>
                    <Value>string</Value>
                </EmKeyValue>
                <EmKeyValue>
                    <Key>string</Key>
                    <Value>string</Value>
                </EmKeyValue>
            </DemograficData>
            <ForceUpdate>boolean</ForceUpdate>
        </InsertMemberDemography>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <InsertMemberDemographyResponse xmlns="http://ws.euromsg.com/member">
            <InsertMemberDemographyResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
            </InsertMemberDemographyResult>
            <MemberID>B04314B832A549A3B92A11153D1F7BA9</MemberID>
        </InsertMemberDemographyResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner. Buna ek olarak yeni eklenen veya güncellenen üyenin MEMBERID alanı döner.

Hata Parametreleri

Code	Message	DetailedMessage	Açıklama
9998	No session. Please try re-logon.		`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	Member already exists. No insertion will be done!		`ForceUpdate` false ise ve kullanıcı sistemde yer alıyorsa alınan hatadır.

QueryCampaignsBetweenDates

`<QueryCampaignsBetweenDates>`
Üyenin belirtilen tarih aralığında aldığı kampanya bilgilerini gösterir.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	ZORUNLU
Key	EMAIL, MEMBER_ID veya Related Marketing Cloud yönetim panelinde tanımlanmış, dilediğiniz her hangi bir alan adı.	ZORUNLU
Value	`Key` alanında belirtilen alan adının değeri.	ZORUNLU
BeginDate	Başlangıç Tarihi. yyyy-MM-dd HH:mm:ss veya yyyyMMdd HH:mm:ss	ZORUNLU
EndDate	Bitiş Tarihi. yyyy-MM-dd HH:mm:ss veya yyyyMMdd HH:mm:ss	ZORUNLU

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <QueryCampaignsBetweenDates xmlns="http://ws.euromsg.com/member">
            <ServiceTicket>string</ServiceTicket>
            <Key>string</Key>
            <Value>string</Value>
            <BeginDate>string</BeginDate>
            <EndDate>string</EndDate>
        </QueryCampaignsBetweenDates>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <QueryCampaignsBetweenDatesResponse
            xmlns="http://ws.euromsg.com/member">
            <QueryCampaignsBetweenDatesResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
            </QueryCampaignsBetweenDatesResult>
            <CampaignResults>
                <EmCampaignResult>
                    <CampaignId>string</CampaignId>
                    <CampaignName>string</CampaignName>
                    <DeliveryStatus>string</DeliveryStatus>
                    <DeliveryDate>string</DeliveryDate>
                    <ChannelAddress>string</ChannelAddress>
                    <ChannelType>string</ChannelType>
                    <SentTime>string</SentTime>
                    <Subject>string</Subject>
                    <CampaignMessage>string</CampaignMessage>
                </EmCampaignResult>
                <EmCampaignResult>
                    <CampaignId>string</CampaignId>
                    <CampaignName>string</CampaignName>
                    <DeliveryStatus>string</DeliveryStatus>
                    <DeliveryDate>string</DeliveryDate>
                    <ChannelAddress>string</ChannelAddress>
                    <ChannelType>string</ChannelType>
                    <SentTime>string</SentTime>
                    <Subject>string</Subject>
                    <CampaignMessage>string</CampaignMessage>
                </EmCampaignResult>
            </CampaignResults>
        </QueryCampaignsBetweenDatesResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner.

Delivery Status	RD : Read, HU : hard-undelivered, SU : Soft Undelivered	EMAIL
Delivery Status	Relayed To Operator, Relayed To Gsm, Delivered, Error_Message, Unexpected Error	SMS

Hata Parametreleri

Code	Message	DetailedMessage	Açıklama
9998	No session. Please try re-logon.		`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	Not a valid Date!		Belirtilen tarih formatı geçersiz.

QueryMemberId

<QueryMemberID>
Belli bir üyeye ait 32 karakterlik ID’yi döndürür.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	ZORUNLU
Key	EMAIL, MEMBER_ID veya Related Marketing Cloud yönetim panelinde tanımlanmış, dilediğiniz her hangi bir alan adı.	ZORUNLU
Value	`Key` alanında belirtilen alan adının değeri.	ZORUNLU

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <QueryMemberID xmlns="http://ws.euromsg.com/member">
            <ServiceTicket>string</ServiceTicket>
            <Key>string</Key>
            <Value>string</Value>
        </QueryMemberID>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <QueryMemberIDResponse xmlns="http://ws.euromsg.com/member">
            <QueryMemberIDResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
            </QueryMemberIDResult>
            <MemberID>D67C7F1655E34F3B8B1DA9BD55C8F4C8</MemberID>
        </QueryMemberIDResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner. Buna ek olarak yeni eklenen veya güncellenen üyenin MEMBERID alanı döner.

Hata Parametreleri

Code	Message	DetailedMessage	Açıklama
9998	No session. Please try re-logon.		`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	No such member!		Key parametresinde gönderilen değere göre bir kayıt mevcut değil.

QuerySendLists

`<QuerySendLists>`
Belli bir üyenin bulunduğu listeleri gösterir.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	ZORUNLU
Key	EMAIL, MEMBER_ID veya Related Marketing Cloud yönetim panelinde tanımlanmış, dilediğiniz her hangi bir alan adı.	ZORUNLU
Value	`Key` alanında belirtilen alan adının değeri.	ZORUNLU

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <QuerySendLists xmlns="http://ws.euromsg.com/member">
            <ServiceTicket>string</ServiceTicket>
            <Key>string</Key>
            <Value>string</Value>
        </QuerySendLists>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <QuerySendListsResponse
            xmlns="http://ws.euromsg.com/member">
            <QuerySendListsResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
            </QuerySendListsResult>
            <Lists>
                <EmSendList>
                    <ListName>E-Bülten</ListName>
                    <GroupName>Genel</GroupName>
                </EmSendList>
                <EmSendList>
                    <ListName>Test Grubu</ListName>
                    <GroupName>Genel</GroupName>
                </EmSendList>
                <EmSendList>
                    <ListName>HelloList</ListName>
                    <GroupName>Genel</GroupName>
                </EmSendList>
            </Lists>
        </QuerySendListsResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner.

Hata Parametreleri

Code	Message	DetailedMessage	Açıklama
9998	No session. Please try re-logon.		`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	No such member!		Belirtilen tarih formatı geçersiz.

RemoveFromSendLists

<RemoveFromSendLists>
Belli bir üyeyi belli bir listeden çıkartır.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	ZORUNLU
Key	EMAIL, MEMBER_ID veya Related Marketing Cloud yönetim panelinde tanımlanmış, dilediğiniz her hangi bir alan adı.	ZORUNLU
Value	`Key` alanında belirtilen alan adının değeri.	ZORUNLU
SendLists	Üyenin çıkarılacağı liste adları.	ZORUNLU
DeleteIfInNoList	`true` gönderildiği taktirde, üyeyi belirtilen listeden çıkardıktan sonra, üye her hangi bir listede bulunmuyorsa, tamamen veritabanından silinir.!	ZORUNLU

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <RemoveFromSendLists xmlns="http://ws.euromsg.com/member">
            <ServiceTicket>string</ServiceTicket>
            <Key>string</Key>
            <Value>string</Value>
            <SendLists>
                <EmSendList>
                    <ListName>string</ListName>
                    <GroupName>string</GroupName>
                </EmSendList>
                <EmSendList>
                    <ListName>string</ListName>
                    <GroupName>string</GroupName>
                </EmSendList>
            </SendLists>
            <DeleteIfInNoList>boolean</DeleteIfInNoList>
        </RemoveFromSendLists>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <RemoveFromSendListsResponse
            xmlns="http://ws.euromsg.com/member">
            <RemoveFromSendListsResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
            </RemoveFromSendListsResult>
        </RemoveFromSendListsResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner.

Hata Parametreleri

Code	Message	Açıklama
9998	No session. Please try re-logon.	`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	No such member!	Belirtilen tarih formatı geçersiz.
99	The list or lists you provided are not valid!	Geçersiz liste adı.

SendOngoingEmail

<SendOngoingEMail>
Üye’nin demografik bilgilerini günceller, sistemde yer almıyorsa ekler ve sonunda bir email kampanyası tetikler.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	ZORUNLU
Key	EMAIL, MEMBER_ID veya Related Marketing Cloud yönetim panelinde tanımlanmış, dilediğiniz her hangi bir alan adı.	ZORUNLU
Value	`Key` alanında belirtilen alan adının değeri.	ZORUNLU
DemograficData	`EmKeyValue` dizisi ile üyeye ait alanlar belirlenir.	ZORUNLU
ForceUpdate	Üye sistemde var ise, `true` değeri gönderilmesi durumunda, varolan üye güncellenir.	ZORUNLU
OngoingCampaignId	Üyeye gönderilecek olan kampanya ID’si.	ZORUNLU

Ad, Soyad gibi alanlar Related Marketing Cloud platformu üzerinden ayarlanır.

Statik Alanlar

Alan Adı	Açıklama
EMAIL	Email adresi
STATUS	Üye durumu. A : Aktif, P : Pasif
EMAIL_PERMIT	Email izin durumu. Y : Evet, N : Hayır
GSM_PERMIT	SMS izin durumu. Y : Evet, N : Hayır
FAX_PERMIT	FAX izin durumu. Y : Evet, N : Hayır
CALL_PERMIT	Call Center izin durumu. Y : Evet, N : Hayır
PRINT_PERMIT	Print izin durumu. Y : Evet, N : Hayır
REFERRAL	Referans adresi
REFERRAL_DOMAIN	Referans domain