Google Пошук пропонує кілька функцій, пов’язаних з перекладом, які дозволяють показувати користувачеві контент, перекладений з іншої мови. Якщо ви керуєте рекламною мережею і ваша реклама не з’являється на перекладених сайтах, перевірте, чи правильно у вас налаштовано показ і атрибуція оголошень. Про те, як це зробити, читайте в посібнику нижче.

Наш підхід

Коли користувач натискає на перекладений результат і хоче перейти на пов’язану з ним сторінку, Google Перекладач отримує цю сторінку від видавця, змінює її вихідний URL і перекладає її вміст.

Як перетворити URL, оброблений в Google Перекладачі, для отримання вихідної адреси сторінки

Якщо ваша рекламна мережа працює зі сторінкою, доступною за вихідною URL-адресою видавця, вам потрібно налаштувати зворотне перетворення URL, створеної в Google Перекладачі, щоб на перекладених сайтах відображалися оголошення. Щоб перетворити ім’я хоста видавця, виконайте наступні дії:

1. Витягніть префікс домену з імені хоста видавця, видаливши з нього суфікс .translate.goog.
2. Розділіть параметр _x_tr_enc за знаком , (комою) і збережіть отримані елементи як список encoding_list.
3. Додайте значення параметра _x_tr_hp на початок префікса домену (якщо воно є).
4. Якщо в списку encoding_list міститься значення 1, а результат операції починається з 1-, приберіть префікс 1- з результату, отриманого на кроці 2.
5. Якщо в списку encoding_list міститься значення 0, а результат починається з 0-, приберіть префікс 0- з результату, отриманого на кроці 3. Якщо ви видалили цей префікс, присвойте елементу is_idn значення true. Якщо ні, присвойте елементу is_idn значення false.
6. Замініть усі регулярні вирази /\b-\b/ на знак . (крапка).
7. Замініть усі -- (подвійні дефіси) на знак - (звичайний дефіс).
8. Якщо елементу is_idn присвоєно значення true, додайте префікс xn-- (символ із кодування Punycode).
9. Необов’язково. Перетворіть отриманий текст у формат Unicode.

Приклад коду JavaScript для перетворення URL після Google Перекладача у вихідну 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;
}

Як отримати вихідний URL

1. У URL вихідної сторінки замініть ім’я хоста на перетворений варіант.
2. Видаліть усі параметри _x_tr_*.

Як перевірити написаний код

За допомогою таблиці нижче ви можете провести модульне тестування свого коду. Для цього переконайтеся, що після обробки елементів proxyUrl вашим алгоритмом усі вихідні значення decodeHostname збігаються із вказаними в таблиці.

Значення з цієї таблиці можуть бути використані тільки для тестування програми, яка перетворює імена хостів. Переконайтеся, що шлях, фрагмент і вихідні параметри URL не були змінені.