logowanie

Rejestracja użytkowników

» Dla właścicieli stron internetowych
Jeszcze nie masz loginu i hasła? Zarejestruj się
Zapomniałeś hasła?
ETARGET XML RPC jest narzędziem dla deweloperów, które ma na celu zautomatyzować standardowe operacje w koncie ETARGET. Dzięki nim wprowadzenie ETARGET do Państwa systemu stanie się łatwiejsze. Wszystkie metody uwzględnione zostały według uwag klientów. Jeśli okaże się, że brakuje pewnych funkcji w palecie narzędzi, prosimy o kontakt. ETARGET XML RPC jest wyłącznie w języku angielskim.

What are ETARGET XML RPC methods?

ETARGET XML RPC methods let developers automate common tasks in their ETARGET account, whether they are using client, agency or partner accounts. With these methods, they can use ETARGET system far more efficiently and manage large or complex amounts of data.

Using XML RPC methods is easy, you don't need to sing up, you don't need no approvals just an active ETARGET account.

Below are examples of methods currently supported by our system, if you would need some other functionality, do let us know and contact us on develop (at) etarget.sk. Also if you need any help or explanation, feel free to ask.

What is XML-RPC?

It's a spec and a set of implementations that allow software running on disparate operating systems, running in different environments to make procedure calls over the Internet. You can develop in any language of your choice. XML RPC interface is supported by all popular programming languages such as PHP, Java, Python, .NET, Perl...It's remote procedure calling using HTTP as the transport and XML as the encoding. XML-RPC is designed to be as simple as possible, while allowing complex data structures to be transmitted, processed and returned.

(show all)
Usage: www.etarget.pl/import/rpc.php?s=XMLRPCstring

Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>addKeywords</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>campaign</name>
            <value>12345</value>
        </param>
        <param>
            <name>keywords</name>
            <value>
                <keyword>
                    <text>nokia</text>                    
                    <price>0.5</price>
                </keyword>
                <keyword>
                    <text>sony</text>
                    <price>0.4</price>
                </keyword>
            </value>
        </param>                               
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
campaignCampaign's ID
keywordsList of keywords and prices
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>addOrEditCampaign</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>id_campaign</name>
            <value>12345</value>
        </param>
        <param>
            <name>image_url</name>
            <value>http://image_url</value>
        </param> 
        <param>
            <name>campaign_name</name>
            <value>some_string</value>
        </param>  
        <param>
            <name>general_network</name>
            <value>1</value>
        </param>          
        <param>
            <name>campaign</name>
            <value>            
                <version>
                    <title>nokia</title>                    
                    <line_1>line 1</line_1>
                    <line_2>line 2</line_2>
                    <real_url>www.real.com</real_url>
                    <shown_url>www.shown.com</shown_url>
                    <version_num>1</version_num>
                    <version_status>active</version_status>
                    <version_img>base64_encode(raw_image_data)</version_img>
                </version>
                <version>
                    <title>nokia</title>                    
                    <line_1>line 1</line_1>
                    <line_2>line 2</line_2>
                    <real_url>www.real.com</real_url>
                    <shown_url>www.shown.com</shown_url>
                    <version_num>2</version_num>
                    <version_status>stop</version_status>
                    <version_img>base64_encode(raw_image_data)</version_img>
                </version>
                <version>
                    <title>nokia</title>                    
                    <line_1>line 1</line_1>
                    <line_2>line 2</line_2>
                    <real_url>www.real.com</real_url>
                    <shown_url>www.shown.com</shown_url>
                    <version_num>3</version_num>
                    <version_status>active</version_status>
                </version>                
            </value>
        </param>         
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
id_campaignCampaign ID, if 0 new campaign will be added.
campaigncampaign data
campaign_name (optional)the name of the campaign
image_url (optional)url of the image (100x60px). Raw image data can be also included in the "campaign" form
general_network (optional)1 ON, 0 OFF. default 1. Enable network of "general" portals (on which ads are not targeted using keywords)
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>addOrEditEshopCampaign</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>id_campaign</name>
            <value>12345</value>
        </param>
        <param>
            <name>campaign_name</name>
            <value>name</value>
        </param>
        <param>
            <name>status</name>
            <value>active</value>
        </param>
        <param>
            <name>title</name>
            <value>nokia e51</value>
        </param>
        <param>
            <name>line_1</name>
            <value>line 1</value>
        </param>
        <param>
            <name>line_2</name>
            <value>line2</value>
        </param>
        <param>
            <name>real_url</name>
            <value>www.real_url.com</value>
        </param>
        <param>
            <name>old_price</name>
            <value>15</value>
        </param>
        <param>
            <name>new_price</name>
            <value>9.99</value>
        </param>
        <param>
            <name>img</name>
            <value>base64_encode(raw_image_data)</value>
        </param>                 
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
id_campaignCampaign ID, if 0 new campaign will be added.
campaign_nameCampaign name
statusCampaign status {active/stop}
titlecampaign title
line_1campaign text line 1
line_2campaign text line 2
real_urlURL
old_priceold price of the product
new_pricenew price of the product
imgimage of the product
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>addOrEditRetargetCode</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>code_name</name>
            <value>my_retargeting_code_name</value>
        </param>
        <param>
            <name>id_campaign</name>
            <value>123456</value>
        </param>
        <param>
            <name>time</name>
            <value>30</value>
        </param>
        <param>
            <name>status</name>
            <value>255</value>
        </param>                   
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
code_name (optional)retargeting code's name
id_campaign (optional)Campaign ID, default all campaigns.
time (optional)retargeting time - 14, 30, 60 or 90 days. default 30
status (optional)set to 255 if you want to delete the retargeting campaign
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>addOrEditRetargetUserCode</methodName>
    <params>
        <param>
            <name>userID</name>
            <value>your_own_track_id</value>
        </param>
        <param>
            <name>customerID</name>
            <value>id_customer</value>
        </param>
        <param>
            <name>campaigns_enable</name>
            <value>12345,6789,9876,54321</value>
        </param>
        <param>
            <name>campaigns_disable</name>
            <value>3456,6543</value>
        </param>
        <param>
            <name>hash</name>
            <value>md5(token.userID.id_customer.campaigns_enable.campaigns_disable)</value>
        </param>                  
    </params>
