telegram-crawler/data/web/promote.telegram.org/getting-started.html
2024-02-14 10:40:31 +00:00

327 lines
24 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Telegram Ads</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no" />
<meta name="format-detection" content="telephone=no" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="MobileOptimized" content="176" />
<meta name="HandheldFriendly" content="True" /><meta name="twitter:card" content="summary"></meta>
<meta property="og:title" content="Telegram Ad Platform Explained">
<meta property="og:image" content="https://promote.telegram.org/file/464001300/5/HuwYKwwmYRA.33581/671095c241ff39569b">
<meta property="og:description" content="The Telegram Ad Platform is a privacy-conscious tool to create sponsored messages in public one-to-many channels with 1000+ subscribers.">
<link rel="icon" type="image/svg+xml" href="/img/website_icon.svg?4">
<link rel="apple-touch-icon" sizes="180x180" href="/img/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/img/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/img/favicon-16x16.png">
<link rel="alternate icon" href="/img/favicon.ico" type="image/x-icon" />
<script>document.cookie="stel_dt="+encodeURIComponent((new Date).getTimezoneOffset())+";path=/;max-age=31536000;samesite=None;secure"</script>
<link href="//telegram.org/css/font-roboto.css?1" rel="stylesheet" type="text/css">
<link href="//telegram.org/css/bootstrap.min.css?3" rel="stylesheet">
<link href="//telegram.org/css/bootstrap-extra.css?2" rel="stylesheet">
<link href="/css/telegram.css?236" rel="stylesheet">
<link href="/css/widget-frame.css?66" rel="stylesheet">
<link href="/css/promote.css?77" rel="stylesheet">
<link href="/css/jquery-ui.min.css?1" rel="stylesheet">
<link href="/css/tchart.min.css?10" rel="stylesheet">
</head>
<body class="emoji_image no-transition">
<div id="aj_progress" class="progress-bar"></div>
<div id="aj_content"><div class="pr-container pr-docs-container">
<div class="pr-header">
<div class="pr-header-auth">
<div class="pr-header-auth-item"><a class="header-auth-link login-link" href="/auth">Log In</a></div>
</div>
<ol class="pr-breadcrumb"><li class="pr-logo compact"><a href="/"><i class="pr-icon"></i><span class="pr-logo-title">Telegram Ads</span></a></li><li class="pr-breadcrumb-item">Telegram Ad Platform Explained</li></ol>
</div>
<section class="pr-content"><div id="dev_page_content_wrap" class=" ">
<div class="dev_page_bread_crumbs"></div>
<h1 id="dev_page_title">Telegram Ad Platform Explained</h1>
<div id="dev_page_content"><blockquote>
<p>This document explores the Telegram Ad Platform in greater detail, for basic information about <strong>sponsored messages</strong>, please see <a href="https://promote.telegram.org/basics">this page</a>.</p>
</blockquote>
<h2><a class="anchor" name="getting-started" href="#getting-started"><i class="anchor-icon"></i></a>Getting Started</h2>
<p>The <a href="https://promote.telegram.org">Telegram Ad Platform</a> is a tool to create <strong>sponsored messages</strong> in public one-to-many channels with 1000+ subscribers. With this tool you can easily manage your ads and budgets, choose where your ads will be displayed and monitor their performance. For step-by-step instructions on how to create, publish and manage your ads, continue reading below.</p>
<h3><a class="anchor" name="logging-in" href="#logging-in"><i class="anchor-icon"></i></a>Logging In</h3>
<p>To start creating ads on the platform, you must first log in. This requires that you have an existing <strong>Telegram account</strong> if you do not yet have an account, download one of our <a href="https://telegram.org/apps#mobile-apps">mobile apps</a> for Android or iOS and sign up. Once you have an account, enter the accounts phone number on the <a href="https://promote.telegram.org">login page</a>, after which you instantly receive a message in Telegram (from our verified service account) to confirm your login to the platform.</p>
<div class="blog_video_player_wrap" style="max-width: 400px; margin: 20px auto 20px;">
<video class="blog_video_player tl_blog_vid_autoplay" onclick="videoTogglePlay(this)" autoplay playsinline loop controls muted poster="/file/464001752/5/i1xdJ8f8mnU.20630/b6e5546fc528644422" style="max-width: 400px;" title="Logging in on the Ad Platform" alt="Logging in on the Ad Platform">
<source src="/file/464001892/5/HjA2HtrFV_E.1259977.mp4/6c40b64060ceb8ce7c" type="video/mp4">
</video>
</div>
<h3><a class="anchor" name="choosing-an-account" href="#choosing-an-account"><i class="anchor-icon"></i></a>Choosing an Account</h3>
<p>Once you&#39;ve logged in on the platform, you can proceed either with your <strong>Personal Account</strong> or by <strong>Creating an Organization</strong>.</p>
<p>Organizations are built around <strong>Telegram Groups</strong> and <strong>Channels</strong> linking your group or channel as an organization gives <strong>all admins</strong> of that chat the ability to manage advertisements created by the organization.</p>
<blockquote>
<p>Only the <strong>owner</strong> of the Group or Channel is allowed to create an organization for that chat.</p>
</blockquote>
<div class="blog_video_player_wrap" style="max-width: 400px; margin: 20px auto 20px;">
<video class="blog_video_player tl_blog_vid_autoplay" onclick="videoTogglePlay(this)" autoplay playsinline loop controls muted poster="/file/464001357/5/G-IXEFj-45s.22436/3feb0daf2059fd4e29" style="max-width: 400px;" title="TITLE" alt="TITLE">
<source src="/file/464001670/1/UkwLGNCIXYQ.1658109.mp4/35610d63468be65656" type="video/mp4">
</video>
</div>
<p>After logging in, you can click <a href="#creating-an-ad"><strong>Create Ad</strong></a> to start designing a sponsored message or <a href="#adding-funds"><strong>Manage Budget</strong></a> to add funds to your account.</p>
<h3><a class="anchor" name="creating-an-ad" href="#creating-an-ad"><i class="anchor-icon"></i></a>Creating an Ad</h3>
<p>Click Create a new ad to start building your advertisement. There you will see a template with several fields to fill in such as giving your ad a <strong>Title</strong>, <strong>Text</strong>, and <strong>URL</strong>. </p>
<p>All links included in the Text and URL field must link to a <strong>channel or bot on Telegram</strong>, using the format t.me/link or @link. Links to external sites are not allowed.</p>
<div class="blog_video_player_wrap" style="max-width: 400px; margin: 20px auto 20px;">
<video class="blog_video_player tl_blog_vid_autoplay" onclick="videoTogglePlay(this)" autoplay playsinline loop controls muted poster="/file/464001209/5/yKXvZhl9-wA.39435/55386733a3bf8728cd" style="max-width: 400px;" title="TITLE" alt="TITLE">
<source src="/file/464001348/1/jwqtlqL7bds.1499672.mp4/bf2a12f2217d90e3c8" type="video/mp4">
</video>
</div>
<blockquote>
<p>The link entered in the URL field will be added to a <strong>button</strong> underneath your sponsored message. If you include a link in the text as well, it must go to the same destination as the link in the URL field. </p>
</blockquote>
<h3><a class="anchor" name="cpm-and-ad-budget" href="#cpm-and-ad-budget"><i class="anchor-icon"></i></a>CPM and Ad Budget</h3>
<p>Once the text of your sponsored message is completed, you can set a <strong>CPM</strong> (Cost-Per-Mille) for the ad, which is the price for one thousand views of your ad. The minimum CPM for a sponsored message is <strong>€2</strong>.</p>
<p>Your ad budget is the amount of funds you are willing to spend on a particular sponsored message. The sponsored message will continue to be shown until it reaches this amount.</p>
<blockquote>
<p>To <strong>increase</strong> an ad&#39;s budget, open it or click the budget field right from your <a href="http://promote.telegram.org/account">homepage</a>.</p>
<p>To <strong>decrease</strong> an ad&#39;s budget, stop and delete the ad the remaining funds will be returned to your overall budget.</p>
</blockquote>
<h3><a class="anchor" name="language-topics-and-target-channels" href="#language-topics-and-target-channels"><i class="anchor-icon"></i></a>Language, Topics and Target Channels</h3>
<p>Sponsored messages are displayed in <a href="https://telegram.org/tour/channels">public channels</a> with <strong>1000+</strong> subscribers. To better customize which channels can host your advertisements, select languages and topics that suit your audience for example English and Spanish channels related to Movies and Music. You are able to combine several languages and topics, or even leave the fields blank if you prefer.</p>
<p>If there are <strong>individual channels</strong> in which you would specifically like your sponsored message to appear, you can include them via their <strong>unique link</strong>, such as t.me/durov. Certain topics and channels can also be <strong>excluded</strong>, giving even more customization. When you are ready, check the box to confirm you have read the <a href="https://promote.telegram.org/tos">Ad Platform Terms of Service</a> and click Create Ad.</p>
<blockquote>
<p>Note that once your ad is created, its targeting parameters cant be changed. But you can always use the <a href="#copying-ads">&#39;Create a similar ad&#39;</a> function to quickly create a new ad with the same parameters and tweak whatever you wanted to change.</p>
</blockquote>
<h3><a class="anchor" name="copying-ads" href="#copying-ads"><i class="anchor-icon"></i></a>Copying Ads</h3>
<p>When you open any of your existing ads, you can use the <strong>&#39;Create similar ad&#39;</strong> link next to its name to create a <strong>new ad</strong> with the same text and parameters. This can be handy if you want to create several ads with slightly different targeting parameters, change targeting parameters in an ad you created, or lower the budget of an ad.</p>
<div class="blog_video_player_wrap" style="max-width: 400px; margin: 20px auto 20px;">
<video class="blog_video_player tl_blog_vid_autoplay" onclick="videoTogglePlay(this)" autoplay playsinline loop controls muted poster="/file/464001762/3/jNbQultn85U.52861/c178021965158d2ba8" style="max-width: 400px;" title="Create a similar ad" alt="Create a similar ad">
<source src="/file/464001795/2/VVZ7AfaIsVg.1321782.mp4/2ae02b91863136db18" type="video/mp4">
</video>
</div>
<h3><a class="anchor" name="adding-funds" href="#adding-funds"><i class="anchor-icon"></i></a>Adding Funds</h3>
<p>If you are creating an ad for the first time, you may not have funds in your account yet. When you try to create your ad, you may see a Your balance is too low message under the <strong>Budget</strong> field. Click Add Funds to put money on your account the ad will be <strong>saved as a draft</strong> so you can easily publish it later.</p>
<div class="blog_image_wrap blog_medium_image_wrap">
<a href="/file/464001300/5/HuwYKwwmYRA.33581/671095c241ff39569b" target="_blank"><img src="/file/464001300/5/HuwYKwwmYRA.33581/671095c241ff39569b" title="Add funds" alt="Add funds" srcset="/file/464001300/5/HuwYKwwmYRA.33581/671095c241ff39569b , 2x" /></a>
</div>
<blockquote>
<p>You can also publish ads without a budget to get a feel for the platform then return when youre ready to launch them.</p>
</blockquote>
<p>You can also access the interface by opening the <a href="https://promote.telegram.org/account/budget">Manage Budget</a> page and clicking <strong>Add Funds</strong>.</p>
<div class="blog_video_player_wrap" style="max-width: 400px; margin: 20px auto 20px;">
<video class="blog_video_player tl_blog_vid_autoplay" onclick="videoTogglePlay(this)" autoplay playsinline loop controls muted poster="/file/464001570/1/mDOlqNNmQVs.31879/1e339f191e1c524d7e" style="max-width: 400px;" title="Creating a request to add funds" alt="Creating a request to Add Funds">
<source src="/file/464001462/2/4zUmvsrX5oE.2137378.mp4/108a56a3e42af59e86" type="video/mp4">
</video>
</div>
<p>Fill in the details about your company on the page that opens and click Send Request our team will review your information and contact you via a <a href="https://t.me/TelegramTips/112"><strong>verified</strong></a> <strong>service account</strong> on Telegram with the necessary documents for our advertising agreement and deposit transfer.</p>
<blockquote>
<p>You will receive a confirmation in Telegram each time funds are credited to your account.</p>
</blockquote>
<!--[screenshot of message sent by service account]-->
<h2><a class="anchor" name="managing-your-ads" href="#managing-your-ads"><i class="anchor-icon"></i></a>Managing Your Ads</h2>
<h3><a class="anchor" name="ad-status" href="#ad-status"><i class="anchor-icon"></i></a>Ad Status</h3>
<p>Once you have submitted an ad, you will see it listed on your accounts homepage. An advertisment can have the following statuses:</p>
<ul>
<li><strong>Stopped</strong>. This is the default status shown for all new ads without a budget. This status is also shown when the ad&#39;s budget has run out.</li>
<li><strong>In Review</strong>. Our team is currently checking the ad content before it can be displayed in channels.</li>
<li><strong>Declined</strong>. Your ad must be changed before it can go live. Open the ad to see a more detailed explanation and a link to the relevant <a href="https://promote.telegram.org/guidelines">guidelines</a>.</li>
<li><strong>Active</strong>. Your ad is live, and sponsored messages are appearing in Telegram according to your parameters</li>
<li><strong>On Hold</strong>. You have paused the ad, but it&#39;s ready to become active again whenever you&#39;re ready.</li>
</ul>
<!--[screenshot of five ads, each with one of the statuses]-->
<h3><a class="anchor" name="ad-info" href="#ad-info"><i class="anchor-icon"></i></a>Ad Info</h3>
<p>Click any of your ads on the <a href="http://promote.telegram.org/account">homepage</a> to make changes to its <strong>content</strong> and <strong>CPM</strong>, increase its <strong>budget</strong>, or see <strong>statistics</strong>. The title, text and URL of your sponsored message can be updated at any time (but not its targeting parameters) to see a preview of how the sponsored message looks inside a channel, click Preview Ad.</p>
<div class="blog_video_player_wrap" style="max-width: 400px; margin: 20px auto 20px;">
<video class="blog_video_player tl_blog_vid_autoplay" onclick="videoTogglePlay(this)" autoplay playsinline loop controls muted poster="/file/464001822/2/7LDj5vvqN-A.44634/9b076decf0c3e89fee" style="max-width: 400px;" title="TITLE" alt="TITLE">
<source src="/file/464001106/3/oozYA9s9aoY.995176.mp4/44b270207efac83a9a" type="video/mp4">
</video>
</div>
<blockquote>
<p>If you would like to change the targeting parameters, click <strong>Create a similar ad</strong> this opens a new template with the same content so you can quickly make a new version.</p>
</blockquote>
<h3><a class="anchor" name="ad-budget" href="#ad-budget"><i class="anchor-icon"></i></a>Ad Budget</h3>
<p>To <strong>increase the budget</strong> of your ad, click the Current Budget field. You can also change the <strong>CPM</strong> to be higher or lower from the CPM field. If you need to <strong>delete</strong> your ad (perhaps to resubmit it with new targeting parameters or a lower budget) tap Delete Ad.</p>
<blockquote>
<p>It is not possible to <strong>decrease</strong> the budget of an ad once it has been submitted in this case, it is best to use Create a similar ad and submit a new ad with a lower budget. </p>
</blockquote>
<!--[screenshot of increase budget pop-up]-->
<p>The budget can also be increased from the Budget tab. This tab also contains the ads <strong>Transaction History</strong>, showing the ad&#39;s spending as well as any increases to the budget including the <strong>amount</strong> and <strong>time</strong> of the increase.</p>
<!--[screenshot of transaction history]-->
<h3><a class="anchor" name="statistics" href="#statistics"><i class="anchor-icon"></i></a>Statistics</h3>
<p>The Statistics tab has an overview of your advertisement, such as the date it was created, CPM, budget and overall views. Underneath, you will see a detailed graph showing views of your sponsored message and the number of times a user joined your channel or started the bot after viewing the sponsored message, able to be displayed in increments of minutes or days.</p>
<h3><a class="anchor" name="your-account-and-organizations" href="#your-account-and-organizations"><i class="anchor-icon"></i></a>Your Account and Organizations</h3>
<p>Click your name in the top-right corner to open a menu here you can edit your account info, create a new organization, switch accounts, or log out. On the Edit Account Info page, you can change your personal info, such as your email. You can also click the Budget tab to see the <strong>full transaction history</strong> of your account.</p>
<div class="blog_image_wrap blog_medium_image_wrap">
<a href="/file/464001514/2/0xYSOjw1aoI.35774/cde5c30756a1680bab" target="_blank"><img src="/file/464001514/2/0xYSOjw1aoI.35774/cde5c30756a1680bab" title="Edit account" alt="Edit account" srcset="/file/464001514/2/0xYSOjw1aoI.35774/cde5c30756a1680bab , 2x" /></a>
</div>
<p>The Telegram Ad Platform allows you to be simultaneously logged in to <strong>multiple organizations</strong>, as well as your <strong>personal ad account</strong>. To switch accounts, simply click your name in the top-right corner and select Switch to …’ from the menu.</p>
<div class="blog_image_wrap blog_medium_image_wrap">
<a href="/file/464001011/2/O0ZWZ8Iabgo.52333/e92e4417d899795814" target="_blank"><img src="/file/464001011/2/O0ZWZ8Iabgo.52333/e92e4417d899795814" title="Switching accounts" alt="Switching accounts" srcset="/file/464001011/2/O0ZWZ8Iabgo.52333/e92e4417d899795814 , 2x" /></a>
</div>
<hr>
<h2><a class="anchor" name="further-questions" href="#further-questions"><i class="anchor-icon"></i></a>Further Questions</h2>
<p>The platform is currently running in test mode. We will be expanding this document with more details.</p>
<p>Once you&#39;ve <a href="#adding-funds">added funds</a> to your account, you will get access to Telegram&#39;s dedicated <strong>Ad Platform Support</strong>.</p>
<!--
<div class="blog_image_wrap blog_medium_image_wrap">
<a href="LARGE" target="_blank"><img src="SMALL" title="TITLE" alt="TITLE" srcset="LARGE , 2x" /></a>
</div>
<div class="blog_video_player_wrap" style="max-width: 400px; margin: 20px auto 20px;">
<video class="blog_video_player tl_blog_vid_autoplay" onclick="videoTogglePlay(this)" autoplay playsinline loop controls muted poster="PHOTO" style="max-width: 400px;" title="TITLE" alt="TITLE">
<source src="VIDEO" type="video/mp4">
</video>
</div>
--></div>
</div></section>
</div><div class="popup-container login-popup-container hide" id="login-popup-container">
<div class="popup">
<div class="popup-body">
<section>
<h2>Log In</h2>
<p>Log in here to manage your ads. Please enter your <b>phone number</b> in the <a target="_blank" rel="noopener" href="https://telegram.org/faq#login-and-sms">international format</a> and we will send a confirmation message to your account via Telegram.</p>
<form id="send-form" class="login-form">
<div class="form-group">
<input type="tel" class="form-control pr-form-control input-lg" id="phone-number" placeholder="+12223334455" autocomplete="off"/>
</div>
<div class="popup-buttons">
<a class="btn btn-link btn-lg login-cancel-btn">Cancel</a><button type="submit" class="btn btn-link btn-lg">Next</button>
</div>
</form>
<div id="login-form" class="hide">
<div class="form-group">
<span class="form-control pr-form-control input input-lg input-disabled"><strong id="phone-number-field"></strong> (<a class="login-back" href="/auth">Incorrect?</a>)</span>
<p class="help-block dots-animated">We&#39;ve just sent you a message.<br/>Please confirm access via Telegram</p>
</div>
<div class="popup-buttons">
<a class="btn btn-link btn-lg login-cancel-btn">Cancel</a><a class="btn btn-link btn-lg login-back">Back</a>
</div>
</div>
</section>
</div>
</div>
</div></div>
<script src="//telegram.org/js/jquery.min.js?1"></script>
<script src="//telegram.org/js/bootstrap.min.js"></script>
<script src="//telegram.org/js/main-aj.js?68"></script>
<script src="/js/main.js?47"></script>
<script src="/js/widget-frame.js?62"></script>
<script src="/js/promote.js?71"></script>
<script src="/js/jquery-ui.min.js?1"></script>
<script src="/js/jquery-ex.js?15"></script>
<script src="/js/tchart.min.js?18"></script>
<script src="/js/health.js?18"></script>
<script src="/js/tgsticker.js?31"></script>
<script>ajInit({"version":963,"apiUrl":"\/api?hash=telegram-crawler","unauth":true});</script>
<script id="aj_script">l.add({"WEB_AB_WARNING_HEADER":"Turn off ad blocker","WEB_POPUP_CLOSE_BTN":"Close","WEB_AB_WARNING_TEXT":"You appear to be using an ad blocker that may prevent pages on the Telegram Ad Platform from working as expected.<br\/><br\/>Please turn off your ad blocker or add <a href=\"http:\/\/promote.telegram.org\/\">promote.telegram.org<\/a> as an exception to manage your promoted messages."});
window.enableInlineVideo&&$('video').each(function(){enableInlineVideo(this)});
Ads.init();
Aj.onLoad(function(state) {
function requestConfirmation(event) {
event && event.preventDefault();
var phone = $('#phone-number').val();
$.ajax({
type: 'POST',
url: '/auth/request',
data: {
phone: phone
},
success: function(result) {
$('#phone-number-field').text(phone);
$('#send-form').addClass('hide');
$('#login-form').removeClass('hide');
checkAuth(result.temp_session);
},
error: function(xhr) {
showAlert(xhr.responseText || 'Server error');
},
dataType: 'json'
});
return false;
}
function cancelConfirmation(event) {
event && event.preventDefault();
$('#phone-number-field').text('');
$('#send-form').removeClass('hide');
$('#login-form').addClass('hide');
$('#phone-number').focus();
clearTimeout(window.authTimeout);
return false;
}
function checkAuth(temp_session) {
clearTimeout(window.authTimeout);
window.authTimeout = setTimeout(function doCheckAuth() {
$.ajax({
type: 'POST',
url: '/auth/login',
data: {
temp_session: temp_session
},
success: function(result) {
if (result) {
location.reload();
} else {
checkAuth(temp_session);
}
},
error: function (xhr) {
showAlert(xhr.responseText || 'Server error');
},
dataType: 'json'
});
}, 700);
}
$('#login-popup-container').on('popup:open', function() {
$('#phone-number').focus();
});
$('#login-popup-container').on('popup:close', function() {
cancelConfirmation();
if (location.pathname == '/auth') {
window.history && history.replaceState(null, null, '/');
}
});
$('#login-popup-container #send-form').on('submit', requestConfirmation);
$('#login-popup-container .login-cancel-btn').on('click', function(e) {
e.preventDefault();
closePopup('#login-popup-container');
});
$('#login-popup-container .login-back').on('click', cancelConfirmation);
$('.login-link').on('click', function(e) {
e.stopImmediatePropagation();
e.preventDefault();
openPopup('#login-popup-container');
});
});
Aj.onUnload(function(state) {
$('#login-popup-container').off('popup:open');
$('#login-popup-container').off('popup:close');
$('#login-popup-container #send-form').off('submit');
$('#login-popup-container .login-cancel-btn').off('click');
$('#login-popup-container .login-back').off('click');
$('.login-link').off('click');
});
</script>
<script>Aj.pageLoaded();</script>
</body>
</html>