Questa pagina è stata tradotta dall'API Cloud Translation.

Attività di trafficking comuni

Questa pagina illustra come eseguire alcune delle più comuni attività di gestione del traffico usando l'API 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 sono obbligatori per una chiamata API.
Ricerche di nomi con caratteri jolly: puoi utilizzare il carattere jolly asterisco (*) per le ricerche di nomi di oggetti. Un asterisco corrisponde a zero o più caratteri. L'API supporta anche una ricerca implicita di sottostringhe, quindi la 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 apportare eventuali modifiche. In caso contrario, l'impostazione di tutti i campi non presenti nella richiesta di aggiornamento verrà annullata.
2. Patch: durante l'applicazione di patch, solo i campi specificati verranno sovrascritti all'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 applicazione patch.
Dimensioni: le dimensioni fisiche sono rappresentate da un oggetto Size definito dal servizio 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. Questo è diverso dal sito web in cui date e orari vengono visualizzati nel fuso orario configurato (fuso orario di America/New York, per impostazione predefinita).

Creazione di un inserzionista

C#

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

// 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à name e status richieste.

// 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à name e status richieste.

$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à name e status richieste.

# 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à name e status richieste.

# 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 proprietà obbligatorie:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione alla quale verranno indirizzati gli utenti quando fanno clic su un annuncio di questa campagna, se non ne è assegnata una a quell'annuncio. 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 di fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco date e orari in Informazioni generali sul codice. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a completare un contratto per un numero specifico di azioni, se non è stato compilato entro la data di fine della campagna specificata.
```
// 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à obbligatorie:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione alla quale verranno indirizzati gli utenti quando fanno clic su un annuncio di questa campagna, se non ne è assegnata una a quell'annuncio. 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 di fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco date e orari in Informazioni generali sul codice. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a completare un contratto per un numero specifico di azioni, se non è stato compilato entro la data di fine della campagna specificata.
```
// 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à obbligatorie:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione alla quale verranno indirizzati gli utenti quando fanno clic su un annuncio di questa campagna, se non ne è assegnata una a quell'annuncio. 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 di fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco date e orari in Informazioni generali sul codice. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a completare un contratto per un numero specifico di azioni, se non è stato compilato entro la data di fine della campagna specificata.
```
$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à obbligatorie:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione alla quale verranno indirizzati gli utenti quando fanno clic su un annuncio di questa campagna, se non ne è assegnata una a quell'annuncio. 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 di fine: devono essere nel futuro e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco date e orari in Informazioni generali sul codice. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a completare un contratto per un numero specifico di azioni, se non è stato compilato entro la data di fine della campagna specificata.
```
# 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à obbligatorie:
- advertiserId: l'inserzionista a cui associare questa campagna.
- name: deve essere univoco in tutte le campagne di questo inserzionista.
- defaultLandingPageId: una pagina di destinazione alla quale verranno indirizzati gli utenti quando fanno clic su un annuncio di questa campagna, se non ne è assegnata una a quell'annuncio. 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 di fine: devono essere future e possono essere precise fino al giorno. Per ulteriori dettagli, consulta il punto elenco date e orari in Informazioni generali sul codice. Le date dei singoli annunci possono superare la data di fine per consentire a un publisher di provare a completare un contratto per un numero specifico di azioni, se non è stato compilato entro la data di fine della campagna specificata.
```
# 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à del posizionamento richieste (inclusi campaignId e siteId). Inoltre, accertati di impostare con precisione il tipo e le dimensioni del 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;

Crea un nuovo oggetto PricingSchedule da assegnare al posizionamento.

// Set the pricing schedule for the placement.
PricingSchedule pricingSchedule = new PricingSchedule();
pricingSchedule.EndDate = campaign.EndDate;
pricingSchedule.PricingType = "PRICING_TYPE_CPM";
pricingSchedule.StartDate = campaign.StartDate;
placement.PricingSchedule = pricingSchedule;

Salva l'oggetto Placement chiamando placements.insert(). Assicurati di memorizzare l'ID restituito se desideri utilizzarlo per l'assegnazione a un annuncio o a una creatività.
```
// Insert the placement.
Placement result = service.Placements.Insert(placement, profileId).Execute();
```

Java

// Create the placement.
Placement placement = new Placement();
placement.setName(placementName);
placement.setCampaignId(campaignId);
placement.setCompatibility("DISPLAY");
placement.setPaymentSource("PLACEMENT_AGENCY_PAID");
placement.setSiteId(dfaSiteId);
placement.setTagFormats(ImmutableList.of("PLACEMENT_TAG_STANDARD"));

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

Crea un nuovo oggetto PricingSchedule da assegnare al posizionamento.

// Set the pricing schedule for the placement.
PricingSchedule pricingSchedule = new PricingSchedule();
pricingSchedule.setEndDate(campaign.getEndDate());
pricingSchedule.setPricingType("PRICING_TYPE_CPM");
pricingSchedule.setStartDate(campaign.getStartDate());
placement.setPricingSchedule(pricingSchedule);

Salva l'oggetto Placement chiamando placements.insert(). Assicurati di memorizzare l'ID restituito se desideri utilizzarlo per l'assegnazione a un annuncio o a una creatività.
```
// Insert the placement.
Placement result = reporting.placements().insert(profileId, placement).execute();
```

PHP

$placement = new Google_Service_Dfareporting_Placement();
$placement->setCampaignId($values['campaign_id']);
$placement->setCompatibility('DISPLAY');
$placement->setName($values['placement_name']);
$placement->setPaymentSource('PLACEMENT_AGENCY_PAID');
$placement->setSiteId($values['site_id']);
$placement->setTagFormats(['PLACEMENT_TAG_STANDARD']);

// Set the size of the placement.
$size = new Google_Service_Dfareporting_Size();
$size->setId($values['size_id']);
$placement->setSize($size);

Crea un nuovo oggetto PricingSchedule da assegnare al posizionamento.

// Set the pricing schedule for the placement.
$pricingSchedule = new Google_Service_Dfareporting_PricingSchedule();
$pricingSchedule->setEndDate($campaign->getEndDate());
$pricingSchedule->setPricingType('PRICING_TYPE_CPM');
$pricingSchedule->setStartDate($campaign->getStartDate());
$placement->setPricingSchedule($pricingSchedule);

Salva l'oggetto Placement chiamando placements.insert(). Assicurati di memorizzare l'ID restituito se desideri utilizzarlo per l'assegnazione a un annuncio o a una creatività.
```
// Insert the placement.
$result = $this->service->placements->insert(
    $values['user_profile_id'],
    $placement
);
```

Python

# Construct and save placement.
placement = {
    'name': 'Test Placement',
    'campaignId': campaign_id,
    'compatibility': 'DISPLAY',
    'siteId': site_id,
    'size': {
        'height': '1',
        'width': '1'
    },
    'paymentSource': 'PLACEMENT_AGENCY_PAID',
    'tagFormats': ['PLACEMENT_TAG_STANDARD']
}

Crea un nuovo oggetto PricingSchedule da assegnare al posizionamento.

# Set the pricing schedule for the placement.
placement['pricingSchedule'] = {
    'startDate': campaign['startDate'],
    'endDate': campaign['endDate'],
    'pricingType': 'PRICING_TYPE_CPM'
}

Salva l'oggetto Placement chiamando placements.insert(). Assicurati di memorizzare l'ID restituito se desideri utilizzarlo per l'assegnazione a un annuncio o a una creatività.
```
request = service.placements().insert(profileId=profile_id, body=placement)

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

Ruby

# Create a new placement resource to insert.
placement = DfareportingUtils::API_NAMESPACE::Placement.new(
  campaign_id: campaign_id,
  compatibility: 'DISPLAY',
  name: 'Example Placement',
  payment_source: 'PLACEMENT_AGENCY_PAID',
  site_id: site_id,
  size: DfareportingUtils::API_NAMESPACE::Size.new(
    height: 1,
    width: 1
  ),
  tag_formats: ['PLACEMENT_TAG_STANDARD']
)