</methodCall>
userIDyour own tracking value
customerIDid of etarget account
campaigns_enablelist of campaigns'ids to be enabled
campaigns_disablelist of campaigns'ids to be disabled, * for all
hashmd5(token.userID.id_customer.campaigns_enable.campaigns_disable) ; inputs are converted as strings
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>AddOrEditRetargetingAndCampaign</methodName>
    <params>
        <param>
            <name>id</name>
            <value>customer_id</value>
        </param>
        <param>
            <name>trackID</name>
            <value>your_own_tracking_id</value>
        </param>
        <param>
            <name>hash</name>
            <value>md5(customer_token.id.trackID.campaigns_enable*(title.line_1.line_2.shown_url.real_url.image).campaigns_disable*(real_url))</value>
        </param>
        <param>
            <name>campaigns_enable</name>
            <value>
            	<campaign>
            		<title>title of the campaign</title>
            		<line_1>first line</line_1>
            		<line_2>second line</line_2>
            		<shown_url>www.example.com</shown_url>
            		<real_url>www.example.com/test.php?param1=value</real_url>
            		<image>base64_encode(raw_image_data)</image>
            	</campaign>
            	<campaign>
            		<title>title of the campaign</title>
            		<line_1>first line</line_1>
            		<line_2>second line</line_2>
            		<shown_url>www.example.com</shown_url>
            		<real_url>www.example.com/test.php?param2=value</real_url>
            		<image>base64_encode(raw_image_data)</image>
            	</campaign>
            	<campaign>
            		<title>title of the campaign</title>
            		<line_1>first line</line_1>
            		<line_2>second line</line_2>
            		<shown_url>www.example.com</shown_url>
            		<real_url>www.example.com/test.php?param3=value</real_url>
            		<image>base64_encode(raw_image_data)</image>
            	</campaign>
            </value>
        </param>
        <param>
            <name>campaigns_disable</name>
            <value>
            	<campaign>
            		<real_url>www.example.com/test.php?param12=value</real_url>
            	</campaign>
            	<campaign>
            		<real_url>www.example.com/test.php?param13=value</real_url>
            	</campaign>
            </value>
        </param>              
    </params>
