Ad Networks & Translation Search Features | Google Search Central | Documentation

Google Search offers several translation-related features that enable users to access translated content. If you run an ad network and your ads aren't working properly on translated web pages, you'll need to follow the steps in this guide to make sure your ads render or attribute correctly.

Our approach

When users access translated content provided by Google Translate from within search results, Google retrieves the page from the publisher, rewrites the source URL, and translates the web page after the user clicks the translated result.

Convert the Google Translate URL to the original URL

If you run an ad network that relies on the publisher’s source URL, you'll need to convert the Google Translate URL to make sure your ads are working properly. Follow these steps to decode the publisher’s hostname:

Extract the domain prefix from the hostname, by removing the .translate.goog suffix.
Split the _x_tr_enc parameter by the , (comma) character and save it as encoding_list .
Prepend the value of the _x_tr_hp parameter to the domain prefix, if it exists.
If encoding_list contains 1 and the output begins with 1- , remove the 1- prefix from the output of step 2.
If encoding_list contains 0 and the output begins with 0- , remove the 0- prefix from the output of step 3. If you removed the prefix, set is_idn to true . Otherwise, set is_idn to false .
Replace /\b-\b/ (regex) with the . (dot) character.
Replace the -- (double hyphen) character with the - (hyphen) character.
If is_idn is set to true , add the punycode prefix xn-- .
Optional : Convert to Unicode.

Sample JavaScript code for decoding the hostname from a Google Translate URL

 function 
  
 decodeHostname 
 ( 
 proxyUrl 
 ) 
  
 { 
  
 const 
  
 parsedProxyUrl 
  
 = 
  
 new 
  
 URL 
 ( 
 proxyUrl 
 ); 
  
 const 
  
 fullHost 
  
 = 
  
 parsedProxyUrl 
 . 
 hostname 
 ; 
  
 // 
  
 1. 
  
 Extract 
  
 the 
  
 domain 
  
 prefix 
  
 from 
  
 the 
  
 hostname 
 , 
  
 by 
  
 removing 
  
 the 
  
 ".translate.goog" 
  
 suffix 
  
 let 
  
 domainPrefix 
  
 = 
  
 fullHost 
 . 
 substring 
 ( 
 0 
 , 
  
 fullHost 
 . 
 indexOf 
 ( 
 '.' 
 )); 
  
 // 
  
 2. 
  
 Split 
  
 _x_tr_enc 
  
 parameter 
  
 by 
  
 "," 
  
 ( 
 comma 
 ), 
  
 save 
  
 as 
  
 encodingList 
  
 const 
  
 encodingList 
  
 = 
  
 parsedProxyUrl 
 . 
 searchParams 
 . 
 has 
 ( 
 '_x_tr_enc' 
 ) 
  
 ? 
  
 parsedProxyUrl 
 . 
 searchParams 
 . 
 get 
 ( 
 '_x_tr_enc' 
 ) 
 . 
 split 
 ( 
 ',' 
 ) 
  
 : 
  
 []; 
  
 // 
  
 3. 
  
 Prepend 
  
 value 
  
 of 
  
 _x_tr_hp 
  
 parameter 
  
 to 
  
 the 
  
 domain 
  
 prefix 
 , 
  
 if 
  
 it 
  
 exists 
  
 if 
  
 ( 
 parsedProxyUrl 
 . 
 searchParams 
 . 
 has 
 ( 
 '_x_tr_hp' 
 )) 
  
 { 
  
 domainPrefix 
  
 = 
  
 parsedProxyUrl 
 . 
 searchParams 
 . 
 get 
 ( 
 '_x_tr_hp' 
 ) 
  
 + 
  
 domainPrefix 
 ; 
  
 } 
  
 // 
  
 4. 
  
 Remove 
  
 '1-' 
  
 prefix 
  
 from 
  
 the 
  
 output 
  
 of 
  
 step 
  
 2 
  
 if 
  
 encodingList 
  
 contains 
  
 // 
  
 '1' 
  
 and 
  
 the 
  
 output 
  
 begins 
  
 with 
  
 '1-' 
 . 
  
 if 
  
 ( 
 encodingList 
 . 
 includes 
 ( 
 '1' 
 ) 
 && 
 domainPrefix 
 . 
 startsWith 
 ( 
 '1-' 
 )) 
  
 { 
  
 domainPrefix 
  
 = 
  
 domainPrefix 
 . 
 substring 
 ( 
 2 
 ); 
  
 } 
  
 // 
  
 5. 
  
 Remove 
  
 '0-' 
  
 prefix 
  
 from 
  
 the 
  
 output 
  
 of 
  
 step 
  
 3 
  
 if 
  
 encodingList 
  
 contains 
  
 // 
  
 '0' 
  
 and 
  
 the 
  
 output 
  
 begins 
  
 with 
  
 '0-' 
 . 
  
 // 
  
 Set 
  
 isIdn 
  
 to 
  
 true 
  
 if 
  
 removed 
 , 
  
 false 
  
 otherwise 
 . 
  
 let 
  
 isIdn 
  
 = 
  
 false 
 ; 
  
 if 
  
 ( 
 encodingList 
 . 
 includes 
 ( 
 '0' 
 ) 
 && 
 domainPrefix 
 . 
 startsWith 
 ( 
 '0-' 
 )) 
  
 { 
  
 isIdn 
  
 = 
  
 true 
 ; 
  
 domainPrefix 
  
 = 
  
 domainPrefix 
 . 
 substring 
 ( 
 2 
 ); 
  
 } 
  
 // 
  
 6. 
  
 Replace 
  
 / 
\ b 
 - 
\ b 
 / 
  
 ( 
 regex 
 ) 
  
 with 
  
 '.' 
  
 ( 
 dot 
 ) 
  
 character 
 . 
  
 // 
  
 7. 
  
 Replace 
  
 '--' 
  
 ( 
 double 
  
 hyphen 
 ) 
  
 with 
  
 '-' 
  
 ( 
 hyphen 
 ) 
 . 
  
 let 
  
 decodedSegment 
  
 = 
  
 domainPrefix 
 . 
 replaceAll 
 ( 
 / 
\ b 
 - 
\ b 
 / 
 g 
 , 
  
 '.' 
 ) 
 . 
 replaceAll 
 ( 
 '--' 
 , 
  
 '-' 
 ); 
  
 // 
  
 8. 
  
 If 
  
 isIdn 
  
 equals 
  
 true 
 , 
  
 add 
  
 the 
  
 punycode 
  
 prefix 
  
 'xn--' 
 . 
  
 if 
  
 ( 
 isIdn 
 ) 
  
 { 
  
 decodedSegment 
  
 = 
  
 'xn--' 
  
 + 
  
 decodedSegment 
 ; 
  
 } 
  
 return 
  
 decodedSegment 
 ; 
 }