Crea un nuovo oggetto PricingSchedule da assegnare al posizionamento.

# Set the pricing schedule for the placement.
placement.pricing_schedule =
  DfareportingUtils::API_NAMESPACE::PricingSchedule.new(
    end_date: campaign.end_date,
    pricing_type: 'PRICING_TYPE_CPM',
    start_date: campaign.start_date
  )

Salva l'oggetto Placement chiamando placements.insert(). Assicurati di memorizzare l'ID restituito se desideri utilizzarlo per l'assegnazione a un annuncio o a una creatività.
```
# Insert the placement strategy.
result = service.insert_placement(profile_id, placement)
```

Carica risorse

Puoi caricare molti tipi di asset tramite una procedura nota come caricamento di contenuti multimediali. Sebbene questo processo sia simile per tutti i tipi di creatività, alcuni tipi potrebbero richiedere il trasferimento di proprietà specifiche come metadati, in modo da poter essere utilizzati correttamente.

C#

Crea un oggetto assetIdentifier e imposta le proprietà richieste. Per tutti gli asset, indipendentemente dal tipo o dall'utilizzo, è necessario specificare un assetIdentifier. Quando assegni l'asset a una creatività, questo oggetto verrà utilizzato per fare riferimento all'asset. Le seguenti proprietà sono obbligatorie:
- La proprietà name, che sarà il nome dell'asset sul server. Il nome deve includere un'estensione che indichi il tipo di file, come .png o .gif, e verrà mostrato al browser con il nome dell'asset, ma non deve essere necessariamente uguale al nome del file originale. Tieni presente che questo nome potrebbe essere modificato da Campaign Manager 360 per renderlo univoco sul server; Controlla il valore restituito per vedere se è stato modificato.
- La proprietà type, che identifica il tipo di asset. Questa proprietà determinerà i tipi di creatività a cui è possibile associare questo asset.
```
// Create the creative asset ID and Metadata.
CreativeAssetId assetId = new CreativeAssetId();
assetId.Name = Path.GetFileName(assetFile);
assetId.Type = assetType;
```

Carica il file chiamando creativeAssets.insert(). Esegui un caricamento di più parti, trasmettendo sia i contenuti assetIdentifier sia i contenuti del file nell'ambito della stessa richiesta. In caso di esito positivo, verrà restituita una risorsa CreativeAsset, con un assetIdentifier che utilizzerai per assegnare questo asset a una creatività.

// Prepare an input stream.
FileStream assetContent = new FileStream(assetFile, FileMode.Open, FileAccess.Read);


CreativeAssetMetadata metaData = new CreativeAssetMetadata();
metaData.AssetIdentifier = assetId;

// Insert the creative.
String mimeType = determineMimeType(assetFile, assetType);
CreativeAssetsResource.InsertMediaUpload request =
    Service.CreativeAssets.Insert(metaData, ProfileId, AdvertiserId, assetContent, mimeType);

IUploadProgress progress = request.Upload();
if (UploadStatus.Failed.Equals(progress.Status)) {
    throw progress.Exception;
}

Java

Crea un oggetto assetIdentifier e imposta le proprietà richieste. Per tutti gli asset, indipendentemente dal tipo o dall'utilizzo, è necessario specificare un assetIdentifier. Quando assegni l'asset a una creatività, questo oggetto verrà utilizzato per fare riferimento all'asset. Le seguenti proprietà sono obbligatorie:
- La proprietà name, che sarà il nome dell'asset sul server. Il nome deve includere un'estensione che indichi il tipo di file, come .png o .gif, e verrà mostrato al browser con il nome dell'asset, ma non deve essere necessariamente uguale al nome del file originale. Tieni presente che questo nome potrebbe essere modificato da Campaign Manager 360 per renderlo univoco sul server; Controlla il valore restituito per vedere se è stato modificato.
- La proprietà type, che identifica il tipo di asset. Questa proprietà determinerà i tipi di creatività a cui è possibile associare questo asset.
```
// Create the creative asset ID and Metadata.
CreativeAssetId assetId = new CreativeAssetId();
assetId.setName(assetName);
assetId.setType(assetType);
```

// Open the asset file.
File file = new File(assetFile);

// Prepare an input stream.
String contentType = getMimeType(assetFile);
InputStreamContent assetContent =
    new InputStreamContent(contentType, new BufferedInputStream(new FileInputStream(file)));
assetContent.setLength(file.length());


CreativeAssetMetadata metaData = new CreativeAssetMetadata();
metaData.setAssetIdentifier(assetId);

// Insert the creative.
CreativeAssetMetadata result = reporting.creativeAssets()
    .insert(profileId, advertiserId, metaData, assetContent).execute();

PHP

Crea un oggetto assetIdentifier e imposta le proprietà richieste. Per tutti gli asset, indipendentemente dal tipo o dall'utilizzo, è necessario specificare un assetIdentifier. Quando assegni l'asset a una creatività, questo oggetto verrà utilizzato per fare riferimento all'asset. Le seguenti proprietà sono obbligatorie:
- La proprietà name, che sarà il nome dell'asset sul server. Il nome deve includere un'estensione che indichi il tipo di file, come .png o .gif, e verrà mostrato al browser con il nome dell'asset, ma non deve essere necessariamente uguale al nome del file originale. Tieni presente che questo nome potrebbe essere modificato da Campaign Manager 360 per renderlo univoco sul server; Controlla il valore restituito per vedere se è stato modificato.
- La proprietà type, che identifica il tipo di asset. Questa proprietà determinerà i tipi di creatività a cui è possibile associare questo asset.
```
$assetId = new Google_Service_Dfareporting_CreativeAssetId();
$assetId->setName($asset['name']);
$assetId->setType($type);
```

$metadata = new Google_Service_Dfareporting_CreativeAssetMetadata();
$metadata->setAssetIdentifier($assetId);

$result = $service->creativeAssets->insert(
    $userProfileId,
    $advertiserId,
    $metadata,
    ['data' => file_get_contents($asset['tmp_name']),
     'mimeType' => $asset['type'],
     'uploadType' => 'multipart']
);

Python

Crea un oggetto assetIdentifier e imposta le proprietà richieste. Per tutti gli asset, indipendentemente dal tipo o dall'utilizzo, è necessario specificare un assetIdentifier. Quando assegni l'asset a una creatività, questo oggetto verrà utilizzato per fare riferimento all'asset. Le seguenti proprietà sono obbligatorie:
- La proprietà name, che sarà il nome dell'asset sul server. Il nome deve includere un'estensione che indichi il tipo di file, come .png o .gif, e verrà mostrato al browser con il nome dell'asset, ma non deve essere necessariamente uguale al nome del file originale. Tieni presente che questo nome potrebbe essere modificato da Campaign Manager 360 per renderlo univoco sul server; Controlla il valore restituito per vedere se è stato modificato.
- La proprietà type, che identifica il tipo di asset. Questa proprietà determinerà i tipi di creatività a cui è possibile associare questo asset.
```
# Construct the creative asset metadata
creative_asset = {'assetIdentifier': {'name': asset_name, 'type': asset_type}}
```
Carica il file chiamando creativeAssets.insert(). Esegui un caricamento di più parti, trasmettendo sia i contenuti assetIdentifier sia i contenuti del file nell'ambito della stessa richiesta. In caso di esito positivo, verrà restituita una risorsa CreativeAsset, con un assetIdentifier che utilizzerai per assegnare questo asset a una creatività.
```
media = MediaFileUpload(path_to_asset_file)
if not media.mimetype():
  media = MediaFileUpload(path_to_asset_file, 'application/octet-stream')

response = service.creativeAssets().insert(
    advertiserId=advertiser_id,
    profileId=profile_id,
    media_body=media,
    body=creative_asset).execute()
```