</methodCall>
idcustomer id
trackIDyour own tracking value
hashmd5(customer_token.id.trackID.campaigns_enable*(title.line_1.line_2.shown_url.real_url.image).campaigns_disable*(real_url))
campaigns_enablelist of campaigns data to be enabled
campaigns_disablelist of campaigns real urls to be disabled
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>changeCampaignStatus</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>id_campaign</name>
            <value>12345</value>
        </param>
        <param>
            <name>new_status</name>
            <value>activate</value>
        </param>
        <param>
            <name>version</name>
            <value>1</value>
        </param>
        
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
id_campaignCampaign ID
new_status{activate/stop}
version{all/1/2/3}
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>deleteCampaign</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>id_campaign</name>
            <value>12345</value>
        </param>                       
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
id_campaignCampaign ID
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>deleteKeywords</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>keywords</name>
            <value>
                <keyword>nokia</keyword>                    
                <keyword>sony</keyword>
            </value>
        </param>                         
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
keywordsList of keywords separated with ,
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>dynamicCampaigns</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>campaigns</name>
            <value>
                <campaign>
                    <id>1</id>
                    <title>Výrobky #KEYWORD# nájdete na www.my_web.com</title>
                    <description>Širokú ponuku produktov #KEYWORD# nájdete v internetovom obchode www.my_web.com.</description>
                    <url>http://www.my_web.com/product.php?id=#I#</url>
                </campaign>
                <campaign>
                    <id>2</id>
                    <title>Internetový obchod MyWeb.com</title>
                    <description>Široká ponuka všetkého.</description>
                    <url>http://www.my_web.com/product.php?id=#ID#</url>
                </campaign>
            </value>
        </param>
        <param>
            <name>dynamic_keywords</name>
            <value>
                <dynamic_keyword>
                    <keyword>nokia</keyword>
                    <text>Nokia</text>
                    <id>9876</id>
                    <id_campaign>1</id_campaign>
                </dynamic_keyword>
                <dynamic_keyword>
                    <keyword>sony</keyword>
                    <text>Sony Ericsson</text>
                    <id>54321</id>
                    <id_campaign>1</id_campaign>
                </dynamic_keyword>
            </value>
        </param>
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
campaignsList of campaigns
dynamic_keywordsList of dynamic keywords
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
    <methodName>updateCampaign</methodName>
    <params>
        <param>
            <name>login</name>
            <value>my_login</value>
        </param>
        <param>
            <name>password</name>
            <value>my_password</value>
        </param>
        <param>
            <name>id</name>
            <value>12345</value>
        </param>
        <param>
            <name>campaign</name>
            <value>
                <data>
                    <id>export_id_1234</id>
                    <title>Lacne dovolenky</title>
                    <description>Najlacnejsia dovolenka v Chorvatsku len u nas</description>
                    <url>http://www.dovolenka.sk/chorvatsko/dovolenka.asp?id=23&#x0026;from=etarget</url>
                    <cleanurl>http://www.dovolenka.sk</cleanurl>
                    <status>1</status>
                    <broad_price>15.00 Sk</broad_price>
                    <keyword>dovolenka</keyword>
                    <keyword>dovolenka chorvatsko</keyword>
                    <keyword>chorvatsko</keyword>
                    <keyword>more</keyword>
                </data>
            </value>
        </param>
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
campaignCampaign data and keywords (all keywords not listed will be deleted)
Method output XML input
(show all)
Usage: www.etarget.pl/export/rpc.php?s=XMLRPCstring

Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
   <methodName>customerCredit</methodName>
   <params>
      <param>
        <name>login</name>
        <value>customer_login</value>
      </param>
      <param>
        <name>password</name>
        <value>customer_password</value>
      </param>
      <param>
        <name>id</name>
        <value>12345</value>
      </param>
   </params>
</methodCall>
loginCustomer login
passwordCustomer password
idCustomer ID
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
   <methodName>customerSpending</methodName>
   <params>
      <param>
        <name>login</name>
        <value>customer_login</value>
      </param>
      <param>
        <name>password</name>
        <value>customer_password</value>
      </param>
      <param>
        <name>id</name>
        <value>12345</value>
      </param>
      <param>
        <name>from</name>
        <value>22.03.2004</value>
      </param>
      <param>
        <name>to</name>
        <value>25.03.2004</value>
      </param>
   </params>
