Pay-per-click(PPC) advertising network
Select Location
CZ
Language
INFOLINKA246 019 741
ETARGET XML RPC metody jsou nástroje pro vývojáře, jak zautomatizovat standardní operace v ETARGET kontě. S těmito nástroji zakomponujete ETARGET do svého systému mnohlem snadněji. Všechny metody jsou a byly vyvýjené speciálně dle požadavků klientů, pokud tedy zjistíte, že Vám nějaká funkcionalita v paletě nástrojů chybí, kontaktujte nás prosím. ETARGET XML RPC poskytujeme jen v angličtině, protože je to jazyk, který je vývojářům, pro které je určen a kteří s ním budou pracovat, nejbližší.

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.cz/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.cz/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
DOMŮREKLAMA NA INTERNETUReklamní odkazy
Cílení
Rozpočet
Stránky
Často kladené otázky a odpovědi
CENÍKCeník doplňkových služeb
Doporučení
Ceny za kliknutí
O NÁSLidé
Kariéra
Ke stažení
Novinky
Agentury
KONTAKT
Etarget je reklama na internetu. Její výhodou je, že zobrazení inzerátu je zdarma, pár korun zaplatíte až za kliknutí - tedy za návštěvníka na Váš web.

V České republice využívá plochy více než 1.300 webových stránek.   © 2002 - 2012 ETARGET CZ, s.r.o.