Ruby

Crea un oggetto assetIdentifier e imposta le proprietà richieste. Per tutti gli asset, indipendentemente dal tipo o dall'utilizzo, è necessario specificare un assetIdentifier. Quando assegni l'asset a una creatività, questo oggetto verrà utilizzato per fare riferimento all'asset. Le seguenti proprietà sono obbligatorie:
- La proprietà name, che sarà il nome dell'asset sul server. Il nome deve includere un'estensione che indichi il tipo di file, come .png o .gif, e verrà mostrato al browser con il nome dell'asset, ma non deve essere necessariamente uguale al nome del file originale. Tieni presente che questo nome potrebbe essere modificato da Campaign Manager 360 per renderlo univoco sul server; Controlla il valore restituito per vedere se è stato modificato.
- La proprietà type, che identifica il tipo di asset. Questa proprietà determinerà i tipi di creatività a cui è possibile associare questo asset.
```
# Construct the creative asset metadata
creative_asset = DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
  asset_identifier: DfareportingUtils::API_NAMESPACE::CreativeAssetId.new(
    name: asset_name,
    type: asset_type
  )
)
```
Carica il file chiamando creativeAssets.insert(). Esegui un caricamento di più parti, trasmettendo sia i contenuti assetIdentifier sia i contenuti del file nell'ambito della stessa richiesta. In caso di esito positivo, verrà restituita una risorsa CreativeAsset, con un assetIdentifier che utilizzerai per assegnare questo asset a una creatività.
```
# Upload the asset.
mime_type = determine_mime_type(path_to_asset_file, asset_type)

result = @service.insert_creative_asset(
  @profile_id,
  advertiser_id,
  creative_asset,
  content_type: mime_type,
  upload_source: path_to_asset_file
)
```

Generazione di una creatività

Un oggetto Creative aggrega un asset esistente. A seconda di come utilizzerai le creatività nella pagina host, puoi creare oggetti Creative di diversi tipi di creatività. Consulta la documentazione di riferimento per stabilire qual è il tipo più adatto a te.

Il seguente esempio mostra come creare una nuova creatività display HTML5.

C#

Carica gli asset. Creatività diverse richiedono tipi e quantità di asset differenti. consulta Caricamento delle risorse per i dettagli. Ogni volta che carichi correttamente un asset, riceverai un assetIdenfitier nella risposta; utilizzerai il nome e il tipo di file memorizzati per fare riferimento a questi asset nella tua creatività, anziché un ID tradizionale.

Crea una creatività e assegna i valori appropriati. Creare un'istanza Creative e impostare il valore type corretto; non puoi modificare il tipo di oggetto Creative dopo averlo salvato. Specifica gli asset in base al valore AssetIdentifier e al relativo role.

// Locate an advertiser landing page to use as a default.
LandingPage defaultLandingPage = getAdvertiserLandingPage(service, profileId, advertiserId);

// Create the creative structure.
Creative creative = new Creative();
creative.AdvertiserId = advertiserId;
creative.Name = "Test HTML5 display creative";
creative.Size = new Size() { Id = sizeId };
creative.Type = "DISPLAY";

// Upload the HTML5 asset.
CreativeAssetUtils assetUtils = new CreativeAssetUtils(service, profileId, advertiserId);
CreativeAssetId html5AssetId =
    assetUtils.uploadAsset(pathToHtml5AssetFile, "HTML").AssetIdentifier;

CreativeAsset html5Asset = new CreativeAsset();
html5Asset.AssetIdentifier = html5AssetId;
html5Asset.Role = "PRIMARY";

// Upload the backup image asset.
CreativeAssetId imageAssetId =
    assetUtils.uploadAsset(pathToImageAssetFile, "HTML_IMAGE").AssetIdentifier;

CreativeAsset imageAsset = new CreativeAsset();
imageAsset.AssetIdentifier = imageAssetId;
imageAsset.Role = "BACKUP_IMAGE";

// Add the creative assets.
creative.CreativeAssets = new List<CreativeAsset>() { html5Asset, imageAsset };

// Configure the bacup image.
creative.BackupImageClickThroughUrl = new CreativeClickThroughUrl() {
  LandingPageId = defaultLandingPage.Id
};
creative.BackupImageReportingLabel = "backup";
creative.BackupImageTargetWindow = new TargetWindow() { TargetWindowOption = "NEW_WINDOW" };

// Add a click tag.
ClickTag clickTag = new ClickTag();
clickTag.Name = "clickTag";
clickTag.EventName = "exit";
clickTag.ClickThroughUrl = new CreativeClickThroughUrl() {
  LandingPageId = defaultLandingPage.Id
};
creative.ClickTags = new List<ClickTag>() { clickTag };

Salva la creatività. Per farlo, chiama creatives.insert(). È necessario specificare un ID inserzionista a cui associare questa creatività.
```
Creative result = service.Creatives.Insert(creative, profileId).Execute();
```

(Facoltativo) Associa la creatività a una campagna. A questo scopo, devi chiamare campaignCreativeAssociations.insert() e inserire gli ID campagna e creatività.

// Create the campaign creative association structure.
CampaignCreativeAssociation association = new CampaignCreativeAssociation();
association.CreativeId = creativeId;

// Insert the association.
CampaignCreativeAssociation result =
    service.CampaignCreativeAssociations.Insert(association, profileId, campaignId).Execute();

Java

Carica gli asset. Creatività diverse richiedono tipi e quantità di asset differenti. consulta Caricamento delle risorse per i dettagli. Ogni volta che carichi correttamente un asset, riceverai un assetIdenfitier nella risposta; utilizzerai il nome e il tipo di file memorizzati per fare riferimento a questi asset nella tua creatività, anziché un ID tradizionale.

// Locate an advertiser landing page to use as a default.
LandingPage defaultLandingPage = getAdvertiserLandingPage(reporting, profileId, advertiserId);

// Create the creative structure.
Creative creative = new Creative();
creative.setAdvertiserId(advertiserId);
creative.setName("Test HTML5 display creative");
creative.setSize(new Size().setId(sizeId));
creative.setType("DISPLAY");

// Upload the HTML5 asset.
CreativeAssetId html5AssetId = CreativeAssetUtils.uploadAsset(reporting, profileId,
    advertiserId, HTML5_ASSET_NAME, PATH_TO_HTML5_ASSET_FILE, "HTML").getAssetIdentifier();

CreativeAsset html5Asset =
    new CreativeAsset().setAssetIdentifier(html5AssetId).setRole("PRIMARY");

// Upload the backup image asset (note: asset type must be set to HTML_IMAGE).
CreativeAssetId imageAssetId = CreativeAssetUtils.uploadAsset(reporting, profileId,
    advertiserId, IMAGE_ASSET_NAME, PATH_TO_IMAGE_ASSET_FILE, "HTML_IMAGE")
    .getAssetIdentifier();

CreativeAsset backupImageAsset =
    new CreativeAsset().setAssetIdentifier(imageAssetId).setRole("BACKUP_IMAGE");

// Add the creative assets.
creative.setCreativeAssets(ImmutableList.of(html5Asset, backupImageAsset));

// Configure the backup image.
creative.setBackupImageClickThroughUrl(
    new CreativeClickThroughUrl().setLandingPageId(defaultLandingPage.getId()));
creative.setBackupImageReportingLabel("backup");
creative.setBackupImageTargetWindow(new TargetWindow().setTargetWindowOption("NEW_WINDOW"));

// Add a click tag.
ClickTag clickTag =
    new ClickTag().setName("clickTag").setEventName("exit").setClickThroughUrl(
        new CreativeClickThroughUrl().setLandingPageId(defaultLandingPage.getId()));
creative.setClickTags(ImmutableList.of(clickTag));

