নেটিভ বিজ্ঞাপন

ভূমিকা

এই নির্দেশিকায় এপিআই (API) ব্যবহার করে গুগল অ্যাড ম্যানেজারের নেটিভ অ্যাডভার্টাইজিং ফিচারগুলো কীভাবে কাজে লাগাতে হয়, তা বিস্তারিতভাবে বর্ণনা করা হয়েছে। শুরু করার আগে, অ্যাড ম্যানেজারের মাধ্যমে নেটিভ অ্যাডভার্টাইজিংয়ের প্রাথমিক বিষয়গুলো আপনার বোঝা আছে কিনা, তা নিশ্চিত করে নিন।

একটি নেটিভ বিজ্ঞাপন ফরম্যাট পুনরুদ্ধার করুন

অ্যাড ম্যানেজার এপিআই-তে নেটিভ অ্যাড ফরম্যাটগুলো একটি CreativeTemplate দ্বারা উপস্থাপিত হয়। আপনার নেটওয়ার্ক থেকে নেটিভ ফরম্যাটগুলো পেতে, CreativeTemplateService ব্যবহার করুন। ক্রিয়েটিভ টেমপ্লেট এবং নেটিভ অ্যাড ফরম্যাটের মধ্যে পার্থক্য করতে, isNativeEligible ফিল্ডটি ব্যবহার করুন। যখন এই ফিল্ডটির মান true হয়, তখন ক্রিয়েটিভ টেমপ্লেটটি একটি নেটিভ অ্যাড ফরম্যাটকে উপস্থাপন করে।

জাভা

StatementBuilder statementBuilder = new StatementBuilder()
    .where("isNativeEligible = :isNativeEligible")
    .orderBy("id DESC")
    .limit(StatementBuilder.SUGGESTED_PAGE_LIMIT)
    .withBindVariableValue("isNativeEligible", true);;

CreativeTemplatePage page = creativeTemplateService.getCreativeTemplatesByStatement(
    statementBuilder.toStatement());

গিটহাবে দেখুন

পাইথন

query = 'WHERE isNativeEligible = :isNativeEligible'
values = [
    {'key': 'isNativeEligible',
     'value': {
         'xsi_type': 'BooleanValue',
         'value': 'true'
     }},
]
statement = ad_manager.FilterStatement(query, values)

response = creative_template_service.getCreativeTemplatesByStatement(
    statement.ToStatement())

গিটহাবে দেখুন

পিএইচপি

$pageSize = StatementBuilder::SUGGESTED_PAGE_LIMIT;
$statementBuilder = (new StatementBuilder())
    ->where('isNativeEligible = :isNativeEligible')
    ->orderBy('id ASC')
    ->limit($pageSize)
    ->withBindVariableValue('isNativeEligible', true);

$page = $creativeTemplateService->getCreativeTemplatesByStatement(
    $statementBuilder->ToStatement());

গিটহাবে দেখুন

.NET

StatementBuilder statementBuilder = new StatementBuilder()
    .Where("isNativeEligible = :isNativeEligible")
    .OrderBy("id ASC")
    .Limit(StatementBuilder.SUGGESTED_PAGE_LIMIT)
    .AddValue("isNativeEligible", true);

CreativeTemplatePage page = creativeTemplateService.getCreativeTemplatesByStatement(
      statementBuilder.ToStatement());

গিটহাবে দেখুন

রুবি

query = 'WHERE isNativeEligible = :isNativeEligible'
values = [
  {
    :key => 'isNativeEligible',
    :value => {
      :xsi_type => 'BooleanValue',
      :value => 'true'
    }
  },
]
statement = AdManagerApi::FilterStatement.new(query, values)

page = creative_template_service.get_creative_templates_by_statement(
  statement.toStatement())

গিটহাবে দেখুন

একটি স্থানীয় সৃজনশীল তৈরি করুন

অ্যাড ম্যানেজার এপিআই-এর TemplateCreatives ) দ্বারা নেটিভ ক্রিয়েটিভগুলো সমর্থিত হয়। এগুলো কোনো স্বতন্ত্র সত্তা নয়। নেটিভ ক্রিয়েটিভ তৈরি করতে, নেটিভ ব্যবহারের জন্য উপযুক্ত একটি CreativeTemplate -এর জন্য একটি TemplateCreative তৈরি করুন। নেটিভ ক্রিয়েটিভের উপাদানগুলো CreativeTemplateVariable ) অবজেক্টে সংরক্ষিত থাকে।

Use 1x1 pixels as the size for native creatives. The size of the rendered ad can be set on the NativeStyle or defined by custom rendering.

জাভা

// Use the system defined native app install creative template.
long nativeAppInstallTemplateId = 10004400L;

// Use 1x1 as the size for native creatives.
Size size = new Size();
size.setWidth(1);
size.setHeight(1);
size.setIsAspectRatio(false);

TemplateCreative nativeAppInstallCreative = new TemplateCreative();
nativeAppInstallCreative.setName("Native creative #" + new Random().nextInt(Integer.MAX_VALUE));
nativeAppInstallCreative.setCreativeTemplateId(nativeAppInstallTemplateId);
nativeAppInstallCreative.setSize(size);

List<BaseCreativeTemplateVariableValue> templateVariables = Lists.newArrayList();

// Set the star rating.
StringCreativeTemplateVariableValue starRatingVariableValue =
    new StringCreativeTemplateVariableValue();
starRatingVariableValue.setUniqueName("Starrating");
starRatingVariableValue.setValue("4");
templateVariables.add(starRatingVariableValue);

গিটহাবে দেখুন

পাইথন

# Use the system defined native app install creative template.
native_app_install_template_id = '10004400'

creative = {
    'xsi_type': 'TemplateCreative',
    'name': 'Native creative',
    'creativeTemplateId': native_app_install_template_id,
    'size': {'width': 1, 'height': 1, 'isAspectRatio': false},
    'creativeTemplateVariableValues': [
        {
            'xsi_type': 'StringCreativeTemplateVariableValue',
            'uniqueName': 'Starrating',
            'value': '4'
        }
    ]
}

গিটহাবে দেখুন

পিএইচপি

// Use the system defined native app install creative template.
$nativeAppInstallTemplateId = 10004400;

// Use 1x1 as the size for native creatives.
$size = new Size();
$size->width = 1;
$size->height = 1;
$size->isAspectRatio = false;

$nativeAppInstallCreative = new TemplateCreative();
$nativeAppInstallCreative->name = 'Native creative #' . uniqid();
$nativeAppInstallCreative->creativeTemplateId = $nativeAppInstallTemplateId;
$nativeAppInstallCreative->size = $size;

$starRatingVariableValue = new StringCreativeTemplateVariableValue();
$starRatingVariableValue->uniqueName = 'Starrating';
$starRatingVariableValue->value = '4';
$nativeAppInstallCreative->creativeTemplateVariableValues[] =
    $starRatingVariableValue;

গিটহাবে দেখুন

সি#

// Use the system defined native app install creative template.
long nativeAppInstallTemplateId = 10004400L;

TemplateCreative nativeAppInstallCreative = new TemplateCreative();
nativeAppInstallCreative.name =
    String.Format("Native creative #{0}", new Random().Next(int.MaxValue));
nativeAppInstallCreative.creativeTemplateId = nativeAppInstallTemplateId;

// Use 1x1 as the size for native creatives.
Size size = new Size();
size.width = 1;
size.height = 1;
size.isAspectRatio = false;
nativeAppInstallCreative.size = size;

List<BaseCreativeTemplateVariableValue> templateVariables =
    new List<BaseCreativeTemplateVariableValue>();

templateVariables.Add(new StringCreativeTemplateVariableValue() {
  uniqueName = "Starrating",
  value = "4"
});

গিটহাবে দেখুন

রুবি

# Use the system defined native app install creative template.
creative_template_id = 10004400

creative = {
    :xsi_type => 'TemplateCreative',
    :name => "Native creative %d" % Time.new.to_i,
    :creative_template_id => creative_template_id,
    :size => {:width => 1, :height => 1, :is_aspect_ratio => false}
}

starrating_variable_value = {
    :xsi_type => 'StringCreativeTemplateVariableValue',
    :unique_name => 'Starrating',
    :value => '4'
}

creative[:creative_template_variable_values] = [
    starrating_variable_value
]

গিটহাবে দেখুন

একটি দেশীয় শৈলী তৈরি করুন

NativeStyleService ব্যবহার করে নেটিভ স্টাইল তৈরি করা যায়। বর্তমানে, এপিআই আপনার দেওয়া CSS এবং HTML স্নিপেটগুলোর ওপর কোনো ভ্যালিডেশন করে না। টার্গেটিং তথ্য সেট করার সময়, শুধুমাত্র inventoryTargeting এবং customTargeting ফিল্ডগুলোই সমর্থিত।

জাভা

long nativeAppInstallTemplateId = 10004400L;

