Pay-per-click(PPC) advertising network
Select Location
RO
Language
INFOLINE031 81 07 440
Metodele ETARGET XML RPC sunt instrumente pentru dezvoltatori pentru automatizarea operațiilor standard din contul Etarget. Cu aceste instrumente puteți încorpora Etarget în sistemul dumneavoastră mult mai ușor. Toate metodele au fost și sunt concepute după cerințele clienților, deci dacă observați că vă lipsește vreo funcție din paleta de instrumente, contactați-ne vă rugăm. ETARGET XML RPC este doar in engleză deoarece este limba cea mai apropiată persoanelor care lucrează cu aceasta.

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.ro/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>http://image.url.jpg</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-1,12345-2,12345-332,54321</value> 		<!-- 12345 is a campaign template and needs aditional data_id  -->
        </param>
        <param>
            <name>campaigns_disable</name>
            <value>12345-331,54320</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>addOrEditTemplateData</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>template_data</name>
            <value>            
                	<data_id>5678</data_id>
                    <PARAM1>some_value</PARAM1>                    
                    <PARAM2>some_value 1</PARAM2>
                    <PARAM3>some_value 2</PARAM3>
                    <PARAM4>some_value</PARAM4>
                    <PARAM5>some_value</PARAM5>           
            </value>
        </param>         
    </params>
</methodCall>
loginClient's login
passwordClient's password
idClient's ID
id_campaignCampaign ID
template_datatemplate data
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.ro/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
HOMEPUBLICITATE ONLINEReclame
Targetare
Buget
Media
Întrebări frecvente
TARIFEServicii suplimentare
Recomandări
Preț Per Click
DESPRE NOIOamenii
Joburi
Download
Știri
Agenții
CONTACT