Questa pagina è stata tradotta dall'API Cloud Translation.

Attività di trafficking comuni

Questa pagina descrive come eseguire alcune delle attività di gestione del traffico più comuni utilizzando l'API DCM/DFA Reporting e Trafficking.

Suggerimenti generali di programmazione

Proprietà e parametri obbligatori e facoltativi: consulta la documentazione di riferimento per sapere se per una chiamata API sono necessari una proprietà o un parametro.
Ricerche di nomi con caratteri jolly: puoi utilizzare il carattere jolly asterisco (*) durante la ricerca di oggetti in base a nomi. Un asterisco corrisponde a zero o più caratteri di qualsiasi tipo. L'API supporta anche una ricerca implicita di sottostringhe, quindi una ricerca di "abc" cercherà implicitamente "*abc*".
Aggiornamento e applicazione di patch: per modificare un oggetto esistente, hai due opzioni:
1. Aggiornamento: quando aggiorni un oggetto, tutti i campi vengono sovrascritti al momento dell'inserimento. È importante caricare l'oggetto da aggiornare e apportarvi eventuali modifiche. In caso contrario, i campi che non sono presenti nella richiesta di aggiornamento verranno annullati.
2. Patching: durante l'applicazione di patch, solo i campi specificati verranno sovrascritti al momento dell'inserimento. In questo caso, puoi creare un nuovo oggetto, assegnargli lo stesso ID dell'oggetto da aggiornare, impostare i campi da aggiornare ed eseguire la richiesta di patch.
Dimensioni: le dimensioni fisiche sono rappresentate da un oggetto Size definito dal servizio delle dimensioni. L'account fornisce un insieme di dimensioni standard a cui puoi aggiungere le tue dimensioni personalizzate.
Date e ore: puoi salvare date e ore nel formato RFC 3339 utilizzando i fusi orari locali. Tutti i valori restituiti dall'API sono in UTC. È diverso dal sito web in cui le date e gli orari sono indicati nel fuso orario configurato (ora di America/New York, per impostazione predefinita).

Creazione di un inserzionista

C#

Crea un oggetto Advertiser e imposta le proprietà obbligatorie name e status.

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

Chiama advertisers.insert() per salvare l'inserzionista.

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

Java

Crea un oggetto Advertiser e imposta le proprietà obbligatorie name e status.

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

Chiama advertisers.insert() per salvare l'inserzionista.

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

PHP

Crea un oggetto Advertiser e imposta le proprietà obbligatorie name e status.

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

Chiama advertisers.insert() per salvare l'inserzionista.

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

Python

Crea un oggetto Advertiser e imposta le proprietà obbligatorie name e status.

# Construct and save advertiser.
advertiser = {
    'name': 'Test Advertiser',
    'status': 'APPROVED'
}

Chiama advertisers.insert() per salvare l'inserzionista.

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

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

Ruby

Crea un oggetto Advertiser e imposta le proprietà obbligatorie name e status.

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

Chiama advertisers.insert() per salvare l'inserzionista.

# Insert the advertiser.
result = service.insert_advertiser(profile_id, advertiser)

Creare una campagna

C#

Crea un oggetto Campaign e imposta le relative proprietà obbligatorie:
- advertiserId: l'inserzionista a cui associare la campagna.
- name: deve essere univoco in tutte le campagne dell'inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui vengono indirizzati gli utenti quando fanno clic su un annuncio della campagna, se non ne è stato assegnato uno. Puoi cercare le pagine di destinazione esistenti chiamando il numero advertiserLandingPages.list o crearne una nuova chiamando il numero advertiserLandingPages.insert.
- Date di inizio e fine: devono essere nel futuro e possono essere precise per fino al giorno. Per ulteriori dettagli, consulta il punto elenco con date e orari in Informazioni generali sulla programmazione. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a rispettare un contratto per un numero specificato di azioni, se non è stato compilato entro la data di fine specificata per la campagna.
```
// 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));
```