Salva la creatività. Per farlo, chiama creatives.insert(). È necessario specificare un ID inserzionista a cui associare questa creatività.
```
Creative result = reporting.creatives().insert(profileId, creative).execute();
```

(Facoltativo) Associa la creatività a una campagna. A questo scopo, devi chiamare campaignCreativeAssociations.insert() e inserire gli ID campagna e creatività.

// Create the campaign creative association structure.
CampaignCreativeAssociation association = new CampaignCreativeAssociation();
association.setCreativeId(creativeId);

// Insert the association.
CampaignCreativeAssociation result = reporting
    .campaignCreativeAssociations().insert(profileId, campaignId, association)
    .execute();

PHP

Carica gli asset. Creatività diverse richiedono tipi e quantità di asset differenti. consulta Caricamento delle risorse per i dettagli. Ogni volta che carichi correttamente un asset, riceverai un assetIdenfitier nella risposta; utilizzerai il nome e il tipo di file memorizzati per fare riferimento a questi asset nella tua creatività, anziché un ID tradizionale.

$creative = new Google_Service_Dfareporting_Creative();
$creative->setAdvertiserId($values['advertiser_id']);
$creative->setAutoAdvanceImages(true);
$creative->setName('Test HTML5 display creative');
$creative->setType('DISPLAY');

$size = new Google_Service_Dfareporting_Size();
$size->setId($values['size_id']);
$creative->setSize($size);

// Upload the HTML5 asset.
$html = uploadAsset(
    $this->service,
    $values['user_profile_id'],
    $values['advertiser_id'],
    $values['html_asset_file'],
    'HTML'
);

$htmlAsset = new Google_Service_Dfareporting_CreativeAsset();
$htmlAsset->setAssetIdentifier($html->getAssetIdentifier());
$htmlAsset->setRole('PRIMARY');

// Upload the backup image asset.
$image = uploadAsset(
    $this->service,
    $values['user_profile_id'],
    $values['advertiser_id'],
    $values['image_asset_file'],
    'HTML_IMAGE'
);

$imageAsset = new Google_Service_Dfareporting_CreativeAsset();
$imageAsset->setAssetIdentifier($image->getAssetIdentifier());
$imageAsset->setRole('BACKUP_IMAGE');

// Add the creative assets.
$creative->setCreativeAssets([$htmlAsset, $imageAsset]);

// Configure the default click-through URL.
$clickThroughUrl =
    new Google_Service_Dfareporting_CreativeClickThroughUrl();
$clickThroughUrl->setLandingPageId($values['landing_page_id']);

// Configure the backup image.
$creative->setBackupImageClickThroughUrl($clickThroughUrl);
$creative->setBackupImageReportingLabel('backup');

$targetWindow = new Google_Service_Dfareporting_TargetWindow();
$targetWindow->setTargetWindowOption('NEW_WINDOW');
$creative->setBackupImageTargetWindow($targetWindow);

// Add a click tag.
$clickTag = new Google_Service_Dfareporting_ClickTag();
$clickTag->setName('clickTag');
$clickTag->setEventName('exit');
$clickTag->setClickThroughUrl($clickThroughUrl);
$creative->setClickTags([$clickTag]);

Salva la creatività. Per farlo, chiama creatives.insert(). È necessario specificare un ID inserzionista a cui associare questa creatività.
```
$result = $this->service->creatives->insert(
    $values['user_profile_id'],
    $creative
);
```

(Facoltativo) Associa la creatività a una campagna. A questo scopo, devi chiamare campaignCreativeAssociations.insert() e inserire gli ID campagna e creatività.

$association =
    new Google_Service_Dfareporting_CampaignCreativeAssociation();
$association->setCreativeId($values['creative_id']);

$result = $this->service->campaignCreativeAssociations->insert(
    $values['user_profile_id'],
    $values['campaign_id'],
    $association
);

Python

Carica gli asset. Creatività diverse richiedono tipi e quantità di asset differenti. consulta Caricamento delle risorse per i dettagli. Ogni volta che carichi correttamente un asset, riceverai un assetIdenfitier nella risposta; utilizzerai il nome e il tipo di file memorizzati per fare riferimento a questi asset nella tua creatività, anziché un ID tradizionale.

# Locate an advertiser landing page to use as a default.
default_landing_page = get_advertiser_landing_page(service, profile_id,
                                                   advertiser_id)

# Upload the HTML5 asset
html5_asset_id = upload_creative_asset(service, profile_id, advertiser_id,
                                       html5_asset_name,
                                       path_to_html5_asset_file, 'HTML')

# Upload the backup image asset
backup_image_asset_id = upload_creative_asset(
    service, profile_id, advertiser_id, backup_image_name,
    path_to_backup_image_file, 'HTML_IMAGE')

# Construct the creative structure.
creative = {
    'advertiserId': advertiser_id,
    'backupImageClickThroughUrl': {
        'landingPageId': default_landing_page['id']
    },
    'backupImageReportingLabel': 'backup_image_exit',
    'backupImageTargetWindow': {'targetWindowOption': 'NEW_WINDOW'},
    'clickTags': [{
        'eventName': 'exit',
        'name': 'click_tag',
        'clickThroughUrl': {'landingPageId': default_landing_page['id']}
    }],
    'creativeAssets': [
        {'assetIdentifier': html5_asset_id, 'role': 'PRIMARY'},
        {'assetIdentifier': backup_image_asset_id, 'role': 'BACKUP_IMAGE'}
    ],
    'name': 'Test HTML5 display creative',
    'size': {'id': size_id},
    'type': 'DISPLAY'
}

Salva la creatività. Per farlo, chiama creatives.insert(). È necessario specificare un ID inserzionista a cui associare questa creatività.

request = service.creatives().insert(profileId=profile_id, body=creative)

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

(Facoltativo) Associa la creatività a una campagna. A questo scopo, devi chiamare campaignCreativeAssociations.insert() e inserire gli ID campagna e creatività.

# Construct the request.
association = {
    'creativeId': creative_id
}

request = service.campaignCreativeAssociations().insert(
    profileId=profile_id, campaignId=campaign_id, body=association)

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

Ruby

Carica gli asset. Creatività diverse richiedono tipi e quantità di asset differenti. consulta Caricamento delle risorse per i dettagli. Ogni volta che carichi correttamente un asset, riceverai un assetIdenfitier nella risposta; utilizzerai il nome e il tipo di file memorizzati per fare riferimento a questi asset nella tua creatività, anziché un ID tradizionale.

# Locate an advertiser landing page to use as a default.
default_landing_page = get_advertiser_landing_page(service, profile_id,
  advertiser_id)

# Upload the HTML5 asset.
html5_asset_id = util.upload_asset(advertiser_id, path_to_html5_asset_file,
  'HTML').asset_identifier

# Upload the backup image asset.
backup_image_asset_id = util.upload_asset(advertiser_id,
  path_to_backup_image_file, 'HTML_IMAGE').asset_identifier

# Construct the creative structure.
creative = DfareportingUtils::API_NAMESPACE::Creative.new(
  advertiser_id: advertiser_id,
  backup_image_click_through_url:
    DfareportingUtils::API_NAMESPACE::CreativeClickThroughUrl.new(
      landing_page_id: default_landing_page.id
    ),
  backup_image_reporting_label: 'backup',
  backup_image_target_window:
    DfareportingUtils::API_NAMESPACE::TargetWindow.new(
      target_window_option: 'NEW_WINDOW'
    ),
  click_tags: [
    DfareportingUtils::API_NAMESPACE::ClickTag.new(
      event_name: 'exit',
      name: 'click_tag',
      click_through_url:
        DfareportingUtils::API_NAMESPACE::CreativeClickThroughUrl.new(
          landing_page_id: default_landing_page.id
        )
    )
  ],
  creative_assets: [
    DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
      asset_identifier: html5_asset_id,
      role: 'PRIMARY'
    ),
    DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
      asset_identifier: backup_image_asset_id,
      role: 'BACKUP_IMAGE'
    )
  ],
  name: 'Example HTML5 display creative',
  size: DfareportingUtils::API_NAMESPACE::Size.new(id: size_id),
  type: 'DISPLAY'
)

