L'API Campaign Manager 360 v4 è deprecata e verrà ritirata il giorno 26 febbraio 2026. Esegui la migrazione alla v5 entro questa data per evitare interruzioni del servizio.

Attività di trafficking comuni

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

Suggerimenti generali per la programmazione

Proprietà e parametri obbligatori e facoltativi: consulta la documentazione di riferimento per scoprire se una proprietà o un parametro è obbligatorio per una chiamata API.
Ricerche di nomi con caratteri jolly: puoi utilizzare l'asterisco (*) come carattere jolly quando cerchi nomi di oggetti. Un asterisco corrisponde a zero o più caratteri qualsiasi. L'API supporta anche una ricerca di sottostringhe implicita, 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 durante l'inserimento. È importante caricare l'oggetto che vuoi aggiornare e apportare le modifiche necessarie. In caso contrario, tutti i campi non presenti nella richiesta di aggiornamento verranno annullati.
2. Applicazione di patch: durante l'applicazione di patch, verranno sovrascritti solo i campi specificati durante l'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 PATCH.
Dimensioni: le dimensioni fisiche sono rappresentate da un oggetto Size definito dal servizio sizes. L'account fornisce un insieme di dimensioni standard e puoi aggiungere le tue dimensioni personalizzate a questo elenco.
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 formato UTC. Questo è diverso dal sito web in cui le date e gli orari vengono visualizzati nel fuso orario configurato (ora di New York, Stati Uniti, 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)

Crea una campagna

C#

Crea un oggetto Campaign e imposta le proprietà richieste:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui gli utenti verranno indirizzati quando fanno clic su un annuncio in questa campagna, se non ne è assegnata una all'annuncio. Puoi cercare le pagine di destinazione esistenti chiamando advertiserLandingPages.list o crearne una nuova chiamando advertiserLandingPages.insert.
- Date di inizio e fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco relativo a date e orari in Informazioni generali sulla codifica. Le date dei singoli annunci possono superare la data di fine, per consentire a un publisher di tentare di soddisfare un contratto per un numero specificato di azioni, se non è stato soddisfatto entro la data di fine della campagna indicata.
```
// 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 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 proprietà richieste:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui gli utenti verranno indirizzati quando fanno clic su un annuncio in questa campagna, se non ne è assegnata una all'annuncio. Puoi cercare le pagine di destinazione esistenti chiamando advertiserLandingPages.list o crearne una nuova chiamando advertiserLandingPages.insert.
- Date di inizio e fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco relativo a date e orari in Informazioni generali sulla codifica. Le date dei singoli annunci possono superare la data di fine, per consentire a un publisher di tentare di soddisfare un contratto per un numero specificato di azioni, se non è stato soddisfatto entro la data di fine della campagna indicata.
```
// 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 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 proprietà richieste:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui gli utenti verranno indirizzati quando fanno clic su un annuncio in questa campagna, se non ne è assegnata una all'annuncio. Puoi cercare le pagine di destinazione esistenti chiamando advertiserLandingPages.list o crearne una nuova chiamando advertiserLandingPages.insert.
- Date di inizio e fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco relativo a date e orari in Informazioni generali sulla codifica. Le date dei singoli annunci possono superare la data di fine, per consentire a un publisher di tentare di soddisfare un contratto per un numero specificato di azioni, se non è stato soddisfatto entro la data di fine della campagna indicata.
```
$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 campaigns.insert() per salvare la campagna.

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

Python

Crea un oggetto Campaign e imposta le proprietà richieste:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui gli utenti verranno indirizzati quando fanno clic su un annuncio in questa campagna, se non ne è assegnata una all'annuncio. Puoi cercare le pagine di destinazione esistenti chiamando advertiserLandingPages.list o crearne una nuova chiamando advertiserLandingPages.insert.
- Date di inizio e fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco relativo a date e orari in Informazioni generali sulla codifica. Le date dei singoli annunci possono superare la data di fine, per consentire a un publisher di tentare di soddisfare un contratto per un numero specificato di azioni, se non è stato soddisfatto entro la data di fine della campagna indicata.
```
# 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 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 proprietà richieste:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione a cui gli utenti verranno indirizzati quando fanno clic su un annuncio in questa campagna, se non ne è assegnata una all'annuncio. Puoi cercare le pagine di destinazione esistenti chiamando advertiserLandingPages.list o crearne una nuova chiamando advertiserLandingPages.insert.
- Date di inizio e fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco relativo a date e orari in Informazioni generali sulla codifica. Le date dei singoli annunci possono superare la data di fine, per consentire a un publisher di tentare di soddisfare un contratto per un numero specificato di azioni, se non è stato soddisfatto entro la data di fine della campagna indicata.
```
# 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 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 richieste (inclusi campaignId e siteId). Inoltre, assicurati di impostare con precisione il tipo e le dimensioni del posizionamento che hai 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;