Срок поддержки API Campaign Manager 360 версии 4 истек. Немедленно переходите на версию 5.

Эта страница переведена с помощью Cloud Translation API.

Распространенные задачи по борьбе с торговлей людьми

На этой странице описано, как выполнять некоторые из наиболее распространенных задач, связанных с незаконным оборотом наркотиков, с помощью API DCM/DFA для отчетности и отслеживания незаконного оборота наркотиков.

Общие советы по программированию

Обязательные и необязательные свойства и параметры — см. справочную документацию , чтобы узнать, является ли свойство или параметр обязательным для вызова API.
Поиск по именам с использованием подстановочных символов — вы можете использовать подстановочный символ звездочки (*) при поиске по именам объектов . Звездочка соответствует нулю или более любым символам. API также поддерживает неявный поиск по подстроке, поэтому поиск по "abc" будет неявно искать "*abc*".
Обновление против внесения исправлений — для изменения существующего объекта у вас есть два варианта:
1. Обновление — При обновлении объекта все поля будут перезаписаны при вставке. Важно загрузить объект, который вы хотите обновить, и внести в него все необходимые изменения. В противном случае все поля, отсутствующие в запросе на обновление, будут сброшены.
2. Вставка изменений — при вставке изменений будут перезаписаны только указанные поля. В этом случае вы можете создать новый объект, присвоить ему тот же идентификатор, что и обновляемому объекту, указать поля для обновления и выполнить запрос на вставку изменений.
Размеры — Физические размеры представлены объектом Size определенным службой размеров . Учетная запись предоставляет набор стандартных размеров, и вы можете добавить в этот список свои собственные пользовательские размеры.
Даты и время — Вы можете сохранять даты и время в формате RFC 3339 , используя местные часовые пояса; все значения, возвращаемые API, указаны в формате UTC. Это отличается от веб-сайта, где даты и время отображаются в настроенном вами часовом поясе (по умолчанию — время США/Нью-Йорка).

Создать рекламодателя

C#

Создайте объект Advertiser и задайте для него необходимые свойства «имя» и «статус» .

// Create the advertiser structure.
Advertiser advertiser = new Advertiser();
advertiser.Name = advertiserName;
advertiser.Status = "APPROVED";

Вызовите advertisers.insert() для сохранения рекламодателя.

// Create the advertiser.
Advertiser result = service.Advertisers.Insert(advertiser, profileId).Execute();

Java

Создайте объект Advertiser и задайте для него необходимые свойства «имя» и «статус» .

// Create the advertiser structure.
Advertiser advertiser = new Advertiser();
advertiser.setName(advertiserName);
advertiser.setStatus("APPROVED");

Вызовите advertisers.insert() для сохранения рекламодателя.

// Create the advertiser.
Advertiser result = reporting.advertisers().insert(profileId, advertiser).execute();

PHP

Создайте объект Advertiser и задайте для него необходимые свойства «имя» и «статус» .

$advertiser = new Google_Service_Dfareporting_Advertiser();
$advertiser->setName($values['advertiser_name']);
$advertiser->setStatus('APPROVED');

Вызовите advertisers.insert() для сохранения рекламодателя.

$result = $this->service->advertisers->insert(
    $values['user_profile_id'],
    $advertiser
);

Python

Создайте объект Advertiser и задайте для него необходимые свойства «имя» и «статус» .
```
# Construct and save advertiser.
advertiser = {
    'name': 'Test Advertiser',
    'status': 'APPROVED'
}
```

Вызовите advertisers.insert() для сохранения рекламодателя.

request = service.advertisers().insert(
    profileId=str(profile_id), body=advertiser
)

# Execute request and print response.
response = request.execute()

Руби

Создайте объект Advertiser и задайте для него необходимые свойства «имя» и «статус» .

# Create a new advertiser resource to insert.
advertiser = DfareportingUtils::API_NAMESPACE::Advertiser.new(
  name: format('Example Advertiser #%s', SecureRandom.hex(3)),
  status: 'APPROVED'
)

Вызовите advertisers.insert() для сохранения рекламодателя.
```
# Insert the advertiser.
result = service.insert_advertiser(profile_id, advertiser)
```

Создать кампанию

C#