Salva la creatività. Per farlo, chiama creatives.insert(). È necessario specificare un ID inserzionista a cui associare questa creatività.
```
# Insert the creative.
result = service.insert_creative(profile_id, creative)
```

(Facoltativo) Associa la creatività a una campagna. A questo scopo, devi chiamare campaignCreativeAssociations.insert() e inserire gli ID campagna e creatività.

# Create a new creative-campaign association to insert
association =
  DfareportingUtils::API_NAMESPACE::CampaignCreativeAssociation.new(
    creative_id: creative_id
  )

# Insert the advertiser group.
result = service.insert_campaign_creative_association(profile_id, campaign_id,
  association)

Crea un annuncio

Ad è il collegamento tra Creative e Placement. Un Ad può essere collegato a uno o più posizionamenti e può contenere una o più creatività.

Puoi creare un Ad in modo esplicito o implicito.

Esplicitamente

C#

Crea un oggetto CreativeAssignment per ogni creatività a cui questo annuncio deve essere associato. Assicurati di impostare il campo CreativeAssignment.active su true.

// Create a click-through URL.
ClickThroughUrl clickThroughUrl = new ClickThroughUrl();
clickThroughUrl.DefaultLandingPage = true;

// Create a creative assignment.
CreativeAssignment creativeAssignment = new CreativeAssignment();
creativeAssignment.Active = true;
creativeAssignment.CreativeId = creativeId;
creativeAssignment.ClickThroughUrl = clickThroughUrl;

Crea un oggetto CreativeRotation per archiviare i CreativeAssignment. Se crei un gruppo di rotazione, assicurati di impostare gli altri campi obbligatori per la rotazione delle creatività.

// Create a creative rotation.
CreativeRotation creativeRotation = new CreativeRotation();
creativeRotation.CreativeAssignments = new List<CreativeAssignment>() {
    creativeAssignment
};

Crea un oggetto PlacementAssignment per ogni posizionamento a cui questo annuncio deve essere associato. Assicurati di impostare il campo PlacementAssignment.active su true.

// Create a placement assignment.
PlacementAssignment placementAssignment = new PlacementAssignment();
placementAssignment.Active = true;
placementAssignment.PlacementId = placementId;

Crea un oggetto Ad. Imposta il creativeRotazione nel campo creativeRotation dell'oggetto Ad e i posizionamenti assegnati nell'array placementAssignments dell'oggetto Ad.

// Create a delivery schedule.
DeliverySchedule deliverySchedule = new DeliverySchedule();
deliverySchedule.ImpressionRatio = 1;
deliverySchedule.Priority = "AD_PRIORITY_01";

DateTime startDate = DateTime.Now;
DateTime endDate = Convert.ToDateTime(campaign.EndDate);

// Create a rotation group.
Ad rotationGroup = new Ad();
rotationGroup.Active = true;
rotationGroup.CampaignId = campaignId;
rotationGroup.CreativeRotation = creativeRotation;
rotationGroup.DeliverySchedule = deliverySchedule;
rotationGroup.StartTime = startDate;
rotationGroup.EndTime = endDate;
rotationGroup.Name = adName;
rotationGroup.PlacementAssignments = new List<PlacementAssignment>() {
    placementAssignment
};
rotationGroup.Type = "AD_SERVING_STANDARD_AD";

Salva l'annuncio chiamando ads.insert().

// Insert the rotation group.
Ad result = service.Ads.Insert(rotationGroup, profileId).Execute();

Java

Crea un oggetto CreativeAssignment per ogni creatività a cui questo annuncio deve essere associato. Assicurati di impostare il campo CreativeAssignment.active su true.

// Create a click-through URL.
ClickThroughUrl clickThroughUrl = new ClickThroughUrl();
clickThroughUrl.setDefaultLandingPage(true);

// Create a creative assignment.
CreativeAssignment creativeAssignment = new CreativeAssignment();
creativeAssignment.setActive(true);
creativeAssignment.setCreativeId(creativeId);
creativeAssignment.setClickThroughUrl(clickThroughUrl);

Crea un oggetto CreativeRotation per archiviare i CreativeAssignment. Se crei un gruppo di rotazione, assicurati di impostare gli altri campi obbligatori per la rotazione delle creatività.
```
// Create a creative rotation.
CreativeRotation creativeRotation = new CreativeRotation();
creativeRotation.setCreativeAssignments(ImmutableList.of(creativeAssignment));
```

Crea un oggetto PlacementAssignment per ogni posizionamento a cui questo annuncio deve essere associato. Assicurati di impostare il campo PlacementAssignment.active su true.

// Create a placement assignment.
PlacementAssignment placementAssignment = new PlacementAssignment();
placementAssignment.setActive(true);
placementAssignment.setPlacementId(placementId);

Crea un oggetto Ad. Imposta il creativeRotazione nel campo creativeRotation dell'oggetto Ad e i posizionamenti assegnati nell'array placementAssignments dell'oggetto Ad.

// Create a delivery schedule.
DeliverySchedule deliverySchedule = new DeliverySchedule();
deliverySchedule.setImpressionRatio(1L);
deliverySchedule.setPriority("AD_PRIORITY_01");

DateTime startDate = new DateTime(new Date());
DateTime endDate = new DateTime(campaign.getEndDate().getValue());

// Create a rotation group.
Ad rotationGroup = new Ad();
rotationGroup.setActive(true);
rotationGroup.setCampaignId(campaignId);
rotationGroup.setCreativeRotation(creativeRotation);
rotationGroup.setDeliverySchedule(deliverySchedule);
rotationGroup.setStartTime(startDate);
rotationGroup.setEndTime(endDate);
rotationGroup.setName(adName);
rotationGroup.setPlacementAssignments(ImmutableList.of(placementAssignment));
rotationGroup.setType("AD_SERVING_STANDARD_AD");

Salva l'annuncio chiamando ads.insert().

// Insert the rotation group.
Ad result = reporting.ads().insert(profileId, rotationGroup).execute();

PHP

Crea un oggetto CreativeAssignment per ogni creatività a cui questo annuncio deve essere associato. Assicurati di impostare il campo CreativeAssignment.active su true.

// Create a click-through URL.
$url = new Google_Service_Dfareporting_ClickThroughUrl();
$url->setDefaultLandingPage(true);

// Create a creative assignment.
$creativeAssignment =
    new Google_Service_Dfareporting_CreativeAssignment();
$creativeAssignment->setActive(true);
$creativeAssignment->setCreativeId($values['creative_id']);
$creativeAssignment->setClickThroughUrl($url);

Crea un oggetto CreativeRotation per archiviare i CreativeAssignment. Se crei un gruppo di rotazione, assicurati di impostare gli altri campi obbligatori per la rotazione delle creatività.
```
// Create a creative rotation.
$creativeRotation = new Google_Service_Dfareporting_CreativeRotation();
$creativeRotation->setCreativeAssignments([$creativeAssignment]);
```

Crea un oggetto PlacementAssignment per ogni posizionamento a cui questo annuncio deve essere associato. Assicurati di impostare il campo PlacementAssignment.active su true.

// Create a placement assignment.
$placementAssignment =
    new Google_Service_Dfareporting_PlacementAssignment();
$placementAssignment->setActive(true);
$placementAssignment->setPlacementId($values['placement_id']);

Crea un oggetto Ad. Imposta il creativeRotazione nel campo creativeRotation dell'oggetto Ad e i posizionamenti assegnati nell'array placementAssignments dell'oggetto Ad.

