ক্যাম্পেইন ম্যানেজার ৩৬০ API v4 বন্ধ করা হয়েছে এবং ২৬ ফেব্রুয়ারি, ২০২৬ তারিখে বন্ধ হবে। পরিষেবা ব্যাহত না হতে এই তারিখের মধ্যে v5 এ মাইগ্রেট করুন ।

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

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

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

সাধারণ কোডিং টিপস

প্রয়োজনীয় এবং ঐচ্ছিক বৈশিষ্ট্য এবং পরামিতি - একটি API কলের জন্য একটি বৈশিষ্ট্য বা প্যারামিটার প্রয়োজন কিনা তা জানতে রেফারেন্স ডকুমেন্টেশন দেখুন।
ওয়াইল্ডকার্ডের নাম অনুসন্ধান - বস্তুর নাম অনুসন্ধান করার সময় আপনি তারকাচিহ্ন (*) ওয়াইল্ডকার্ড ব্যবহার করতে পারেন। একটি তারকাচিহ্ন শূন্য বা তার বেশি অক্ষরের সাথে মেলে। API একটি অন্তর্নিহিত সাবস্ট্রিং অনুসন্ধানও সমর্থন করে, তাই "abc" অনুসন্ধান করলে পরোক্ষভাবে "*abc*" অনুসন্ধান করা হবে।
আপডেট বনাম প্যাচিং - একটি বিদ্যমান বস্তু পরিবর্তন করতে, আপনার কাছে দুটি বিকল্প আছে:
1. আপডেট করা - কোনও অবজেক্ট আপডেট করার সময়, ইনসার্টে সমস্ত ক্ষেত্র ওভাররাইট করা হবে। আপনি যে অবজেক্টটি আপডেট করতে চান তা লোড করা এবং সেই অবজেক্টে যেকোনো পরিবর্তন করা গুরুত্বপূর্ণ। অন্যথায়, আপডেট অনুরোধে উপস্থিত না থাকা যেকোনো ক্ষেত্র আনসেট করা হবে।
2. প্যাচিং - প্যাচ করার সময়, শুধুমাত্র নির্দিষ্ট ক্ষেত্রগুলি সন্নিবেশ করার সময় ওভাররাইট করা হবে। এই ক্ষেত্রে, আপনি একটি নতুন অবজেক্ট তৈরি করতে পারেন, আপডেট করার জন্য অবজেক্টের মতো একই আইডি বরাদ্দ করতে পারেন, আপডেট করার জন্য ক্ষেত্রগুলি সেট করতে পারেন এবং প্যাচ অনুরোধটি কার্যকর করতে পারেন।
আকার - ভৌত মাত্রাগুলি sizes পরিষেবা দ্বারা সংজ্ঞায়িত একটি Size বস্তু দ্বারা প্রতিনিধিত্ব করা হয়। অ্যাকাউন্টটি স্ট্যান্ডার্ড আকারের একটি সেট সরবরাহ করে এবং আপনি এই তালিকায় আপনার নিজস্ব কাস্টম আকার যোগ করতে পারেন।
তারিখ এবং সময় - আপনি স্থানীয় সময় অঞ্চল ব্যবহার করে RFC 3339 ফর্ম্যাটে তারিখ/সময় সংরক্ষণ করতে পারেন; API দ্বারা প্রদত্ত সমস্ত মান UTC-তে থাকে। এটি সেই ওয়েবসাইট থেকে আলাদা যেখানে আপনার কনফিগার করা সময় অঞ্চলে তারিখ এবং সময় দেখানো হয় (আমেরিকা/নিউ ইয়র্ক সময়, ডিফল্টরূপে)।

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

সি#

একটি Advertiser অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় নাম এবং স্থিতি বৈশিষ্ট্য সেট করুন।
```
// 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 অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় নাম এবং স্থিতি বৈশিষ্ট্য সেট করুন।
```
// 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 অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় নাম এবং স্থিতি বৈশিষ্ট্য সেট করুন।
```
$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 অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় নাম এবং স্থিতি বৈশিষ্ট্য সেট করুন।
```
# Construct and save advertiser.
advertiser = {
    'name': 'Test Advertiser',
    'status': 'APPROVED'
}
```

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

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

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

রুবি

একটি Advertiser অবজেক্ট তৈরি করুন এবং এর প্রয়োজনীয় নাম এবং স্থিতি বৈশিষ্ট্য সেট করুন।
```
# 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));
```
ক্যাম্পেইনটি সংরক্ষণ করতে 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());

// 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->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': '2015-01-01',
    'endDate': '2020-01-01'
}
```

ক্যাম্পেইনটি সংরক্ষণ করতে 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: '2014-01-01',
  end_date: '2020-01-01'
)
```
ক্যাম্পেইনটি সংরক্ষণ করতে campaigns.insert() এ কল করুন।
```
# Insert the campaign.
result = service.insert_campaign(profile_id, campaign)
```