Создайте объект Campaign и задайте для него необходимые свойства:
- advertiserId — рекламодатель, с которым будет связана эта кампания.
- name — оно должно быть уникальным во всех рекламных кампаниях данного рекламодателя.
- defaultLandingPageId — целевая страница, на которую будут перенаправлены пользователи при клике на объявление в этой кампании, если для этого объявления такая страница еще не назначена. Вы можете найти существующие целевые страницы, вызвав advertiserLandingPages.list , или создать новую, вызвав advertiserLandingPages.insert .
- Даты начала и окончания — они должны быть в будущем и могут быть точными до дня. Более подробную информацию см. в разделе «Даты и время» в общей информации о кодировании . Даты отдельных объявлений могут превышать дату окончания, чтобы издатель мог попытаться выполнить контракт на определенное количество действий, если он не был выполнен к дате окончания кампании.
```
// Locate an advertiser landing page to use as a default.
LandingPage defaultLandingPage = getAdvertiserLandingPage(service, profileId, advertiserId);

// Create the campaign structure.
Campaign campaign = new Campaign();
campaign.Name = campaignName;
campaign.AdvertiserId = advertiserId;
campaign.Archived = false;
campaign.DefaultLandingPageId = defaultLandingPage.Id;

// Set the campaign start date. This example uses today's date.
campaign.StartDate =
    DfaReportingDateConverterUtil.convertToDateString(DateTime.Now);

// Set the campaign end date. This example uses one month from today's date.
campaign.EndDate =
    DfaReportingDateConverterUtil.convertToDateString(DateTime.Now.AddMonths(1));

campaign.EuPoliticalAdsDeclaration = "CONTAINS_EU_POLITICAL_ADS";
```

Для сохранения кампании вызовите метод campaigns.insert() .

// Insert the campaign.
Campaign result = service.Campaigns.Insert(campaign, profileId).Execute();

Java

Создайте объект Campaign и задайте для него необходимые свойства:
- advertiserId — рекламодатель, с которым будет связана эта кампания.
- name — оно должно быть уникальным во всех рекламных кампаниях данного рекламодателя.
- defaultLandingPageId — целевая страница, на которую будут перенаправлены пользователи при клике на объявление в этой кампании, если для этого объявления такая страница еще не назначена. Вы можете найти существующие целевые страницы, вызвав advertiserLandingPages.list , или создать новую, вызвав advertiserLandingPages.insert .
- Даты начала и окончания — они должны быть в будущем и могут быть точными до дня. Более подробную информацию см. в разделе «Даты и время» в общей информации о кодировании . Даты отдельных объявлений могут превышать дату окончания, чтобы издатель мог попытаться выполнить контракт на определенное количество действий, если он не был выполнен к дате окончания кампании.
```
// Locate an advertiser landing page to use as a default.
LandingPage defaultLandingPage = getAdvertiserLandingPage(reporting, profileId, advertiserId);

// Create the campaign structure.
Campaign campaign = new Campaign();
campaign.setName(campaignName);
campaign.setAdvertiserId(advertiserId);
campaign.setArchived(false);
campaign.setDefaultLandingPageId(defaultLandingPage.getId());
campaign.setEuPoliticalAdsDeclaration("CONTAINS_EU_POLITICAL_ADS");

// Set the campaign start date. This example uses today's date.
Calendar today = Calendar.getInstance();
DateTime startDate = new DateTime(true, today.getTimeInMillis(), null);
campaign.setStartDate(startDate);

// Set the campaign end date. This example uses one month from today's date.
Calendar nextMonth = Calendar.getInstance();
nextMonth.add(Calendar.MONTH, 1);
DateTime endDate = new DateTime(true, nextMonth.getTimeInMillis(), null);
campaign.setEndDate(endDate);
```

Для сохранения кампании вызовите метод campaigns.insert() .

// Insert the campaign.
Campaign result = reporting.campaigns().insert(profileId, campaign).execute();

PHP

Создайте объект Campaign и задайте для него необходимые свойства:
- advertiserId — рекламодатель, с которым будет связана эта кампания.
- name — оно должно быть уникальным во всех рекламных кампаниях данного рекламодателя.
- defaultLandingPageId — целевая страница, на которую будут перенаправлены пользователи при клике на объявление в этой кампании, если для этого объявления такая страница еще не назначена. Вы можете найти существующие целевые страницы, вызвав advertiserLandingPages.list , или создать новую, вызвав advertiserLandingPages.insert .
- Даты начала и окончания — они должны быть в будущем и могут быть точными до дня. Более подробную информацию см. в разделе «Даты и время» в общей информации о кодировании . Даты отдельных объявлений могут превышать дату окончания, чтобы издатель мог попытаться выполнить контракт на определенное количество действий, если он не был выполнен к дате окончания кампании.
```
$startDate = new DateTime('today');
$endDate = new DateTime('+1 month');

$campaign = new Google_Service_Dfareporting_Campaign();
$campaign->setAdvertiserId($values['advertiser_id']);
$campaign->setDefaultLandingPageId($values['default_landing_page_id']);
$campaign->setName($values['campaign_name']);
$campaign->setEuPoliticalAdsDeclaration($values['eu_political_ads_declaration']);
$campaign->setStartDate($startDate->format('Y-m-d'));
$campaign->setEndDate($endDate->format('Y-m-d'));
```

