광고주 생성

광고주는 광고 캠페인을 운영하는 비즈니스를 나타냅니다. Advertiser 리소스는 다음을 수행합니다.

  • 하위 리소스에서 사용하는 호스트 일반 설정입니다.
  • 게재하는 모든 광고에 브랜드 안전성 설정을 적용합니다.
  • 게재되는 광고로 사용되는 광고 소재를 소유해야 합니다.
  • 광고 타겟팅에 사용되는 항목을 관리합니다. 여기에는 채널 및 위치 목록이 포함됩니다.

기존 광고주를 사용하는 경우 캠페인 만들기로 건너뛰세요.

구성 선택

광고주를 만들기 전에 다음 설정을 검토하고 결정하세요.

Advertiser 리소스에도 선택적 필드가 많이 있습니다. 자세한 내용은 참조 문서를 참고하세요.

광고주를 만드는 방법

광고주를 만드는 방법은 다음과 같습니다.

자바

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