ক্যাম্পেইন ম্যানেজার ৩৬০ API v4 তার নির্ধারিত সূর্যাস্তের তারিখে পৌঁছেছে। অবিলম্বে v5 এ মাইগ্রেট করুন ।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

সাধারণ পাচারের কাজ

এই পৃষ্ঠায় DCM/DFA রিপোর্টিং এবং ট্র্যাফিকিং API ব্যবহার করে সবচেয়ে সাধারণ কিছু পাচার সংক্রান্ত কাজ কীভাবে সম্পাদন করতে হয়, তার রূপরেখা দেওয়া হয়েছে।

কোডিং সম্পর্কিত সাধারণ পরামর্শ

প্রয়োজনীয় এবং ঐচ্ছিক প্রোপার্টি ও প্যারামিটার - কোনো এপিআই কলের জন্য কোনো প্রোপার্টি বা প্যারামিটার আবশ্যক কিনা তা জানতে রেফারেন্স ডকুমেন্টেশন দেখুন।
ওয়াইল্ডকার্ড নাম অনুসন্ধান - অবজেক্টের নাম অনুসন্ধানের জন্য আপনি অ্যাস্টারিস্ক (*) ওয়াইল্ডকার্ড ব্যবহার করতে পারেন। একটি অ্যাস্টারিস্ক শূন্য বা তার বেশি যেকোনো অক্ষরের সাথে মেলে। এপিআই একটি অন্তর্নিহিত সাবস্ট্রিং অনুসন্ধানও সমর্থন করে, তাই "abc" অনুসন্ধান করলে তা স্বয়ংক্রিয়ভাবে "*abc*" অনুসন্ধান করবে।
আপডেটিং বনাম প্যাচিং - একটি বিদ্যমান অবজেক্ট পরিবর্তন করার জন্য আপনার কাছে দুটি বিকল্প রয়েছে:
1. আপডেট করা - কোনো অবজেক্ট আপডেট করার সময়, ইনসার্ট করার সাথে সাথে সমস্ত ফিল্ড ওভাররাইট হয়ে যাবে। আপনি যে অবজেক্টটি আপডেট করতে চান সেটি লোড করা এবং সেই অবজেক্টে যেকোনো পরিবর্তন করা গুরুত্বপূর্ণ। অন্যথায়, আপডেট অনুরোধে উপস্থিত নয় এমন যেকোনো ফিল্ড আনসেট হয়ে যাবে।
2. প্যাচিং - প্যাচিং করার সময়, ইনসার্ট করার মুহূর্তে শুধুমাত্র নির্দিষ্ট ফিল্ডগুলোই ওভাররাইট করা হবে। এক্ষেত্রে, আপনি একটি নতুন অবজেক্ট তৈরি করে, সেটিকে আপডেট করার অবজেক্টের মতো একই আইডি দিতে পারেন, আপডেট করার জন্য ফিল্ডগুলো সেট করতে পারেন এবং প্যাচ রিকোয়েস্টটি এক্সিকিউট করতে পারেন।
Sizes - Physical dimensions are represented by a Size object defined by the sizes service . The account supplies a set of standard sizes, and you can add your own custom sizes to this list.
তারিখ ও সময় - আপনি স্থানীয় সময় অঞ্চল ব্যবহার করে RFC 3339 ফরম্যাটে তারিখ/সময় সংরক্ষণ করতে পারেন; API দ্বারা ফেরত দেওয়া সমস্ত মান UTC-তে থাকে। এটি ওয়েবসাইট থেকে ভিন্ন, যেখানে তারিখ ও সময় আপনার কনফিগার করা সময় অঞ্চলে (ডিফল্টরূপে আমেরিকা/নিউ ইয়র্ক সময়) দেখানো হয়।

একজন বিজ্ঞাপনদাতা তৈরি করুন

সি#

একটি Advertiser অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় name ও status প্রোপার্টিগুলো সেট করুন।
```
// Create the advertiser structure.
Advertiser advertiser = new Advertiser();
advertiser.Name = advertiserName;
advertiser.Status = "APPROVED";
```
বিজ্ঞাপনদাতাকে সংরক্ষণ করতে advertisers.insert() কল করুন।
```
// Create the advertiser.
Advertiser result = service.Advertisers.Insert(advertiser, profileId).Execute();
```

জাভা

