إنشاء معلِن

يمثّل المعلِن نشاطًا تجاريًا يطلق حملات إعلانية. تنفّذ مراجع 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']);