// Create a delivery schedule.
$deliverySchedule = new Google_Service_Dfareporting_DeliverySchedule();
$deliverySchedule->setImpressionRatio(1);
$deliverySchedule->SetPriority('AD_PRIORITY_01');

$startDate = new DateTime('today');
$endDate = new DateTime($campaign->getEndDate());

// Create a rotation group.
$ad = new Google_Service_Dfareporting_Ad();
$ad->setActive(true);
$ad->setCampaignId($values['campaign_id']);
$ad->setCreativeRotation($creativeRotation);
$ad->setDeliverySchedule($deliverySchedule);
$ad->setStartTime($startDate->format('Y-m-d') . 'T23:59:59Z');
$ad->setEndTime($endDate->format('Y-m-d') . 'T00:00:00Z');
$ad->setName($values['ad_name']);
$ad->setPlacementAssignments([$placementAssignment]);
$ad->setType('AD_SERVING_STANDARD_AD');

Salva l'annuncio chiamando ads.insert().

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

Python

Crea un oggetto CreativeAssignment per ogni creatività a cui questo annuncio deve essere associato. Assicurati di impostare il campo CreativeAssignment.active su true.

# Construct creative assignment.
creative_assignment = {
    'active': 'true',
    'creativeId': creative_id,
    'clickThroughUrl': {
        'defaultLandingPage': 'true'
    }
}

Crea un oggetto CreativeRotation per archiviare i CreativeAssignment. Se crei un gruppo di rotazione, assicurati di impostare gli altri campi obbligatori per la rotazione delle creatività.

# Construct creative rotation.
creative_rotation = {
    'creativeAssignments': [creative_assignment],
    'type': 'CREATIVE_ROTATION_TYPE_RANDOM',
    'weightCalculationStrategy': 'WEIGHT_STRATEGY_OPTIMIZED'
}

Crea un oggetto PlacementAssignment per ogni posizionamento a cui questo annuncio deve essere associato. Assicurati di impostare il campo PlacementAssignment.active su true.
```
# Construct placement assignment.
placement_assignment = {
    'active': 'true',
    'placementId': placement_id,
}
```

Crea un oggetto Ad. Imposta il creativeRotazione nel campo creativeRotation dell'oggetto Ad e i posizionamenti assegnati nell'array placementAssignments dell'oggetto Ad.

# Construct delivery schedule.
delivery_schedule = {
    'impressionRatio': '1',
    'priority': 'AD_PRIORITY_01'
}

# Construct and save ad.
ad = {
    'active': 'true',
    'campaignId': campaign_id,
    'creativeRotation': creative_rotation,
    'deliverySchedule': delivery_schedule,
    'endTime': '%sT00:00:00Z' % campaign['endDate'],
    'name': 'Test Rotation Group',
    'placementAssignments': [placement_assignment],
    'startTime': '%sT23:59:59Z' % time.strftime('%Y-%m-%d'),
    'type': 'AD_SERVING_STANDARD_AD'
}

Salva l'annuncio chiamando ads.insert().

request = service.ads().insert(profileId=profile_id, body=ad)

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

Ruby

Crea un oggetto CreativeAssignment per ogni creatività a cui questo annuncio deve essere associato. Assicurati di impostare il campo CreativeAssignment.active su true.

# Construct creative assignment.
creative_assignment =
  DfareportingUtils::API_NAMESPACE::CreativeAssignment.new(
    active: true,
    creative_id: creative_id,
    click_through_url: DfareportingUtils::API_NAMESPACE::ClickThroughUrl.new(
      default_landing_page: true
    )
  )

Crea un oggetto CreativeRotation per archiviare i CreativeAssignment. Se crei un gruppo di rotazione, assicurati di impostare gli altri campi obbligatori per la rotazione delle creatività.

# Construct creative rotation.
creative_rotation = DfareportingUtils::API_NAMESPACE::CreativeRotation.new(
  creative_assignments: [creative_assignment],
  type: 'CREATIVE_ROTATION_TYPE_RANDOM',
  weight_calculation_strategy: 'WEIGHT_STRATEGY_OPTIMIZED'
)

Crea un oggetto PlacementAssignment per ogni posizionamento a cui questo annuncio deve essere associato. Assicurati di impostare il campo PlacementAssignment.active su true.

# Construct placement assignment.
placement_assignment =
  DfareportingUtils::API_NAMESPACE::PlacementAssignment.new(
    active: true,
    placement_id: placement_id
  )

Crea un oggetto Ad. Imposta il creativeRotazione nel campo creativeRotation dell'oggetto Ad e i posizionamenti assegnati nell'array placementAssignments dell'oggetto Ad.

# Construct delivery schedule.
delivery_schedule = DfareportingUtils::API_NAMESPACE::DeliverySchedule.new(
  impression_ratio: 1,
  priority: 'AD_PRIORITY_01'
)

# Construct and save ad.
ad = DfareportingUtils::API_NAMESPACE::Ad.new(
  active: true,
  campaign_id: campaign_id,
  creative_rotation: creative_rotation,
  delivery_schedule: delivery_schedule,
  end_time: format('%sT00:00:00Z', campaign.end_date),
  name: 'Example Rotation Group',
  placement_assignments: [placement_assignment],
  start_time: format('%sT23:59:59Z', Time.now.strftime('%Y-%m-%d')),
  type: 'AD_SERVING_STANDARD_AD'
)

Salva l'annuncio chiamando ads.insert().

result = service.insert_ad(profile_id, ad)

Implicito

C#

Crea e salva un Placement.
Crea e salva un Creative.

Associa Creative allo stesso Campaign utilizzato per Placement chiamando campaignCreativeAssociations.insert() (vedi il passaggio 4 nella sezione Creazione di una creatività). Verrà creato un annuncio predefinito associato sia alla creatività sia al posizionamento.

// Create the campaign creative association structure.
CampaignCreativeAssociation association = new CampaignCreativeAssociation();
association.CreativeId = creativeId;

// Insert the association.
CampaignCreativeAssociation result =
    service.CampaignCreativeAssociations.Insert(association, profileId, campaignId).Execute();

Java

Crea e salva un Placement.
Crea e salva un Creative.

// Create the campaign creative association structure.
CampaignCreativeAssociation association = new CampaignCreativeAssociation();
association.setCreativeId(creativeId);

// Insert the association.
CampaignCreativeAssociation result = reporting
    .campaignCreativeAssociations().insert(profileId, campaignId, association)
    .execute();

PHP

Crea e salva un Placement.
Crea e salva un Creative.

$association =
    new Google_Service_Dfareporting_CampaignCreativeAssociation();
$association->setCreativeId($values['creative_id']);

$result = $this->service->campaignCreativeAssociations->insert(
    $values['user_profile_id'],
    $values['campaign_id'],
    $association
);

Python

Crea e salva un Placement.
Crea e salva un Creative.

# Construct the request.
association = {
    'creativeId': creative_id
}

request = service.campaignCreativeAssociations().insert(
    profileId=profile_id, campaignId=campaign_id, body=association)

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

Ruby

Crea e salva un Placement.
Crea e salva un Creative.

# Create a new creative-campaign association to insert
association =
  DfareportingUtils::API_NAMESPACE::CampaignCreativeAssociation.new(
    creative_id: creative_id
  )

# Insert the advertiser group.
result = service.insert_campaign_creative_association(profile_id, campaign_id,
  association)

La creazione di un annuncio implicitamente salva il passaggio aggiuntivo relativo alla creazione di un Ad. Tieni presente che questa operazione può essere eseguita solo se nella tua campagna non esiste già un annuncio predefinito delle dimensioni specificate.

Cercare oggetti

Puoi cercare oggetti chiamando l'operazione list() esposta dal servizio che definisce l'oggetto da trovare, specificando criteri facoltativi appropriati per quel tipo di oggetto. Ad esempio, per cercare oggetti dell'annuncio, devi chiamare ads.list(). I criteri facoltativi espongono un insieme di proprietà appropriate per l'oggetto in questione. e compilare tutte le proprietà che vuoi cercare. La ricerca restituirà solo gli oggetti che soddisfano tutti i criteri; non è possibile eseguire una ricerca corrispondente a un criterio. Le stringhe supportano il carattere jolly *, non sono sensibili alle maiuscole e corrispondono all'interno di stringhe più grandi.

Per migliorare le prestazioni, è possibile richiedere risposte parziali utilizzando il parametro fields. Questo indica al server di restituire solo i campi specificati, anziché la rappresentazione completa della risorsa. Per ulteriori informazioni su questo argomento, consulta la guida Suggerimenti per il rendimento.

Paging

A volte non è consigliabile recuperare tutti i risultati di una richiesta list(). Ad esempio, potrebbero essere interessati solo i 10 annunci più recenti provenienti da un pool di migliaia di utenti. Per semplificare questa operazione, molti metodi di list() consentono di richiedere meno risultati tramite un processo noto come paging.

I metodi che supportano il paging restituiscono sottoinsiemi di risultati in gruppi chiamati pagine. Il numero massimo di risultati per pagina è 1000 (valore predefinito). Puoi modificare il numero di risultati per pagina impostando il maxResults e puoi scorrere le pagine utilizzando il nextPageToken restituito nella risposta:

C#

// Limit the fields returned.
String fields = "nextPageToken,ads(advertiserId,id,name)";

AdsListResponse result;
String nextPageToken = null;

do {
  // Create and execute the ad list request.
  AdsResource.ListRequest request = service.Ads.List(profileId);
  request.Active = true;
  request.Fields = fields;
  request.PageToken = nextPageToken;
  result = request.Execute();

  foreach (Ad ad in result.Ads) {
    Console.WriteLine(
        "Ad with ID {0} and name \"{1}\" is associated with advertiser" +
        " ID {2}.", ad.Id, ad.Name, ad.AdvertiserId);
  }

  // Update the next page token.
  nextPageToken = result.NextPageToken;
} while (result.Ads.Any() && !String.IsNullOrEmpty(nextPageToken));

Java

// Limit the fields returned.
String fields = "nextPageToken,ads(advertiserId,id,name)";

AdsListResponse result;
String nextPageToken = null;

do {
  // Create and execute the ad list request.
  result = reporting.ads().list(profileId).setActive(true).setFields(fields)
      .setPageToken(nextPageToken).execute();

  for (Ad ad : result.getAds()) {
    System.out.printf(
        "Ad with ID %d and name \"%s\" is associated with advertiser ID %d.%n", ad.getId(),
        ad.getName(), ad.getAdvertiserId());
  }

  // Update the next page token.
  nextPageToken = result.getNextPageToken();
} while (!result.getAds().isEmpty() && !Strings.isNullOrEmpty(nextPageToken));

PHP

$response = null;
$pageToken = null;

do {
    // Create and execute the ads list request.
    $response = $this->service->ads->listAds(
        $values['user_profile_id'],
        ['active' => true, 'pageToken' => $pageToken]
    );

    foreach ($response->getAds() as $ads) {
        $this->printResultsTableRow($ads);
    }

    // Update the next page token.
    $pageToken = $response->getNextPageToken();
} while (!empty($response->getAds()) && !empty($pageToken));

Python

# Construct the request.
request = service.ads().list(profileId=profile_id, active=True)

while True:
  # Execute request and print response.
  response = request.execute()

  for ad in response['ads']:
    print 'Found ad with ID %s and name "%s".' % (ad['id'], ad['name'])

  if response['ads'] and response['nextPageToken']:
    request = service.ads().list_next(request, response)
  else:
    break

Ruby

token = nil
loop do
  result = service.list_ads(profile_id,
    page_token: token,
    fields: 'nextPageToken,ads(id,name)')

  # Display results.
  if result.ads.any?
    result.ads.each do |ad|
      puts format('Found ad with ID %d and name "%s".', ad.id, ad.name)
    end

    token = result.next_page_token
  else
    # Stop paging if there are no more results.
    token = nil
  end

  break if token.to_s.empty?
end

Generare tag Floodlight

I tag Floodlight sono tag HTML incorporati in una pagina, utilizzati per monitorare le azioni degli utenti (ad esempio gli acquisti) all'interno di un sito. Per generare tag Floodlight, è necessaria una FloodlightActivity che appartiene a un FloodlightActivityGroup:

C#

Crea un nuovo gruppo attività Floodlight, trasmettendo i valori per name, type e floodlightConfigurationId.

// Create the floodlight activity group.
FloodlightActivityGroup floodlightActivityGroup = new FloodlightActivityGroup();
floodlightActivityGroup.Name = groupName;
floodlightActivityGroup.FloodlightConfigurationId = floodlightConfigurationId;
floodlightActivityGroup.Type = "COUNTER";

Salva il gruppo attività Floodlight chiamando floodlightActivityGroups.insert(). Verrà restituito l'ID del nuovo gruppo.

// Insert the activity group.
FloodlightActivityGroup result =
    service.FloodlightActivityGroups.Insert(floodlightActivityGroup, profileId).Execute();

Crea una nuova attività Floodlight e assegnale l'ID del gruppo attività Floodlight appena creato, nonché tutti gli altri campi obbligatori.

// Set floodlight activity structure.
FloodlightActivity activity = new FloodlightActivity();
activity.CountingMethod = "STANDARD_COUNTING";
activity.Name = activityName;
activity.FloodlightActivityGroupId = activityGroupId;
activity.FloodlightTagType = "GLOBAL_SITE_TAG";
activity.ExpectedUrl = url;

Salva la nuova attività chiamando il numero floodlightActivities.insert(), che restituirà l'ID della nuova attività.

// Create the floodlight tag activity.
FloodlightActivity result =
    service.FloodlightActivities.Insert(activity, profileId).Execute();

Genera i tag chiamando floodlightActivities.generatetag() con il floodlightActivityId della tua nuova attività. Invia i tag al webmaster del sito web dell'inserzionista.

// Generate the floodlight activity tag.
FloodlightActivitiesResource.GeneratetagRequest request =
    service.FloodlightActivities.Generatetag(profileId);
request.FloodlightActivityId = activityId;

FloodlightActivitiesGenerateTagResponse response = request.Execute();

Java

Crea un nuovo gruppo attività Floodlight, trasmettendo i valori per name, type e floodlightConfigurationId.

// Create the floodlight activity group.
FloodlightActivityGroup floodlightActivityGroup = new FloodlightActivityGroup();
floodlightActivityGroup.setName(groupName);
floodlightActivityGroup.setFloodlightConfigurationId(floodlightConfigurationId);
floodlightActivityGroup.setType("COUNTER");

Salva il gruppo attività Floodlight chiamando floodlightActivityGroups.insert(). Verrà restituito l'ID del nuovo gruppo.

// Insert the activity group.
FloodlightActivityGroup result =
    reporting.floodlightActivityGroups().insert(profileId, floodlightActivityGroup).execute();

Crea una nuova attività Floodlight e assegnale l'ID del gruppo attività Floodlight appena creato, nonché tutti gli altri campi obbligatori.

// Set floodlight activity structure.
FloodlightActivity activity = new FloodlightActivity();
activity.setName(activityName);
activity.setCountingMethod("STANDARD_COUNTING");
activity.setExpectedUrl(url);
activity.setFloodlightActivityGroupId(activityGroupId);
activity.setFloodlightTagType("GLOBAL_SITE_TAG");

Salva la nuova attività chiamando il numero floodlightActivities.insert(), che restituirà l'ID della nuova attività.

// Create the floodlight tag activity.
FloodlightActivity result =
    reporting.floodlightActivities().insert(profileId, activity).execute();

Genera i tag chiamando floodlightActivities.generatetag() con il floodlightActivityId della tua nuova attività. Invia i tag al webmaster del sito web dell'inserzionista.

// Generate the floodlight activity tag.
Generatetag request = reporting.floodlightActivities().generatetag(profileId);
request.setFloodlightActivityId(activityId);

FloodlightActivitiesGenerateTagResponse response = request.execute();

PHP

Crea un nuovo gruppo attività Floodlight, trasmettendo i valori per name, type e floodlightConfigurationId.

$group = new Google_Service_Dfareporting_FloodlightActivityGroup();
$group->setFloodlightConfigurationId($values['configuration_id']);
$group->setName($values['group_name']);
$group->setType('COUNTER');

Salva il gruppo attività Floodlight chiamando floodlightActivityGroups.insert(). Verrà restituito l'ID del nuovo gruppo.
```
$result = $this->service->floodlightActivityGroups->insert(
    $values['user_profile_id'],
    $group
);
```

Crea una nuova attività Floodlight e assegnale l'ID del gruppo attività Floodlight appena creato, nonché tutti gli altri campi obbligatori.

$activity = new Google_Service_Dfareporting_FloodlightActivity();
$activity->setCountingMethod('STANDARD_COUNTING');
$activity->setExpectedUrl($values['url']);
$activity->setFloodlightActivityGroupId($values['activity_group_id']);
$activity->setFloodlightTagType('GLOBAL_SITE_TAG');
$activity->setName($values['activity_name']);

Salva la nuova attività chiamando il numero floodlightActivities.insert(), che restituirà l'ID della nuova attività.
```
$result = $this->service->floodlightActivities->insert(
    $values['user_profile_id'],
    $activity
);
```
Genera i tag chiamando floodlightActivities.generatetag() con il floodlightActivityId della tua nuova attività. Invia i tag al webmaster del sito web dell'inserzionista.
```
$result = $this->service->floodlightActivities->generatetag(
    $values['user_profile_id'],
    ['floodlightActivityId' => $values['activity_id']]
);
```

Python

Crea un nuovo gruppo attività Floodlight, trasmettendo i valori per name, type e floodlightConfigurationId.

# Construct and save floodlight activity group.
activity_group = {
    'name': 'Test Floodlight Activity Group',
    'floodlightConfigurationId': floodlight_config_id,
    'type': 'COUNTER'
}

Salva il gruppo attività Floodlight chiamando floodlightActivityGroups.insert(). Verrà restituito l'ID del nuovo gruppo.
```
request = service.floodlightActivityGroups().insert(
    profileId=profile_id, body=activity_group)
```

Crea una nuova attività Floodlight e assegnale l'ID del gruppo attività Floodlight appena creato, nonché tutti gli altri campi obbligatori.

# Construct and save floodlight activity.
floodlight_activity = {
    'countingMethod': 'STANDARD_COUNTING',
    'expectedUrl': 'http://www.google.com',
    'floodlightActivityGroupId': activity_group_id,
    'floodlightTagType': 'GLOBAL_SITE_TAG',
    'name': 'Test Floodlight Activity'
}

Salva la nuova attività chiamando il numero floodlightActivities.insert(), che restituirà l'ID della nuova attività.
```
request = service.floodlightActivities().insert(
    profileId=profile_id, body=floodlight_activity)
```

Genera i tag chiamando floodlightActivities.generatetag() con il floodlightActivityId della tua nuova attività. Invia i tag al webmaster del sito web dell'inserzionista.

# Construct the request.
request = service.floodlightActivities().generatetag(
    profileId=profile_id, floodlightActivityId=activity_id)

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

Ruby

Crea un nuovo gruppo attività Floodlight, trasmettendo i valori per name, type e floodlightConfigurationId.

# Create a new floodlight activity group resource to insert.
activity_group =
  DfareportingUtils::API_NAMESPACE::FloodlightActivityGroup.new(
    floodlight_configuration_id: floodlight_config_id,
    name:
      format('Example Floodlight Activity Group #%s', SecureRandom.hex(3)),
    type: 'COUNTER'
  )

Salva il gruppo attività Floodlight chiamando floodlightActivityGroups.insert(). Verrà restituito l'ID del nuovo gruppo.

# Insert the floodlight activity group.
result = service.insert_floodlight_activity_group(profile_id, activity_group)

Crea una nuova attività Floodlight e assegnale l'ID del gruppo attività Floodlight appena creato, nonché tutti gli altri campi obbligatori.

# Create a new floodlight activity resource to insert.
activity = DfareportingUtils::API_NAMESPACE::FloodlightActivity.new(
  counting_method: 'STANDARD_COUNTING',
  expected_url: 'http://www.google.com',
  floodlight_activity_group_id: activity_group_id,
  floodlight_tag_type: 'GLOBAL_SITE_TAG',
  name: format('Example Floodlight Activity #%s', SecureRandom.hex(3))
)

Salva la nuova attività chiamando il numero floodlightActivities.insert(), che restituirà l'ID della nuova attività.
```
# Insert the floodlight activity.
result = service.insert_floodlight_activity(profile_id, activity)
```
Genera i tag chiamando floodlightActivities.generatetag() con il floodlightActivityId della tua nuova attività. Invia i tag al webmaster del sito web dell'inserzionista.
```
# Construct the request.
result = service.generatetag_floodlight_activity(profile_id,
  floodlight_activity_id: activity_id)
```

Genera tag di posizionamento

L'ultimo passaggio consiste nel generare tag HTML da inviare al publisher per visualizzare gli annunci. Per generare i tag tramite l'API, effettua una richiesta a placements.generatetags(), specificando un set di placementIds e tagFormats.

C#

// Generate the placement activity tags.
PlacementsResource.GeneratetagsRequest request =
    service.Placements.Generatetags(profileId);
request.CampaignId = campaignId;
request.TagFormats =
    PlacementsResource.GeneratetagsRequest.TagFormatsEnum.PLACEMENTTAGIFRAMEJAVASCRIPT;
request.PlacementIds = placementId.ToString();

PlacementsGenerateTagsResponse response = request.Execute();

Java

// Generate the placement activity tags.
Generatetags request = reporting.placements().generatetags(profileId);
request.setCampaignId(campaignId);
request.setTagFormats(tagFormats);
request.setPlacementIds(ImmutableList.of(placementId));

PlacementsGenerateTagsResponse response = request.execute();

PHP

$placementTags = $this->service->placements->generatetags(
    $values['user_profile_id'],
    ['campaignId' => $values['campaign_id'],
     'placementIds' => [$values['placement_id']],
     'tagFormats' => ['PLACEMENT_TAG_STANDARD',
                      'PLACEMENT_TAG_IFRAME_JAVASCRIPT',
                      'PLACEMENT_TAG_INTERNAL_REDIRECT']
    ]
);

Python

# Construct the request.
request = service.placements().generatetags(
    profileId=profile_id, campaignId=campaign_id,
    placementIds=[placement_id])

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

Ruby

# Construct the request.
result = service.generate_placement_tags(profile_id,
  campaign_id: campaign_id,
  placement_ids: [placement_id])

Attività di trafficking comuni Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Suggerimenti generali per la programmazione

Creazione di un inserzionista

C#

Java

PHP

Python

Ruby

Creare una campagna

C#

Java

PHP

Python

Ruby

Creare un posizionamento

C#

Java

PHP

Python

Ruby

Carica risorse

C#

Java

PHP

Python

Ruby

Generazione di una creatività

C#

Java

PHP

Python

Ruby

Crea un annuncio

Esplicitamente

C#

Java

PHP

Python

Ruby

Implicito

C#

Java

PHP

Python

Ruby

Cercare oggetti

Paging

C#

Java

PHP

Python

Ruby

Generare tag Floodlight

C#

Java

PHP

Python

Ruby

Genera tag di posizionamento

C#

Java

PHP

Python

Ruby

Attività di trafficking comuni