একটি Advertiser অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় name ও status প্রোপার্টিগুলো সেট করুন।
```
// Create the advertiser structure.
Advertiser advertiser = new Advertiser();
advertiser.setName(advertiserName);
advertiser.setStatus("APPROVED");
```
বিজ্ঞাপনদাতাকে সংরক্ষণ করতে advertisers.insert() কল করুন।
```
// Create the advertiser.
Advertiser result = reporting.advertisers().insert(profileId, advertiser).execute();
```

পিএইচপি

একটি Advertiser অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় name ও status প্রোপার্টিগুলো সেট করুন।
```
$advertiser = new Google_Service_Dfareporting_Advertiser();
$advertiser->setName($values['advertiser_name']);
$advertiser->setStatus('APPROVED');
```
বিজ্ঞাপনদাতাকে সংরক্ষণ করতে advertisers.insert() কল করুন।
```
$result = $this->service->advertisers->insert(
    $values['user_profile_id'],
    $advertiser
);
```

পাইথন

একটি Advertiser অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় name ও status প্রোপার্টিগুলো সেট করুন।
```
# Construct and save advertiser.
advertiser = {
    'name': 'Test Advertiser',
    'status': 'APPROVED'
}
```

বিজ্ঞাপনদাতাকে সংরক্ষণ করতে advertisers.insert() কল করুন।

request = service.advertisers().insert(
    profileId=str(profile_id), body=advertiser
)

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

রুবি

একটি Advertiser অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় name ও status প্রোপার্টিগুলো সেট করুন।

# Create a new advertiser resource to insert.
advertiser = DfareportingUtils::API_NAMESPACE::Advertiser.new(
  name: format('Example Advertiser #%s', SecureRandom.hex(3)),
  status: 'APPROVED'
)

বিজ্ঞাপনদাতাকে সংরক্ষণ করতে advertisers.insert() কল করুন।
```
# Insert the advertiser.
result = service.insert_advertiser(profile_id, advertiser)
```

একটি প্রচারাভিযান তৈরি করুন

সি#

একটি Campaign অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় প্রোপার্টিগুলো সেট করুন:
- advertiserId - যে বিজ্ঞাপনদাতার সাথে এই ক্যাম্পেইনটি যুক্ত করা হবে।
- name - এই বিজ্ঞাপনদাতার সকল ক্যাম্পেইনে এই নামটি অবশ্যই অনন্য হতে হবে।
- defaultLandingPageId - এই ক্যাম্পেইনের কোনো বিজ্ঞাপনে ক্লিক করলে ব্যবহারকারীদের এই ল্যান্ডিং পেজে পাঠানো হবে, যদি সেই বিজ্ঞাপনের জন্য আগে থেকে কোনো ল্যান্ডিং পেজ নির্ধারিত না থাকে। আপনি advertiserLandingPages.list কল করে বিদ্যমান ল্যান্ডিং পেজগুলো দেখতে পারেন অথবা advertiserLandingPages.insert কল করে একটি নতুন ল্যান্ডিং পেজ তৈরি করতে পারেন।
- শুরু এবং শেষের তারিখ - এই তারিখগুলো অবশ্যই ভবিষ্যতের হতে হবে এবং দিন পর্যন্ত নির্ভুল হতে পারে। আরও বিস্তারিত জানতে 'সাধারণ কোডিং তথ্য'- এর 'তারিখ ও সময়' বুলেট পয়েন্টটি দেখুন। প্রতিটি বিজ্ঞাপনের তারিখ শেষের তারিখকে অতিক্রম করতে পারে, যাতে কোনো পাবলিশার নির্দিষ্ট সংখ্যক অ্যাকশনের জন্য করা চুক্তি পূরণের চেষ্টা করতে পারেন, যদি প্রদত্ত ক্যাম্পেইন শেষের তারিখের মধ্যে তা পূরণ না হয়।
```
// 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));

campaign.EuPoliticalAdsDeclaration = "CONTAINS_EU_POLITICAL_ADS";
```
ক্যাম্পেইনটি সংরক্ষণ করতে campaigns.insert() কল করুন।
```
// Insert the campaign.
Campaign result = service.Campaigns.Insert(campaign, profileId).Execute();
```

জাভা

