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

Общие задачи управления трафиком, Общие задачи управления трафиком

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

Общие советы по кодированию

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

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

С#

Создайте объект 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();

Ява

Создайте объект 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
);

Питон

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

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

request = service.advertisers().insert(
    profileId=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)
```

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

С#

Создайте объект 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));
```

Вызовите campaigns.insert() чтобы сохранить кампанию.

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

Ява

Создайте объект 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());

// 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->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
);

Питон

Создайте объект 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': '2015-01-01',
    'endDate': '2020-01-01'
}
```

Вызовите 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: '2014-01-01',
  end_date: '2020-01-01'
)
```

Вызовите campaigns.insert() чтобы сохранить кампанию.

# Insert the campaign.
result = service.insert_campaign(profile_id, campaign)

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

С#

Создайте объект 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;