</methodCall>
loginCustomer login
passwordCustomer password
idCustomer ID
fromBeginning date for statistics (e.g. <value><int>#TIMESTAMP</int></value> or <value>25.3.2004</value> or <<value>2004.3.25</value>)
toEnding date for statistics (same format as 'from')
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
   <methodName>getAgencyCampaignKeywords</methodName>
   <params>
      <param>
        <name>login</name>
        <value>agency_login</value>
      </param>
      <param>
        <name>password</name>
        <value>agency_password</value>
      </param>
      <param>
        <name>id_agency</name>
        <value>12345</value>
      </param>
      <param>
        <name>id_customer</name>
        <value>12345</value>
      </param>
      <param>
        <name>id_campaign</name>
        <value>12345</value>
      </param>      
   </params>
</methodCall>
loginAgency login
passwordAgency password
idAgency ID
customer0 - all customers, otherwise only the campaigns owned by customer with this ID is returned.
id_campaign0 - all campaigns, otherwise only the keywords owned by campaign with this ID is returned.
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
   <methodName>getAgencyCampaigns</methodName>
   <params>
      <param>
        <name>login</name>
        <value>agency_login</value>
      </param>
      <param>
        <name>password</name>
        <value>agency_password</value>
      </param>
      <param>
        <name>id_agency</name>
        <value>12345</value>
      </param>
      <param>
        <name>id_customer</name>
        <value>12345</value>
      </param>
      <param>
        <name>from</name>
        <value>22.03.2004</value>
      </param>
      <param>
        <name>to</name>
        <value>25.03.2004</value>
      </param>
   </params>
</methodCall>
loginAgency login
passwordAgency password
idAgency ID
customer0 - all customers, otherwise only the campaigns owned by customer with this ID is returned.
fromBeginning date for statistics (e.g. <value><int>#TIMESTAMP</int></value> or <value>25.3.2004</value> or <<value>2004.3.25</value>)
toEnding date for statistics (same format as 'from')
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
   <methodName>getCampaignKeywords</methodName>
   <params>
      <param>
        <name>login</name>
        <value>my_login</value>
      </param>
      <param>
        <name>password</name>
        <value>my_password</value>
      </param>
      <param>
        <name>id</name>
        <value>12345</value>
      </param>
      <param>
        <name>id_campaign</name>
        <value>12345</value>
      </param>      
   </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
id_campaignCampaign ID
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
   <methodName>getCampaigns</methodName>
   <params>
      <param>
        <name>login</name>
        <value>my_login</value>
      </param>
      <param>
        <name>password</name>
        <value>my_password</value>
      </param>
      <param>
        <name>id</name>
        <value>12345</value>
      </param>
      <param>
        <name>from</name>
        <value>22.03.2004</value>
      </param>
      <param>
        <name>to</name>
        <value>25.03.2004</value>
      </param>      
   </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
fromBeginning date for statistics (e.g. <value><int>#TIMESTAMP</int></value> or <value>25.3.2004</value> or <<value>2004.3.25</value>)
toEnding date for statistics (same format as 'from')
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
   <methodName>publisherStats</methodName>
   <params>
      <param>
        <name>login</name>
        <value>publisher_login</value>
      </param>
      <param>
        <name>password</name>
        <value>publisher_password</value>
      </param>
      <param>
        <name>id</name>
        <value>12345</value>
      </param>
      <param>
        <name>from</name>
        <value>22.03.2004</value>
      </param>
      <param>
        <name>to</name>
        <value>25.03.2004</value>
      </param>
      <param>
        <name>group_by_days</name>
        <value>false</value>
      </param>
   </params>
</methodCall>
loginPublisher login
passwordPublisher password
idPublisher ID
fromBeginning date for statistics (e.g. <value><int>#TIMESTAMP</int></value> or <value>25.3.2004</value> or <<value>2004.3.25</value>)
toEnding date for statistics (same format as 'from')
group_by_daysDefault = false, if set to true, the results are grouped by days
Method output XML input
Parameters:[show example input string]
<?xml version="1.0"?>
<methodCall>
   <methodName>publisherStats</methodName>
   <params>
      <param>
        <name>login</name>
        <value>publisher_login</value>
      </param>
      <param>
        <name>password</name>
        <value>publisher_password</value>
      </param>
      <param>
        <name>id</name>
        <value>12345</value>
      </param>
      <param>
        <name>area</name>
        <value>12345</value>
      </param>
      <param>
        <name>from</name>
        <value>22.03.2004</value>
      </param>
      <param>
        <name>to</name>
        <value>25.03.2004</value>
      </param>
   </params>
</methodCall>
loginPublisher login
passwordPublisher password
idPublisher ID
areaidArea ID
fromBeginning date for statistics (e.g. <value><int>#TIMESTAMP</int></value> or <value>25.3.2004</value> or <<value>2004.3.25</value>)
toEnding date for statistics (same format as 'from')
Method output XML input
Zgłoś problem/błąd! | Państwa uwagi i pomysły | O nas
Hotline ( Pon.-Pt. 9.00-17.00) | info@etarget.pl
angielski | slovensky | česky | magyarul | în română | na srpskom | na hrvatskom | po polsku