Документация для разработчиков
Темная тема

SetDesiredKeywords

Описание и параметры

CAdvBanner::SetDesiredKeywords(
	mixed keywords,
	varchar(255) TYPE_SID=""
);

Описание

Метод задает массив желательных ключевых слов для данной страницы. Если одно из ключевых слов баннера (либо контракта, к которому принадлежит баннер) будет найдено в данном массиве, то этот баннер будет показываться на данной странице с более высоким приоритетом. В случае, если не будет найден ни один баннер, отвечающий установленным ключевым словам, то баннер для показа будет выбран из тех, для которых вообще не установлено ни одно ключевое слово. Метод нестатический.

Параметры метода

ПараметрОписание
keywords Ключевые слова. Конструкции, которые можно передавать в этом параметре, описаны в примечаниях ниже.
TYPE_SID Идентификатор типа. В данном параметре вы можете указать тип рекламы для которой будут заданы ключевые слова. Если данный параметр оставить пустым, то ключевые слова будут заданы для всех типов. Необязательный параметр.

Примеры использования

Пример использования на конкретной странице:

<?
require_once($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");
if (CModule::IncludeModule("advertising"))
{
	 // желательные ключевые слова с точным совпадением		
	 $arrKeywords = array();
	 $arrKeywords[] = array("EXACT_MATCH" => "Y", "KEYWORD" => "GeForce");
	 $arrKeywords[] = array("EXACT_MATCH" => "Y", "KEYWORD" => "video");
	 CAdvBanner::SetDesiredKeywords($arrKeywords, "LEFT");

	 // желательные ключевые слова с вхождением
	 CAdvBanner::SetDesiredKeywords(array("Ford", "BMW", "Lada"), "RIGHT");
}

$APPLICATION->SetTitle("Заголовок страницы");
require_once($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_after.php");

// тело страницы
require_once($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/epilog.php");
?>

Пример использования для всего сайта, в prolog_after.php:

<?
if (CModule::IncludeModule("advertising"))
{
	CAdvBanner::SetDesiredKeywords($APPLICATION->GetPageProperty("keywords"));
}
?>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
...
Примечания

Конструкции, которые можно передавать в параметре keywords, включают.

  1. Массив, состоящий из массивов, каждый из которых имеет ключи:
    • EXACT_MATCH - указывает как искать слово - точное совпадение (Y), либо вхождение (N).
    • KEYWORDS - ключевое слово.
    Пример:

    Array
    (
    	[0] => Array
    	(
    		[EXACT_MATCH] => Y
    		[KEYWORD] => GeForce
    	)
    
    	[1] => Array
    	(
    		[EXACT_MATCH] => Y
    		[KEYWORD] => Radeon
    	)
    )
    
  2. Массив, элементами которого будут являться сами ключевые слова.

    Пример:


    Array
    (
    	[0] => GeForce
    	[1] => Radion
    	[2] => Sony
    )
    
    В этом варианте по умолчанию в дальнейшем будет искаться вхождение ключевых слов баннера в данные ключевые слова (либо наоборот).

  3. Список ключевых слов, разделенных запятой.

    Пример:


    "GeForce, Radion, Sony"
    
    В этом варианте по умолчанию в дальнейшем будет также искаться вхождение ключевых слов баннера в данные ключевые слова (либо наоборот).


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх