Einen Werbetreibenden erstellen

Ein Werbetreibender ist ein Unternehmen, das Werbekampagnen schaltet. Advertiser-Ressourcen haben folgende Funktionen:

  • Host für allgemeine Einstellungen, die von den untergeordneten Ressourcen verwendet werden.
  • Markensicherheitseinstellungen für alle Anzeigen durchzusetzen, die ausgeliefert werden
  • Sie sind Inhaber der Creatives, die als Anzeigen ausgeliefert werden.
  • Entitäten verwalten, die für die Anzeigenausrichtung verwendet werden. Dazu gehören Channels und Standortlisten.

Wenn Sie einen vorhandenen Werbetreibenden verwenden, können Sie direkt zum Abschnitt Kampagne erstellen springen.

Konfigurationen auswählen

Bevor Sie einen Werbetreibenden erstellen, sollten Sie sich die folgenden Einstellungen ansehen und eine Entscheidung treffen:

Die Ressource Advertiser hat auch viele optionale Felder. Weitere Informationen finden Sie in der Referenzdokumentation.

Werbetreibenden erstellen

So erstellen Sie einen Werbetreibenden:

Java

// Provide the ID of the parent partner.
long partnerId = partner-id;

// Provide the display name of the advertiser.
String displayName = display-name;

// Provide the ID of the billing profile for the advertiser to use.
long billingProfileId = billing-profile-id;

// Provide whether or not the advertiser will serve EU political ads.
String containsEuPoliticalAds = contains-eu-political-ads;

// Provide the domain URL and currency code of the advertiser.
String domainUrl = "http://www.google.com";
String currencyCode = "USD";

// Create the advertiser structure.
Advertiser advertiser =
    new Advertiser()
        .setPartnerId(partnerId)
        .setDisplayName(displayName)
        .setEntityStatus("ENTITY_STATUS_ACTIVE")
        .setContainsEuPoliticalAds(containsEuPoliticalAds);

// Create and set the advertiser general configuration.
AdvertiserGeneralConfig advertiserGeneralConfig =
    new AdvertiserGeneralConfig().setDomainUrl(domainUrl).setCurrencyCode(currencyCode);
advertiser.setGeneralConfig(advertiserGeneralConfig);

// Create the ad server configuration structure.
AdvertiserAdServerConfig advertiserAdServerConfig = new AdvertiserAdServerConfig();

// Create and add the third party only configuration to the ad server configuration.
ThirdPartyOnlyConfig thirdPartyOnlyConfig = new ThirdPartyOnlyConfig();
advertiserAdServerConfig.setThirdPartyOnlyConfig(thirdPartyOnlyConfig);

// Set the ad server configuration.
advertiser.setAdServerConfig(advertiserAdServerConfig);

// Create and set the billing configuration.
AdvertiserBillingConfig advertiserBillingConfig = new AdvertiserBillingConfig();
advertiserBillingConfig.setBillingProfileId(billingProfileId);
advertiser.setBillingConfig(advertiserBillingConfig);

// Configure the create request.
Advertisers.Create request = service.advertisers().create(advertiser);

// Create the advertiser.
Advertiser response = request.execute();

// Display the new advertiser ID.
System.out.printf("Advertiser %s was created.", response.getName());

Python

# Provide the ID of the parent partner.
partner_id = partner-id

# Provide the display name of the advertiser.
display_name = display-name

# Provide the domain URL and currency code of the advertiser.
domain_url = "http://www.google.com"
currency_code = "USD"

# Provide the ID of the billing profile for the advertiser to use.
billing_profile_id = billing-profile-id

# Provide whether or not the advertiser will serve EU political ads.
contains_eu_political_ads = contains-eu-political-ads

# Create the advertiser object.
advertiser_obj = {
    "partnerId": partner_id,
    "displayName": display_name,
    "entityStatus": "ENTITY_STATUS_ACTIVE",
    "generalConfig": {"domainUrl": domain_url, "currencyCode": currency_code},
    "adServerConfig": {"thirdPartyOnlyConfig": {}},
    "creativeConfig": {},
    "billingConfig": {"billingProfileId": billing_profile_id},
    "containsEuPoliticalAds": contains_eu_political_ads,
}

# Build and execute request.
response = service.advertisers().create(body=advertiser_obj).execute()

# Print the new advertiser.
print(f"Advertiser {response['name']} was created.")

PHP

// Provide the ID of the parent partner.
$partnerId = $values['partner_id'];

// Provide the display name of the advertiser.
$displayName = $values['display_name'];

// Provide the ID of the billing profile for the advertiser to use.
$billingProfileId = $values['billing_profile_id'];

// Provide whether or not the advertiser will serve EU political ads.
$containsEuPoliticalAds = $values['contains_eu_political_ads'];

// Provide the domain URL and currency code of the advertiser.
$domainUrl = "http://www.google.com";
$currencyCode = "USD";

// Create the advertiser structure.
$advertiser = new Google_Service_DisplayVideo_Advertiser();
$advertiser->setPartnerId($partnerId);
$advertiser->setDisplayName($displayName);
$advertiser->setEntityStatus('ENTITY_STATUS_ACTIVE');
$advertiser->setContainsEuPoliticalAds($containsEuPoliticalAds);

// Create and set the advertiser general configuration.
$generalConfig =
    new Google_Service_DisplayVideo_AdvertiserGeneralConfig();
$generalConfig->setDomainUrl($domainUrl);
$generalConfig->setCurrencyCode($currencyCode);
$advertiser->setGeneralConfig($generalConfig);

// Create and set the ad server configuration structure.
$adServerConfig =
new Google_Service_DisplayVideo_AdvertiserAdServerConfig();
$adServerConfig->setThirdPartyOnlyConfig(
    new Google_Service_DisplayVideo_ThirdPartyOnlyConfig()
);
$advertiser->setAdServerConfig($adServerConfig);

// Create and set the creative configuration structure.
$advertiser->setCreativeConfig(
    new Google_Service_DisplayVideo_AdvertiserCreativeConfig()
);

// Create and set the billing configuration.
$billingConfig = new Google_Service_DisplayVideo_AdvertiserBillingConfig();
$billingConfig->setBillingProfileId($billingProfileId);
$advertiser->setBillingConfig($billingConfig);

// Call the API, creating the advertiser.
try {
    $result = $this->service->advertisers->create($advertiser);
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Print the new advertiser.
printf('<p>Advertiser %s was created.</p>', $result['name']);