Chiama il numero campaigns.insert() per salvare la campagna.

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

Java

Crea un oggetto Campaign e imposta le relative proprietà obbligatorie:
- advertiserId: l'inserzionista a cui associare la campagna.
- name: deve essere univoco in tutte le campagne dell'inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui vengono indirizzati gli utenti quando fanno clic su un annuncio della campagna, se non ne è stato assegnato uno. Puoi cercare le pagine di destinazione esistenti chiamando il numero advertiserLandingPages.list o crearne una nuova chiamando il numero advertiserLandingPages.insert.
- Date di inizio e fine: devono essere nel futuro e possono essere precise per fino al giorno. Per ulteriori dettagli, consulta il punto elenco con date e orari in Informazioni generali sulla programmazione. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a rispettare un contratto per un numero specificato di azioni, se non è stato compilato entro la data di fine specificata per la campagna.
```
// 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);
```

Chiama il numero campaigns.insert() per salvare la campagna.

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

PHP

Crea un oggetto Campaign e imposta le relative proprietà obbligatorie:
- advertiserId: l'inserzionista a cui associare la campagna.
- name: deve essere univoco in tutte le campagne dell'inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui vengono indirizzati gli utenti quando fanno clic su un annuncio della campagna, se non ne è stato assegnato uno. Puoi cercare le pagine di destinazione esistenti chiamando il numero advertiserLandingPages.list o crearne una nuova chiamando il numero advertiserLandingPages.insert.
- Date di inizio e fine: devono essere nel futuro e possono essere precise per fino al giorno. Per ulteriori dettagli, consulta il punto elenco con date e orari in Informazioni generali sulla programmazione. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a rispettare un contratto per un numero specificato di azioni, se non è stato compilato entro la data di fine specificata per la campagna.
```
$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'));
```

Chiama il numero campaigns.insert() per salvare la campagna.

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

Python

Crea un oggetto Campaign e imposta le relative proprietà obbligatorie:
- advertiserId: l'inserzionista a cui associare la campagna.
- name: deve essere univoco in tutte le campagne dell'inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui vengono indirizzati gli utenti quando fanno clic su un annuncio della campagna, se non ne è stato assegnato uno. Puoi cercare le pagine di destinazione esistenti chiamando il numero advertiserLandingPages.list o crearne una nuova chiamando il numero advertiserLandingPages.insert.
- Date di inizio e fine: devono essere nel futuro e possono essere precise per fino al giorno. Per ulteriori dettagli, consulta il punto elenco con date e orari in Informazioni generali sulla programmazione. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a rispettare un contratto per un numero specificato di azioni, se non è stato compilato entro la data di fine specificata per la campagna.
```
# 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'
}
```

Chiama il numero campaigns.insert() per salvare la campagna.

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

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

Ruby

Crea un oggetto Campaign e imposta le relative proprietà obbligatorie:
- advertiserId: l'inserzionista a cui associare la campagna.
- name: deve essere univoco in tutte le campagne dell'inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui vengono indirizzati gli utenti quando fanno clic su un annuncio della campagna, se non ne è stato assegnato uno. Puoi cercare le pagine di destinazione esistenti chiamando il numero advertiserLandingPages.list o crearne una nuova chiamando il numero advertiserLandingPages.insert.
- Date di inizio e fine: devono essere nel futuro e possono essere precise per fino al giorno. Per ulteriori dettagli, consulta il punto elenco con date e orari in Informazioni generali sulla programmazione. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a rispettare un contratto per un numero specificato di azioni, se non è stato compilato entro la data di fine specificata per la campagna.
```
# 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'
)
```

Chiama il numero campaigns.insert() per salvare la campagna.

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

Creare un posizionamento

C#

Crea un oggetto Placement e imposta le proprietà di posizionamento obbligatorie (tra cui campaignId e siteId). Inoltre, assicurati di impostare accuratamente il tipo e le dimensioni del posizionamento per il posizionamento negoziato con il tuo sito web.

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