// Create a native style for native app install ads.
NativeStyle nativeStyle = new NativeStyle();
nativeStyle.setName("Native style #" + new Random().nextInt(Integer.MAX_VALUE));
nativeStyle.setCreativeTemplateId(nativeAppInstallTemplateId);
nativeStyle.setSize(size);
nativeStyle.setHtmlSnippet(htmlSnippet);
nativeStyle.setCssSnippet(cssSnippet);

গিটহাবে দেখুন

পাইথন

native_app_install_template_id = '10004400'

# Create a style for native app install ads.
native_style = {
    'name': 'Native style #%d' % uuid.uuid4(),
    'htmlSnippet': html_snippet,
    'cssSnippet': css_snippet,
    'creativeTemplateId': native_app_install_template_id,
    'size': {
        'width': width,
        'height': height,
        'isAspectRatio': False
    }
}

গিটহাবে দেখুন

পিএইচপি

$nativeAppInstallTemplateId = 10004400;

// Create a style for native app install ads.
$nativeStyle = new NativeStyle();
$nativeStyle->setName('Native style #'. uniqid());
$nativeStyle->setCreativeTemplateId($nativeAppInstallTemplateId);
$nativeStyle->setSize($size);
$nativeStyle->setHtmlSnippet($htmlSnippet);
$nativeStyle->setCssSnippet($cssSnippet);

গিটহাবে দেখুন

সি#

long nativeAppInstallTemplateId = 10004400L;

// Create a style for native app install ads.
NativeStyle nativeStyle = new NativeStyle();
nativeStyle.name = string.Format("Native style #{0}", new Random().Next());
nativeStyle.creativeTemplateId = nativeAppInstallTemplateId;
nativeStyle.size = size;
nativeStyle.htmlSnippet = htmlSnippet;
nativeStyle.cssSnippet = cssSnippet;

গিটহাবে দেখুন

রুবি

native_app_install_template_id = 10004400

# Create a style for native app install ads.
native_style = {
  :name => 'Native style #%d' % (Time.new.to_f * 1000),
  :html_snippet => html_snippet,
  :css_snippet => css_snippet,
  :creative_template_id => native_app_install_template_id,
  :size => size
}

গিটহাবে দেখুন

স্টাইলটি যদি পরিবর্তনশীল আকারের জন্য হয়, তাহলে isFluid ফিল্ডটির মান true সেট করুন এবং size 1x1 পিক্সেল হিসেবে নির্ধারণ করুন।

একটি স্থানীয় বিজ্ঞাপনে ট্র্যাফিক

নেটিভ অ্যাডের জন্য একটি LineItem তৈরি করার সময়, CreativePlaceholder এর CreativeSizeType এর ধরন NATIVE এবং কাঙ্ক্ষিত নেটিভ অ্যাড ফরম্যাটের creativeTemplateId সেট করতে হবে।

জাভা

// Create creative placeholder size.
Size size = new Size();
size.setWidth(1);
size.setHeight(1);
size.setIsAspectRatio(false);

long nativeAppInstallTemplateId = 10004400L;

// Create the creative placeholder.
CreativePlaceholder creativePlaceholder = new CreativePlaceholder();
creativePlaceholder.setSize(size);
creativePlaceholder.setCreativeTemplateId(nativeAppInstallTemplateId);
creativePlaceholder.setCreativeSizeType(CreativeSizeType.NATIVE);

পাইথন

native_app_install_template_id = '10004400'

# Create the creative placeholder.
creative_placeholder = {
    'size': {
        'width': '1',
        'height': '1'
    },
    'creativeTemplateId': native_app_install_template_id,
    'creativeSizeType': 'NATIVE'
}

পিএইচপি

$nativeAppInstallTemplateId = 10004400;

// Create the creative placeholder.
$creativePlaceholder = new CreativePlaceholder();
$creativePlaceholder->setSize(new Size(1, 1, false));
$creativePlaceholder->setCreativeTemplateId($nativeAppInstallTemplateId);
$creativePlaceholder->setCreativeSizeType(CreativeSizeType::NATIVE);

সি#

// Create the creative placeholder size.
Size size = new Size();
size.width = 1;
size.height = 1;
size.isAspectRatio = false;

long nativeAppInstallTemplateId = 10004400L;

// Create the creative placeholder.
CreativePlaceholder creativePlaceholder = new CreativePlaceholder();
creativePlaceholder.size = size;
creativePlaceholder.creativeTemplateId = nativeAppInstallTemplateId;
creativePlaceholder.creativeSizeType = CreativeSizeType.NATIVE;

রুবি

# Create the creative placeholder.
creative_placeholder = {
    :size => {:width => 1, :height => 1, :is_aspect_ratio => false},
    :creative_template_id => 10004400,
    :creative_size_type => 'NATIVE'
}