একটি Campaign অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় প্রোপার্টিগুলো সেট করুন:
- advertiserId - যে বিজ্ঞাপনদাতার সাথে এই ক্যাম্পেইনটি যুক্ত করা হবে।
- name - এই বিজ্ঞাপনদাতার সকল ক্যাম্পেইনে এই নামটি অবশ্যই অনন্য হতে হবে।
- defaultLandingPageId - এই ক্যাম্পেইনের কোনো বিজ্ঞাপনে ক্লিক করলে ব্যবহারকারীদের এই ল্যান্ডিং পেজে পাঠানো হবে, যদি সেই বিজ্ঞাপনের জন্য আগে থেকে কোনো ল্যান্ডিং পেজ নির্ধারিত না থাকে। আপনি advertiserLandingPages.list কল করে বিদ্যমান ল্যান্ডিং পেজগুলো দেখতে পারেন অথবা advertiserLandingPages.insert কল করে একটি নতুন ল্যান্ডিং পেজ তৈরি করতে পারেন।
- শুরু এবং শেষের তারিখ - এই তারিখগুলো অবশ্যই ভবিষ্যতের হতে হবে এবং দিন পর্যন্ত নির্ভুল হতে পারে। আরও বিস্তারিত জানতে 'সাধারণ কোডিং তথ্য'- এর 'তারিখ ও সময়' বুলেট পয়েন্টটি দেখুন। প্রতিটি বিজ্ঞাপনের তারিখ শেষের তারিখকে অতিক্রম করতে পারে, যাতে কোনো পাবলিশার নির্দিষ্ট সংখ্যক অ্যাকশনের জন্য করা চুক্তি পূরণের চেষ্টা করতে পারেন, যদি প্রদত্ত ক্যাম্পেইন শেষের তারিখের মধ্যে তা পূরণ না হয়।
```
// 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());
campaign.setEuPoliticalAdsDeclaration("CONTAINS_EU_POLITICAL_ADS");

// 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);
```
ক্যাম্পেইনটি সংরক্ষণ করতে campaigns.insert() কল করুন।
```
// Insert the campaign.
Campaign result = reporting.campaigns().insert(profileId, campaign).execute();
```

পিএইচপি

একটি Campaign অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় প্রোপার্টিগুলো সেট করুন:
- advertiserId - যে বিজ্ঞাপনদাতার সাথে এই ক্যাম্পেইনটি যুক্ত করা হবে।
- name - এই বিজ্ঞাপনদাতার সকল ক্যাম্পেইনে এই নামটি অবশ্যই অনন্য হতে হবে।
- defaultLandingPageId - এই ক্যাম্পেইনের কোনো বিজ্ঞাপনে ক্লিক করলে ব্যবহারকারীদের এই ল্যান্ডিং পেজে পাঠানো হবে, যদি সেই বিজ্ঞাপনের জন্য আগে থেকে কোনো ল্যান্ডিং পেজ নির্ধারিত না থাকে। আপনি advertiserLandingPages.list কল করে বিদ্যমান ল্যান্ডিং পেজগুলো দেখতে পারেন অথবা advertiserLandingPages.insert কল করে একটি নতুন ল্যান্ডিং পেজ তৈরি করতে পারেন।
- শুরু এবং শেষের তারিখ - এই তারিখগুলো অবশ্যই ভবিষ্যতের হতে হবে এবং দিন পর্যন্ত নির্ভুল হতে পারে। আরও বিস্তারিত জানতে 'সাধারণ কোডিং তথ্য'- এর 'তারিখ ও সময়' বুলেট পয়েন্টটি দেখুন। প্রতিটি বিজ্ঞাপনের তারিখ শেষের তারিখকে অতিক্রম করতে পারে, যাতে কোনো পাবলিশার নির্দিষ্ট সংখ্যক অ্যাকশনের জন্য করা চুক্তি পূরণের চেষ্টা করতে পারেন, যদি প্রদত্ত ক্যাম্পেইন শেষের তারিখের মধ্যে তা পূরণ না হয়।
```
$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->setEuPoliticalAdsDeclaration($values['eu_political_ads_declaration']);
$campaign->setStartDate($startDate->format('Y-m-d'));
$campaign->setEndDate($endDate->format('Y-m-d'));
```
ক্যাম্পেইনটি সংরক্ষণ করতে campaigns.insert() কল করুন।
```
$result = $this->service->campaigns->insert(
    $values['user_profile_id'],
    $campaign
);
```

পাইথন