Для сохранения кампании вызовите метод campaigns.insert() .

$result = $this->service->campaigns->insert(
    $values['user_profile_id'],
    $campaign
);

Python

Создайте объект Campaign и задайте для него необходимые свойства:
- advertiserId — рекламодатель, с которым будет связана эта кампания.
- name — оно должно быть уникальным во всех рекламных кампаниях данного рекламодателя.
- defaultLandingPageId — целевая страница, на которую будут перенаправлены пользователи при клике на объявление в этой кампании, если для этого объявления такая страница еще не назначена. Вы можете найти существующие целевые страницы, вызвав advertiserLandingPages.list , или создать новую, вызвав advertiserLandingPages.insert .
- Даты начала и окончания — они должны быть в будущем и могут быть точными до дня. Более подробную информацию см. в разделе «Даты и время» в общей информации о кодировании . Даты отдельных объявлений могут превышать дату окончания, чтобы издатель мог попытаться выполнить контракт на определенное количество действий, если он не был выполнен к дате окончания кампании.
```
# Locate an advertiser landing page to use as a default.
default_landing_page = get_advertiser_landing_page(service, profile_id,
                                                   advertiser_id)

# Construct and save campaign.
campaign = {
    'name': 'Test Campaign #%s' % uuid.uuid4(),
    'advertiserId': advertiser_id,
    'archived': 'false',
    'defaultLandingPageId': default_landing_page['id'],
    'startDate': '2025-11-01',
    'endDate': '2025-12-01',
    'euPoliticalAdsDeclaration': 'CONTAINS_EU_POLITICAL_ADS',
}
```

Для сохранения кампании вызовите метод campaigns.insert() .

request = service.campaigns().insert(profileId=profile_id, body=campaign)

# Execute request and print response.
response = request.execute()

Руби

Создайте объект Campaign и задайте для него необходимые свойства:
- advertiserId — рекламодатель, с которым будет связана эта кампания.
- name — оно должно быть уникальным во всех рекламных кампаниях данного рекламодателя.
- defaultLandingPageId — целевая страница, на которую будут перенаправлены пользователи при клике на объявление в этой кампании, если для этого объявления такая страница еще не назначена. Вы можете найти существующие целевые страницы, вызвав advertiserLandingPages.list , или создать новую, вызвав advertiserLandingPages.insert .
- Даты начала и окончания — они должны быть в будущем и могут быть точными до дня. Более подробную информацию см. в разделе «Даты и время» в общей информации о кодировании . Даты отдельных объявлений могут превышать дату окончания, чтобы издатель мог попытаться выполнить контракт на определенное количество действий, если он не был выполнен к дате окончания кампании.
```
# Locate an advertiser landing page to use as a default.
default_landing_page = get_advertiser_landing_page(service, profile_id,
  advertiser_id)

# Create a new campaign resource to insert.
campaign = DfareportingUtils::API_NAMESPACE::Campaign.new(
  advertiser_id: advertiser_id,
  archived: false,
  default_landing_page_id: default_landing_page.id,
  name: format('Example Campaign #%s', SecureRandom.hex(3)),
  start_date: '2025-11-01',
  end_date: '2025-12-01',
  eu_political_ads_declaration: 'CONTAINS_EU_POLITICAL_ADS'
)
```
Для сохранения кампании вызовите метод campaigns.insert() .
```
# Insert the campaign.
result = service.insert_campaign(profile_id, campaign)
```

Создать размещение

C#

Создайте объект Placement и задайте необходимые свойства размещения (включая campaignId и siteId ). Также убедитесь, что тип и размер размещения указаны точно в соответствии с условиями, согласованными с вашим сайтом.

// Create the placement.
Placement placement = new Placement();
placement.Name = placementName;
placement.CampaignId = campaignId;
placement.Compatibility = "DISPLAY";
placement.PaymentSource = "PLACEMENT_AGENCY_PAID";
placement.SiteId = dfaSiteId;
placement.TagFormats = new List<string>() { "PLACEMENT_TAG_STANDARD" };

// Set the size of the placement.
Size size = new Size();
size.Id = sizeId;
placement.Size = size;