Reconstruct the URL

Using the original page URL, replace the hostname with the decoded hostname.
Remove all _x_tr_* parameters.

Test your code

You can create unit tests for your code using the following table. Given a proxyUrl , the decodeHostname must match the expected value.

The following table can only be used to test the hostname decoding. You’ll need to ensure that the path, fragment, and original parameters of the URL are preserved as is.

`proxyUrl`	`decodeHostname`
`https://example-com.translate.goog`	`example.com`
`https://foo-example-com.translate.goog`	`foo.example.com`
`https://foo--example-com.translate.goog`	`foo-example.com`
`https://0-57hw060o-com.translate.goog/?_x_tr_enc=0`	`xn--57hw060o.com (⚡😊.com)`
`https://1-en--us-example-com/?_x_tr_enc=1`	`en-us.example.com`
`https://0-en----w45as309w-com.translate.goog/?_x_tr_enc=0`	`xn--en--w45as309w.com (en-⚡😊.com)`
`https://1-0-----16pw588q-com.translate.goog/?_x_tr_enc=0,1`	`xn----16pw588q.com (⚡-😊.com)`
`https://lanfairpwllgwyngyllgogerychwyrndrobwllllantysiliogogogoch-co-uk.translate.goog/?_x_tr_hp=l`	`llanfairpwllgwyngyllgogerychwyrndrobwllllantysiliogogogoch.co.uk`
`https://lanfairpwllgwyngyllgogerychwyrndrobwllllantysiliogogogoch-co-uk.translate.goog/?_x_tr_hp=www-l`	`www.llanfairpwllgwyngyllgogerychwyrndrobwllllantysiliogogogoch.co.uk`
`https://a--aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-com.translate.goog/?_x_tr_hp=a--xn--xn--xn--xn--xn--------------------------a`	`a-xn-xn-xn-xn-xn-------------aa-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.com`
`https://g5h3969ntadg44juhyah3c9aza87iiar4i410avdl8d3f1fuq3nz05dg5b-com.translate.goog/?_x_tr_enc=0&_x_tr_hp=0-`	`xn--g5h3969ntadg44juhyah3c9aza87iiar4i410avdl8d3f1fuq3nz05dg5b.com (💖🌲😊💞🤷‍♂️💗🌹😍🌸🌺😂😩😉😒😘💕🐶🐱🐭🐹🐰🐻🦊🐇😺.com)`

Enabling your ad network to work with translation-related Google Search features

Our approach

Convert the Google Translate URL to the original URL

Sample JavaScript code for decoding the hostname from a Google Translate URL

Reconstruct the URL

Test your code