একটি Campaign অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় প্রোপার্টিগুলো সেট করুন:
- advertiserId - যে বিজ্ঞাপনদাতার সাথে এই ক্যাম্পেইনটি যুক্ত করা হবে।
- name - এই বিজ্ঞাপনদাতার সকল ক্যাম্পেইনে এই নামটি অবশ্যই অনন্য হতে হবে।
- defaultLandingPageId - এই ক্যাম্পেইনের কোনো বিজ্ঞাপনে ক্লিক করলে ব্যবহারকারীদের এই ল্যান্ডিং পেজে পাঠানো হবে, যদি সেই বিজ্ঞাপনের জন্য আগে থেকে কোনো ল্যান্ডিং পেজ নির্ধারিত না থাকে। আপনি advertiserLandingPages.list কল করে বিদ্যমান ল্যান্ডিং পেজগুলো দেখতে পারেন অথবা advertiserLandingPages.insert কল করে একটি নতুন ল্যান্ডিং পেজ তৈরি করতে পারেন।
- শুরু এবং শেষের তারিখ - এই তারিখগুলো অবশ্যই ভবিষ্যতের হতে হবে এবং দিন পর্যন্ত নির্ভুল হতে পারে। আরও বিস্তারিত জানতে 'সাধারণ কোডিং তথ্য'- এর 'তারিখ ও সময়' বুলেট পয়েন্টটি দেখুন। প্রতিটি বিজ্ঞাপনের তারিখ শেষের তারিখকে অতিক্রম করতে পারে, যাতে কোনো পাবলিশার নির্দিষ্ট সংখ্যক অ্যাকশনের জন্য করা চুক্তি পূরণের চেষ্টা করতে পারেন, যদি প্রদত্ত ক্যাম্পেইন শেষের তারিখের মধ্যে তা পূরণ না হয়।
```
# 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': '2025-11-01',
    'endDate': '2025-12-01',
    'euPoliticalAdsDeclaration': 'CONTAINS_EU_POLITICAL_ADS',
}
```

ক্যাম্পেইনটি সংরক্ষণ করতে campaigns.insert() কল করুন।

request = service.campaigns().insert(profileId=profile_id, body=campaign)

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

রুবি

একটি Campaign অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় প্রোপার্টিগুলো সেট করুন:
- advertiserId - যে বিজ্ঞাপনদাতার সাথে এই ক্যাম্পেইনটি যুক্ত করা হবে।
- name - এই বিজ্ঞাপনদাতার সকল ক্যাম্পেইনে এই নামটি অবশ্যই অনন্য হতে হবে।
- defaultLandingPageId - এই ক্যাম্পেইনের কোনো বিজ্ঞাপনে ক্লিক করলে ব্যবহারকারীদের এই ল্যান্ডিং পেজে পাঠানো হবে, যদি সেই বিজ্ঞাপনের জন্য আগে থেকে কোনো ল্যান্ডিং পেজ নির্ধারিত না থাকে। আপনি advertiserLandingPages.list কল করে বিদ্যমান ল্যান্ডিং পেজগুলো দেখতে পারেন অথবা advertiserLandingPages.insert কল করে একটি নতুন ল্যান্ডিং পেজ তৈরি করতে পারেন।
- শুরু এবং শেষের তারিখ - এই তারিখগুলো অবশ্যই ভবিষ্যতের হতে হবে এবং দিন পর্যন্ত নির্ভুল হতে পারে। আরও বিস্তারিত জানতে 'সাধারণ কোডিং তথ্য'- এর 'তারিখ ও সময়' বুলেট পয়েন্টটি দেখুন। প্রতিটি বিজ্ঞাপনের তারিখ শেষের তারিখকে অতিক্রম করতে পারে, যাতে কোনো পাবলিশার নির্দিষ্ট সংখ্যক অ্যাকশনের জন্য করা চুক্তি পূরণের চেষ্টা করতে পারেন, যদি প্রদত্ত ক্যাম্পেইন শেষের তারিখের মধ্যে তা পূরণ না হয়।
```
# 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: '2025-11-01',
  end_date: '2025-12-01',
  eu_political_ads_declaration: 'CONTAINS_EU_POLITICAL_ADS'
)
```
ক্যাম্পেইনটি সংরক্ষণ করতে campaigns.insert() কল করুন।
```
# Insert the campaign.
result = service.insert_campaign(profile_id, campaign)
```