ਸਿੱਧਾ Annual Ads ਪਲੇਟਫਾਰਮ 'ਤੇ ਬਣਾਓ — ਵਿਗਿਆਪਕ ਬਣਾਓ, ਵਿਗਿਆਪਨ ਪ੍ਰਕਾਸ਼ਿਤ ਕਰੋ, ਭੁਗਤਾਨ ਟ੍ਰਿਗਰ ਕਰੋ ਅਤੇ ਰੈਂਕ ਟਰੈਕ ਕਰੋ, ਪੂਰੀ ਤਰ੍ਹਾਂ API ਰਾਹੀਂ।
ਪੂਰੀ ਕੀਮਤਾਂ ਦੀ ਗ੍ਰਿਡ ਵੇਖੋਤੁਸੀਂ 70% ਰੱਖਦੇ ਹੋ ਤੁਹਾਡੇ ਕਨੈਕਟ-ਮੋਡ ਵਿਗਿਆਪਨਦਾਤਾ ਆਪਣੇ ਵਿਗਿਆਪਨਾਂ ਲਈ ਜੋ ਭੁਗਤਾਨ ਕਰਦੇ ਹਨ — ਸਿੱਧਾ ਤੁਹਾਡੇ ਵਾਲਿਟ ਵਿੱਚ ਆਟੋਮੈਟਿਕ ਤੌਰ 'ਤੇ ਜਮ੍ਹਾਂ ਹੋ ਜਾਂਦਾ ਹੈ। ਹੇਠਾਂ ਵੇਖੋ ਕਿ ਇਹ ਕਿਵੇਂ ਕੰਮ ਕਰਦਾ ਹੈ।
ਹਰ ਬੇਨਤੀ ਨੂੰ Bearer ਸਕੀਮ ਦੀ ਵਰਤੋਂ ਕਰਦਿਆਂ Authorization ਹੈਡਰ ਵਿੱਚ ਇੱਕ ਗੁਪਤ ਕੁੰਜੀ ਨਾਲ ਪ੍ਰਮਾਣਿਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।
POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/jsonAPI ਕੁੰਜੀਆਂ ਸਾਲਾਨਾ ਇਸ਼ਤਿਹਾਰ ਟੀਮ ਵੱਲੋਂ ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਸਾਂਝੇਦਾਰ ਖਾਤਿਆਂ ਨੂੰ ਜਾਰੀ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ।
ਸਾਂਝੇਦਾਰ ਖਾਤਾ ਬਣਾਓ| POST | /v1/partner/advertisersਆਪਣੇ ਕਿਸੇ ਇੱਕ ਯੂਜ਼ਰ ਦੀ ਤਰਫੋਂ ਇਸ਼ਤਿਹਾਰਦਾਤਾ ਖਾਤਾ ਬਣਾਓ (ਕਨੈਕਟ ਮੋਡ)। | advertisers:write |
| GET | /v1/partner/advertisers/{id}ਇਸ ਸਾਂਝੀਦਾਰ ਦੁਆਰਾ ਬਣਾਇਆ ਗਿਆ ਇੱਕ ਵਿਗਿਆਪਕ ਖਾਤਾ ਲੱਭੋ। | advertisers:read |
| POST | /v1/partner/adsਇੱਕ ਵਿਗਿਆਪਨ ਬਣਾਓ। ਇਹ ਡਰਾਫਟ ਸਥਿਤੀ ਵਿੱਚ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ। ਵਿਕਲਪਿਕ advertiser_type, promotion_type, link_type ਅਤੇ promoted_brand ਖੇਤਰ ਸਹਿਯੋਗੀ, ਰੈਫਰਲ, ਰਚਨਾਕਾਰ ਜਾਂ ਵਿਅਕਤੀਗਤ ਵਿਗਿਆਪਨ ਦਾ ਵਰਣਨ ਕਰਦੇ ਹਨ — ਹੇਠਾਂ ਦਿੱਤੇ ਨੋਟ ਨੂੰ ਵੇਖੋ। | ads:write |
| GET | /v1/partner/ads/{id}ਇਸ਼ਤਿਹਾਰ ਵੇਖੋ। | ads:read |
| PATCH | /v1/partner/ads/{id}ਸੰਪਾਦਕੀ ਸਮੱਗਰੀ ਨੂੰ ਅਪਡੇਟ ਕਰੋ — ਸਿਰਲੇਖ, ਵੇਰਵਾ, ਲਿੰਕ, ਵਿਗਿਆਪਕ ਕਿਸਮ, ਪ੍ਰਚਾਰ ਕਿਸਮ, ਲਿੰਕ ਕਿਸਮ, ਅਤੇ ਪ੍ਰਚਾਰਿਤ ਬ੍ਰਾਂਡ। ਸ਼੍ਰੇਣੀ, ਭੂਗੋਲ, ਅਤੇ ਰੈਂਕਿੰਗ ਇੰਜਣ ਵੱਲੋਂ ਪੜ੍ਹੀ ਜਾਣ ਵਾਲੀ ਕੋਈ ਵੀ ਚੀਜ਼ ਇੱਥੇ ਕਦੇ ਵੀ ਬਦਲੀ ਨਹੀਂ ਜਾ ਸਕਦੀ। | ads:write |
| POST | /v1/partner/ads/{id}/imageਇੱਕ ਵਿਗਿਆਪਨ ਚਿੱਤਰ ਸਿੱਧਾ ਅਪਲੋਡ ਕਰੋ (JPEG/PNG/WebP, ਵੱਧ ਤੋਂ ਵੱਧ 5 MB)। ਪਹਿਲੀ ਭੁਗਤਾਨ ਤੋਂ ਪਹਿਲਾਂ ਲਾਜ਼ਮੀ — ਹੇਠਾਂ ਦਿੱਤੇ ਭੁਗਤਾਨ ਸਮੂਹ ਨੂੰ ਵੇਖੋ। | ads:write |
| POST | /v1/partner/ads/{id}/image-urlਫਾਈਲ ਅਪਲੋਡ ਕਰਨ ਦੀ ਬਜਾਏ ਕਿਸੇ URL ਤੋਂ ਇਸ਼ਤਿਹਾਰ ਦੀ ਤਸਵੀਰ ਸੈੱਟ ਕਰੋ — ਸਰਵਰ ਖੁਦ ਹੀ ਇਸਨੂੰ ਲਿਆਉਂਦਾ ਅਤੇ ਰੀ-ਹੋਸਟ ਕਰਦਾ ਹੈ। ਇਹੀ ਲੋੜ: ਪਹਿਲੀ ਭੁਗਤਾਨ ਤੋਂ ਪਹਿਲਾਂ ਲਾਜ਼ਮੀ। | ads:write |
| GET | /v1/partner/ads/{id}/rankਇੱਕ ਵਿਗਿਆਪਨ ਲਈ ਮੌਜੂਦਾ ਦਰਜਾ, ਸ਼੍ਰੇਣੀ, ਅਤੇ ਭੂਗੋਲਿਕ ਦਾਇਰਾ। | ads:read |
| GET | /v1/partner/ads/{id}/statsਇੱਕ ਵਿਗਿਆਪਨ ਲਈ ਕੁੱਲ ਵਿਊਜ਼ ਅਤੇ ਕਲਿੱਕ — ਲੰਘੇ/ਬਾਕੀ ਦਿਨ ਪਹਿਲਾਂ ਹੀ GET /{id} 'ਤੇ ਮੌਜੂਦ activated_at/expires_at ਫੀਲਡਾਂ ਤੋਂ ਆਉਂਦੇ ਹਨ, ਅਤੇ ਰੈਂਕ GET /{id}/rank ਤੋਂ। | ads:read |
| POST | /v1/partner/paymentsਸ਼ੁਰੂਆਤੀ ਖਰੀਦ ਜਾਂ ਟਾਪ-ਅੱਪ ਲਈ ਕ੍ਰਿਪਟੋ ਭੁਗਤਾਨ ਸ਼ੁਰੂ ਕਰੋ। ਸ਼ੁਰੂਆਤੀ ਭੁਗਤਾਨ 422 ਨਾਲ ਅਸਫਲ ਹੁੰਦਾ ਹੈ ਜੇਕਰ ਵਿਗਿਆਪਨ ਵਿੱਚ ਪਹਿਲਾਂ ਹੀ ਚਿੱਤਰ ਨਾ ਹੋਵੇ — ਉੱਪਰ uploadAdImage/setAdImageUrl ਵੇਖੋ। | payments:write |
| GET | /v1/partner/payments/{id}ਭੁਗਤਾਨ ਦੀ ਸਥਿਤੀ ਜਾਂਚੋ। | payments:read |
| POST | /v1/partner/referralsਇੱਕ ਰੈਫਰਲ ਲਿੰਕ ਬਣਾਓ। | referrals:write |
| GET | /v1/partner/referrals/{code}/earningsਸਥਿਤੀ ਅਨੁਸਾਰ ਵੰਡੀਆਂ ਕੁੱਲ ਰੈਫਰਲ ਕਮਾਈਆਂ। | referrals:read |
| GET | /v1/partner/ad-revenue/earningsਕਨੈਕਟ ਮੋਡ ਵਿੱਚ ਤੁਹਾਡੇ ਦੁਆਰਾ ਬਣਾਏ ਗਏ ਵਿਗਿਆਪਨਦਾਤਾਵਾਂ ਦੁਆਰਾ ਆਪਣੇ ਵਿਗਿਆਪਨਾਂ ਲਈ ਕੀਤੇ ਗਏ ਭੁਗਤਾਨ ਵਿੱਚੋਂ ਤੁਹਾਡਾ 70% ਹਿੱਸਾ, ਸਥਿਤੀ ਅਨੁਸਾਰ ਵੰਡਿਆ ਹੋਇਆ। | ad-revenue:read |
| GET | /v1/partner/access-logਇਸ ਕੁੰਜੀ — ਮੈਥਡ, ਪਾਥ, IP, ਟਾਈਮਸਟੈਂਪ ਲਈ ਪੂਰੀ ਕਾਲ ਇਤਿਹਾਸ। | ਉੱਥੇ |
| GET | /v1/rankings?category={id}&geo={scope}ਸ਼੍ਰੇਣੀ ਅਤੇ ਭੂਗੋਲਿਕ ਦਾਇਰੇ ਲਈ ਸਿਰਫ-ਪੜ੍ਹਨਯੋਗ ਰੈਂਕਿੰਗ। | ਜਨਤਕ |
| GET | /v1/tiers7 ਸੰਰਚਿਤ ਕੀਮਤ ਪੱਧਰ (ਸੀਮਾ, ਅਨਲੌਕ ਕੀਤੀਆਂ ਸਹੂਲਤਾਂ) | ਜਨਤਕ |
| GET | /v1/referral-programਰੈਫਰਲ ਕੈਸਕੇਡ ਅਤੇ ਲੀਡਰਜ਼ ਪੂਲ ਲਈ ਵਰਤਮਾਨ ਵਿੱਚ ਸਰਗਰਮ ਕਮਿਸ਼ਨ ਪ੍ਰਤੀਸ਼ਤ। | ਜਨਤਕ |
| GET | /v1/partner-programਤੁਹਾਡੇ ਅਤੇ ਸਾਲਾਨਾ ਇਸ਼ਤਿਹਾਰਾਂ ਵਿਚਕਾਰ ਮੌਜੂਦਾ ਇਸ਼ਤਿਹਾਰ ਆਮਦਨ ਵੰਡ (ਕਨੈਕਟ ਮੋਡ) | ਜਨਤਕ |
| GET | /v1/search?q={query}ਕੁਦਰਤੀ ਭਾਸ਼ਾ ਖੋਜ — ਇੱਕ ਪੁੱਛਗਿੱਛ ਜਿਵੇਂ "ਕੀਨੀਆ ਵਿੱਚ ਫਰਨੀਚਰ ਦੇ ਵਿਗਿਆਪਨਕਰਤਾ" ਨੂੰ ਮੇਲ ਖਾਂਦੀ ਸ਼੍ਰੇਣੀ ਅਤੇ ਭੂਗੋਲਿਕ ਦਾਇਰੇ ਵੱਲ ਰਾਹ ਦਿਖਾਉਂਦੀ ਹੈ, ਫਿਰ ਉਸ ਰੈਂਕਿੰਗ ਨੂੰ ਉਸਦੀ ਅਸਲ ਕ੍ਰਮਵਾਰਤਾ ਵਿੱਚ ਵਾਪਸ ਕਰਦੀ ਹੈ। | ਜਨਤਕ |
ਸਹਿਯੋਗੀ ਅਤੇ ਸਿਫਾਰਸ਼ੀ ਵਿਗਿਆਪਨ
advertiser_type, promotion_type, link_type, ਅਤੇ promoted_brand POST ਅਤੇ PATCH /v1/partner/ads 'ਤੇ ਵਿਕਲਪਿਕ ਖੇਤਰ ਹਨ — ਸਾਲਾਨਾ ਇਸ਼ਤਿਹਾਰ ਸਿਰਫ਼ ਉਹਨਾਂ ਕਾਰੋਬਾਰਾਂ ਤੱਕ ਸੀਮਤ ਨਹੀਂ ਹਨ ਜੋ ਆਪਣੇ ਆਪ ਦਾ ਇਸ਼ਤਿਹਾਰ ਕਰ ਰਹੇ ਹਨ। ਜਦੋਂ link_type affiliate_link ਜਾਂ referral_invitation_link ਹੁੰਦਾ ਹੈ, ਜਾਂ promotion_type affiliate_offer ਜਾਂ referral_opportunity ਹੁੰਦਾ ਹੈ, ਤਾਂ affiliate_terms_accepted ਸਹੀ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ, ਨਹੀਂ ਤਾਂ ਬੇਨਤੀ ਨੂੰ 422 ਨਾਲ ਰੱਦ ਕਰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ। ਸਿਰਲੇਖ 35 ਅੱਖਰਾਂ ਅਤੇ ਵੇਰਵਾ 80 ਅੱਖਰਾਂ ਤੱਕ ਸੀਮਤ ਹੈ — ਦੋਵੇਂ ਸਿਰਫ਼ ਡੈਸ਼ਬੋਰਡ UI ਵਿੱਚ ਹੀ ਨਹੀਂ, ਸਗੋਂ ਸਰਵਰ-ਸਾਈਡ 'ਤੇ ਲਾਗੂ ਹੁੰਦੇ ਹਨ।
ਹਰ ਵਿਗਿਆਪਕ ਖਾਤੇ ਨੂੰ ਬਿਲਟ-ਇਨ AI ਟੂਲਜ਼ ਦਾ ਇੱਕ ਸੈੱਟ ਮਿਲਦਾ ਹੈ — ਇੱਕ ਵਿਗਿਆਪਨ ਸਮੱਗਰੀ ਅਤੇ ਵਿਜ਼ੂਅਲ ਜਨਰੇਟਰ, ਇੱਕ ਸੰਵਾਦੀ ਸਹਾਇਕ, ਇੱਕ ਬਜਟ ਸਲਾਹਕਾਰ, ਅਤੇ ਇੱਕ ਬਾਹਰੀ SEO ਆਡੀਟਰ — ਜਿਨ੍ਹਾਂ ਲਈ ਫਲੈਟ ਸਾਲਾਨਾ ਕੀਮਤ ਦੇ ਇਲਾਵਾ AI ਕ੍ਰੈਡਿਟਾਂ ਨਾਲ ਭੁਗਤਾਨ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।
| POST | /v1/advertisers/{id}/ai/assistantAsk Annual Ads — ਇੱਕ ਫਲੋਟਿੰਗ ਗੱਲਬਾਤ ਸਹਾਇਕ, ਸਿਰਫ ਜਾਣਕਾਰੀ ਲਈ, ਖਾਤਾ ਡੇਟਾ 'ਤੇ ਸਿਰਫ ਪੜ੍ਹਨਯੋਗ। | ਜਨਤਕ |
| POST | /v1/advertisers/{id}/ai/creative-studioਇੱਕ ਛੋਟੀ ਕਾਰੋਬਾਰੀ ਵੇਰਵੇ ਤੋਂ ਇੱਕ ਵਿਗਿਆਪਨ ਦਾ ਸਿਰਲੇਖ, ਵੇਰਵਾ ਅਤੇ ਕੀਵਰਡ ਤਿਆਰ ਕਰੋ। | 2 ਕ੍ਰੈਡਿਟ(ਸ) |
| POST | /v1/advertisers/{id}/ai/creative-studio/imageਉਸੇ ਕਾਰੋਬਾਰੀ ਵੇਰਵੇ ਤੋਂ ਇੱਕ ਲਿਸਟਿੰਗ ਵਿਜ਼ੂਅਲ (PNG) ਤਿਆਰ ਕਰੋ, ਜੋ ਹੋਸਟ ਕੀਤਾ ਹੋਇਆ ਹੈ ਅਤੇ ਇਸ਼ਤਿਹਾਰ ਨਾਲ ਜੋੜਨ ਲਈ ਤਿਆਰ ਹੈ। | 8 ਕ੍ਰੈਡਿਟ(ਸ) |
| POST | /v1/advertisers/{id}/ai/budget-advisorਇੱਕ ਅਸਲੀ ਅੰਕੜਾ-ਅਧਾਰਿਤ ਅਨੁਮਾਨ — ਕਦੇ ਵੀ ਕੋਈ ਉਤਪੰਨ ਅਨੁਮਾਨ ਨਹੀਂ — ਕਿਸੇ ਨਿਰਧਾਰਤ ਦਰਜੇ ਨੂੰ 30/90/365 ਦਿਨਾਂ ਲਈ ਬਰਕਰਾਰ ਰੱਖਣ ਦੀ ਸੰਭਾਵਨਾ। | 1 ਕ੍ਰੈਡਿਟ(ਸ) |
| POST | /v1/advertisers/{id}/ai/seo-auditਵਿਗਿਆਪਕ ਦੀ ਆਪਣੀ ਬਾਹਰੀ ਵੈੱਬਸਾਈਟ ਦਾ ਵਿਸ਼ਲੇਸ਼ਣ ਕਰੋ ਅਤੇ ਠੋਸ SEO ਸੁਧਾਰਾਂ ਦੀ ਸਿਫਾਰਸ਼ ਕਰੋ। | 2 ਕ੍ਰੈਡਿਟ(ਸ) |
ਉਹੀ ਸ਼੍ਰੇਣੀ ਅਤੇ ਕਾਰੋਬਾਰੀ ਵੇਰਵਾ ਹੇਠਾਂ ਦਿੱਤੇ ਚਿੱਤਰ ਜਨਰੇਟਰ ਨੂੰ ਵੀ ਸੰਚਾਲਿਤ ਕਰਦੇ ਹਨ।
POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json
{
"category_name": "Furniture",
"business_description": "We sell handmade oak dining tables"
}{
"title": "Handmade Oak Dining Tables — Built to Last",
"description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
"keywords": ["oak furniture", "dining table", "handmade"],
"credits_remaining": 8
}ਉਸੇ ਇਸ਼ਤਿਹਾਰ ਲਈ ਇੱਕ ਮੇਲ ਖਾਂਦਾ ਵਿਜ਼ੂਅਲ ਤਿਆਰ ਕਰੋ:
POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json
{
"category_name": "Furniture",
"business_description": "We sell handmade oak dining tables"
}{
"visual_url": "https://cdn.uploadscenter.com/file_01m1...",
"credits_remaining": 4
}ਤਿਆਰ-ਬਣਾਇਆ ਇਸ਼ਤਿਹਾਰ ਯੂਨਿਟ ਆਪਣੀ ਸਾਈਟ 'ਤੇ ਸਿੱਧਾ ਡ੍ਰੌਪ ਕਰੋ — ਕੋਈ ਬਿਲਡ ਸਟੈਪ ਨਹੀਂ, ਕੋਈ iframe ਨਹੀਂ। ਸਕ੍ਰਿਪਟ ਇੱਕ ਅਲੱਗ Shadow DOM ਵਿੱਚ ਸਿੱਧਾ ਪੰਨੇ 'ਤੇ ਰੈਂਡਰ ਹੁੰਦੀ ਹੈ, ਇਸ ਲਈ ਇਸ ਦੀਆਂ ਸਟਾਈਲਾਂ ਕਦੇ ਵੀ ਤੁਹਾਡੀ ਸਾਈਟ ਵਿੱਚ ਨਹੀਂ ਲੀਕ ਹੁੰਦੀਆਂ, ਅਤੇ ਤੁਹਾਡੀ ਸਾਈਟ ਦੀਆਂ ਸਟਾਈਲਾਂ ਕਦੇ ਵੀ ਇਸ ਵਿੱਚ ਨਹੀਂ ਲੀਕ ਹੁੰਦੀਆਂ।
<div
class="annualads-widget"
data-category="YOUR_CATEGORY_ID"
data-geo="global"
data-count="4"
data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>ਡਿਫੌਲਟ ਤੌਰ 'ਤੇ ਇਹ ਸ਼੍ਰੇਣੀ ਦੀ ਪੂਰੀ ਜਨਤਕ ਰੈਂਕਿੰਗ ਦਿਖਾਉਂਦਾ ਹੈ — ਪਲੇਟਫਾਰਮ 'ਤੇ ਹਰ ਇਸ਼ਤਿਹਾਰਦਾਤਾ, ਸਿਰਫ਼ ਉਹ ਨਹੀਂ ਜੋ ਤੁਸੀਂ ਲਿਆਏ ਹੋ। ਸਿਰਫ਼ ਉਹ ਇਸ਼ਤਿਹਾਰ ਦਿਖਾਉਣ ਲਈ ਜੋ ਤੁਸੀਂ Connect ਮੋਡ ਰਾਹੀਂ ਬਣਾਏ ਇਸ਼ਤਿਹਾਰਦਾਤਾਵਾਂ ਦੇ ਹਨ (ਜੋ ਤੁਹਾਡਾ ਹਿੱਸਾ ਪੈਦਾ ਕਰ ਰਹੇ ਹਨ), ਆਪਣੇ ਪਾਰਟਨਰ ID ਨਾਲ data-partner ਸ਼ਾਮਿਲ ਕਰੋ (ਇਹ ਤੁਹਾਡੇ ਆਪਣੇ ਡੈਸ਼ਬੋਰਡ ਦੇ ਡਿਵੈਲਪਰਜ਼ ਪੇਜ 'ਤੇ ਮਿਲੇਗਾ):
<div
class="annualads-widget"
data-category="YOUR_CATEGORY_ID"
data-geo="global"
data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>ਜੇ ਤੁਹਾਡੇ ਵਿਗਿਆਪਕ ਕਈ ਸ਼੍ਰੇਣੀਆਂ ਵਿੱਚ ਫੈਲੇ ਹੋਏ ਹਨ, ਤਾਂ data-category ਨੂੰ ਪੂਰੀ ਤਰ੍ਹਾਂ ਹਟਾ ਦਿਓ — ਸਿਰਫ data-partner ਨਾਲ, ਵਿਜੇਟ ਤੁਹਾਡੇ ਸਾਰੇ ਵਿਗਿਆਪਨ ਸਾਰੀਆਂ ਸ਼੍ਰੇਣੀਆਂ ਵਿੱਚੋਂ ਇੱਕ ਹੀ ਗ੍ਰਿਡ ਵਿੱਚ ਦਿਖਾਉਂਦਾ ਹੈ, ਇਸ ਤਰ੍ਹਾਂ ਹਰ ਸ਼੍ਰੇਣੀ ਲਈ ਵੱਖਰਾ ਵਿਜੇਟ ਬਲਾਕ ਲਗਾਉਣ ਦੀ ਲੋੜ ਨਹੀਂ ਰਹਿੰਦੀ:
<div
class="annualads-widget"
data-geo="global"
data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>ਕੀ ਤੁਸੀਂ ਆਪਣੇ ਇਨ-ਕੰਟੈਂਟ ਯੂਨਿਟ ਦੇ ਨਾਲ ਇੱਕ ਫੁੱਟਰ-ਸਟਾਈਲ ਯੂਨਿਟ ਵੀ ਚਾਹੁੰਦੇ ਹੋ, ਜੋ ਹਰ ਇੱਕ ਵੱਖ-ਵੱਖ ਇਸ਼ਤਿਹਾਰ ਦਿਖਾਏ? ਇੱਕ ਦੂਜਾ ਵਿਜੇਟ ਬਲਾਕ ਸ਼ਾਮਲ ਕਰੋ ਜਿਸ ਵਿੱਚ data-layout="compact" (ਇੱਕ ਇਸ਼ਤਿਹਾਰ, ਜੋ ਇੱਕ ਛੋਟੀ ਗੋਲੀ ਵਾਂਗ ਸੰਕੁਚਿਤ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ) ਅਤੇ data-offset ਨੂੰ ਆਪਣੇ ਪਹਿਲੇ ਵਿਜੇਟ ਦੁਆਰਾ ਪਹਿਲਾਂ ਹੀ ਦਿਖਾਏ ਜਾ ਰਹੇ ਇਸ਼ਤਿਹਾਰਾਂ ਦੀ ਗਿਣਤੀ ਦੇ ਅਨੁਸਾਰ ਸੈੱਟ ਕਰੋ:
<!-- in your content -->
<div
class="annualads-widget"
data-category="YOUR_CATEGORY_ID"
data-geo="global"
data-count="4"
data-columns="2"
></div>
<!-- in your footer, showing different ads via data-offset -->
<div
class="annualads-widget"
data-category="YOUR_CATEGORY_ID"
data-geo="global"
data-layout="compact"
data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>data-category | ਦਿਖਾਉਣ ਲਈ ਸ਼੍ਰੇਣੀ ਆਈਡੀ। ਲਾਜ਼ਮੀ — ਜੇ data-partner ਸੈੱਟ ਕੀਤਾ ਗਿਆ ਹੈ, ਤਾਂ ਇਸਨੂੰ ਛੱਡਣ ਨਾਲ ਹਰ ਸ਼੍ਰੇਣੀ ਵਿੱਚ ਉਸ ਭਾਗੀਦਾਰ ਦੇ ਇਸ਼ਤਿਹਾਰ ਦਿਖਾਏ ਜਾਂਦੇ ਹਨ। |
data-geo | ਜਿਓ-ਸਕੋਪ: ਸਥਾਨਕ, ਖੇਤਰੀ, ਜਾਂ ਵਿਸ਼ਵ-ਵਿਆਪੀ। ਡਿਫੌਲਟ ਵਿਸ਼ਵ-ਵਿਆਪੀ ਹੈ। |
data-count | ਦਿਖਾਉਣ ਲਈ ਵਿਗਿਆਪਨਾਂ ਦੀ ਗਿਣਤੀ। ਡਿਫੌਲਟ 4 ਹੈ। |
data-columns | ਗ੍ਰਿਡ ਕਾਲਮਾਂ ਦੀ ਗਿਣਤੀ। ਡਿਫੌਲਟ 2 ਹੈ। |
data-layout | ਗ੍ਰਿਡ, ਸੂਚੀ, ਜਾਂ ਕੰਪੈਕਟ। ਡਿਫੌਲਟ ਗ੍ਰਿਡ ਹੈ। ਕੰਪੈਕਟ ਇੱਕ ਇਸ਼ਤਿਹਾਰ ਦਿਖਾਉਂਦਾ ਹੈ (data-count ਨੂੰ ਨਜ਼ਰਅੰਦਾਜ਼ ਕੀਤਾ ਜਾਂਦਾ ਹੈ) ਜਿਸ ਵਿੱਚ ਇੱਕ ਬਟਨ ਹੁੰਦਾ ਹੈ ਜਿਸ ਨਾਲ ਇਸਨੂੰ ਇੱਕ ਛੋਟੀ ਗੋਲੀ ਵਾਂਗ ਸੁੰਗੇੜਿਆ ਅਤੇ ਵਾਪਸ ਲਿਆਂਦਾ ਜਾ ਸਕਦਾ ਹੈ — ਇੱਕ ਫੁੱਟਰ-ਸ਼ੈਲੀ ਦੀ ਯੂਨਿਟ, ਜੋ ਸਕ੍ਰਿਪਟ ਦੁਆਰਾ ਕਦੇ ਵੀ ਫਿਕਸਡ ਤੌਰ 'ਤੇ ਪੋਜ਼ੀਸ਼ਨ ਨਹੀਂ ਕੀਤੀ ਜਾਂਦੀ, ਤੁਸੀਂ ਆਪਣੇ ਪੰਨੇ 'ਤੇ ਕੰਟੇਨਰ div ਨੂੰ ਆਪਣੀ ਪਸੰਦ ਅਨੁਸਾਰ ਰੱਖਦੇ ਅਤੇ ਸਟਾਈਲ ਕਰਦੇ ਹੋ। |
data-offset | ਸਭ ਤੋਂ ਉੱਚ-ਰੈਂਕ ਵਾਲੀਆਂ ਇਸ਼ਤਿਹਾਰਾਂ ਨੂੰ ਛੱਡਣ ਦੀ ਗਿਣਤੀ। ਡਿਫੌਲਟ 0 ਹੈ। ਇਹ ਇੱਕੋ ਪੰਨੇ 'ਤੇ ਦੂਜੇ ਵਿਜੇਟ (ਉਦਾਹਰਨ ਵਜੋਂ ਫੁੱਟਰ ਵਿੱਚ ਇੱਕ ਸੰਖੇਪ ਵਿਜੇਟ ਅਤੇ ਉੱਪਰ ਇੱਕ ਗ੍ਰਿਡ ਵਿਜੇਟ) ਨੂੰ ਇੱਕੋ ਇਸ਼ਤਿਹਾਰ ਦੋ ਵਾਰ ਦਿਖਾਉਣ ਦੀ ਬਜਾਏ ਵੱਖ-ਵੱਖ ਇਸ਼ਤਿਹਾਰ ਦਿਖਾਉਣ ਦੀ ਆਗਿਆ ਦਿੰਦਾ ਹੈ — ਦੂਜੇ ਵਿਜੇਟ ਵੱਲੋਂ ਪਹਿਲਾਂ ਹੀ ਦਿਖਾਏ ਜਾ ਰਹੇ ਇਸ਼ਤਿਹਾਰਾਂ ਦੀ ਗਿਣਤੀ ਦਿਓ। |
data-partner | ਤੁਹਾਡੀ ਪਾਰਟਨਰ ID (ਇਸਨੂੰ ਆਪਣੇ ਡੈਸ਼ਬੋਰਡ ਦੇ ਡਿਵੈਲਪਰਜ਼ ਪੇਜ 'ਤੇ ਲੱਭੋ)। ਵਿਕਲਪਿਕ — ਇਸਦੇ ਬਿਨਾਂ, ਵਿਜੇਟ ਉਸ ਸ਼੍ਰੇਣੀ ਲਈ ਪਲੇਟਫਾਰਮ 'ਤੇ ਮੌਜੂਦ ਹਰ ਵਿਗਿਆਪਨਦਾਤਾ ਦੀ ਪੂਰੀ ਜਨਤਕ ਰੈਂਕਿੰਗ ਦਿਖਾਉਂਦਾ ਹੈ। ਇਸਦੇ ਨਾਲ, ਸਿਰਫ ਉਹ ਵਿਗਿਆਪਨ ਦਿਖਾਏ ਜਾਣਗੇ ਜੋ ਤੁਸੀਂ Connect ਮੋਡ ਰਾਹੀਂ ਲਿਆਂਦੇ ਹਨ — ਉਹੀ ਜੋ ਅਸਲ ਵਿੱਚ ਤੁਹਾਡਾ ਹਿੱਸਾ ਪੈਦਾ ਕਰਦੇ ਹਨ। |
ਕੁੰਜੀ ਪ੍ਰਤੀ ਮਿੰਟ ਅਨੁਰੋਧਾਂ ਦੀ ਸੀਮਾ ਨਿਰਧਾਰਤ ਕੀਤੀ ਗਈ ਹੈ। ਹਰ ਪ੍ਰਮਾਣਿਤ ਜਵਾਬ ਵਿੱਚ X-RateLimit-Limit, X-RateLimit-Remaining ਅਤੇ X-RateLimit-Reset ਹੈਡਰ ਹੁੰਦੇ ਹਨ; ਸੀਮਾ ਪਾਰ ਕਰਨ 'ਤੇ Retry-After ਹੈਡਰ ਨਾਲ 429 Too Many Requests ਵਾਪਸ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।
ਵਿਕਲਪਿਕ, ਹਰ ਸਾਥੀ ਲਈ। ਜਦ ਤੱਕ ਤੁਸੀਂ ਕੋਈ ਐਂਟਰੀ ਨਹੀਂ ਜੋੜਦੇ, ਤੁਹਾਡੀਆਂ ਕੁੰਜੀਆਂ ਕਿਸੇ ਵੀ IP ਤੋਂ ਬੇਨਤੀਆਂ ਸਵੀਕਾਰ ਕਰਦੀਆਂ ਹਨ — ਪਹਿਲੀ ਐਂਟਰੀ ਉਸ ਸਾਥੀ ਦੀਆਂ ਸਾਰੀਆਂ ਕੁੰਜੀਆਂ ਨੂੰ ਸਿਰਫ਼ ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਸੂਚੀ ਤੱਕ ਸੀਮਤ ਕਰ ਦਿੰਦੀ ਹੈ।
ਹਰ ਵੈਬਹੁੱਕ ਨੂੰ ਬਣਾਉਣ ਸਮੇਂ ਇੱਕ ਵਾਰੀ ਜਾਰੀ ਕੀਤੇ ਗਏ ਗੁਪਤ ਸੈਕਰੇਟ ਦੀ ਵਰਤੋਂ ਕਰਕੇ HMAC-SHA256 ਨਾਲ ਦਸਤਖਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ — ਪੇਲੋਡ 'ਤੇ ਭਰੋਸਾ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਦਸਤਖਤ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ। ਘਟਨਾਵਾਂ ਸਿਰਫ ਉਸ ਸਾਥੀ ਨੂੰ ਭੇਜੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਜੋ ਸੰਬੰਧਤ ਵਿਗਿਆਪਕ ਦਾ ਮਾਲਕ ਹੈ।
payment.succeeded | ਇੱਕ ਭੁਗਤਾਨ ਪੁਸ਼ਟੀ ਹੋ ਗਿਆ ਹੈ। |
payment.refunded | ਰਿਫੰਡ ਕੀਤਾ ਗਿਆ ਹੈ। |
ad.activated | ਇੱਕ ਇਸ਼ਤਿਹਾਰ ਆਪਣੇ ਆਪ ਜਾਂ ਪ੍ਰਸ਼ਾਸਕ ਦੀ ਸਮੀਖਿਆ ਤੋਂ ਬਾਅਦ ਸਰਗਰਮ ਹੋ ਜਾਂਦਾ ਹੈ। |
invoice.issued | ਇੱਕ ਇਨਵੌਇਸ ਜਾਰੀ ਕੀਤਾ ਗਿਆ ਹੈ। |
referral.payout.completed | ਇੱਕ ਰੈਫਰਲ ਕਮਿਸ਼ਨ ਭੁਗਤਾਨਯੋਗ ਦਰਜੇ ਤੱਕ ਪਹੁੰਚ ਜਾਂਦਾ ਹੈ। |
referral.payout.failed | ਪ੍ਰਦਾਤਾ ਕੋਲ ਰੈਫਰਲ ਭੁਗਤਾਨ ਬੈਚ ਅਸਫਲ ਹੋ ਜਾਂਦਾ ਹੈ — ਕਮਾਈਆਂ ਭੁਗਤਾਨਯੋਗ ਵਿੱਚ ਵਾਪਸ ਆ ਜਾਂਦੀਆਂ ਹਨ ਅਤੇ ਮੁੜ ਕੋਸ਼ਿਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। |
rank.changed | ਇੱਕ ਇਸ਼ਤਿਹਾਰ ਦੀ ਰੈਂਕ ਬਦਲਦੀ ਹੈ — ਜਿਸ ਵਿੱਚ ਹੋਰ ਕਿਸੇ ਵਿਗਿਆਪਨਦਾਤਾ ਦੀ ਭੁਗਤਾਨੀ ਕਾਰਨ ਵੀ ਸ਼ਾਮਿਲ ਹੈ। |
ad.expiring_soon | ਇਸ਼ਤਿਹਾਰ ਦੀ ਮਿਆਦ ਖਤਮ ਹੋਣ ਤੋਂ 30, 7, ਜਾਂ 1 ਦਿਨ ਪਹਿਲਾਂ। |
partner_ad_revenue.payout.completed | ਇਸ਼ਤਿਹਾਰ ਆਮਦਨ ਸਾਂਝੇਦਾਰੀ ਭੁਗਤਾਨ ਭੁਗਤਾਨੀ ਸਥਿਤੀ ਤੱਕ ਪਹੁੰਚਦਾ ਹੈ। |
partner_ad_revenue.payout.failed | ਪ੍ਰਦਾਤਾ ਕੋਲ ਵਿਗਿਆਪਨ ਆਮਦਨ ਸਾਂਝੇ ਭੁਗਤਾਨ ਦਾ ਇੱਕ ਬੈਚ ਅਸਫਲ ਹੋ ਜਾਂਦਾ ਹੈ — ਸ਼ੇਅਰ ਮੁੜ ਭੁਗਤਾਨਯੋਗ ਵਿੱਚ ਆ ਜਾਂਦੇ ਹਨ ਅਤੇ ਮੁੜ ਕੋਸ਼ਿਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। |
ਇਸੇ API ਵਿਸ਼ੇਸ਼ਤਾ ਤੋਂ ਤਿਆਰ ਕੀਤੇ ਗਏ ਅਧਿਕਾਰਤ JavaScript/TypeScript ਅਤੇ Python SDKs ਦੀ ਯੋਜਨਾ ਤਾਂ ਬਣਾਈ ਗਈ ਹੈ, ਪਰ ਉਹ ਅਜੇ ਪ੍ਰਕਾਸ਼ਿਤ ਨਹੀਂ ਹੋਏ — ਤਦ ਤੱਕ HTTP API ਨੂੰ ਸਿੱਧਾ ਕਾਲ ਕਰੋ।
ਅਜੇ ਤੱਕ ਕੋਈ SDK ਨਹੀਂ — ਇਹ ਸਿੱਧਾ HTTP API ਨੂੰ ਕਾਲ ਕਰਦੇ ਹਨ ਅਤੇ ਅੱਜ ਕਿਸੇ ਵੀ ਭਾਸ਼ਾ ਵਿੱਚ ਕੰਮ ਕਰਦੇ ਹਨ।
cURL
curl -X POST https://api.adhub365.com/v1/partner/ads \
-H "Authorization: Bearer sk_sandbox_..." \
-H "Content-Type: application/json" \
-d '{"advertiser_id":"adv_9f2a...","category_id":"cat_furniture","geo_scope":"local","title":"..."}'JavaScript
await fetch("https://api.adhub365.com/v1/partner/ads", {
method: "POST",
headers: {
Authorization: "Bearer sk_sandbox_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
advertiser_id: "adv_9f2a...",
category_id: "cat_furniture",
geo_scope: "local",
title: "...",
}),
});Python
import requests
requests.post(
"https://api.adhub365.com/v1/partner/ads",
headers={"Authorization": "Bearer sk_sandbox_..."},
json={
"advertiser_id": "adv_9f2a...",
"category_id": "cat_furniture",
"geo_scope": "local",
"title": "...",
},
)